BACKUPPREFIX: Specifying the prefix for the backup version name or the dump copy data set name

Explanation: BACKUPPREFIX(prefix) is an optional parameter specifying the prefix (high-level qualifier) of the data set name DFSMShsm generates when it backs up a data set or dumps a volume. prefix must be defined as 1 to 7 alphanumeric characters; the first character must be alphabetic only.

Attention

Changing this parameter after the DFSMShsm environment is set could result in failures during the recall and recovery of data sets from tape and SDSPs.

The backup version name has the following format:

prefix.BACK.Tssmmhh.user1.user2.Xyddd

If patch-enabled, the following dataset name will be generated:

prefix.BACK.Tcccchh.user1.user2.Xyddd

where:

prefix is replaced with the prefix you specify with this command.
BACK indicates that this is a backup version.
Tssmmhh is the time when DFSMShsm backed up the data set; ss is the second, mm is the minute, and hh is the hour. If a duplicate exists after this name is generated, DFSMShsm changes the first character of the time stamp.
Tcccchh is the time when DFSMShsm backed up the data set; cccc is the time in hundredths of seconds from the beginning of the hour converted to four alphabetic characters and hh is hours. For more information, see Generating names of backup versions of data sets.
user1 and user2 are replaced with the first two qualifiers of the data set name. The data set name can be 44 characters long.
Xyddd is the date when DFSMShsm backed up the data set. DFSMShsm replaces the X with a letter that represents the decade. A–J have the following numeric values:
```
    A—1,  B—2,  C—3,  D—4,  E—5
    F—6,  G—7,  H—8,  I—9,  J—0
```

For example, you specify BACKUPPREFIX(HSMBAK). Your data set name is TERRY.CLIST.TEXT. DFSMShsm backs up the data set on 30 December 1991 at 9:15 a.m. The backup version name is:

   HSMBAK.BACK.T001509.TERRY.CLIST.I0364

The dump copy data set name has the following format:

prefix.DMP.dclass.Vvolser.Dyyddd.Tssmmhh

where:

prefix is replaced with the prefix you specify with this command
DMP indicates that this is a dump version
dclass is the dump class name
Vvolser is the source volume serial number
Dyyddd is the date when DFSMShsm dumped the data set. yy is the last two digits of the year of the dump date stamp. ddd is the Julian day of the dump date stamp.
Tssmmhh is the time when DFSMShsm dumped the data set; ss is the second, mm is the minute, and hh is the hour.

If you request it, DFSMShsm makes a dump VTOC copy data set for each dump generation that is made for a volume.

The dump VTOC copy data set name has the following format:

prefix.DUMPVTOC.Tssmmhh.Vvolser.Dyyddd

where:

prefix is replaced with the prefix you specify with this command
DUMPVTOC indicates that this is a dump VTOC version
Tssmmhh is the time when DFSMShsm dumped the data set; ss is the second, mm is the minute, and hh is the hour.
Vvolser is the source volume serial number
Dyyddd is the date when DFSMShsm dumped the data set. yy is the last two digits of the year of the dump date stamp. ddd is the Julian day of the dump date stamp.

SMS relationship: Parameter has the same meaning when applied to SMS-managed or non-SMS-managed DASD volumes or data sets.

SETSYS default: None.

DFSMShsm default: If you do not specify this parameter on any SETSYS command, the DFSMShsm default is the UID parameter you specified in the DFSMShsm startup procedure. This UID is used as the first qualifier for data set names generated by DFSMShsm during the BACKUP or MIGRATION functions. Changing this UID after the DFSMShsm environment is set could result in failures during the recall and recovery of data sets from tape and SDSPs. z/OS DFSMShsm Implementation and Customization Guide explains the UID and the DFSMShsm startup procedure.