Adding records to the IMS catalog with the DFS3PU00 utility

You can add additional records to an existing IMS catalog from one or more ACB library data sets of IMS systems by using the IMS Catalog Populate utility (DFS3PU00).

Prerequisites:
  • Prior to running the DFS3PU00 utility to add records to an IMS catalog, the ACB members for any new or changed DBDs or PSBs must be generated by the ACB Maintenance utility.
  • To add metadata to the IMS catalog for GSAM databases, in addition to the ACB library, you must also provide both the DBD library and the PSB library that were used to generate the members in the ACB library.
  • To add metadata to the IMS catalog for logical databases, in addition to the ACB library, you must also provide the DBD library that was used to generate the members in the ACB library.

If the IMS catalog is shared among IMS systems, you can add records to the catalog using a DL/I batch job even when the catalog is authorized by an online IMS system. If the IMS catalog is not shared, you can add records to the catalog by running the DFS3PU00 utility as a batch message processing (BMP) job in the IMS system that the catalog supports.

If the IMS management of ACBs is enabled by ACBMGMT=CATALOG in the <CATALOG> section of the DFSDFxxx PROCLIB member, the DFS3PU00 utility also copies the input ACBs to either the catalog staging data set or the IMS directory data set, depending on the specification of the MANAGEDACBS= control statement. If MANAGEDACBS=UPDATE is specified, IMS must be shut down while the DFS3PU00 utility adds the ACBs to the IMS directory directly and the ACBs are activated when IMS restarts. If MANAGEDACBS=STAGE is specified, the DFS3PU00 utility adds the ACBs to the staging data set of the IMS directory. The ACBs in the staging data sets are not activated until the IMPORT DEFN SOURCE(CATALOG) is specified.

For backout and recovery purposes, IMS logs all changes to the catalog and, if the IMS catalog is registered with DBRC, records these logs in the RECON data set. Save the logs for recovery purposes.

When adding records to the IMS catalog, the JCL for the utility must specify the IMS-provided PSB DFSCP001, which includes a PCB defined with PROCOPT=A. For example:
  //UPDTCAT EXEC PGM=DFS3PU00,
  //             PARM=(DLI,DFS3PU00,DFSCP001,,,,,,,,,,,Y,N,,,,,,,,,,,,'DFSDF=001')

The N in the preceding example indicates that IRLM is not used and, therefore, data sharing is not enabled for the IMS catalog that is being updated. If IRLM is active for the IMS catalog that is being updated, you must change the N to a Y and add the IRLM ID in the following position.

For an example of the complete utility JCL, click the following link to the IMS Catalog Populate utility documentation.