Populating the IMS catalog using the ACB Generation and Catalog Populate utility (DFS3UACB)

You can generate ACB members and populate the IMS catalog in a single step by using the ACB Generation and Catalog Populate utility (DFS3UACB).

To support the IMS management of ACBs function, the DFS3UACB utility can also be used to set up the IMS catalog to manage ACBs and to load the ACBs into system data sets for activation in the IMS system. Whether the utility sets up or loads IMS-managed ACBs into the IMS system is controlled by the MANAGEDACBS= statement in the utility SYSINP DD statement.

The DFS3UACB utility can be used to generate an entire ACB library and perform an initial load of an IMS catalog or to generate specific ACB members and add the corresponding records to an existing IMS catalog.

To generate the ACB members, the DFS3UACB makes an internal call to the ACB Maintenance utility. The DFS3UACB utility accepts all of the same control statements as the ACB Maintenance utility. Error messages issued during the ACB generation phase can come from either the DFS3UACB utility or the ACB Maintenance utility. For the ACB generation phase of the utility execution, the operation requirements are the same as those of the ACB Maintenance utility.

Similarly, to load or update the IMS catalog, the DFS3UACB utility makes an internal call to the IMS Catalog Populate utility (DFS3PU00). Consequently, any error messages that are issued during the population phase can come from either the DFS3UACB utility or the DFS3PU00 utility.

The DFS3UACB utility requires access to the DFSDFxxx member of the IMS.PROCLIB data set. Specify the DFSDFxxx member in the utility JCL.

Requirement: The catalog parameters in the DFSDFxxx member are specified in a catalog section. For the purpose of populating the IMS catalog, you must identify the start of the catalog section in a DFSDFxxx member by using the heading <CATALOG>. The IMS Catalog Populate utility (DFS3PU00) and the ACB Generation and Catalog Populate utility (DFS3UACB) do not support the <CATALOGxxxx> heading. The <CATALOGxxxx> heading is used when multiple IMS systems share a DFSDFxxx member, but do not share IMS catalogs.

An optional ACBCATWK data set can be used to greatly improve the performance of the population phase of the DFS3UACB utility. The DFS3UACB utility records the ACB members generated in the ACBCATWK data set, which eliminates the need to read the ACB library during the population phase to determine which IMS catalog records need to be created or updated.

When the DFS3UACB utility populates the IMS catalog, the utility stores the ACB members in the IMS.ACBLIB data set and internally calls the IMS Catalog Populate utility (DFS3PU00) to load or update the records in the IMS catalog in the same unit of work (UOW).