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: - 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 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.
- See The CBKPARMS data set for information about defining the
CBKPARMS data set.
- 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.