CATALOG


>>-+-----------------------+-----------------------------------><
   +-CATalog---------------+   
   +-RECATalog(newcatname)-+   
   '-RECATalog(*)----------'

CATALOG specifies that on a data set copy operation, DFSMSdss is to catalog data sets that it allocates. For a logical copy operation, CATALOG instructs DFSMSdss to catalog data sets that it allocates. For a physical copy operation, CATALOG instructs DFSMSdss to catalog the non-VSAM single volume data sets that it allocates. An IDCAMS DEFINE RECATALOG must be used to catalog the VSAM data sets after the physical copy. If the CATALOG keyword is not specified, single volume non-VSAM target data sets will be uncataloged as well.

CATALOG: catalogs the target data set as determined by the standard catalog search order. This is the default for VSAM, multivolume data sets, and SMS-managed data sets.

Note:

If the CATALOG keyword was specified, but the RENAMEUNCONDITIONAL or UNCATALOG keywords were not specified, an ADR385E message will be issued because two data sets with the same name cannot be cataloged in the standard order of search at the same time.
The CATALOG keyword is ignored for preallocated target data sets.

RECATALOG(newcatname): catalogs the target data set in the newcatname catalog. If you do not specify the RECATALOG(newcatname) keyword, single volume non-VSAM target data sets remain uncataloged as well.
RECATALOG(*): catalogs the target data set in the same catalog that points to the source data set. If the source data set was not cataloged, the new data set is not cataloged either. After DFSMSdss determines the catalog status of the data set and is changed by other means outside of DFSMSdss, the original catalog status is used. If you do not specify the RECATALOG(*) keyword, single volume non-VSAM target data sets remain uncataloged as well.

Note:

Be careful when using the RECATALOG(newcatname) keyword because the target data set may be cataloged outside of the standard order of search.
The CATALOG or RECATALOG operation fails if the target data set is already cataloged in the same catalog and DELETE, RENAMEU, or UNCATALOG is not specified. The RECATALOG keyword is ignored for SMS-managed targets.
An alternate index (AIX®) is always cataloged in the same catalog as its associated base cluster. If the base cluster is recataloged, the AIX is recataloged.
If you omit the CATALOG or RECATALOG keyword for a single volume, non-VSAM, non-SMS-managed data set, the target data set is uncataloged.
The CATALOG and RECATALOG keywords are ignored for preallocated data sets.
If the RECATALOG(newcatname) or RECATALOG(*) keyword is specified, but RENAMEUNCONDITIONAL or UNCATALOG is not specified, message ADR385E will be issued if the newcatname catalog is in the standard order of search since two data sets with the same name cannot be cataloged in the standard order of search.