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

Chapter 6 89
STORE and TurboSTORE/iX Command Options
STORE Options
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 a backup device or an indirect file. An indirect file is a text file
containing STORE commands 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 occurred. 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 the following messages on the console:
STORE IS MARKING REEL BAD ON LDEV #
MOUNT MEDIA # OF SET # FOR STORE ON LDEV #