SYNCPOINT
Establish a syncpoint.
Syntax
Conditions: INVREQ, ROLLEDBACK
This command is threadsafe.
NOHANDLE, RESP, and
RESP2 are common options that can be added to all EXEC CICS
commands to process error conditions. They are not explicitly included in the command syntax diagram
and option descriptions. For information about these common options and EXEC CICS
command syntax, see EXEC CICS command format and programming considerations.
Note: The Recovery Manager processes this command on an open TCB wherever possible to minimize TCB
switching. Syncpoint processing can take place on an open TCB for all resource types declared as
threadsafe that were accessed in the unit of work. If resource types not declared as threadsafe were
accessed in the unit of work, the Recovery Manager switches to the QR TCB for those resource types.
A CICS® resource type declares itself to the Recovery Manager
as threadsafe if the
EXEC CICS commands relating to the resource type are
threadsafe. Description
SYNCPOINT divides a task (usually a long-running one) into smaller units of work. It specifies that all changes to recoverable resources made by the task since its last syncpoint are to be committed.
Note: A failure occurring during the commit phase (phase 2) of syncpoint processing does not return
an error condition and the transaction is not abnormally terminated. Subsequent units of work in the
transaction are allowed to continue normally. See Unit of work recovery and abend processing for
further information.
Conditions
- 16 INVREQ
- RESP2 values:
- 200
- SYNCPOINT was in a program that is linked to from a remote system that has not specified the SYNCONRETURN option, or if it has been linked to locally and is defined with EXECUTIONSET=DPLSUBSET.
Default action: terminate the task abnormally.
- 82 ROLLEDBACK
- Occurs when a SYNCPOINT command is driven into rollback by a remote system that is unable to
commit the syncpoint. All changes made to recoverable resources in the current unit of work are
backed out.
Default action: terminate the task abnormally.
