Examples of using DFHRMUTL

The following sections illustrate the uses of DFHRMUTL.

Setting an initial start without operator intervention
Examining the override record
Resetting a warm or emergency start
Improving the performance of a cold start

Related reference
Recovery manager utility program (DFHRMUTL)
JCL requirements for DFHRMUTL
Specifying parameters for DFHRMUTL
Return codes from DFHRMUTL

Setting an initial start without operator intervention

Figure 61 shows the statements required to update the global catalog so that CICS® performs an initial start if START=AUTO is specified.

You could use this job to modify a newly-defined global catalog. This would mean that could retain START=AUTO for all your CICS start jobs, including the first with a new global catalog.

Note:
If you use this step to initialize a newly-defined global catalog, you should use the DFHCCUTL utility to initialize the local catalog too. (If you use it to reinitialize an existing global catalog, it is not necessary to initialize the local catalog.) For information about initializing catalog data sets, see the CICS System Definition Guide.
Figure 61. DFHRMUTL--setting the next auto start to be an initial start.
//RMUTL    EXEC PGM=DFHRMUTL,REGION=1M
//STEPLIB  DD DSNAME=link.dataset,DISP=SHR
//SYSPRINT DD SYSOUT=A
//DFHGCD   DD DSNAME=catalog.dataset,DISP=OLD
//SYSIN    DD *
  SET_AUTO_START=AUTOINIT
/*

Back to top
Examples of using DFHRMUTL
More examples
Examining the override record
Resetting a warm or emergency start
Improving the performance of a cold start

Examining the override record

Figure 62 shows the statements required to examine the autostart override record on a CICS global catalog data set.

Figure 62. DFHRMUTL--examining an autostart override record
//RMUTL    EXEC PGM=DFHRMUTL,REGION=1M
//STEPLIB  DD DSNAME=link.dataset,DISP=SHR 
//SYSPRINT DD SYSOUT=A
//DFHGCD   DD DSNAME=catalog.dataset,DISP=OLD
//SYSIN    DD * 
/* 

This JCL also reveals:

Back to top
Examples of using DFHRMUTL
More examples
Setting an initial start without operator intervention
Resetting a warm or emergency start
Improving the performance of a cold start

Resetting a warm or emergency start

Figure 63 shows the statements required to update the global catalog so that CICS performs a warm or emergency start if START=AUTO is specified. This enables you to undo the effects of a previous run of DFHRMUTL that set the autostart override record to AUTOINIT or AUTOCOLD. (The AUTOASIS override record is equivalent to there being no override record in the global catalog.)

If the global catalog data set was produced by a COLD_COPY, or if it is empty, DFHRMUTL rejects the AUTOASIS value.

Figure 63. DFHRMUTL--resetting a warm or emergency start
//RMUTL    EXEC PGM=DFHRMUTL,REGION=1M
//STEPLIB  DD DSNAME=link.dataset,DISP=SHR
//SYSPRINT DD SYSOUT=A
//DFHGCD   DD DSNAME=catalog.dataset,DISP=OLD
//SYSIN    DD *
  SET_AUTO_START=AUTOASIS
/*

Back to top
Examples of using DFHRMUTL
More examples
Setting an initial start without operator intervention
Examining the override record
Improving the performance of a cold start

Improving the performance of a cold start

Figure 64 shows the statements required to:

Because the original catalog data set is overwritten by a COLD_COPY, it is not suitable for a warm or emergency start. DFHRMUTL does not allow you to reset the override record to read AUTOASIS.

Figure 64. DFHRMUTL--setting the global catalog for a cold start. COLD_COPY is used to improve performance.
//RMUTL    EXEC PGM=DFHRMUTL,REGION=1M
//STEPLIB  DD DSNAME=link.dataset,DISP=SHR
//SYSPRINT DD SYSOUT=A
//DFHGCD   DD DSNAME=catalog.dataset,DISP=OLD
//NEWGCD   DD DSNAME=newcatalog.dataset,DISP=OLD
//SYSIN    DD *
  SET_AUTO_START=AUTOCOLD,COLD_COPY
/*
//         IF (RMUTL.RC=0) THEN
//* Step to be performed if RMUTL succeeds
//COPY     EXEC PGM=IDCAMS
//DFHGCD   DD DSNAME=catalog.dataset,DISP=OLD
//SYSPRINT DD SYSOUT=A
//NEWGCD   DD DSNAME=newcatalog.dataset,DISP=OLD
//SYSIN    DD *
  REPRO INFILE(NEWGCD) OUTFILE(DFHGCD) REUSE
/*
//* End of step
//         ENDIF

Back to top
Examples of using DFHRMUTL
More examples
Setting an initial start without operator intervention
Examining the override record
Resetting a warm or emergency start
[[ Contents Previous Page | Next Page Index ]]