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
- 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.