The SEL-RESTORE command restores from backup medium one or more items in a file.
Format
SEL-RESTORE [DICT] filename item-list [(options )] |
Parameter(s)
DICT |
Specifies the file dictionary. |
filename |
Name of the file to which you want the items restored. |
item-list |
List of items you want to restore. Use an asterisk (*) to restore all items in the file. |
options |
Include one or more single-character codes that specify the report format and direct or modify output. They must be enclosed in parentheses, can be entered in any order, and need not be separated by spaces or any delimiters such as commas. For complete information about using these parenthetical options, see the section, Connectives, Modifiers, and Options in the INFO/ACCESS User Reference Guide. |
Description
The SEL-RESTORE can be used only with a FILE-SAVE or an ACCOUNT-SAVE backup medium; it cannot be used with an incremental filesave backup medium. You can also use SEL-RESTORE to verify the contents of a filesave backup medium.
Using SEL-RESTORE
To use SEL-RESTORE:
Type the names of accounts and files exactly as they appear on the backup medium; do not enter a synonym.
If the account name or file name has a synonym, use the File Statistics Report to obtain the exact name of the account or file as it is on the backup medium.
If you specify the N option, you are prompted to enter the number of the file instead of its name.
After you type the account and file name, or file number, the backup medium is searched for the data requested.
If the filesave consists of two or more backup media, each backup medium is searched to locate the data.
You can reduce the search to a single backup medium by using the File Statistics Report to find out which backup medium contains the requested data.
When the data is found, the specified items are restored to disk and the group update flags of all restored groups are set. This preserves the cumulative incremental cycle.
If you use the B option, items to be restored must contain either mvBASIC object code or select-lists.
If you use the A option, you must position the backup medium at the beginning of the account to be restored before you run the SEL-RESTORE command.
The S option is useful at the beginning of the second or later reel of a multireel tape.
Using a Save Tape
To use a save tape:
Unless the A option is specified, the tape must be positioned at the beginning of the filesave tape before executing the SEL-RESTORE command.
Upon executing the SEL-RESTORE command, 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 |
If the A option is specified, the SEL-RESTORE command will assume the tape is at a location other than BOT or EOF, and this prompt displays:
> Level: 0-System 1-Account 2-Dictionary 3-Data File: |
The Levels 0, 1, 2, and 3 are as follows:
0 |
The filesave tape is positioned within the SYSTEM file, and the user will be prompted for an account-name. |
1 |
The filesave tape is positioned within the specified account, and the user will be prompted for a dictionary name. |
2 |
The filesave tape is positioned within the specified dictionary, and the user will be prompted for a file name. |
3 |
The filesave tape is positioned at the specified file name. |
The A option is useful when restoring from volumes other than the first volume in a multi-volume set, or when performing multiple SEL-RESTORES from a single account.
When the restore operation is complete, the tape is positioned at the End-Of-File (EOF) mark.
You can also retrieve and list data from tape by using the TAPE modifier with INFO/ACCESS commands such as LIST and LIST-ITEM. For more information about the TAPE modifier, see the section, Connectives, Modifiers, and Options in the INFO/ACCESS User Reference Guide.
NOTE |
Users will not be able to restore dictionaries, data files, or accounts that they are not authorized to access. |
Restoring Selected Items by File Name
If you don’t specify any options when you enter the SEL-RESTORE command, you are prompted to enter the account name and the file name as they appear on the backup medium:
>SEL-RESTORE DICT PARTS * ACCOUNT NAME AS SAVED? INV FILE NAME? DICT PARTS |
If you press ENTER at the file name prompt, the Master Dictionary of the account is restored.
Restoring Selected Items by File Number
If you use the N option, the system prompts for file number instead of file name.
A list of the latest file numbers can be found in the File Statistics Report. For example:
>SEL-RESTORE DICT PARTS * (N) FILE NUMBER? 33 |
As the backup medium is searched, each file name displays as it is found, along with the file numbers. File names followed by an (S) are synonyms. The list of names is indented as follows:
FILE NAME? MYFILE ACCOUNT-NAME 56 DICTIONARY-NAME 57 FILENAME 58 FILENAME (S) 59 DICTIONARY-NAME 60 FILENAME 61 |
Verifying Files on Backup Media
You can use the SEL-RESTORE command to verify all the files contained on a formatted filesave backup medium.
Type SEL-RESTORE followed by the name of any file in the account you are logged on to, and the name of the nonexistent file item.
When you are prompted to enter the names of the account and the file on the backup medium, type nonexistent names.
As the backup medium is searched for the non-existent file, all file names found display with their file numbers, as described above. The format of the backup medium data is checked; if any errors are found, a message displays on the screen.
For example, in the SYSPROG account you might type the following:
>SEL-RESTORE NEWAC non-existent-item |
At the next two prompts you would enter the names of a nonexistent account and a nonexistent file:
ACCOUNT NAME ON TAPE? non-existent-account FILE NAME? non-existent-file |
The names of all files contained on the backup medium will then be listed to the screen as they are verified.
Restoring Q-Pointers from the SYSTEM File
When using the SEL-RESTORE command to restore Q-pointers from the SYSTEM file, you are prompted to enter an account name.
Press ENTER at the account name prompt, to restore all items in the SYSTEM file. For example:
>SEL-RESTORE QFILE ACCOUNT NAME ON TAPE? <ENTER> |
Restoring Dictionary Items from the ACC File
When using the SEL-RESTORE command to restore dictionary items from the ACC file, you are prompted to enter an account name and a dictionary name.
Type the account name (at the account name prompt) and press ENTER (at the dictionary name prompt), to restore all dictionary items in the ACC file. For example:
>SEL-RESTORE DFILE ACCOUNT NAME ON TAPE? ACC DICTIONARY NAME ON TAPE? <ENTER> |