FCLJ gate, WRITE_ADD function
This function causes a write_add log record to be written to the system log if the file is recoverable and if the DESTINATION parameter specifies BOTH. It causes a write_add log record to be written to the autojournal if journaling of write adds was specified on the file definition. The record is written to the replication log if the file was set to logreplicate.
Input Parameters
- BACKOUT
- Indicates whether the call is made as part of transaction backout
processing. Values for the parameter are:
- YES
- NO
- BASE_ESDS_RBA
- The relative byte address (RBA) of the record being added, if the file is an extended entry-sequenced data set (ESDS).
- DESTINATION
- Specifies whether the log record is to be written to the autojournal
only, or to both the autojournal and the system log. It is used to
suppress writing records that are otherwise requested by the file
definition. Values for the parameter are:
- JOURNAL
- BOTH
- FCTE_ADDRESS
- The address of the file control table entry for the file being written to.
- FRAB_ADDRESS
- The address of the FRAB.
- KEY_ADDRESS
- The address of the key of the record being added.
- KEY_LENGTH
- The key length of the record being written to.
- MASSINSERT
- Indicates whether the record is being added as part of a mass
insert. Values for the parameter are:
- YES
- NO
- RECORD_ADDRESS
- The address of the record being added.
- RECORD_LENGTH
- The length of the record being added.
- SHUNTED
- Indicates whether the unit of work has ever been shunted. Values
for the parameter are:
- YES
- NO
Output Parameters
- 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