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:
  • For 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.
  • After 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:
  • For each data set that has retained locks (determined by issuing INQ DSNAME RETLOCKS), it forces backout for the shunted indoubt units of work.
  • After 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.

For more information about these batch-enabling sample programs see Batch-enabling sample programs for RLS access-mode data sets (DFH0BATx), 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 CICSTS54.CICS.SDFHSAMP library.



dfht209.html | Timestamp icon Last updated: Monday, 5 June 2017