The ACCOUNT-RESTORE command restores one or more accounts from a FILE-SAVE or ACCOUNT-SAVE backup medium.
Format
ACCOUNT-RESTORE account [account...] [(options )] |
Parameter(s)
account |
Name the account will have when it is restored to the system. The name can be different from the one used when the account was saved. |
|
options |
A |
Assumes the filesave backup medium to be positioned at a location other than BOT or EOF within a specified file. |
B |
Ignores item size errors. Binary items requiring more than 255 frames are not restored. |
|
D |
Verifies that the data on the backup medium is 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, it is 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
The ACCOUNT-RESTORE command is used to restore one or more accounts. You cannot restore an account from backup media that have the same name as an account on disk. If the account exists on disk, use the DELETE-ACCOUNT Proc (or DELETE-FILE M/DICT...) to delete it, or choose a different name when restoring the account.
If the filesave consists of two or more backup media, the ACCOUNT-RESTORE command searches each backup medium to locate the specified account. You can reduce the search to a single backup medium by using the File Statistics Report to find out which backup media the account is on.
Restoring an Account from Backup Media
To use the ACCOUNT-RESTORE command, enter the ACCOUNT-RESTORE statement:
You are prompted to enter the name of the account as it appears on the backup medium (when restoring multiple accounts, enter account-name [account-name] [account-name...] in response to the prompt).
The backup medium is then searched for the account; a list of accounts appears on the screen while the backup medium is being searched.
When the account is found, it is restored to disk, and the group update flags of all restored groups are set. Setting the group update flags preserves the cumulative incremental cycle.
If a D-pointer in the account on the backup medium points to a file in another account, or if a D-pointer on the backup medium is unrecognizable because of a parity error, this message displays:
SYNONYM NOT FOUND |
The D-pointer is not created, and the account-restore continues.
When the account-restore is finished, you are returned to the TCL prompt. Any errors encountered during a restore are logged in the RESTORE-ERRORS account (see RESTORE Command).
Example
This example shows the normal sequence of messages you will see when you use ACCOUNT-RESTORE:
>ACCOUNT-RESTORE GAMES
Account name on tape:GAMES BLOCK SIZE: 16896 SYSPROG ACC WORDS . . . GAMES GAMES1 9058,7 HANGMAN-FILE 9065,7 YHS 9056,1 YHS 9072,1 GAMES.BP 9075,3 GAMES.BP 9837,27 POINTER-FILE 10097,1 BP 10100,1 BP 10101,7 PROC-LIB 10131,1 PROC-LIB 10132,3
> |