Recovery manager utility program (DFHRMUTL)

This section describes the recovery manager utility program, DFHRMUTL, for overriding the type of CICS® startup produced by a START=AUTO, and improving the performance of cold and initial starts.

Note: For detailed information about the type of startup produced by each possible combination of START setting, global catalog and system log contents, and autostart override, see Controlling start and restart.

DFHRMUTL processes the global catalog data set. It can insert or modify the recovery manager autostart override record. Optionally, it can extract a subset of the catalog records to build a reduced new catalog for a cold start.

You can use the recovery manager utility program to:
  • Set or reset the recovery manager autostart override record on the global catalog.
  • Examine the setting of the autostart override record on the global catalog.
  • Copy that part of the catalog needed for a cold start to a new global catalog.

    If a new catalog is built using DFHRMUTL, CICS is able to perform only a cold start or an initial start with the new catalog. The performance of these starts will, however, be better than that of a cold or initial start with a full catalog.

DFHRMUTL sets a return code indicating if it has succeeded.

You can specify what you want DFHRMUTL to do by supplying parameters in a single optional record in the input data set, SYSIN. See Specifying parameters for DFHRMUTL.

You may need to supply one or two CICS global catalog data sets:
DFHGCD
The catalog from which a copy is extracted or, if no copy is being made, the one in which the autostart override record is placed.
NEWGCD
The catalog which is cleared and receives the copy, if one is requested.
DFHRMUTL writes some or all of the following to the output data set, SYSPRINT:
  • The input record from SYSIN.
  • Error messages.
  • A summary of the autostart override record found on the global catalog, DFHGCD.
  • The next CICS start type found on the global catalog, DFHGCD.
  • Counts of those units of work (UOWs) that were in an indoubt, commit-failed or backout-failed state when CICS was shut down. Note that these counts are provided if the next CICS start type is warm.
  • Whether or not the DFHGCD catalog is a reduced copy from a previous run of DFHRMUTL.
  • The autostart override record that has been set on DFHGCD, or on NEWGCD if a copy is made.

The catalogs DFHGCD and NEWGCD may be updated. If no copy is requested, DFHGCD may have an override record inserted, or updated. If a copy is requested, DFHGCD is unchanged, NEWGCD is cleared, and the copy and new override record written to NEWGCD.