DSNAME: Specifying the data sets to recover from a copy pool backup version

Explanation: DSNAME is a required parameter that is mutually exclusive with the COPYPOOL and TOVOLUME parameters. The DSNAME parameter indicates to DFSMShsm to recover individual data sets from a copy pool backup version.

For dsname, substitute one or more fully-qualified or partially-qualified names of data sets you want to recover (separate each name with a comma). Deleted data sets must be fully-qualified. If you specify a partially-qualified data set name, every cataloged data set in the standard search order that matches the filtering criteria is processed. If one or more data sets are not found, processing continues.

The high-level qualifier of the specified data set name must be fully-qualified or partially-qualified. A double wildcard ("**") is used in place of a full qualifier and a single wildcard ("*") is used within a qualifier. You cannot specify a double wildcard as the high-level qualifier or as the only qualifier. You can specify a single wildcard in the high-level qualifier position if it is not the first character specified. These restrictions help to prevent an unmanageable number of data sets from being processed. The remainder of the data set name can include any arrangement of wildcard characters.

When the optional NEWNAME(newdsname) parameter is specified, dsname must be a single, fully-qualified data set name.

When GDG data sets are recovered, their bases are serialized. When using a wildcard to recover multiple GDG generations with the same base, they will fail due to serialization errors. It is recommended that multiple GDG generation data sets are recovered individually.

Defaults: None.