RST can be used to select a volume or volumes to restore.
The RST command protocol requires that all physical file systems adhere to a certain set of predefined rules governing how restore is handled, depending on whether or not the object exists on the system. For purposes of restoring an optical volume image, the target media must exist on the system, either mounted in a stand-alone device or imported into an optical media library. Also, it must be accessible by the name specified on the OBJ-New Path Name parameter. The OBJ-New Path Name must either match the name of the OBJ-Name parameter or be *SAME. This restriction will require that unformatted volumes be renamed before executing the RST command. Unformatted volumes can be renamed using option 7 from either the WRKOPTOL, WRKLNK display or by issuing the generic RNM command.
When an unformatted volume is renamed, the new name acts as an alias to the unformatted volume. The new name will not be written to the media and will not be preserved if the volume is removed from the device. The name is only a temporary volume identifier used to refer to this volume until the volume is restored.
Saved volumes can be restored to both unformatted and formatted volumes. If restoring to a formatted volume that contains active files and directories, an inquiry message is sent. If you proceed with the restore, all data on the target media will be lost.
Saved HPOFS volumes can be restored to Erasable media with matching sector sizes and a capacity equal to or greater than the saved volume.
Saved UDF volumes on DVD and Erasable can be restored onto DVD or eraseable media, but media capacity and sector size must be identical to the saved volume.
WORM volumes can be restored to either WORM or Erasable media as long as the capacity of the target media is greater than or equal to the saved volume capacity and the sector size is identical to the saved volume. When restoring to WORM, the target volume must be unformatted.
The performance of RST is comparable to DUPOPT, although it depends on the target device chosen.
OBJ Name Name of the optical volume image or images to be restored from a save/restore device.
OBJ New Path Name Specify a single or multiple path names. The path name cannot be extended beyond the volume level. Examples of invalid path names include, ’/QOPT/VOL/*’ or ’/QOPT/VOL/DIR/FILE’. Specify the names of existing volumes or *SAME.
SUBTREE Must be *STG when restoring optical volume images.
OPTION Must be *ALL or *OLD.
ALOWOBJDIF Select *OWNER, *PGP, *AUTL, *NONE, *ALL. The value selected determines what differences will be tolerated between the saved volume and the formatted target volume. If changes are allowed, an attempt will made to preserve the security attributes UID, GID and PERMS of a the UDF target volume root directory. The *OWNER and *PGP values are not checked when restoring to an uninitialized volume or when restoring to an initialized HPOFS volume.
Refer to the CL Reference guide for a further explanation of parameter values and their meaning.
RST DEV(’/qsys.lib/xzylib.lib/xzysavefile.file’) OBJ((* *INCLUDE *SAME)) SUBTREE(*STG).
RST DEV(’/qsys.lib/xzylib.lib/xzysavefile.file’) OBJ((’/qopt/vola*’ *INCLUDE *same) (’/qopt/volb*’ *INCLUDE *same)) SUBTREE(*STG)
RST DEV(’/qsys.lib/tap01.devd’) OBJ((’/qopt/vol1’ *INCLUDE *same)) SUBTREE(*STG)