JCL to define CICS configurations
Here is example JCL for defining or updating CICS® configurations. A version of this JCL is supplied in the member CCVX0002 of the sample library SCCVSAMP:
Figure 1. Example
JCL: using the DATATAKEUP batch command to define CICS configurations
//SORT EXEC PGM=SORT
//SYSOUT DD SYSOUT=*
//SORTIN DD DISP=SHR,DSN=input_dsn 1
//SORTOUT DD DSN=&&SORTOUT,
// DISP=(MOD,PASS),
// UNIT=SYSDA,
// SPACE=(CYL,(1,1)),
// DCB=(LRECL=255,BLKSIZE=2550)
//SORTWK01 DD UNIT=SYSDA,SPACE=(CYL,(10,10))
//SYSIN DD *
SORT FIELDS=(1,1,CH,A,5,8,CH,A,3,1,CH,A) 2
/*
// EXEC PGM=CCVBMAIN
//STEPLIB DD DISP=SHR,DSN=ccvhlq.SCCVAENU 3
// DD DISP=SHR,DSN=ccvhlq.
SCCVLINK
//CCVPRINT DD SYSOUT=*
//CCONFIG1 DD DISP=SHR,DSN=&&SORTOUT 4
//CCVPARMS DD *
CONNECT IPADDRESS=ip_address,PORT=ip_port_number,SSL=YES,KEYRING=keyring
DATATAKEUP TYPE=CCONFIG,DDNAME=CCONFIG1,REPLACE=YES
/*
- 1
- This input_dsn refers to an unsorted
input data set for the DATATAKEUP command.
The following members of the sample library SCCVSAM2 are example input data sets with detailed comments and instructions. Use one of these as a starting point for creating your own input data set:
- CCVX0020
- Use this to define or update CICS configurations for either CSD files or CICSPlex® SM contexts, with or without transformation variables and remote system connections.
- CCVX0019
- An abridged, simplified copy of CCVX0020. Use this to define or update CICS configurations for CSD files without transformation variables or remote system connections.
- 2
- This sort step ensures that the records are in the order required
by the DATATAKEUP batch command:
- Comments (records with an asterisk in the first column)
- CICS configuration name (columns 5 to 8)
- Input record type (column 3):
- C
- Defines a CICS configuration
- L
- Defines a remote system connection for a CSD-based CICS configuration
- R
- Defines the record-level sharing (RLS) access option for a CSD-based CICS configuration
- V
- Defines a transformation variable (only relevant if you use migration schemes with transformation rules to migrate change packages)
- 3
- The STEPLIB concatenation must contain the CICS Configuration
Manager
national language support (NLS) load module library
SCCVAlang and the program load module library. 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.
- 4
- This ddname identifies the correctly sorted input data set for the DATATAKEUP command. This ddname must match the DDNAME parameter of the DATATAKEUP command. In this example, the ddname CCONFIG1 refers to &&SORTOUT, which is the sorted version of the input data set originally specified by the ddname SORTIN.