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.SCCVAUTH
//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:
If you connect to the CICS Configuration Manager server via an authenticated port, then both of these libraries must be APF-authorized. For details, see Optional: Enable PassTicket processing.
This data set can be any one of the following types:
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.
For details of the message output, see Batch output.
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.