JCL requirements for the DBD/PSB/ACB Reversal utility

When you code the JCL to run the DBD/PSB/ACB Reversal utility, include the EXEC statement and appropriate DD statements.

Subsections:

JCL example

An example of the JCL that is required for DBD/PSB/ACB Reversal is shown in the following figure.

Figure 1. Example of DBD/PSB/ACB Reversal JCL (FABNRVRS JCL)
//stepname EXEC PGM=FABNRVRS
//STEPLIB    DD DSN=HPS.SHPSLMD0,DISP=SHR
//DBDLIB     DD DSN=IMSVS.DBDLIB,DISP=SHR
//PSBLIB     DD DSN=IMSVS.PSBLIB,DISP=SHR
//ACBLIB     DD DSN=IMSVS.ACBLIB,DISP=SHR
//SYSOUT     DD SYSOUT=A
//SYSPRINT   DD SYSOUT=A
//SYSPUNCH   DD SYSOUT=B,FREE=CLOSE
//DBDSRC     DD DSN=PDS.DBDSRC,DISP=SHR
//PSBSRC     DD DSN=PDS.PSBSRC,DISP=SHR
//MAPOUT     DD SYSOUT=B,FREE=CLOSE
//SYSIN      DD *
    (control statements)
/*

EXEC statement

This statement must be in the following format: 
//stepname EXEC PGM=FABNRVRS

DD statements

Code the following DD statements to identify the source of input and the placement of output information:
STEPLIB DD or JOBLIB DD
This DD statement is required. This input DD statement defines the IMS™ Library Integrity Utilities load module library.
DBDLIB DD
This statement is required when you process DBDs. This statement is also required when you specify the OPTION ACB_GSAM=YES option to process ACBs that have GSAM information.

The DBDLIB DD input data set is the load library that contains the DBDs for which reports and control statements are created.

PSBLIB DD
This statement is required when you process PSBs. This statement is also required when you specify the OPTION ACB_GSAM=YES option to process ACBs that have GSAM information.

The PSBLIB DD input data set is the load library that contains the PSBs for which reports and control statements are created.

ACBLIB DD
This statement is required when ACB operations are to be performed.

The ACBLIB DD input data set is the load library that contains the PSB-type ACBs and the DBD-type ACBs for which reports and control statements are created.

SYSOUT DD
This DD statement is required. The SYSOUT DD data set contains all activity messages and error messages.

The record format is fixed-blocked, and the logical record length is 133. The block size, if coded, must be a multiple of 133.

SYSPRINT DD
This DD statement is not required if only the DECODE keyword is specified in the SYSIN data set; otherwise it is required.

The SYSPRINT DD data set contains various reports that correspond to the SYSIN control statements. The record format is fixed-blocked, and the logical record length is 133. The block size, if coded, must be a multiple of 133.

SYSPUNCH DD
This optional data set contains the IMS DBDGEN/PSBGEN utility control statements re-created by DBD/PSB/ACB Reversal function.

The record format is fixed-blocked, and the logical record length is 80. The block size, if coded, must be a multiple of 80.

DBDSRC DD
This optional PDS or PDSE contains the IMS DBDGEN utility control statements re-created by DBD or ACB reversal function.

The record format is fixed-blocked, and the logical record length is 80. The block size, if coded, must be a multiple of 80.

PSBSRC DD
This optional PDS or PDSE contains the IMS PSBGEN utility control statements re-created by the PSB or ACB Reversal function.
The record format is fixed-blocked, and the logical record length is 80. The block size, if coded, must be a multiple of 80.
Note: If the keyword DECODE is specified, you must specify either of the following data sets as the output data set:
  • SYSPUNCH DD
  • DBDSRC DD, PSBSRC DD, or both
Related reading: For more information about the relation of DD statements and control statements, see Table 1.
MAPOUT DD
This data set contains input to the DBD/PSB/ACB Mapper program. It is an optional output data set for the DBD/PSB/ACB Reversal function. If it is specified, the input to the DBD/PSB/ACB Mapper is generated.

The record format is fixed-blocked and the logical record length is 80. The block size, if coded, must be a multiple of 80.

SYSIN DD
This DD statement is required. The input data set, SYSIN DD, contains the control statements for DBD/PSB/ACB Reversal program.

The record format is fixed-blocked, and the logical record length is 80. The block size, if coded, must be a multiple of 80.

Related reading: For the format of the control statements, see Control statements for the DBD/PSB/ACB Reversal utility.
OPTPRT DD
This DD statement is optional. The OPTPRT DD data set contains the Run-time Option report. The record format is fixed-blocked, and the logical record length is 133. The block size, if coded, must be a multiple of 133.
Parent topic: DBD/PSB/ACB Reversal utility