gtps1m5sSystem Macros

WLOGC-Write to the Recovery Log

Use this system macro to permit the transaction manager (TM) and resource managers (RMs) to control the writing of information to the recovery log. The recovery log is used by the TPF system in association with TPF transaction services. Recovery log support is general in nature and is designed to be extended to support the recovery of additional resources such as message and tape processing. Application-specific resources can also use the recovery log to become part of the recoverable resources.

Required Authorizations
Key0 Restricted System Common Storage

X

Format




CONTROL=Rx
A register (R1-R6, R14) that contains the address of the control or header information that is part of the transaction log record. This parameter is required.

DATALIST=Ry
A register (R1-R6, R14) that contains the address of a list of data elements that will be written to the transaction log. This parameter is required.

TMCR=Rz
A register (R1-R6, R14) that contains a pointer to the transaction manager control record (TMCR) associated with this write request. This parameter is optional and, if not coded, will cause the WLOGC service to calculate the address of the TMCR.

WAKEUP
This is a special parameter whose use is restricted to the CL22 program. This parameter permits the CL22 program to link to the WLOGC service routine to reactivate resources that are waiting. The following resources are processed:

WAITERS
Wake up WLOGC requesters, which are waiting for buffer input/output (I/O) to be completed.

UNBLOCK
Wake up WLOGC requesters, which are waiting for WLOGC processing to continue. WLOGC processing is blocked when all buffers are in use.

BUFFER=Rz
A register (R1-R6, R14) that contains a pointer to the buffer associated with the WAKEUP request. This parameter is required when you code WAKEUP=WAITERS.

Entry Requirements

Return Conditions

Programming Considerations

Examples

The following is an example of how to write to the recovery log.

WLOGC CONTROL=R2,DATALIST=R3