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 RECORDS parameter defines how many records will be allocated to the CSD. The parameter takes two values: n1 is the primary extent, and n2 is the secondary extent, which will only be used if the allocated number of records defined by n1 is exceeded. For guidance on setting this parameter, see Calculating CSD disk space.
    • The RECORDSIZE parameter defines the average record size, in bytes, as well as the maximum record size. 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, then the average record size will be higher. 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(CICSTS55.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(CICSTS55.CICS.CSD.FWDRECOV)   -           4
            BWO(NO))                     -                        4
 
          DATA                           -
            (NAME(CICSTS55.CICS.applid.DFHCSD.DATA)   -
            CONTROLINTERVALSIZE(8192))          -
          INDEX                                 -
            (NAME(CICSTS55.CICS.applid.DFHCSD.INDEX))
/*
//INIT     EXEC PGM=DFHCSDUP,REGION=300K
//STEPLIB  DD DSN=CICSTS55.CICS.SDFHLOAD,DISP=SHR
//DFHCSD   DD DSN=CICSTS55.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.