Using the IMS catalog

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

Building indexes and ILDSs for 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 DBD library

If you disable the IMS management of ACBs, IMS Index Builder retrieves database information from DBD libraries.

When building IMS catalog indexes and ILDSs by using database information retrieved from DBD libraries, the following JCL and control statement requirements might apply depending on the usage scenario:

Place the IMS Catalog Definition exit routine (DFS3CDX0) in the STEPLIB DD concatenation in the following cases:

  • If the IMS catalog database partitions are defined by using the IMS Catalog Partition Definition Data Set utility (DFS3UCD0) instead of by using DBRC.
  • If an IMS catalog alias name other than ALIAS=DFSC is defined.

If the IMS Catalog Partition Definition Data Set utility (DFS3UCD0) is used, specify the statements as follows:

  • Specify DBRC=N on the INPUT control statement.
  • If the MDA member for the HALDB partition definition data set (DFSHDBSC) is used, specify the library on the STEPLIB DD statement, not on the IMSDALIB DD statement.

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.

Restriction for using IMS-managed ACBs

Start of changeIMS Index Builder does not support IMS-managed ACBs when it is requested to retrieve database information from an IMS catalog database that is not registered to the DBRC RECON data set.End of change