Initializing the CSD

The INITIALIZE command initializes your CSD with definitions of the resources that are supplied by CICS. After initialization, you can migrate resource definitions from your CICS control tables and begin defining your resources. You use the INITIALIZE command only once in the lifetime of the CSD.

About this task

Before you can use the CSD, you must define it as a VSAM KSDS data set, and initialize it using the DFHCSDUP utility program. Use the sample job to define and initialize the CSD.

Procedure

  1. Code the KEYS parameter as shown in the sample job.
    The key length is 22 bytes.
  2. Calculate the CSD disk space that is required.
    The average record size is 200 bytes for a CSD that contains only the supplied resource definitions (generated by the INITIALIZE and UPGRADE commands). If you create a larger proportion of terminal resource definition entries than are defined in the initial CSD, the average record size is higher because of the larger size of the terminal-type entries. The TERMINAL and TYPETERM definition record sizes are listed under Calculating CSD disk space. The maximum record size is 2000, as shown in the sample job.
  3. Code the SHAREOPTIONS parameter as shown in the sample job.
  4. Optional: You can specify the recovery attributes for the CSD in the ICF catalog instead of using the CSD system initialization parameters.
    If you decide to use the CSD in RLS mode, you must define the recovery attributes in the ICF catalog:
    • LOG(NONE) (Nonrecoverable data set)
    • LOG(UNDO) (For backout only)
    • LOG(ALL) (For both backout and forward recovery)

    If you specify LOG(ALL), you must also specify LOGSTREAMID to define the 26-character name of the MVS™ log stream to be used as the forward recovery log. If you specify recovery attributes in the ICF catalog, and also want to use BWO, specify LOG(ALL) and BWO(TYPECICS).

  5. You must specify the DDNAME for the CSD as DFHCSD.

Example

Figure 1. Sample job to define and initialize the CSD
//DEFINIT  JOB  accounting information
//DEFCSD   EXEC PGM=IDCAMS
//SYSPRINT DD   SYSOUT=A
//AMSDUMP  DD   SYSOUT=A
//SYSIN    DD   *
   DEFINE CLUSTER -
            (NAME(CICSTS53.CICS.applid.DFHCSD) -
            VOLUMES(volid)               -
            KEYS(22 0)                   -                        1
            INDEXED                      -
            RECORDS(n1 n2)               -
            RECORDSIZE(200 2000)         -                        2
            FREESPACE(10 10)             -
            SHAREOPTIONS(2)              -                        3
            LOG(ALL)                     -                        4
            LOGSTREAMID(CICSTS53.CICS.CSD.FWDRECOV)   -           4
            BWO(NO)                                               4
 
          DATA                           -
            (NAME(CICSTS53.CICS.applid.DFHCSD.DATA)   -
            CONTROLINTERVALSIZE(8192))          -
          INDEX                                 -
            (NAME(CICSTS53.CICS.applid.DFHCSD.INDEX))
/*
//INIT     EXEC PGM=DFHCSDUP,REGION=300K
//STEPLIB  DD DSN=CICSTS53.CICS.SDFHLOAD,DISP=SHR
//DFHCSD   DD DSN=CICSTS53.CICS.applid.DFHCSD,DISP=SHR            5
//SYSPRINT DD SYSOUT=A
//SYSUDUMP DD SYSOUT=A
//SYSIN    DD *
           INITIALIZE
           LIST ALL OBJECTS
/*
//

What to do next

The command LIST ALL OBJECTS lists the CICS-supplied resources that are now in the CSD.