Explanation: MIGRATEPREFIX(prefix) is
an optional parameter specifying the prefix (high-level qualifier)
of the data set name that DFSMShsm generates when it migrates the
data set. 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 migration copy name has the following format:
prefix.HMIG.Tssmmhh.user1.user2.Xyddd
If patch-enabled, the following dataset name will
be generated:
prefix.HMIG.Tcccchh.user1.user2.Xyddd
where:
- prefix is replaced with the prefix you
specify with this command.
- HMIG indicates that this is a migrated data set.
- Tssmmhh is the time when DFSMShsm migrated
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 migrated 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 Names of migrated 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 migrated
the data set. DFSMShsm replaces the X with a letter that represents
the decade. A–J have the following meaning:
A—1, B—2, C—3, D—4, E—5
F—6, G—7, H—8, I—9, J—0
For example, you specify MIGRATEPREFIX(HSMMIG). Your data set
name is TERRY.CLIST.TEXT. DFSMShsm migrates the data set on 15 July
1990 at 5:33 p.m. The migration copy name is:
HSMMIG.HMIG.T003317.TERRY.CLIST.I0198
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 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.Space management of SMS-managed storage explains
the UID and the DFSMShsm startup procedure.