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
If the BROWSE parameter is omitted, the request is treated as a single UOW inquire. Setting the BROWSE parameter to FIRST indicates a search for a UOW ID greater than or equal to the specified UOW ID. Setting the BROWSE parameter to NEXT indicates a search for a UOW ID greater than the specified UOW ID.
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


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