JCL to invoke the batch command program
You can invoke the CICS® Configuration Manager batch programs from JCL as executable job step programs or you can invoke them as callable programs. The following example JCL uses the batch command program to migrate a change package, and then produce a detailed report of the changes to resource definitions caused by the migration.
The JCL to perform other tasks is similar, with some additional job steps or ddnames. For details, see JCL to define CICS configurations and JCL to unload or load journal records.
//CCVJOB JOB your job statement information
//STEP EXEC PGM=CCVBMAIN
//STEPLIB DD DISP=SHR,DSN=ccvhlq.SCCVAlang
// DD DISP=SHR,DSN=ccvhlq.
SCCVLINK
//CCVPRINT DD SYSOUT=*
//CCVREPRT DD SYSOUT=*
//CCVPARMS DD *
CONNECT IPADDRESS=ip_address,PORT=ip_port_number
* Migrate change package ID 555 using migration scheme TEST
MIGRATE PACKAGE=555,SCHEME=TEST
* Report changes to resource definitions by the migration
REPORT TYPE=JOURNAL,
VIEW=PACKAGE,
LEVEL=ATTRIBUTE
CRITERIASET COND=(CPID EQ 555),
COND=(SCHEME EQ TEST),
COND=(DATE EQ TODAY)
⋮
more batch commands
/*
The following ddnames apply to both CICS Configuration Manager batch programs:
- STEPLIB
- The batch programs are supplied in the program load module library SCCVLINK, and use messages
defined in the national language support load module library SCCVAlang,
where lang is ENU
(U.S. English) or JPN (Japanese).
If you connect to the CICS Configuration Manager server via an authenticated port,
you must also enable PassTicket processing
. For details, see Optional: Enable PassTicket processing.
- CCVREPRT
- This ddname is required only if you use the REPORT batch command;
it defines a sequential data set for the report output. This data
set must have the following DCB attributes:
- LRECL=133
- RECFM=FBA
This data set can be any one of the following types:
- Partitioned data set (PDS) member
- Sequential data set
- GDG data set
- SYSOUT=*
- DUMMY or NULLFILE
CCVREPRT is the default ddname for report output. To output a report to a different ddname, use the DDNAME parameter of the REPORT batch command. This is especially useful if you produce several reports in a single batch job, and you want to output the reports to separate ddnames.
- CCVPRINT
- Defines a sequential data set for message output. The data set
can be written to a system output device, a tape, or a DASD volume.
This data set has the following DCB attributes:
- LRECL at least 132 bytes
- RECFM=FBA
For details of the message output, see Batch output.
- CCVPARMS
- Defines a sequential data set containing the batch commands that you want to perform. The data
set may be defined as job control in-stream data (as shown in the previous example), a tape file, or
a DASD file. This data set has the following DCB attributes:
- LRECL=80
- RECFM=FB
An asterisk (*) in column 1 marks a comment line. Blank lines may appear anywhere within the input data stream and are ignored. Command keywords must appear in columns 1 - 72. For more details, see White space in batch commands.
The first batch command must be CONNECT, specifying the connection details of the CICS Configuration Manager server. CONNECT is relevant only to the batch interface: there is no equivalent API command. Follow CONNECT with one or more other batch commands, such as MIGRATE, depending on the batch program you are using.