JCL requirements for the Multiple Resource Checker utility

When you code a JCL job to run the Multiple Resource Checker utility, include the EXEC statement and appropriate DD statements.

Subsections:

JCL example

The following figure shows a JCL example that contains the JCL statements for checking the consistency of multiple resources and reporting the differences in multiple sets of RECON data sets.

Figure 1. JCL for checking the consistency of multiple resources and the difference in multiple sets of RECON data sets
//stepname EXEC PGM=FABWMCHK
//STEPLIB  DD   DSN=HPS.SHPSLMD0,DISP=SHR
//IMSV13   DD   DSN=IMSV13.RESLIB,DISP=SHR
//IMSV14   DD   DSN=IMSV14.RESLIB,DISP=SHR
//IMSV15   DD   DSN=IMSV15.RESLIB,DISP=SHR
//RECON011 DD   DSN=IMSVS1.RECON1,DISP=SHR
//RECON012 DD   DSN=IMSVS1.RECON2,DISP=SHR
//RECON013 DD   DSN=IMSVS1.RECON3,DISP=SHR
//RECON021 DD   DSN=IMSVS2.RECON1,DISP=SHR
//RECON022 DD   DSN=IMSVS2.RESON2,DISP=SHR
//RECON023 DD   DSN=IMSVS2.RECON3,DISP=SHR
//RECON031 DD   DSN=IMSVS3.RECON1,DISP=SHR
//RECON032 DD   DSN=IMSVS3.RECON2,DISP=SHR
//RECON033 DD   DSN=IMSVS3.RECON3,DISP=SHR
//DBDLIB01 DD   DSN=IMSVS.DBDLIB1,DISP=SHR
//DBDLIB02 DD   DSN=IMSVS.DBDLIB2,DISP=SHR
//DBDLIB03 DD   DSN=IMSVS.DBDLIB3,DISP=SHR
//DBDLIB04 DD   DSN=IMSVS.DBDLIB4,DISP=SHR
//PSBLIB01 DD   DSN=IMSVS.PSBLIB1,DISP=SHR
//PSBLIB02 DD   DSN=IMSVS.PSBLIB2,DISP=SHR
//ACBLIB01 DD   DSN=IMSVS.ACBLIB1,DISP=SHR
//ACBLIB02 DD   DSN=IMSVS.ACBLIB2,DISP=SHR
//ACBLIB03 DD   DSN=IMSVS.ACBLIB3,DISP=SHR
//ACBLIB04 DD   DSN=IMSVS.ACBLIB4,DISP=SHR
//FABWOUT  DD   SYSOUT=A
//FABWSUMM DD   SYSOUT=A
//FABWRRPT DD   SYSOUT=A
//SYSPRINT DD   SYSOUT=A
//FABWCTL  DD   *
     (control statements)
/*

EXEC statement

The EXEC statement must be in the following format:
//stepname EXEC PGM=FABWMCHK

You can optionally specify the IMSPLEX and DBRCGRP parameters on the EXEC statement. If specified, the utility processes RECON data sets that belong to the same group identified by the IMSPLEX and DBRCGRP parameters. The utility cannot process the RECON data sets that do not belong to the group.

For example:
  //stepname EXEC PGM=FABWMCHK,PARM='IMSPLEX=imsplex,DBRCGRP=dbrcgrp'
IMSPLEX=imsplex
A 1-to-5 character IMSplex name to be used for RECON data sets.
DBRCGRP=dbrcgrp
A 1-to-3 character identifier (ID) assigned to a group of DBRC instances that access the same RECON data set in an IMSplex.

DD statements

Code the following DD statements to identify the source of input and the placement of output information:

STEPLIB DD or JOBLIB DD
Required. This input DD statement defines the IMS Library Integrity Utilities load module library.
IMSVnn DD
Optional. This input DD statement points to the library that contains the IMS load modules. Specify this DD statement if you want to compare RECON data sets.

For nn, specify the version of IMS. For example, to process the RECON data sets that were generated by IMS 15, specify an IMSV15 DD statement.

If you use the DBRC Structured Call Interface (SCI) Registration Exit to access RECON data sets, specify it in this DD statement. If specified, the utility processes the RECON data sets that can be accessed with the SCI exit.

RECONxxn DD
Optional. This input DD statement points to the RECON data sets.
xx
Specify 01 to process one set of RECON data sets. To process multiple sets of RECON data sets, specify a sequential number for each set of the RECON data sets. Up to 10 sets can be specified.
n
Specify 1, 2, or 3 to identify the RECON data set within a set of RECON data sets:
1
Copy1 RECON data set.
2
Copy2 RECON data set.
3
Spare RECON data set.
DBDLIBxx DD
Optional. This input data set points to the library that contains the DBDs to check. For xx, assign a sequential number for up to 10 libraries.

Concatenation of multiple DBD libraries is not supported.

PSBLIBxx DD
Optional. This input data set points to the library that contains the PSBs to check. For xx, assign a sequential number for up to 10 libraries.

Concatenation of multiple PSB libraries is not supported.

ACBLIBxx DD
Optional. This input data set points to the library that contains the ACBs to check. For xx, assign a sequential number for up to 10 libraries.

Concatenation of multiple ACB libraries is not supported.

FABWOUT DD
Required. All the input parameters, runtime parameters, and error messages are written to this output data set.

The record format is fixed block (FB). The logical record length is 133. Block size, if coded, must be a multiple of 133.

FABWSUMM DD
Required. The Resource Check Summary report is generated in this output data set.

The record format is fixed block (FB). The logical record length is 133. Block size, if coded, must be a multiple of 133.

FABWRRPT DD
Optional. The RECON Difference report is generated in this output data set. If you specify DIFFREP=Y on the FABWCTL statement, which requests to generate the RECON Difference report, you must specify this DD statement.

The record format is fixed block (FB). The logical record length is 133. Block size, if coded, must be a multiple of 133.

FABWCTL DD
Optional. This input data set contains the control statements for the FABWMCHK program.

The record format is fixed block (FB). The logical record length is 80. Block size, if coded, must be a multiple of 80.

For a complete description of the control statements, see Control statements for the Multiple Resource Checker utility.

SYSPRINT DD
Optional. This data set is used when the utility accesses RECON data sets. If you specify the RECONxxn DD statements, specify this DD statement.

The record format is fixed block (FB). The logical record length is 133. Block size, if coded, must be a multiple of 133.

The following messages are written to this data set until the utility finds a valid combination of IMS versions in IMS DD and RECON DD statements.
DSP0024I  RECON(n) HEADER RECORD MISSING OR INVALID
DSP0245I  JOB TERMINATED DUE TO UNAVAILABLE RECON DATA SETS