The RESTORE command restores the specified dictionary, data file, or account from a filesave backup medium.
Format
RESTORE dict-name data-name [data-name...] [(options )] RESTORE SYSTEM account-name [(options )] |
Parameter(s)
dict-name |
Specifies the name of the dictionary into which the data files will be restored. |
|
data-name |
Specifies the name of the data file, defined within the dictionary, to be restored. Multiple data files may be specified. |
|
account-name |
Specifies the name of the account to be restored. |
|
SYSTEM |
Specifies the system dictionary. |
|
options |
The following options are supported: |
|
B |
Ignores item size errors. Binary items requiring more than 255 frames are not restored. |
|
D |
Verifies that the data on the backup medium are the same as the data on the system (to be used with the V option). Note: there will be a mismatch with the ACC file. |
|
L |
Logs the restore process in the Update Logger. |
|
N |
Prevents resizing of files. |
|
R |
Enables resizing of files. |
|
S |
Suppresses the list of file names being searched for on the filesave backup medium. |
|
V |
Verifies data and detects defective D-pointers, invalid item sizes, unrecognizable backup media segments, and other backup media format errors. Data is discarded after being verified, they are not restored. |
|
X |
Ignores the Restore Updates? prompt when restoring from a full filesave backup medium. Automates the save, verify, and restore procedures. |
|
Y |
Prevents the conversion of CL items, restoring them as linked binary items. |
|
Description
When using the L option, the Update Logger must be enabled (see :ULOG-ON/:ULOG-OFF Command), and the specified dictionary may not have logging suppressed (see ULOG-SKIP Command, or CHANGE-FILE Command (U option).
The R option enables resizing of files when restoring a filesave backup medium created using the C option. When specifying the R option, the user will be prompted:
Tape producer data frame size = |
In response to this prompt, type the frame size (in multiples of 500) of the operating system from which you are upgrading, as shown:
O/S |
Frame Size |
GA |
? |
Honeywell |
? |
Microdata |
? |
Mentor O/E 2.8, 2.8A, 2.8+, 3.0 |
2000 |
Mentor PC/OS Release 2.4Zx |
500 |
Mentor 2.4 |
500 |
Mentor 2.6, 2.6A |
2000 |
Mentor 2.7, 2.7A |
2000 |
Mentor 3.0 |
2000 |
Pick Systems R83 |
500 |
Pick Systems AP/Native 5.2 |
1000 |
Sanyo/Icon Upboard |
2000 |
Tower 2.4 |
2000 |
Alpha Micro Pick 64+ |
2000 |
Contact your system supplier if your MultiValue system is not listed above.
Depending on the level of the first file on the save backup medium, one or more of these prompts display:
Account name on tape: account-name Dictionary name on tape: dict-name File name on tape: file-name |
In Response to: |
Enter |
Account name on tape: |
Account-name as it appears on backup medium. This account-name may be different from the account-name specified by the RESTORE command . |
Dictionary name on tape: |
Dictionary-name as it appears on backup medium. The name of this dictionary may be different from the dict-name specified by the RESTORE command. |
File name on tape: |
List of data-names corresponding to those specified by the RESTORE command (a null response is acceptable). If data-names are missing from the list, the data-names specified by the RESTORE command will be used. An asterisk may be entered instead of a list of data-names, allowing any file on the backup medium (which does not already exist in the dictionary) to be restored to the dictionary. |
If the backup medium restored is a full filesave backup medium made without the C or X options, the user will asked if updates are to be restored. If updates are to be restored, only updates to the files specified by the RESTORE command will be restored.
NOTE |
The user will not be able to restore dictionaries, data files, or accounts that they are not authorized to access. |
Error Handling During a Restore
Any errors encountered during a restore are logged in the RESTORE-ERRORS account. The RESTORE-ERRORS account is created by the restore process and may not exist prior to the restore. After the restore has completed, it is important to examine the contents of the RESTORE-ERRORS account to determine if the restore was successful.
Before examining the account, a Q-pointer to the Master Dictionary of the RESTORE-ERRORS account must be created. For example:
REST-ERRORS 001 Q 002 RESTORE-ERRORS |
After the Q-pointer has been created, the contents of the account may be examined.
Type this command:
>LIST REST-ERRORS |
If the restore process enters the system debugger during the restore, it is possible to continue the restore with the next segment of the filesave backup medium.
After typing END in response to the debug (!) prompt, this prompt displays:
> (C)ontinue with the next segment or (Q)uit? |
Type C to continue the restore process with minimal data loss.
Verifying an Account-save Backup Medium
This example verifies an account-save backup medium:
> RESTORE SYSTEM account-name (DV BLOCK SIZE: XXX Account name on tape: |
In response to the prompt, press ENTER.