Defining and initializing a CICS BAC control file

Each CICS® region that uses CICS BAC support requires its own unique CICS BAC control file. You define this as a VSAM key-sequenced data set (KSDS) and initialize it using the sample JCL shown in Figure 2. This sample job is also supplied as member CBKDIFIL in the SCBKSAMP data set.

Figure 2. Sample JCL to define and initialize a CICS BAC control file
//CBKDIFIL JOB (accounting informaton)
//* Define a control file as a VSAM KSDS
//*
//DEFINE    EXEC PGM=IDCAMS,REGION=1M 
/* 
//SYSPRINT DD SYSOUT=*
//SYSIN    DD * 
 DEFINE CLUSTER (NAME(hlq.control.file) -
         UNIQUE                 -
         INDEXED                -
         CYL(3 1)               -
         SHR(1)                 -
         RECORDSIZE(2048 32760) -
         KEYS(96 0)             -
         FREESPACE(20 20)       -
         VOLUMES(volume) )      -
        DATA                    -
         (NAME(hlq.control.file.data)  -
         CISZ(32768) )          -
        INDEX                   -
         (NAME(hlq.control.file.index) -
          NOIMBED               -
          NOREPLICATE)
//*
//*  Initialize the newly created data set
//*                                               
//INITFILE EXEC PGM=CBKIFILE,PARM='applid'
//STEPLIB  DD  DISP=SHR,DSN=hlq.SCBKLOAD
//CBKCNTL  DD  DISP=SHR,DSN=hlq.control.file
//SYSPRINT DD  SYSOUT=*
//SYSABEND DD  SYSOUT=*
Note:
Edit the sample CBKDIFIL job shown in Figure 2 by substituting your own values for the names shown in bold italic characters. Specify your own names for:

When a CICS region KSDS has been defined by IDCAMS in the first job step shown in Figure 2, the CICS BAC control file initialization program, CBKIFILE, then initializes the data set in job step 2. This program creates one default CICS region properties object record and one default object record for each of the resource types:

All these default records have the same identifier, namely $DEFAULT, and they provide default values when object records are being created in the following circumstances:

For information about undefined object processing, see the description of the CREATERECORD parameter on the UPDATE REGION command.

You can update these default object records to set your own default values, using either the file maintenance utility UPDATE commands, or the workstation administration client. To see what parameter values are set in these $DEFAULT records, you can use the file maintenance utility LIST command to get a listing of each record or view the records using the workstation administration client. For information about using the file maintenance utility to maintain a CICS region control file after you have defined and initialized it, see CICS BAC file maintenance utility.