DFHAC2246    date time applid Transaction termination processing for transaction tranid could not be completed normally because a connected system has requested that the unit of work be rolled back{. EXCI job = } exci_id. condmsg

Explanation

A transaction has issued an EXEC CICS RETURN in backout required program state. The backout required program state is set when an application receives a backout request on a protected conversation.

Recoverable resources updated by the unit of work are backed out and locks released.

Exci Job =exci_id is added when tranid is a server transaction running on behalf of a non CICS job using the external CICS interface (EXCI). The exci_id consists of 'jobname.stepname.procname - MVSid' and identifies the EXCI client job. The stepname and procname may be omitted. The MVSid identifies the MVS system on which the EXCI client job is running. If MRO/XCF is being used, this can be different from the MVS system on which this CICS system is running. The MVSid is the SMF system identification (SID), hence the MVSid will be omitted if SMF is not active. Terminal termid represents the connection between the EXCI client and CICS rather than a real terminal.

In the case of an MRO or an ISC APPC (parallel sessions) connected system, termid is a terminal identifier (transaction routing) or a session identifier, and sysid is the identifier of the linked CICS system. The display ends with the termination message condmsg issued by the linked system.

System action

If possible, message DFHAC2216 is sent to the terminal user. Termination processing continues.

User response

To avoid the error, the application should code an EXEC CICS SYNCPOINT command before the EXEC CICS RETURN. A syncpoint issued in 'backout required' program state results in a backout being performed, and the ROLLEDBACK condition returned on the EXEC CICS SYNCPOINT command. If this condition is then handled, a subsequent EXEC CICS RETURN will complete successfully.

Resubmit the transaction after the cause of the indication to roll back has been removed.

Module

DFHTFP

XMEOUT parameters/Message inserts

  1. date
  2. time
  3. applid
  4. tranid
  5. Value chosen from the following options:
  6. exci_id
  7. condmsg

Destination

CSMT



DFHAC2246.html | Timestamp icon Last updated: Sunday, 4 June 2017