tcl.sel-restore

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.