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


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