Explanation: MIGRATIONLEVEL2 is an optional parameter specifying the division of key ranges for DASD migration level 2 volumes. When you specify MIGRATIONLEVEL2, you can also specify KEYS to indicate how data sets are assigned to the available DASD migration level 2 volumes.
Subparameter | Explanation |
---|---|
KEYS | MIGRATIONLEVEL2(KEYS(key ...)) specifies an ascending alphanumeric sequence of
lower key-range boundaries, where the set of initial characters of
the data set name is compared against the key. Any data set having
the set of initial characters within the specified alphanumeric range
migrates to the volume associated with that range. You specify only
the lower boundary of the key range for a volume. The maximum number
of key ranges you can define is 61.
You specify one key less than the number of key ranges being defined because the lower boundary for the first key range defaults to the lowest key possible. For example, KEYS(L T) identifies three key ranges: the first key range begins with A and ends with K9999999, the second key range begins with L and ends with S9999999, and the third key range begins with T and ends with Z9999999. For key ..., substitute one or more strings of 1 to 8 characters, starting with an alphabetic or $, #, or @. The remaining characters can be alphanumeric and $, #, or @. |
VOLUMES | MIGRATIONLEVEL2(VOLUMES(volser ...))VOLUMES is an optional subparameter specifying
a list of DASD migration level 2 volumes, assigned to the specified
key ranges. If you specify fewer volumes than key ranges, DFSMShsm
assigns an available DASD migration level 2 volume to the key range
when it needs another volume. An available DASD migration level 2
volume is one that is not associated with a key range and has not
been associated with a key range since the last ADDVOL or DELVOL command
was issued. If you specify more volumes than key ranges, the extra
volumes are not associated with any key range. Before you can specify
any DASD migration level 2 volumes with the DEFINE command, you must
add the volumes to DFSMShsm control by using the ADDVOL command.
For volser ..., substitute the serial numbers of the DASD migration level 2 volumes, assigned to the corresponding specified key ranges. Only one volume is associated with each key range at a time. When the specified volume for a key range is full, DFSMShsm assigns an available DASD migration level 2 volume to that key range. To cover all specified key ranges, you must specify one more volume than you specify keys. |