Installing the IMS catalog DBDs and PSBs

Like other types of IMS databases, the structure of the IMS catalog is defined by database descriptions (DBDs), and access to the IMS catalog is defined by program specification blocks (PSBs).

The DBDs and PSBs for the IMS catalog are shipped as DBDGEN and PSBGEN output (load modules) that you must copy to your IMS.DBDLIB and IMS.PSBLIB data sets before you can use the IMS catalog. The load modules are included in the IMS.SDFSRESL data set. You do not need to use the DBD or PSB generation utilities before including the catalog resource modules in your ACB library.

After copying the DBDs and PSBs for the IMS catalog into your DBDLIB and PSBLIB, you must run the ACB Maintenance utility to generate the ACBs for the IMS catalog.

If you choose to define alias names for the IMS catalog, you must update the DBDLIB members using the IMS catalog alias names utility (DFS3ALI0) either during or at any time after installation.

You do not need to define the MODBLKS resources for the IMS catalog database or programs. IMS manages the catalog MODBLKS internally.

The DBDs for the IMS catalog include:
DFSCD000
Defines the IMS catalog database
Restriction: This DBD defines an IMS full-function database type (ACCESS=PHIDAM,OSAM) with OSAM utilizing Physical Sequential data sets or VSAM Linear Data Sets.
DFSCX000
Defines the IMS catalog secondary index

The PSBs for the IMS catalog are used by primarily by internal IMS processes.

IMS automatically increases the space allocated for the user PSB to attach the catalog PSBs. 96 bytes of additional space are allocated for each user PSB in the PSB CSA storage pool. The catalog PSB itself occupies 12kb in the DLIPSB pool and 500 bytes CSAPSB pool for each user PSB that uses the catalog PSBs. You might need to increase the size of your storage pools, up to the maximum size of the catalog PSB in each pool multiplied by the number of user PSBs that concurrently access the catalog.

The IMS catalog PSBs include:
DFSCPL00
For an initial load of the IMS catalog by either the IMS Catalog Populate utility (DFS3PU00) or the ACB Generation and Populate utility (DFS3UACB).
DFSCP000
Provides read access to the IMS catalog for the DFS3PU00 utility and other COBOL or high-level assembler programs.
DFSCP001
Provides update access to the IMS catalog for the DFS3PU00 utility and the DFS3UACB utility.
DFSCP002
Provides read access to the IMS catalog for PL/I programs.
DFSCP003
Provides read access to the IMS catalog for PASCAL programs.
DFSCP004
A place holder for future catalog enhancements. Will be displayed as NOTINIT during IMS control region initialization and if displayed by the /DIS STATUS PGM or QUERY PGM NAME(NAME*) SHOW(STATUS) commands.
DFSCP005
A place holder for future catalog enhancements. Will be displayed as NOTINIT during IMS control region initialization and if displayed by the /DIS STATUS PGM or QUERY PGM NAME(NAME*) SHOW(STATUS) commands.

Procedure

  1. To copy the DBD and PSB load modules from IMS.SDFSRESL to your DBDLIB and PSBLIB, use the following JCL job: 
      //COPYRES EXEC PGM=IEBCOPY                             
  //SYSPRINT DD  SYSOUT=*                                
  //SDFSRESL DD  DSN=IMS.SDFSRESL,DISP=SHR             
  //DBDLIB   DD  DSN=MYIMS.DBDLIB,DISP=OLD    
  //PSBLIB   DD  DSN=MYIMS.PSBLIB,DISP=OLD     
  //SYSIN    DD  *                                       
          COPYMOD   OUTDD=DBDLIB,INDD=((SDFSRESL,R)),LIST=YES       
          SELECT MEMBER=(DFSCD000,DFSCX000)
          COPYMOD   OUTDD=PSBLIB,INDD=((SDFSRESL,R)),LIST=YES       
          SELECT MEMBER=(DFSCPL00,DFSCP000,DFSCP001,DFSCP002,DFSCP003)
  /*

    COPYMOD rather than COPY is recommended if the DBDLIB or PSBLIB being copied to has a smaller block size than the .SDFSRESL data set.

  2. Run the ACBGEN process for the catalog DBD and PSB members.
    Use the following JCL job:
      //CATACB  EXEC PGM=DFSRRC00,PARM='UPB'
  //SYSPRINT DD  SYSOUT=*                             
  //STEPLIB  DD  DSN=IMS.SDFSRESL,DISP=SHR          
  //DFSRESLB DD  DSN=IMS.SDFSRESL,DISP=SHR          
  //IMS      DD  DSN=MYIMS.PSBLIB,DISP=SHR
  //         DD  DSN=MYIMS.DBDLIB,DISP=SHR
  //IMSACB   DD  DSN=IMS.ACBLIB,DISP=OLD  
  //SYSIN    DD  *                                    
           BUILD PSB=(DFSCPL00)                         
           BUILD PSB=(DFSCP000)                         
           BUILD PSB=(DFSCP001)                         
           BUILD PSB=(DFSCP002)                         
           BUILD PSB=(DFSCP003)                         
  /*
  3. Activate the new IMS catalog ACB members in your IMS system.
    Choose one of the following options:
    • Copy the new ACBLIB members to an inactive staging ACBLIB and then activate the staging ACBLIB to make the IMS catalog resources available for use.
    • Copy the new ACBLIB members directly to an active ACBLIB with Online Change or Member Online Change.