NEWNAME: Specifying a new data set name for the recovered data set

Explanation: NEWNAME(newdsname) is an optional parameter specifying a new, fully qualified data set name for the recovered backup version or dump copy. For newdsname, substitute a new, fully qualified data set name for the recovered data set.

If a cataloged data set exists with the same name as the new name you are specifying, you must specify the REPLACE parameter to replace the existing cataloged data set. If an uncataloged data set with the same name as the new name you are specifying exists on the volume, you must specify the REPLACE parameter to replace the existing uncataloged data set.

Defaults: None.

Note:
  1. The NEWNAME parameter applies only to data set recovery. If you specify NEWNAME when it does not apply, DFSMShsm ignores it.
  2. You must specify NEWNAME when a data set exists with the same data set name as the data set that you are recovering and you want to keep both versions of the data set.
  3. If a VSAM data set is being recovered and you specify NEWNAME, the new data set name can be cataloged in the same or different catalog as the original data set under the following restrictions:
    1. If the new data set will be cataloged in a different catalog than the original, only the base cluster will be recovered, even when there were alternate indexes at the time of backup. You may use the access method services (AMS) BLDINDEX facility to rebuild the alternate indexes (AIX).
    2. If the old data set does not exist, the new data set can be recovered provided the original data set's data and index components follow these standard naming conventions:
      • The old data component was the base cluster name followed by the .DATA qualifier.
      • The old index component was the base cluster name followed by the .INDEX qualifier.

    For VSAM data sets not cataloged in the Integrated Catalog Facility catalog, if you specify TOVOLUME with NEWNAME, the volume must be owned by the catalog where the data set being recovered will be cataloged.

  4. The following only applies if DFHSM 2.6.0 (or earlier release) was used to move the data during backup. When you specify NEWNAME for VSAM data sets, DFSMShsm will fail the recovery if the original data set exists and has two or more paths defined to the base cluster. In some cases the path defined to the base cluster will not be recovered; use the (AMS) DEFINE PATH command.

    Additionally, the data and index object names of the data set being recovered must be the same as the data and index object names that were exported. The object names of the data set being recovered will be passed to AMS IMPORT for renaming the NEWNAME data set. The access method services facility (AMS) then verifies that the data and index object names of the data set being recovered are the same as the ones that were exported.

  5. DFSMShsm does not handle partitioned data set members individually. If you specify a partitioned data set with a member name for either the data set name or the new data set name, DFSMShsm fails the command.
  6. You can recover a backup version of a migrated data set if you specify the NEWNAME parameter. For VSAM data sets, the following is required for recovery to a new name:
    • There is zero or one path defined to the base cluster, and
    • There is zero or one alternate index, and
    • There is zero or one path defined to the alternate index.
    The newname parameter cannot be the name of the migrated data set.
Parent topic: Optional parameters of the RECOVER command