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,
specify a new, fully-qualified data set name for the recovered data
set. The originally-named data set will be preserved for analysis
or other purposes.
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.
Note: - The NEWNAME parameter applies only to data set recovery. If you
specify NEWNAME when it does not apply, DFSMShsm ignores it.
- 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.
- A GDG base cannot be recovered using fast replication data set
recovery. If you specify the NEWNAME keyword when you recover a generation
data set (GDS) to a new name, the new GDG base name must have already
been defined.
Defaults: None.