tcl.sel-restore Verb: Access/TCL

tcl.sel-restore

Command tcl.sel-restore Verb: Access/TCL
Applicable release versions: AP, R83
Category TCL (746)
Description selectively restores items from either a "file-save", "account-save", "incremental save", or "transaction log" media to a specific file.

Normal backup procedures ensure all the items in all the files are saved from time to time. Critical files can be backed up continuously using the transaction logger.

The media used for this backup can be SCT, half-inch tape, floppies, etc. For convenience, the save media is referred to as "tape", or simply "media".

This verb can be invoked after the desired physical save media is put in the appropriate I/O device and attached with the appropriate command.

"destination.file.reference" indicates the file to restore into. The file must already exist.

"tape.file.reference" indicates the name of the file on the offline media.

The system prompts for the "file name" of the file to restore from the save media. If a null "file.reference" is entered, the account's master dictionary is restored.

"item.list*" designates which items to restore from tape. A null list restores all items.

The specified "account.name" and "file.reference" must match exactly with the appropriate name on tape.

To check the contents of the tape, the files can be listed by using a "sel-restore" and specifying a "dummy" account name and "file.reference" on the tape. (A "dummy" account/filename is one that does NOT exist in the system, such as "oxymoron"). The entire tape is searched looking for the "dummy" account, printing the names of the files on the tape.

In restoring both the dictionary and data section of a file, restore the data section first. Although the dictionary name appears before the data section name on the screen, the data is saved (and restored) before the dictionary.

At any point, the media may be moved backward ("t-bck (n)"), or forward ("t-fwd (n)") to position it (assuming that the "save" media device supports the command), and a "sel-restore" with the "a" or "n" option may be started. This may be faster than restarting the tape from the beginning when restoring both the dictionary and the data sections of a file, or when restoring multiple files. Unfortunately, however, SCT's do NOT allow "t-bck"; the only recourse is rewinding ("t-rew") and moving forward to the correct file ("t-fwd").

Account dictionaries (master dictionary items) follow all other files for each md on the tape.

If "s" is specified when the save tape is created, the contents of the tape can be seen using "list-file-stats" anytime before another file save using the "s" option.
Syntax sel-restore destination.file.reference {item.list*} {(options)}
Account name on tape:? account.name
File Name:? tape.file.reference
Options a Indicates that the media is already positioned at the correct account. The "a" option is used to avoid rewinding and searching. If the order of the file on the tape is known (from the "list-file-stats" report normally generated following the save) then multiple files may be restored without rewinding the media. After the first file is restored on the account, the next "sel-restore" is done using the "a" option. The "sel-restore" process prompts directly for file.reference. The system next prompts for "full, incremental, or transaction restore". As the tape is searched, the file names on it are printed, along with the file numbers. Names are indented one space for account names, two spaces for dictionaries, and three for data file names. At the completion of the restore, the system again prompts for incremental and transaction restore.

c Causes every item in current file to be a candidate for restore. This ensures that data can be restored even if a "d-pointer" is damaged on the tape. This option is used with the "n" option.

f Displays all file.references for all accounts. This is not compatible with the "n" option.

i Item-ids of the restored items are not to be printed.

n Restores file by its number. The process prompts for the number of the file to restore. This option is particularly useful for restoring from a multi-reel backup media, so that the restore can begin from the reel where the file resides (or begins). The file number can be found on the "file statistics" report for the appropriate save media. See "list-file-stats".

o Overwrites, if a duplicate item-id is found on disk. "d-pointers" are protected from being overwritten.

s Suppresses the "'item-id' exists on file" message.
Example
sel-restore dict devices
Restore from (F)ull account, (I)ncremental, (T)ransaction log: _ f
Account name on tape: dm
File name: dict devices
  :
  Scans the file-save tape, and finds the 'dm' account
  Scans the DM account and finds the 'dict devices' file
  Scans the DEVICES file and restores the requested item(s)
  :
Restore from Incremental save tape? _ no
Restore from transaction log? _ no
Purpose
Related tcl.set-floppy
tcl.set-half
tcl.set-sct
tcl.file-save
dummy.save
tcl.set-device
tcl.set-tape-type
tcl.set-sct-dma
access.t-load
tcl.itemlist*
tcl.t-att
tcl.set-8mm
tcl.list-file-stats
tcl.save
tcl.account-restore
dummy.restore
tcl.account-save
filename.restore-errors
restore