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


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