RESTORE command

From m204wiki
Jump to: navigation, search

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 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 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 Security interfaces pages.
  • If a file is skewed, the file can only be transferred from one device type to another through the Model 204 DUMP/RESTORE facility. File skewing is an obsolete feature.
  • 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.
  • After Model 204 starts to restore a file, it displays a message showing the date and time the file was dumped. File dumping and restoring 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 BROADCAST MESSAGE NUMBER TWO RESTORE FROM DUMPFPL OPEN FPLJUNK <broadcast message number two> is displayed.