CICS BAC batch request utility job step

About this task

A CICS BAC batch request utility job step requires the following statements in the JCL:
  • An EXEC statement for program CBKBMAIN (note the program name must be CBKBMAIN).
  • 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, CBKBATCH, that contains the batch request utility runtime parameters
    Alternatively, you can include the CBKCFTBL and CBKBATCH 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 CBKBATCH 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. The batch request utility searches for CBKCFTBL and CBKBATCH 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 batch request utility if the data sets are not in the MVS linklist.
  • A DD statement for the CBKIN data set, from which the CICS BAC batch request utility reads the commands it is to execute.
  • A DD statement for the CBKPRINT data set, to which the CICS BAC batch request utility writes its output messages.

The sample JCL in Figure 1 illustrates a CICS BAC batch request utility job step.

Figure 1. Sample JCL for a CICS BAC batch request utility job step
//CBKBTCH  EXEC PGM=CBKBMAIN
//STEPLIB  DD DISP=SHR,DSN=hlq.SCBKLOAD
//         DD DISP=SHR,DSN=hlq.SDFHEXCI
//CBKPARMS DD DISP=SHR,DSN=hlq.CBKPARMS
//CBKGROUP DD DISP=SHR,DSN=your.cicsgrps.dataset
//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 *
DEFAULT CICS(CICSHUR1),NOTACTIVE(TERMINATE)
SET FILE(FILEA),OPENSTATUS(CLOSED),ENABLESTATUS(DISABLE)
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 CBKBATCH 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.
  5. The CBKGROUP DD statement is optional. See CICS group and alias function for more information.

There is some sample JCL for a batch request utility job step shown in member CBKSAMP1, which you can find in the SCBKSAMP library. You can copy this and modify it for your own use.


Task Task

Feedback


Timestamp icon Last updated: Monday, 2 December 2013


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