sel-restore Command

The sel-restore command selectively restores items from either a file-save, account-save, incremental save, or transaction log media to a specific file.

Syntax

sel-restore destination.file {item.list*} {(options)}

Account name on tape:? account.name

File Name:? tape.file

Parameter(s)

destination.file	File to restore into. The file must already exist.
tape.file	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.
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 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 the 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 the 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 multireel 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.
	o	Overwrites if a duplicate item-ID is found on disk. D-pointers are protected from being replaced by duplicate item-IDs.
	s	Suppresses the message ’item-ID’ exists on file.
	z	Bypasses prompts for restore only.

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, floppy disks, and so on. For convenience, the save media is referred to as tape, or media.

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

The specified account name and file reference variables 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/file name is one that does not exist in the system. For example, 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, SCTs 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 master dictionary 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.

NOTE

Term, tape, is used for a documentation convention only. The type of media is determined prior to using this command by the use of either the set-floppy, set-sct, or other media-attaching commands. After the media is attached, all of the normal tape-handling commands may be used, with a few exceptions such as t-reten and t-erase.

Example(s)

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