Explanation: CONVERT is an optional parameter
that you use to migrate all data sets, only aged data sets, or a specific
data set from a level 0 volume to a migration level 1 volume and then
immediately recall those data sets to another level 0 volume. You
can use this parameter when you want to remove a volume from the system.
For example, you can use this parameter to move data sets from a
3380 volume to a 3390 volume.
For volser2, specify the volume where DFSMShsm is to recall
the data set. For unittype2, specify the type of unit where
DFSMShsm is to mount the target volume. If you do not specify volser2, DFSMShsm selects the target volume the same way it normally
selects target volumes during recall. If you use the volser2 subparameter
to specify a volume not managed by DFSMShsm, you must also specify
the unittype2 subparameter.
In addition, when you specify MIGRATE(0), DFSMShsm can process
types of data sets that it does not normally process during migration.
These are:
- Cataloged list and utility data sets that cannot be scratched
because they have been referred to too recently.
- Data sets that have temporarily been marked as not able to be
migrated because a job in a JES3 system planned to use them.
Note: In a JES3 system, two jobs could use the same data
set at the same time if you submit one job before the conversion is
done and you submit the second job after the conversion. Therefore,
ensure that no jobs are waiting to run if those jobs use the data
sets on the volume being converted.
Defaults: For cataloged data sets, you do
not have to specify
volser2 or
unittype2. If you
do not specify these values, DFSMShsm chooses the volume and type
of unit.
Note: - The space management technique must be migration. You can specify
the MIGRATE subparameter of the VOLUME parameter, the MIGRATE parameter
of the ADDVOL command, or use the default of migration on the ADDVOL
command.
- To prevent the source volume from being selected as the target
volume for recall, specify the NOAUTORECALL parameter of the ADDVOL
command for the source volume until the migration finishes.
- If you want DFSMShsm to convert all data sets on a level 0 volume,
you must also specify the MIGRATE(0) subparameter of the MIGRATE command.
If, however, you used the SETMIG command to specify the DATASETNAME,
LEVEL, or VOLUME parameter with the NOMIGRATION parameter, DFSMShsm
will not migrate the specified entry when you specify the CONVERT
parameter even if you also specified the MIGRATE(0) parameter. For
example, if you specified SETMIG LEVEL(USER) NOMIGRATION, those data
sets with the first qualifier of USER do not migrate from the primary
volume.
- If you specify the CONVERT parameter in a direct-to-tape environment,
the command fails.
- You can use the CONVERT parameter with the UNIT parameter if you
want to convert non-SMS-managed volumes not managed by DFSMShsm to
volumes managed by DFSMShsm.
- VSAM data sets created on the same day that the MIGRATE VOLUME
(MIGRATE(0)) CONVERT command was issued are not migrated because of
a data integrity exposure.