Restrictions

Because dsname is a required positional parameter, you must specify it immediately after HMIGRATE.
The volume on which the data set resides must be mounted before you issue the command.
When you specify a password with a filter, all the data sets protected by a password must have the same password. Otherwise, DFSMShsm authorization checking fails the migration of those data sets that are protected by a different password.
DFSMShsm does not process individual partitioned data set members. If you specify a partitioned data set name with a member name, DFSMShsm fails the HMIGRATE command.
If dsname is fully qualified and refers to a VSAM data set, specify the base cluster name, or any component name, or any path name. The entire VSAM sphere will be migrated. If the sphere has more than one alternate index (AIX), more than one path, or more than one path on the AIX, the data set can be recalled by the base cluster name only.
If you migrate a VSAM data set with more than one path per alternate index, only the last path listed in the catalog is preserved. After the migration, you must redefine any other paths that are needed.