Explanation: NEWNAME is an optional parameter. dsname is
the name of the data set to back up, and newdsname is
the data set name to assign to the new backup version that is created
by specifying BACKDS. Both dsname and newdsname must
be fully-qualified and in the standard data set name format. DATE,
TIME, SPHERE, and GENVSAMCOMPNAMES are optional parameters that are
only valid with the NEWNAME parameter.
The parameters of the NEWNAME parameter are explained:
- DATE
- specifies the date to assign to the backup version. If DATE is
specified without the NEWNAME parameter, the BACKDS command will fail.
If DATE is specified without TIME, the current time will be assigned
to the backup version. The date format is: yyyy/mm/dd;
where yyyy is the 4-digit year, mm is
the 2-digit month, and dd is the 2-digit
day.
- TIME
- specifies the time to assign to the new backup version. If TIME
is specified without DATE, the BACKDS command will fail. If DATE
is specified without TIME, the current time will be assigned to the
backup version. If TIME is not specified, and a backup copy with the
date specified on the command and the current time already exists,
the command will fail. The time format is: hhmmss;
where hh is 2-digit hour, mm is
the 2-digit minute, and ss is the 2-digit
second.
- SPHERE
- specifies whether AIX and
PATH components of a VSAM data set will be backed up with the base
cluster. SPHERE(YES) indicates that a backup of the entire VSAM sphere
will be performed. SPHERE(NO) indicates that a backup of the base
cluster will be performed, and any associated AIXs and/or PATHs will
not be backed up. SPHERE(YES) is the default. If SPHERE is specified
without NEWNAME, the BACKDS command will fail.
- GENVSAMCOMPNAMES
- GVCN
- specifies whether to override the SETSYS DSBACKUP(GENVSAMCOMPNAMES)
value. If GENVSAMCOMPNAMES(YES) is specified and dsname is
a VSAM data set and newdsname is a migrated
or uncataloged data set, the command is processed, and default names
will be assigned to the data and index components. If GENVSAMCOMPNAMES(NO)
is specified, and dsname is a VSAM data
set and newdsname is a migrated or uncataloged
data set, the command will fail. If newdsname is
a cataloged data set and is not migrated, or if dsname is
a non-VSAM data set, the GENVSAMCOMPNAMES parameter is ignored.
Defaults: If date and time are not specified, the current
date and time are assigned to the backup version.
Note: The following restrictions apply when using the BACKDS NEWNAME
command to back up a VSAM data set:
- No more than one PATH can be defined for the data set to be backed
up, and no more than one PATH can be defined for the new name data
set.
- No more than one AIX can
exist for the data set to be backed up, and no more than one AIX can exist for
the new name data set.
- The NEWNAME keyword cannot be specified with the UNIT and VOLUME
keywords.
- A backup version created with the (H)BACKDS NEWNAME will always
have a VERSION NUMBER = 000.