After using the STORE program to back up files, you should
check to be sure that no errors occurred during the backup by using VSTORE. VSTORE verifies that the data written to backup is valid.
The first place to check is the STORE listing. At the end
of the listing, STORE prints a summary of how many files, HFS directories,
symbolic links, and MPE directories were stored. It will also display
the number of files that were not stored, and the number of files that
failed to store. The "files not stored" count includes all files
that were specified on the STORE command line, or in an indirect
file, that failed to qualify for the backup. Reasons for this could
include:
File is open for write
access when an online backup was performed.
File does not meet a DATES or FCODE specification
User did not have appropriate security requirements
to store file
The "files failed to store" count indicates a more serious
problem during the backup. These files qualified for the backup,
but an error occurred while actually storing the file to the backup
media. The STORE listing should be examined to determine which files
failed to store, and why.
The user interface for the VSTORE command is similar to that for the RESTORE command which is described in Chapter 11, "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 precaution.
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 filename, a default name is used.
For example, to verify the files on a backup, enter:
Now issue a VSTORE command that backreferences the backup file and
includes the file or files you want to verify. For example:
If you have omitted the FILE command, you would enter:
In addition to the backup filename 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-60238)
or refer to Chapter 11, "Restoring Files." Implementation of the VSTORE options is the same as implementation of the RESTORE options, except for the ones described above.
The VSTORE options are:
PARTIALDB, TurboSTORE only
RESTORESET, TurboSTORE only