FCCU gate, INQUIRE function

This function returns information about the status of an active unit of work.

Input Parameters

BROWSE
Optional Parameter
Specifies whether the inquire is for a single unit of work or for the first or next unit of work in a browse. If this parameter is omitted, the inquire is assumed to be a single unit of work inquire. Values for the parameter are:
  • FIRST
  • NEXT
The FIRST option indicates a search for a UOW ID greater than or equal to the specified UOW ID, and NEXT indicates a search for a UOW ID greater than the specified UOW ID.
TRANSACTION_NUMBER
Optional Parameter
This 4-character string identifies the requesting task in the debug trace if used.
UOW_ID
This 8-character string combines the subsystem name with the unit of work identification in the client region to form the fully qualified unit of work identifier.
UOW_RESTARTED
Optional Parameter
Specifies that the function must select only units of work that have or have not been through restart processing. Values for the parameter are:
  • YES
  • NO

Output Parameters

REASON
The following values are returned when RESPONSE is EXCEPTION:
  • SERVER_CONNECTION_FAILED
  • RECOVERY_NOT_ENABLED
  • UOW_NOT_FOUND
RESPONSE
Indicates whether the domain call was successful. For more information, see RESPONSE parameter on domain interfaces.
Values for the parameter are:
  • OK
  • EXCEPTION
  • DISASTER
  • INVALID
  • KERNERROR
  • PURGED
UOW_ID
The 8-character unit of work identification.
UOW_RESTARTED
Indicates whether the unit of work has been through restart. Values for the parameter are:
  • YES
  • NO
UOW_RETAINED
Indicates whether the locks for the unit of work have been marked as retained, either explicitly in the current connection or implicitly by a restart. Values for the parameter are:
  • YES
  • NO
UOW_STATE
Indicates the state of an active unit of work. Values for the parameter are:
IN_FLIGHT
The unit of work has made changes but has not yet reached the stage of prepare to commit.
IN_DOUBT
The unit of work has been prepared but not committed or backed out.
IN_COMMIT
Commit processing has started.
IN_BACKOUT
Backout processing has started.
When commit or backout processing completes, the unit of work is deleted.


dfhs3_FCCUinquire.html | Timestamp icon Last updated: Monday, 5 June 2017