FCDU gate, INQUIRE function
This function issues an INQUIRE to the coupling facility data table (CFDT) to obtain information about the status of an active unit of work (UOW).
Input Parameters
- BROWSE
- Optional Parameter
- Specifies whether the inquire is for a single UOW or for the first
or next UOW in a browse. Values for the parameter are:
- FIRST
- NEXT
- POOL_ELEM_ADDR
- The address of the pool element that identifies the CFDT pool for which the backout is to be issued. One or more of the CFDTs updated by the UOW reside in this pool. The backout call is issued to the CFDT server for this pool.
- POOL_NAME
- The name of the CFDT pool. The pool name is included for diagnostic purposes.
- UOW_ID
- This 8-character string identifies the UOW for which status information is being requested or gives the ID for the previous UOW in the browse.
- UOW_RESTARTED
- Optional Parameter
- Indicates whether the inquire will select only UOWs that have
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
- CF_ACCESS_ERROR
- CFDT_SYSIDERR
- CFDT_SERVER_NOT_AVAILABLE
- CFDT_SERVER_NOT_FOUND
- CFDT_CONNECT_ERROR
- CFDT_DISCONNECT_ERROR
- RESYNC_RETRY_FAILED
- The following values are returned when RESPONSE is INVALID:
- INVALID_FORMAT
- INVALID_FUNCTION
- The following values are returned when RESPONSE is DISASTER:
- ABEND
- DISASTER_PERCOLATION
- RESPONSE
- Indicates whether the domain call was successful. For more information, see RESPONSE parameter on domain interfaces.
- Values for the parameter are:
- OK
- DISASTER
- EXCEPTION
- INVALID
- KERNERROR
- PURGED
- RETURNED_UOW_ID
- This 8-character string specifies the UOW for which the browse is returning status information.
- UOW_RESTART_STATE
- Indicates whether the UOW has been through restart processing.
Values for the parameter are:
- YES
- NO
- UOW_RETAINED
- Indicates whether the locks for the UOW have been retained. Values
for the parameter are:
- YES
- NO
- UOW_STATE
- Indicates the state of the UOW. Values for the parameter are:
- IN_FLIGHT
- IN_DOUBT
- IN_COMMIT
- IN_BACKOUT