Adding records to the IMS catalog with the DFS3UACB utility

If you are adding new or changed ACB members to an ACB library, you can add the corresponding new or changed IMS catalog records to an existing IMS catalog in the same job step by using the ACB Generation and Catalog Populate utility (DFS3UACB).

This task applies only for IMS systems that use an ACB library.

The DFS3UACB utility calls the ACB Maintenance utility to generate the ACB members. After generating the ACB members and loading them into the IMS.ACBLIB data set, the DFS3UACB utility calls the IMS Catalog Populate utility (DFS3PU00).

Recommendation: To improve the performance of the population of the IMS catalog, specify a work data set for the DFS3UACB utility with the ACBCATWK DD statement. During the ACB generation phase, the ACB members that are generated are listed in the work data set. During the populate phase, the work data set is read as input, which significantly reduces the time required to update the IMS catalog.

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 that is defined with PROCOPT=A.

DLI,DFS3PU00,DFSCP001,,,,,,,,,,,Y,N,,,,,,,,,,,,DFSDF=CAT

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.