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.

Figure 1. Example JCL: approving a change package
//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:

STEPLIB
The batch programs are supplied in the authorized program load module library SCCVAUTH, 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, then both of these libraries must be APF-authorized. 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 example above), 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 172. 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.