Defining the local catalog
The local catalog is a VSAM key-sequenced data set (KSDS). The local catalog is not shared by any other CICS region.
Before you begin
Unlike the global catalog, which must be defined with enough space to cope with any increase in installed resource definitions, the size of the local catalog is relatively static. The following section describes the information held on the local catalog.
CICS® Transaction Server for z/OS® is divided into functional areas (or components) known as domains. These domains communicate through a central component, the CICS kernel, and their initialization and termination is controlled by the domain manager. All the domains require an individual domain parameter record, and these are stored in the local catalog. The CICS domains use the local catalog to save some of their information between CICS runs and to preserve this information across a cold start. For further guidance information about what is written to the local catalog, and about how CICS uses the local catalog for startup and restart, see Controlling start and restart.
About this task
You can define and initialize the CICS local catalog in two ways. You can use the sample job as described below or you can use the CICS-supplied job, DFHDEFDS, to create a local catalog for an active CICS region.
Edit the sample job as follows:
Procedure
Example
//LOCAT JOB accounting info,,CLASS=A
//DEFLCD EXEC PGM=IDCAMS
//SYSPRINT DD SYSOUT=*
//SYSIN DD *
DEFINE CLUSTER -
(NAME( CICSTS54.CICS.applid.DFHLCD) - 1
INDEXED -
RECORDS( 200 10 ) - 2
FREESPACE(10 10) -
SHAREOPTIONS( 2 ) -
REUSE -
VOLUMES( volid )) -
DATA -
(NAME( CICSTS54.CICS.applid.DFHLCD.DATA ) -
KEYS( 52 0 ) -
RECORDSIZE( 70 2041 ) - 3
CONTROLINTERVALSIZE( 2048 )) -
INDEX (NAME( CICSTS54.CICS.applid.DFHLCD.INDEX ) )
/*
//*****************************************************************
//INITLCD EXEC PGM=DFHCCUTL
//*
//* INITIALIZE THE CICS LOCAL CATALOG
//*
//STEPLIB DD DSN=CICSTS54.CICS.SDFHLOAD,DISP=SHR
//SYSPRINT DD SYSOUT=*
//SYSUDUMP DD SYSOUT=*
//DFHLCD DD DSN=CICSTS54.CICS.applid.DFHLCD,DISP=SHR
//*
//