HPlogo STORE and TurboSTORE/iX Products Manual > Chapter 9 When STORE is Complete

Verifying That STORE Files Are Error Free Using VSTORE

MPE documents

Complete PDF
Table of Contents
Index
Glossary

E0300 Edition 2 ♥
E0796 Edition 1

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



Checking File Listings for Errors

Using NODECOMPRESS