IBM SC34-7012-01 manual Investigating an indoubt failure, Intrapartition transient data

reads against VSAM data sets and has made no updates to other resources, it is safe to force the unit of work using the SET DSNAME or SET UOW commands.

CICS saves enough information about the unit of work to allow it to be either committed or backed out when the indoubt unit of work is unshunted when the coordinator provides the resolution (or when the transaction wait time expires). This information includes the log records written by the unit of work.

When CICS has re-established communication with the coordinator for the unit of work, it can resynchronize all indoubt units of work. This involves CICS first unshunting the units of work, and then proceeding with the commit or backout. All CICS enqueues and VSAM RLS record locks are released, unless a commit failure or backout failure occurs.

For information about the resynchronization process for units of work that fail indoubt, see the CICS Installation Guide.

Intrapartition transient data

When a UOW that has updated a logically recoverable intrapartition transient data queue fails indoubt, CICS converts the locks held against the TD queue to retained locks.

Until the UOW is unshunted, the default action is to reject with the LOCKED condition further requests of the following types:

vREADQ, if the indoubt UOW had issued READQ or DELETEQ requests

vWRITEQ, if the indoubt UOW had issued WRITEQ or DELETEQ requests

vDELETEQ, if the indoubt UOW had issued READQ, WRITEQ, or DELETEQ requests

You can use the WAITACTION option on the TD queue resource definition to control the action that CICS takes when an update request is made against a shunted indoubt UOW that has updated the queue. In addition to the default option, which is WAITACTION(REJECT), you can specify WAITACTION(QUEUE) to queue further requests while the queue is locked by the failed-indoubt UOW.

After resynchronization, the shunted updates to the TD queue are either committed or backed out, and the retained locks are released.

Auxiliary temporary storage

When a UOW that has updated a recoverable temporary storage queue fails indoubt, the locks held against the queue are converted to retained locks. Until the UOW is unshunted, further update requests against the locked queue items are rejected with the LOCKED condition.

After resynchronization, the shunted updates to the TS queue are either committed or backed out, and the retained locks are released.

Investigating an indoubt failure

This example shows how to investigate a unit of work (UOW) that has failed indoubt. For the purposes of the example, the CICS-supplied transaction CIND has been used to create the failure - one of the FILEA sample application transactions, UPDT, has been made to fail indoubt.

For more information about CIND, see the CICS Supplied Transactions.

Chapter 8. Unit of work recovery and abend processing 85