RESTORE Restore Files from Archive to Disk

RESTORE Restore Files from Archive to Disk

The ONXRESTORE Variable Action can only be processed in conjunction with an Archive directory list created by DIR directory. RESTORE allows files or Job variables that were saved with the SAVE or DSAVE Archive statements to be restored to the system under the same or to different names.

'str1'='str2' Name transformation rules. For further information, see page 5-.

STATE Corresponds to the Archive operand FROM=...,STATE in the RESTORE/DRESTORE statement.

The STATE parameter is only valid for partial save entries (PART type). It results in the last full save of the file being restored, and then the modified pages from the partial saves.

TO=PUBLIC|vsn|(vsn,...)

Corresponds to the Archive operand TO=... in the FILES statement.

The TO= parameter will result in the restoral of the files to the specified private volume, or to public space.

Standard: If the TO= operand is not specified, the files will be restored to the original private volumes from which they were saved, or back to public.

DEVICE=device

Only used in conjunction with the TO=vsn (see above), this parameter identifies the device type for the specified private volume.

ENV-ATT=FROM-TARGET|FROM-ORIGIN

Corresponds to the ENVIRONMENT-ATTRIBUTES operands in the [D]RESTORE statement.

This parameter controls how the RESTORE of files which already exist and which are protected with ACL, BACL or GUARDS, will be performed.

CONV=NO|STD|CONV

Corresponds to the CONVERSION operands in the [D]RESTORE statement.

This parameter will control how files which had had a PAM key before the save operation will be converted, if the target volume of the restore operation is an NK volume.

REP=YES|NO|ALL|ALLP

Corresponds to the Archive operand REPLACE=... in the [D]RESTORE statement.

This parameter determines whether existing files of the same name will be overwritten or not. For further information, see the ARCHIVE User Manual, RESTORE statement.

SPACE=REORG|KEEP

Corresponds to the Archive operand SPACE=... in the [D]RESTORE statement.

This parameter determines whether the existing file will be deleted prior to it being replaced or not. For further information, see the Archive User Manual, RESTORE statement.

PASSWORD=passw|(passw,...)

Corresponds to the Archive operand PASSWORD=... in the [D]RESTORE statement.

This parameter allows any necessary read passwords for the saved files to be entered. The system administrator does not need to specify passwords. For further information, see the Archive User Manual, RESTORE statement.

DIR=NONE This parameter will result in a directory file not being required when ARCHIVE performs a restore. This means that the DO procedure will contain the VSN's of the tapes required to restore the files, as well as the correct device types, in the ARCHIVE Restore statement. A TYPE message will be issued to CONSOLE to inform the operator when to mount the relevant tapes.

An example of the application of the DIR=NONE parameter is if the ARCHIVE Restore procedure for certain files is created on one host, then transferred to another host by file transfer and executed there. The files can then be restored without reference to the original directory file. The sole prerequisite is access to the correct Archive tapes.

PARAM ... Corresponds to the PARAM Archive statement in a RESTORE process.

General Archive settings can be set here, such as,

The CATID=YES|NO operand may not be set in the PARAM statement, since CFS sets it automatically depending on the value already set in the Archive directory.

The PARAM statement must be specified last, and must be separated by a blank from the preceding parameters.

Note:

ONXRESTORE can only be used to restore files or Job variables from a CFS Archive directory list that was saved with the Archive statements SAVE or DSAVE. Files that were saved with EXPORT must be restored with the ONXIMPORT Variable Action (See page 5-).