Verifying That STORE Files Are Error Free Using VSTORE [ STORE and TurboSTORE/iX Products Manual ] MPE/iX 5.5 Documentation
STORE and TurboSTORE/iX Products Manual
Verifying That STORE Files Are Error Free Using VSTORE
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:
: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 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:
* SHOW
* ONERR
* DIRECTORY
* PROGRESS
* COPYACD, NOACD
* TREE, NOTREE
* NODECOMPRESS
* STOREDIRECTORY
* PARTIALDB, TurboSTORE only
* RESTORESET, TurboSTORE only
* MOSET, TurboSTORE only
* NAME, TurboSTORE only
MPE/iX 5.5 Documentation