FCFR gate, READ_UPDATE_SET function

Read a record for updating, and return a pointer to a buffer containing the data.

Input Parameters

BACKOUT_TYPE
A value that indicates:
  • whether the request is for a backout request
  • whether the request is to processing a write-add log record or a read-update log record
  • for write requests, whether the write is direct or sequential.
Values for the parameter are:
  • NOT_BACKOUT
  • READ_UPD
  • WRITE_DIRECT
  • WRITE_SEQUENTIAL
BYPASS_SECURITY_CHECK
A binary value that indicates that security checking can be omitted for the current request.
Values for the parameter are:
  • NO
  • YES
CONDITIONAL
A binary value that indicates whether the request should wait if VSAM is holding an active lock against the record, including records locked as the result of a DEADLOCK. CONDITIONAL(YES) corresponds to option NOSUSPEND on the CICS API.
Values for the parameter are:
  • NO
  • YES
ENVIRONMENT_IDENTIFIER
A token that identifies the caller's environment.
FILE_NAME
The name of the FILE resource.
GENERIC
A binary value that specifies whether the search key is a generic key.
Values for the parameter are:
  • NO
  • YES
KEY_COMPARISON
A value that specifies whether the search can be satisfied only by a record having the same key as that specified in the record identification field parameter, or by a record having a greater key.
Values for the parameter are:
  • EQUAL
  • GTEQ
RECORD_ID_ADDRESS
The address of the record identification field.
RECORD_ID_TYPE
The type of data contained in the record identification field.
Values for the parameter are:
  • DEBKEY
  • DEBREC
  • KEY
  • RBA
  • RRN
TOKEN_REQUEST
A binary value that indicates whether a token is supplied with the request.
Values for the parameter are:
  • NO
  • YES
BASE_RECORD_ID_ADDRESS
Optional Parameter
The address of the base record identifier.
FCTE_POINTER
Optional Parameter
The address of the file control table entry (FCTE) for the file.
RECORD_ID_LENGTH
Optional Parameter
The length of the record identifier.
RECORD_LOCK_ONLY
Optional Parameter
A binary value that indicates whether the purpose of the request is solely to lock the record.
Values for the parameter are:
  • NO
  • YES
REMOTE_FILE_NAME
Optional Parameter
The file name in the remote system.
REMOTE_SYSTEM
Optional Parameter
The SYSID of the remote system.
WORK_ELEMENT_ADDRESS
Optional Parameter
The address of the current file request thread element (FRTE).

Output Parameters

REASON
The following values are returned when RESPONSE is DISASTER:
  • ABEND
  • CFDT_REOPEN_ERROR
  • DISASTER_PERCOLATION
  • SECURITY_FAILURE
The following values are returned when RESPONSE is EXCEPTION:
  • BDAM_KEY_CONVERSION
  • CACHE_FAILURE
  • CFDT_CONNECT_ERROR
  • CFDT_SERVER_NOT_AVAILABLE
  • CFDT_SERVER_NOT_FOUND
  • CFDT_SYSIDERR
  • CFDT_TABLE_GONE
  • DATASET_BEING_COPIED
  • DEADLOCK_DETECTED
  • DUPLICATE_READ_UPDATE
  • FILE_DISABLED
  • FILE_NOT_OPEN
  • FILE_NOT_RECOVERABLE
  • FULL_KEY_WRONG_LENGTH
  • GENERIC_KEY_TOO_LONG
  • IO_ERROR
  • KEY_LENGTH_NEGATIVE
  • LOADING
  • LOCK_STRUCTURE_FULL
  • LOCKED
  • LOST_LOCKS
  • NOSUSPEND_NOT_RLS
  • NOT_IN_SUBSET
  • PREVIOUS_RLS_FAILURE
  • RBA_ACCESS_TO_RLS_KSDS
  • READ_NOT_AUTHORISED
  • RECLEN_EXCEEDS_LOGGER_BFSZ
  • RECORD_BUSY
  • RECORD_NOT_FOUND
  • RESTART_FAILED
  • RLS_DEADLOCK_DETECTED
  • RLS_DISABLED
  • RLS_FAILURE
  • SELF_DEADLOCK_DETECTED
  • SERVREQ_VIOLATION
  • SHIPPED_SECURITY_FAILURE
  • SYSIDERR
  • TIMEOUT
  • TOO_MANY_CFDTS_IN_UOW
  • VSAM_REQUEST_ERROR
The following values are returned when RESPONSE is INVALID:
  • INVALID_FORMAT
  • INVALID_FUNCTION
ACCMETH_RETURN_CODE
The return code from the file access method for request.
DUPLICATE_KEY
When the data set is being accessed by way of an alternate index path that allows non-unique alternate keys, a binary value that indicates whether further records exist with the same alternate key.
Values for the parameter are:
  • NO
  • YES
MAXIMUM_RECORD_LENGTH
The length of the longest record in the data set.
RECORD_ADDRESS
The address of the target record.
RECORD_LENGTH
Optional Parameter
The length of the record.
RESPONSE
Indicates whether the domain call was successful. For more information, see RESPONSE parameter on domain interfaces.
TERMINATE_REMOTE_REQUEST
A binary value that indicates whether a remote file request should be terminated.
Values for the parameter are:
  • NO
  • YES
TERMINATE_STRING
A binary value that indicates whether the FRTE string should be terminated.
Values for the parameter are:
  • NO
  • YES
UPDATE_TOKEN
Optional Parameter
A token that identifies an update request, and allows subsequent requests to refer to it.


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