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


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