Using the IMS catalog

IMS Index Builder can build IMS catalog databases. It can also retrieve database information from IMS catalog instead of DBD libraries.

Building IMS catalog databases

IMS Index Builder can build primary indexes and ILDSs of catalog PHIDAM databases and partitions of catalog PSINDEX databases. Information of the IMS catalog databases can be retrieved from either the DBD library or the IMS catalog itself.

Retrieving database information from the IMS catalog

If you enable the IMS management of ACBs, IMS Index Builder can retrieve database information from the IMS catalog. When IMS Index Builder retrieves database information from the IMS catalog, IMS Index Builder does not refer to DBD libraries.

To run IMS Index Builder in an IMS managed ACBs environment, complete the following steps:
  1. Register all databases that will be processed by IMS Index Builder to the IMS catalog.
  2. Enable the IMS management of ACBs by completing one of the following steps:
    • Create an IMS Catalog Definition exit routine (DFS3CDX0) which enables IMS management of ACBs.
    • Create a DFSDFxxx member in IMS.PROCLIB. This member must contain the ACBMGMT=CATALOG parameter in the <CATALOG> section.
  3. Concatenate the following program libraries to the STEPLIB DD statement of IMS Index Builder JCL:
    • IMS Tools Catalog Interface of IMS Tools Base for z/OS®
    • IMS Catalog Definition exit routine, if the exit is used to enable IMS managed ACBs
  4. If the DFSDFxxx member is used to enable IMS managed ACBs, complete the following steps:
    1. Specify the PROCLIB DD statement, which contains the IMS.PROCLIB data set with the DFSDFxxx member, in the IMS Index Builder JCL.
    2. Specify the DFSDF control statement in the IIUIN data set to identify the DFSDFxxx member that IMS Index Builder uses.
  5. If you want to retrieve database information from the IMS catalog staging data set, specify the DFSACBPD DD statement with the STAGING keyword.

Restrictions for using IMS managed ACBs

IMS Index Builder does not support IMS managed ACBs if either of the following conditions is met. Use the DBD library to retrieve database information in these cases:
  • Retrieving database information from an IMS catalog database that is not registered to the DBRC RECON data set.
  • Building an IMS catalog database with a DBD name other than the standard names (DFSCD000 and DFSCX000).