LGGL gate, WRITE function
Write a record to a general log identified by a token from a previous OPEN.
Input Parameters
- DATA
- The address of a reusable Iliffe vector describing the items of data to be written to the log stream.
- LOG_TOKEN
- The token returned by OPEN
- 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
Output Parameters
- REASON
- The following values are returned when RESPONSE is EXCEPTION:
- BUFFER_LENGTH_ERROR
- WRITE_ERROR
- The following values are returned when RESPONSE is INVALID:
- UNKNOWN_LOG_TOKEN
- 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