CATALOG or RECATALOG


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

For a logical restore operation, CATALOG instructs DFSMSdss to catalog data sets that it allocates. For a physical restore operation, CATALOG is used for non-VSAM single volume data sets; RECATALOG is ignored. DFSMSdss does not catalog VSAM data sets during physical restore. If the CATALOG keyword is specified, it is ignored when processing VSAM data sets. You must use IDCAMS DEFINE RECATALOG to catalog the data sets after the physical restore.

CATALOG: catalogs the target data set in a catalog as determined by the standard catalog search order. This is the default for VSAM data sets, multivolume data sets, and SMS-managed data sets (during logical data set restore). It is also the default for single-volume, non-VSAM, SMS-managed data sets (in physical data set restore).
RECATALOG(newcatname): catalogs the target data set in the newcatname catalog.
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.

Note:

CATALOG or RECATALOG fails if the target data set is already cataloged in the same catalog and RENAME is not specified.
CATALOG and RECATALOG are ignored when the target data set is preallocated.
RECATALOG is ignored for SMS-managed data sets.
Be careful when using RECATALOG(newcatname) because the target data set might already be cataloged outside of the standard order of search.
If RECATALOG is specified for a physical restore it is ignored. DFSMSdss does not attempt to catalog the data set. If the data set is already cataloged on another volume:
- The catalog entry is not updated, and
- The data set is restored, but it is not cataloged.
If CATALOG is specified for a physical restore of a single-volume non-VSAM data set, DFSMSdss attempts to catalog the data set. If the data set is already cataloged on another volume:
- Message ADR385E, reason code 08, is issued,
- The catalog entry will not be updated, and
- The data set will be restored, but it will not be cataloged.
DFSMSdss physical data set restore does not create catalog entries for VSAM, multivolume non-VSAM, or preallocated data sets. The user must create all catalog entries.
For multivolume non-VSAM data sets, use IDCAMS DEFINE NONVSAM.