Copying an IMS catalog that does not contain IMS-managed ACBs

You can create a copy of an IMS catalog and, optionally, copies of the ACB, DBD, and PSB library data sets that were used to populate the IMS catalog by using the IMS™ Catalog Copy utility (DFS3CCE0, DFS3CCI0).

When you copy an IMS catalog, you must ensure that the copy is consistent with the ACB, DBD, and PSB libraries of the destination environment. To ensure consistency, you can use the IMS Catalog Copy utility to copy the ACB, DBD, and PSB libraries in the same job step that it copies the IMS catalog.

The IMS Catalog Export utility copies all of the DBD and PSB records in an IMS catalog. However, if an ACB library is specified on the IMSACB DD statement in the export JCL, the IMS Catalog Export utility copies only the segments in a DBD or PSB record that have a timestamp that matches the timestamp of the corresponding member in the specified ACB library. If the IMSACB DD statement is omitted, the utility copies all timestamp versions of the segments in every DBD or PSB record in the IMS catalog.

If an ACB library is specified on the IMSACB DD statement, but the ACB member for a particular DBD or PSB record in the IMS catalog is not found, the utility issues a warning message and copies all timestamp versions of the segments in the record.

If you are introducing a copy of an IMS catalog in an environment where multiple IMS catalogs are managed by DBRC in the same RECON data set, each IMS catalog must be registered in the RECON data set by using a unique alias name. If you need to define a new alias name for the copy of the IMS catalog, additional steps are required.

Procedure

To copy an IMS catalog:

  1. Code the JCL statements of the DFS3CCE0 export program of the IMS Catalog Copy utility.
  2. Run the IMS Catalog Copy utility in the original environment to export the IMS catalog and any optional ACB library, DBD library, and PSB library to export data sets.
  3. Send the export data sets to the destination environment.
  4. If you are introducing a new IMS catalog in the destination environment, in the DFSDFxxx member of the IMS.PROCLIB data set, code an entry for the IMS catalog.
    If the destination environment includes multiple IMS catalogs that are managed by DBRC in a single RECON data set, specify a unique alias name on the ALIAS parameter in the DFSDFxxx entry.
  5. If you specified the ALIAS parameter in a new DFSDFxxx entry, run the IMS Catalog Alias Name utility (DFS3ALI0).
  6. If you are introducing a new IMS catalog in the destination environment, register the IMS catalog database and partitions in the RECON data set by using the DBRC commands INIT.DB and INIT.PART.
    If you defined an alias name for the IMS catalog, specify the alias name as the DBD name on the INIT commands.
  7. Code the JCL statements for the DFS3CCI0 import program of the IMS Catalog Copy utility.
  8. Run the IMS Catalog Copy utility to import the copy of the IMS catalog and any ACB library, DBD library, and PSB library into data sets in the destination environment.