File maintenance utility JCL

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:
  1. 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.
  2. Also change hlq.sysmdump.dataset to the name of your own dump data set.
  3. 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.
  4. 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.


Reference Reference

Feedback


Timestamp icon Last updated: Monday, 2 December 2013


http://pic.dhe.ibm.com/infocenter/cicsts/v5r1/topic/com.ibm.cics.bac.doc/cbka1/cbka1h0015.html