MIGRATIONLEVEL2: Specifying DASD level 2 volumes and their associated key range structure

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.

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.

Defaults: If you do not specify KEYS, DFSMShsm assumes that you are defining one key range for all possible keys.

Note:

You must issue a DEFINE command with the MIGRATIONLEVEL2 parameter before DFSMShsm can process level 1 to level 2 migration.
If you want to reuse the DASD migration level 2 volume after it has been removed from a key range, you must use the DELVOL command with the UNASSIGN parameter.
DFSMShsm does not process a change to the key range definition while migration to DASD migration level 2 volumes is occurring.