dsname and *: Specifying the name of the data set to be recovered

Explanation: dsname is a required positional parameter specifying the fully qualified name of the data set you want to recover. For dsname, substitute the fully qualified name of the data set you want to recover. You can specify an asterisk (*) as the dsname to request that the volume you identify with the TOVOLUME parameter is recovered. Unless FROMDUMP is specified, the volume must be a level 0 volume. If FROMDUMP is specified, the volume can be a DFSMShsm-owned DASD volume.

During volume recovery, if DFSMShsm created backup versions of both cataloged and uncataloged data sets that have the same data set name and DFSMShsm created them from the volume being recovered, DFSMShsm recovers the backup version that has the latest creation date and the same data set organization.

Defaults: None.
Note:
  1. Because dsname is a required positional parameter, you must specify it immediately after the command name. You cannot specify an alias for dsname. If you do, DFSMShsm does not recover the data set.
  2. DFSMShsm does not handle partitioned data set members individually. If you specify a partitioned data set with a member name, DFSMShsm recovers the entire partitioned data set.
  3. A DUMP VTOC copy data set must exist in order to restore a data set from a DUMP copy, except when the DUMPVOLUME subparameter is specified. By using the DUMPVOLUME subparameter, you are deliberately bypassing this requirement; therefore, no data set verification is performed on the dump tape. If the data set you are trying to restore is not on the dump tape, DFSMShsm still ends with a successful message even though the data set was not restored.
  4. DFSMShsm cannot recover an integrated catalog facility catalog data set from a dump copy. An integrated catalog facility catalog that was dumped by DFSMShsm can be recovered from a dump copy without DFSMShsm.