LGGL gate, WRITE_JNL function
Write a record to a general log identified by a journal name
Input Parameters
- COMPONENT
- Identifies the component (e.g. FC) opening this stream
- DATA
- The address of a reusable Iliffe vector describing the items of data to be written to the log stream.
- JNL_NAME
- The 8-byte journal name to be opened
- FORCE_AT_SYNC
- Optional Parameter
- Indicates that the caller wants the log stream to be forced when the associated transaction reaches Syncpoint. FORCE_AT_SYNC can be used in conjunction with FORCE_NOW. This is needed by File control for ESDS writes which have to be forced immediately but which also need the UOW structure to allow the calculation of Fuzzy backup recovery times.
- Values for the parameter are:
- NO
- YES
- FORCE_NOW
- Optional Parameter
- Indicates that the caller wants to wait until the data has been successfully written to the log stream.
- Values for the parameter are:
- NO
- YES
- SUSPEND
- Optional Parameter
- Supported for compatibility with old EXEC interface. Causes BUFFER_FULL exception to be raised if there is no space rather than waiting for space. The task may still be suspended for many other reasons.
- Values for the parameter are:
- NO
- YES
Output Parameters
- REASON
- The following values are returned when RESPONSE is EXCEPTION:
- BUFFER_FULL
- BUFFER_LENGTH_ERROR
- ERROR_OPENING_LOG
- INVALID_JNL_NAME
- LOG_HAS_FAILED
- LOG_IS_DISABLED
- LOG_IS_SYSTEM_LOG
- LOG_NOT_DEFINED
- WRITE_ERROR
- RESPONSE
- Indicates whether the domain call was successful. For more information, see RESPONSE parameter on domain interfaces.
- FORCE_TOKEN
- Optional Parameter
- A token to be used on a subsequent FORCE to ensure that a specific records and any prior records have been hardened