FCLJ gate, READ_UPDATE function

This function causes a read_update log record to be written to the system log if the file is recoverable and if the DESTINATION parameter specifies either LOG or BOTH. This function causes a read_update log record to be written to the autojournal if journaling of read updates is specified on the file definition and if the DESTINATION parameter specifies either JOURNAL or BOTH. The record is written to the replication log if the file was set to logreplicate.

Input Parameters

BASE_ESDS_RBA
The relative byte address (RBA) of the record being read for update, if the file is an extended entry-sequenced data set (ESDS).
DESTINATION
Specifies whether the log record is to be written to the autojournal, the system log, or both. It is used to suppress writing records that are otherwise requested by the file definition. Values for the parameter are:
  • JOURNAL
  • LOG
  • BOTH
FCTE_ADDRESS
The address of the file control table entry for the file being read for update.
FRAB_ADDRESS
The address of the FRAB.
KEY_ADDRESS
The address of the key of the record being read for update.
KEY_LENGTH
The key length of the record being read for update.
RECORD_ADDRESS
The address of the record being read for update.
RECORD_LENGTH
The length of the record being read for update.
SHUNTED
Indicates whether the unit of work has ever been shunted. Values for the parameter are:
  • YES
  • NO
SYNCHRONIZE_LOG
Indicates whether the system log is to be synchronized when the log record is written. Values for the parameter are:
  • YES
  • NO

Output Parameters

LOG_TOKEN
Optional Parameter
This parameter is returned if SYNCHRONIZE(NO) was specified. It contains a token to be used when subsequently synchronizing the system log.
REASON
The following values are returned when RESPONSE is DISASTER:
  • ABEND
  • LG_RETURNED_ERROR
  • RM_RETURNED_ERROR
The following value is returned when RESPONSE is EXCEPTION:
  • JOURNAL_TOO_SMALL
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
  • PURGED


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