Verifying That STORE Files Are Error Free [ STORE and TurboSTORE/iX Manual ] MPE/iX 5.0 Documentation
STORE and TurboSTORE/iX Manual
Verifying That STORE Files Are Error Free
After using the STORE program to write files to backup, you may want to
check to be sure that no errors occurred in the process. A new MPE XL
command, VSTORE, allows you to verify that any or all the files were
correctly stored. VSTORE can also be used to verify the file system
directory or to list the date that a given file was stored.
The user interface for the VSTORE command is similar to that for the
RESTORE command which is described in Chapter 10, "Restoring Files."
Command syntax for VSTORE is shown in Appendix B, "Command Syntax."
To verify one or more files on a STORE backup, mount the backup on your
backup device. The write ring should be removed as a protection.
As with the STORE and RESTORE commands, you may optionally precede the
VSTORE command with a FILE command assigning a file name to the backup
drive. If you do not assign a file name, a default name is used.
For example, to verify the files on a backup, enter:
:FILE T;DEV=TAPE
Now issue a VSTORE command that backreferences the backup file and
includes the file or files you want to verify. For example:
:VSTORE *T;@.@.@
If you have omitted the FILE command, you would enter:
:VSTORE ;@.@.@
In addition to the backup file name and the names of the files to be
verified, four parameters are available: SHOW, ONERR[OR], LOCAL, and
DIRECTORY. The following is a brief description of each of these
parameters:
* The SHOW parameter allows you to list the names of each file
successfully verified. (If you do not specify this parameter, the
total number of files verified is displayed.) Additional options
used with the SHOW parameter include short and long form
descriptions of files, creation, last access, last modification
date, security status, and an offline printing option.
* The ONERR[OR] parameter informs VSTORE what to do if a media error
is encountered while verifying a file. Two options are available.
If ONERR=SKIP is specified, then VSTORE will continue to verify
files after an error is encountered. It will print an error
message for any file that it was unable to verify. This is the
default. Specifying ONERR=QUIT causes VSTORE to terminate upon
getting a media error. The rest of the files in the backup will
not be verified, and an error message for each file will be
issued.
* The DIRECTORY parameter allows for the file system directory on
the backup to be verified. Use of this parameter requires SM or
OP capability.
The following are examples of the above parameters:
:VSTORE *T;@.@.@;SHOW
:VSTORE *T;FILE1.MANAGER.SYS;SHOW;ONERR=SKIP
:VSTORE *T;@.@.@;DIRECTORY
NOTE The VSTORE command is not valid for a STORE backup created with the
TRANSPORT parameter.
For a full discussion of all VSTORE command options, refer to the MPE/iX
Commands Reference Manual Volumes 1 and 2 (32650-90003 and 32650-90364)
or refer to Chapter 10, "Restoring Files." Implementation of the VSTORE
options is the same as implementation of the RESTORE options. The VSTORE
options are:
* SHOW
* ONERR
* DIRECTORY
* COPYACD, NOACD
* TREE, NOTREE
* RESTORESET, TurboSTORE only
* MOSET, TurboSTORE only
MPE/iX 5.0 Documentation