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