FCDU gate, RETAIN function
This function calls the coupling facility data table (CFDT) server to convert locks held by the unit of work against recoverable CFDTs into retained locks.
Input Parameters
- POOL_ELEM_ADDR
- The address of the pool element that identifies the CFDT pool for which the retain is to be issued. One or more of the coupling facility data tables updated by the unit of work reside in this pool. The retain call will be 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
- The identifier for the unit of work for which the locks are going to be retained.
Output Parameters
- REASON
- The following values are returned when RESPONSE is EXCEPTION:
- SERVER_CONNECTION_FAILED
- RECOVERY_NOT_ENABLED
- UOW_NOT_FOUND
- UOW_MADE_NO_CHANGES
- UOW_FAILED
- NO_SPACE_IN_POOL
- POOL_STATE_ERROR
- 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