JCL requirements for the MFS Reversal utility

When you code the JCL to run the MFS Reversal utility, include the EXEC statement and appropriate DD statements.

Subsections:

JCL example
EXEC statement
DD statements

JCL example

An example of the JCL that is required for MFS Reversal is shown in the following figure.

Figure 1. Example of MFS Reversal JCL (FABVRVRS JCL)

//stepname EXEC  PGM=FABVRVRS
//STEPLIB  DD    DSN=HPS.SHPSLMD0,DISP=SHR
//         DD    DSN=IMSVS.SDFSRESL,DISP=SHR
//SYSPRINT DD    SYSOUT=*,DCB=BLKSIZE=133
//SYSOUT   DD    SYSOUT=*,DCB=BLKSIZE=133
//FORMAT   DD    DSN=ims.format,DISP=SHR
//MFSSRCE  DD    DSN=user.mfs.source,DISP=SHR
//SYSIN    DD    *

Modify the fields shown in lower case to reflect your operating environment.

EXEC statement

This statement invokes the MFS Reversal utility, FABVRVRS. The statement must be in the format shown:

//stepname   EXEC    PGM=FABVRVRS

DD statements

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

STEPLIB DD: This library contains the FABVRVRS utility program in its executable form. Change the name HPS.SHPSLMD0 to reflect the name used at your site. Concatenate the IMS™ RESLIB as part of the STEPLIB. Change the name IMSVS.SDFSRESL to the name used at your site.
SYSPRINT DD: This sequential data set contains the cross-reference report from the FABVRVRS program. The data set can be the JES spool data set or a standard sequential data set.
SYSOUT DD: This is the sequential data set that contains activity logs and any errors encountered during the execution of FABVRVRS. The data set can be the JES spool data set or a standard sequential data set.
FORMAT DD: This library contains the IMS MFS formats for which the source is to be generated. Check the DISP= parameter if this library is also used in the IMS Online Control Region JCL.
If two or more data sets are concatenated to the FORMAT DD, MFS Reversal processes only the first data set.
MFSSRCE DD: This data set is a partitioned data set and contains the IMS MFS control block source statements generated by the utility. The LRECL of this data set must be 80. The block size can be any valid multiple of 80.
SYSIN DD: This is the control data set for this 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. SYSIN contains the control statements for the MFS Reversal utility.

Related reading: For the format of the control statements, see Control statements for the MFS Reversal utility.
COPYFMT DD: This DD statement is required when the copy function is used. This partitioned data set contains the MFS control blocks that are copied by the copy function. Attributes of the data set must be same as the MFS format library. For information about the MFS format library, see the IMS Installation.
COPYPRT DD: This optional DD statement is used when the copy function is used. This data set, if provided, contains the copy report that summarizes the results of the copy process. The record format is fixed-blocked, and the logical record length is 133. The block size, if coded, must be a multiple of 133.