FCLJ gate, WRITE_ADD_COMPLETE function
This function causes a write_add_complete log record to be written to the forward recovery log, if the file or associated data set is forward recoverable, and to the autojournal if write_add_complete journaling is specified on the file definition. The record is written to the replication log if the file was set to logreplicate.
If the file is a recoverable ESDS accessed
in non-RLS mode, this function causes a truncated write_add_complete
log record to be written to the system log. If the MASSINSERT parameter
is set to YES and the MASSINSERT_STAGE is set
to LAST, only the system log record is written and not the forward
recovery log or autojournal record.
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 that was added, if the file is an extended entry-sequenced data set (ESDS).
- FCTE_ADDRESS
- The address of the file control table entry for the file that was written to.
- FRAB_ADDRESS
- The address of the FRAB.
- KEY_ADDRESS
- The address of the key of the record that was added.
- KEY_LENGTH
- The key length for the file that was written to.
- MASSINSERT
- Indicates whether the record was added as part of a mass insert.
Values for the parameter are:
- YES
- NO
- MASSINSERT_STAGE
- Optional Parameter
- Indicates whether the record is the first or last record added
during a mass insert sequence. Values for the parameter are:
- FIRST
- LAST
- RECORD_ADDRESS
- The address of the record that was added.
- RECORD_LENGTH
- The length of the record that was 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