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.SCCVAUTH
//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 the example above. 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 and authorized program load module
library. All libraries in the STEPLIB concatenation must be APF-authorized.
- 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.