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


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