Selecting an Error Recovery Method (ONERROR) [ STORE and TurboSTORE/iX Manual ] MPE/iX 5.0 Documentation
STORE and TurboSTORE/iX Manual
Selecting an Error Recovery Method (ONERROR)
When STORE encounters an error, it either automatically recovers or
terminates, depending upon the nature of the error and the error recovery
method you choose.
Unrecoverable Errors
The following unrecoverable errors always cause STORE to terminate:
* A command syntax error.
* An error in the file system directory.
* An error opening the backup file or an indirect file. An indirect
file is a text file containing STORE command and options. Refer
to "Using Indirect Files", in Chapter 5, "Storing Files".
Disk Read Errors
If STORE encounters a disk read error while storing a file, it skips the
remainder of that file and sends an error message to the standard listing
device describing the offset from the start of the file and the number of
bytes that have been lost. STORE then continues to copy the remainder of
the files. The STORE operation does not terminate. Since the files that
contain disk errors are not stored, you will not be able to restore them.
Media Errors
When a media error occurs while writing to a output device, the behavior
of STORE depends on the value of the ONERROR option, as explained below.
Tape Error Recovery.
The STORE command's ONERROR parameter lets you specify a backup error
recovery procedure. Your options are ONERROR=QUIT and ONERROR=REDO. REDO
is the default. QUIT instructs STORE to abort upon encountering a backup
I/O error while REDO instructs STORE to continue after encountering an
I/O error.
If you specify REDO and the STORE command encounters a backup I/O error
on any device, STORE sends a message to your terminal (or the file or
device to which you have assigned the file SYSLIST). This message
indicates where the error occured. For example, STORESET=(*T1,*T2,*T3)
is requested and a backup error occurs on the device referenced by *T2
while it is creating reel 2. STORE rewinds the reel to the load point,
marks the reel as bad, and asks you to mount another reel. After you
mount the new reel, STORE automatically stores all the files from the
point where the bad reel began.
The message is similar to the following:
* The user sees:
STORE ENCOUNTERED MEDIA WRITE ERROR ON LDEV #
where LDEV # is the device referenced by *T2. This means that the
store error recovery occurs on the same device where the error
occurred.
* The operator sees:
STORE IS MARKING REEL BAD ON LDEV #
MOUNT MEDIA # OF SET # FOR STORE ON LDEV #
Optical Disk Errors.
If an optical disk write error is encountered the same messges which are
used for backup devices display.
You can determine which piece of media is has been marked bad by using
the STATUS command of the MOUTIL program. The status display indicates
which piece of media is bad by showing "THE MEDIA IS BAD" in the media
name field.
Bad Media
Once a piece of media has been marked bad, it should not be used for
future STORE operations. If a media that has been marked bad is mounted
for use in a STORE operation, STORE will issue the following message to
the console:
MEDIA ON LDEV # IS BAD. CONTINUE ANYWAY?(Y/N)
If you reply YES, then STORE will write over this media. If you reply
NO, the media will be unloaded, and you should mount another piece of
media.
NOTE STORE will not check to see if a piece of media has been marked bad
for the very first reel mounted. Therefore, it is important that
once a reel has been marked bad by store, some note is made on the
physical label of the media to indicate that it encountered a write
error while storing to it.
MPE/iX 5.0 Documentation