RESTORE command

Summary

Privileges

File manager plus ad hoc updates

Function

Restores a Model 204 file from a dumped version of that file

Syntax

RESTORE [option] FROM ddname

Where:

option	is a decimal value. Options can be summed. The options are: Option Meaning 128 The size of a file data set or the number of data sets in a file is being changed. 64 The name of a file is being changed.
ddname	is the name of the data set from which the Model 204 file is being restored. If the FROM ddname clause points to a data set that was not created by the Model 204 DUMP command, the following error messages is issued: M204.2711: ddname IS NOT A DUMP DATASET, CANNOT RESTORE INTO ddname2

Example

OPEN CEN M204.0620: FILE CEN OPENED M204.1203: FILE CEN WAS LAST UPDATED ON hh:mm:ss RESTORE 192 FROM DUMPCEN M204.0500: FILE CEN: RESTORING FROM DUMP OF 88.262 SEP 19 14.24.29 M204.1760: FILE CEN: RESTORE BEGINNING AT 14.29.06 M204.1761: FILE CEN: RESTORE COMPLETED AT 14.29.24

Usage notes

The RESTORE command restores a Model 204 file from a dumped version of that file. RESTORE takes a sequential data set produced by a DUMP command and turns it into a Model 204 file again.

Note: Before using the RESTORE (or REGENERATE) command, you need to have DUMP copies of the files. DUMP processing updates the file while making a backup copy (to a target media). Otherwise, when you do a media recovery using either RESTORE (which does not include journals) or REGENERATE (to include journals), the backup copy does not incorporate all updates, and you cannot detect this.

The RESTORE command can be issued only in file context. (That is, the current default must be a file, not a group.) The file must be opened with file manager privileges and privileges to update with ad hoc requests.

If an external security interface is active, the user ID issuing the command is checked for the proper data set usage authorization. If the authorization check fails, the attempt is logged as a security violation and the command is not executed. Under a security interface, you must have READ privileges to read a file specified by this command. For more information, refer to the Model 204 Security Interfaces Manual.

If a file is skewed, the file can only be transferred from one device type to another through the Model 204 DUMP/RESTORE facility. For a complete discussion of the obsolete skewing feature, refer to the "File skewing" section in the Model 204 File Manager's Guide.

When RESTORE has finished processing, it automatically closes all private or semi-public files. Public files remain open.

When it processes RESTORE, Model 204 ends any update unit in progress and begins a non-backoutable update unit. For more information about Model 204 update units, see the Model 204 File Manager's Guide.

After Model 204 starts to restore a file, it displays a message showing the date and time the file was dumped. The Rocket Model 204 File Manager's Guide discusses the RESTORE options, along with a full presentation of DUMP, RESTORE, and their use in moving, renaming, and changing the size of files.

Although the DUMP command copies the FILE BROADCAST message with the FPL, the RESTORE command leaves the current BROADCAST message in the file. For example:

OPEN FPLJUNK BROADCAST FILE BROADCAST MESSAGE NUMBER ONE DUMP TO DUMPFPL OPEN FPLJUNK BROADCAST FILE BRAODCAST MESSAGE NUMBER 2 RESTORE FROM DUMPFPL OPEN FPLJUNK <broadcast message number two> is displayed.