A
file maintenance utility job step requires the following statements in the JCL:
- An EXEC statement for program CBKFMAIN (note the program name
must be CBKFMAIN).
- A DD statement for the CBKPARMS data set that contains:
- The control file table member, CBKCFTBL, that identifies the control
file data set name for each CICS® region
- The parameter member, CBKMAINT, that contains the file maintenance utility runtime
parameters
Alternatively, you can include the CBKCFTBL and CBKMAINT members
in a data set that is in the MVS™ logical
parmlib concatenation, in which case you do not need the CBKPARMS
DD statement. However, if you put the
CBKCFTBL member and the optional CBKMAINT parameter member in the MVS logical
parmlib concatenation, authorize the file maintenance utility to have READ access to
all the data sets in the MVS logical parmlib concatenation.
The file maintenance utility searches for CBKCFTBL and CBKMAINT in the logical parmlib
concatenation if either of these members is not found in the CBKPARMS
data set.
- A STEPLIB DD statement that references the SCBKLOAD
and the SDFHEXCI data set containing the load modules required by
the file maintenance utility if the data sets are not in the MVS linklist.
- A DD statement for the CBKIN data set, from which the CICS BAC file maintenance utility reads
the commands it is to execute.
- A DD statement for the CBKPRINT data set, to which the CICS BAC file maintenance utility writes
its output messages.
The JCL in Figure 1 shows a sample job to run the
file maintenance utility.
Figure 1. Sample
JCL to run the file maintenance utility//CBKFMU EXEC PGM=CBKFMAIN,PARM='APPLID(CICSPROD)'
//STEPLIB DD DISP=SHR,DSN=hlq.SCBKLOAD
// DD DISP=SHR,DSN=hlq.SDFHEXCI
//CBKPARMS DD DISP=SHR,DSN=hlq.CBKPARMS
//CBKPRINT DD SYSOUT=*
//SYSABEND DD SYSOUT=*
//*****************************************************************
//* Un-comment the following DD statement if you need to add a
//* SYSMDUMP DD statement. You might need to modify this statement
//* to meet your installation’s requirements.
//*****************************************************************
//*SYSMDUMP DD DISP=(,CATLG),DSN=hlq.sysmdump.dataset,
//* UNIT=SYSDA,SPACE=(CYL,(50,25)),
//* DCB=(DSORG=PS,RECFM=FBS,LRECL=4160,
//* BLKSIZE=24960 //CBKPRINT DD SYSOUT=*
//CBKIN DD *
ADD FILE(FILEA),RLSOPTIONS(TERMINATE),RLSRETCODE(12)
Note: - Change the characters hlq to the high-level
qualifiers for these data sets:
- SCBKLOAD is the name of the CICS BAC load library
- SDFHEXCI is the name of the CICS TS
EXCI load library
- CBKPARMS is the name of your CICS BAC parmlib.
- Also change hlq.sysmdump.dataset to the
name of your own dump data set.
- If you put the CBKCFTBL member and the optional CBKMAINT
parameter member in the MVS logical parmlib concatenation,
authorize the batch request utility to have READ access to all the
data sets in the MVS logical parmlib concatenation.
- See The CBKPARMS data set for information about defining the
CBKPARMS data set.
There is some sample JCL for a file maintenance utility job shown in member CBKFMJCL,
which you can find in the SCBKSAMP library. You can copy this and
modify it for your own use.