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