FCCR gate, POINT function
This function locates a record in a coupling facility data table (CFDT).
Input Parameters
- KEY
- The 16-byte key of the record to be accessed. For approximate key operations, this parameter specifies the start key and is updated on successful completion to contain the key of the record accessed.
- KEY_COMPARISON
- The comparison condition; this parameter can take the following
values:
- LT
- LTEQ
- EQ
- GTEQ
- GT
- KEY_MATCH_LENGTH
- The key match length for generic key operations.
- TABLE_NAME
- This 16-character field contains the 8-character name of the CFDT and is padded with trailing blanks.
- TABLE_TOKEN
- The token returned by the OPEN function, which must be passed on all subsequent requests against that open table.
- TRANSACTION_NUMBER
- This 4-character string identifies the requesting task in the debug trace, if used.
- UOW_ID
- This 8-character string specifies the unit of work ID. The unit of work ID is required when updating using the locking model.
Output Parameters
- KEY
- Returns the 16-byte key of the located record.
- REASON
- The following values are returned when RESPONSE is EXCEPTION:
- SERVER_CONNECTION_FAILED
- RECORD_NOT_FOUND
- TABLE_LOADING
- TABLE_TOKEN_INVALID
- TABLE_DESTROYED
- POOL_STATE_ERROR
- CF_ACCESS_ERROR
- 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