tcl.t-verify Verb: Access/Tape Commands

tcl.t-verify

Command tcl.t-verify Verb: Access/Tape Commands
Applicable release versions: AP, R83 3.1
Category Tape Commands (36)
Description validates the integrity of "file-save" or "account-save" backups.

The process can compare the contents of the backup media with the corresponding data on disk, or simply check the media to ensure that it has the correct backup format.

This process first attempts to attach to the tape. If it is already attached to another process, the following message appears:

tape attached to line {port.number}
[1144] the tape is not available for use now.

"port.number" is the port with the tape attached. See the "where" command. The process with a "t" under the "stat" column has the media attached.

Items displayed are in file hierarchy format:

mds > account > dictionary > data section

By default, only account names are displayed. All errors found are displayed. The display pauses at the bottom of each screen and disk and tape comparisons are made.

The "t-verify" is an option provided during the "file-save" process. If it is selected, errors are logged to the "tv.log" file.
Syntax t-verify {(options}
Options number (integer number) Indicates "choke" count. This specifies the maximum number of errors allowed before abort. The tape is left at the abort point. By default, the errors never "choke" and just continue down the screen.

? Displays brief on-line help.

a Validates an "account-save". This verifies all accounts until the "end of save" mark on tape, by forwarding to the beginning of each account and verifying its contents. This option is useful for "file-save" reels other than reel 1 (one).

d Suppresses display of duplicate item-ids in a group. (R83 only).

e Displays errors only.

f Displays all file names found on the tape in hierarchical format. If used with the "i" option, item-ids are also displayed.

g Suppresses group "hashing". Skips hashing test on all items. No errors will be found if items are in the wrong group. This item is especially useful when going from AP to R83 (using the "c" option with the "save" command), where case sensitivity could generate error messages for all lower-case items. The most likely use for this option is on R83 systems only.

i Displays all items found on the tape in file hierarchy format. The display is 'in place' for each file (i.e., all items for that file display on the same line). If used with the "f" option, items are displayed in the "form-feed" format, showing each item on a new line.

l Logs errors to a log file. Attribute 1 of the log file is the error message from the "messages" file. Attribute 2 is the element that caused the error, in hierarchical form. The "l" option prompts the operator for the log file name.

n Activates "nopage" function on output to terminal.

p Directs output to printer, via the Spooler.

q Queries operator on each error found. The operator gets a choice to either continue, quit or skip file system comparisons for the current file.

t Verifies contents of tape only.

x Displays index b-trees found on tape. This is useful for determining if the indices were saved with the file system. See the "b" option in the "save" command for saving indices.
Example
Purpose
Related tcl.t-chk
dummy.save
tcl.list-device
tape.handling.verbs
tcl.fuser
tcl.save
tcl.where
filename.tv.log
tcl.t-stat
dummy.restore
tcl.:files
t-verify.messages
tcl.t-verify.link