Using the EXEC CICS SYNCPOINT ROLLBACK command

About this task

The EXEC CICS® SYNCPOINT ROLLBACK command is used to back out changes to recoverable resources. In a DTP environment, the effect of the EXEC CICS SYNCPOINT ROLLBACK command is propagated across all conversations that are using synchronization level 2. An EXEC CICS SYNCPOINT ROLLBACK command can be issued in any conversation state. If the command is issued when a conversation is in receive (state 5), incoming data on that conversation is purged as described for the EXEC CICS ISSUE ERROR and EXEC CICS ISSUE ABEND commands.

When a transaction receives an EXEC CICS SYNCPOINT ROLLBACK in response to a sync point request, the EIBRLDBK indicator is set. If EXEC CICS SYNCPOINT ROLLBACK is received in response to any other request, the EIBERR and EIBSYNRB indicators are set.

The rules for determining the state after EXEC CICS SYNCPOINT ROLLBACK depend on the CICS release of the remote partner system. CICS follows APPC architecture. Therefore, following an EXEC CICS SYNCPOINT ROLLBACK command, conversations revert to the state that they were in at the start of the LUW.

If a session failure or notification of a deallocate abend occurs during EXEC CICS SYNCPOINT ROLLBACK processing, the command still completes successfully. If the same thing happens during EXEC CICS SYNCPOINT processing, the command can complete successfully with EIBRLDBK set. In such conditions, the conversation on which the failure or abend occurred is in free state (state 12).

To avoid potential state checks, it is therefore advisable to check the conversation state, by using the EXEC CICS EXTRACT ATTRIBUTES command before issuing further DTP commands.