STORE and TurboSTORE/iX Products Manual (B5151-90003)

170 Chapter11
Restoring Files
RESTORE Command Options
• The filenames displayed in a RESTORE listing are those of the final destination filename,
which may not be the same name the file has on the tape. Restore options such as
GROUP, ACCOUNT, and LOCAL may affect what filename is printed.
• For the LONG listing, RESTORE has an extra field, called OLDSP. This field will contain
the old spoolfile name for any spool files that are being restored. Since a spoolfile is
given a new name when it is restored, this field will help you to associate new spoolfiles
with their previous names.
Selecting a RESTORE Error Recovery Method (ONERROR)
As RESTORE restores files from tape, it displays the number of files restored and not
restored, and the names of files not restored, if any. The RESTORE message also explains
why each file was not restored. Such errors do not necessarily abort the RESTORE process.
When RESTORE encounters an error, it either automatically recovers or terminates,
depending upon the nature of the error and the error recovery method you choose.
The following errors always cause RESTORE to abort:
• A command syntax error.
• A disk input or output error (in the system).
• A file directory error.
• An error opening the tape file or an indirect file. Refer to "Using Indirect Files," in
Chapter 5, "Storing Files.")
• An incorrectly formatted STORE tape.
• No continuation reel. You did not find a continuation reel for a multi-reel tape set.
• A device reference error. Either the specification for the device parameter is illegal, or
the device is not available.
The ONERROR option of the RESTORE command lets you choose an error recovery procedure.
Your options are ONERROR=QUIT, ONERROR=SKIP,orONERROR=FULL. QUIT is the default. You
do not have to specify the ONERROR option if you want the default behavior.
If you specify SKIP, RESTORE skips the file in which the error occurred and continues
restoring files from the tape. If you do not specify the ONERR option, or specify ONERR=QUIT,
RESTORE terminates upon encountering a tape error.
You must have Privileged Mode capabilities to specify ONERROR=FULL. This option tells
RESTORE to recover as much of a file as possible if a media error is encountered when
reading the file. The file is restored, if possible to the system. However, parts of the file may
be missing. These
missing parts are filled with the default fill character for the file.
For each missing piece of file data, RESTORE prints a warning message to the listing file.
Also, a warning message is issued for the file, stating that is was "partially restored."
In the final count of files restored at the end of the restore operation, you get a total count
of the number of files, HFS directories, and symbolic links that were partially restored. You
should look carefully through your RESTORE listing when you use ONERROR=FULL, to
make sure that you know which files were partially restored. These files may be corrupted,
and should be inspected carefully before use. Non-flat files, such as message files or KSAM