INQUIRE UOWDSNFAIL
CEMT INQUIRE UOWDSNFAIL DSN(datasetname) can return information about shunted units of work that have failed to commit changes to the named data set. The information includes the resource that caused the failure and, where there can be more than one reason, the reason for the failure. The EXEC CICS® INQUIRE UOWDSNFAIL command provides a browse interface, allowing an application program to browse through all the shunted units of work for a data set or a group of data sets.
- Indoubt failure, where a communication failure has occurred while a commit participant is in the indoubt state. The cause of an indoubt failure is returned on an INQUIRE UOWDSNFAIL command as CONNECTION. Indoubt failures are retried automatically when the connection is resynchronized.
- Backout failure, where a unit of work that is backing out
changes fails during the backout of:
- One or more data sets (which returns a CAUSE of DATASET)
- A number of data sets bound to a failing cache (which returns a CAUSE of CACHE)
- All the RLS data sets updated in the unit of work when the SMSVSAM server fails (which returns a CAUSE of RLSSERVER with REASON RLSGONE).
Backout failures can be retried after the cause of the failure has been corrected. In some cases, the retry occurs automatically.
- Commit failure, where a unit of work has failed during
the commit action. The commit action may be either to commit the changes made
by a completed unit of work, or to commit the successful backout of a unit of work. This
failure is caused by a failure of the SMSVSAM server, which is returned as
RLSSERVER on the CAUSE option and COMMITFAIL or RRCOMMITFAIL on the REASON
option of the INQUIRE UOWDSNFAIL command. (RLSSERVER is also returned as the
WAITCAUSE on an INQUIRE UOW command.)
Commit failures can be retried after the cause of the failure has been corrected. The retry usually occurs automatically.
Note that INQUIRE UOWDSNFAIL displays information about UOWs that are currently failed with respect to one or more data sets. The command does not display information for a unit of work that was in backout-failed or commit-failed state and is being retried, or for a unit of work that was indoubt and is being completed. The retry, or the completion of the indoubt unit of work, could fail, in which case a subsequent INQUIRE UOWDSNFAIL displays the relevant information.