IBM SC34-7012-01 The batch-enabling sample programs, CEMT command examples, DFH0BAT1, DFH0BAT2

Diagnostic messages DFHFC3003 and DFHFC3010 are issued for each log record.

If a data set has both indoubt-failed and other (backout- or commit-) failed units of work, deal with the indoubt UOWs first, using SET DSNAME UOWACTION, because this might result in other failures which can then be cleared by the SET DSNAME RESETLOCKS command.

The batch-enabling sample programs

CICS provides a suite of sample programs to help you automate batch preparation procedures.

The three coordinating programs, which use CICS distributed program link (DPL) commands to run programs on a set of nominated CICS regions, are:

DFH0BAT1

This sample program disables, through the programs to which it links, a set of nominated transactions.

DFH0BAT2

This sample program identifies, through the programs to which it links, the retained lock information for nominated data sets:

vFor each data set, it issues a SET DSNAME RETRY command to try to resolve any retained locks that are due to transient failures, or failures that have been corrected.

vAfter a timed delay to allow retries to run, it issues, for each data set, an INQUIRE DSNAME RETLOCKS command to determine whether there are any retained locks. If there are, it issues an INQUIRE UOWDSNFAIL command to obtain information about any remaining shunted units of work that have made uncommitted changes to the data set. It displays the information returned by the command, together with recommended procedures for resolving the locks.

DFH0BAT3

Through the programs to which it links, this sample program forces locks for nominated data sets:

vFor each data set that has retained locks (determined by issuing INQ DSNAME RETLOCKS), it forces backout for the shunted indoubt units of work.

vAfter a timed delay to allow the forced backouts to run, it resets the locks for any commit-failed or backout-failed units of work.

The DFH0BAT3 sample program is also useful for resolving pending backouts after a failure to forward recover a data set. See “Procedure for failed RLS mode forward recovery operation” on page 198.

For more information about these batch-enabling sample programs see the CICS Operations and Utilities Guide, which describes how to install the programs and how to prepare the required input for them. See also the comments contained in the source code supplied in the CICSTS41.CICS.SDFHSAMP library.

CEMT command examples

The following is a series of CEMT command examples showing how you can use CEMT to resolve unit of work failures in preparation for batch processing.

1.A CEMT INQUIRE UOWDSNFAIL command for a specified data set shows in the following display that there are two failed units of work:

178CICS TS for z/OS 4.1: Recovery and Restart Guide