Ref: 11030025
Title: Internal Errors for 3+Backup
Date:  6/88

Copyright 3Com Corporation, 1991.  All rights reserved.

Internal errors are almost all errors from the tape drive. Some
of them do not display return codes from the tape drive, while
some of them do.  These errors will be itemized at the end, but
are represented in the following list as xxx.

Internal error 1

The call to the MIND buffer manager MINDSBUF to retrieve a buffer
failed.  This would indicate a serious MINDS inconsistency in its
state.


Internal error 2. rc=xxx

Occurs if a backup of a disk partition fails because of any tape drive
reason.


Internal error 3. rc=xxx

Occurs if a restore of data fails because of any tape drive reason.


Internal error 4. rc=xxx

This means that the tape drive returned a strange error when trying to
read the very first block on the tape.  It needs to read this block
before beginning all backup operations (BACKUP, RESTORE, TAPE
DIRECTORY).  There should be an error code associated with this.  For
example:

    Internal error 4. rc=17.

That number will at least tell us what the driver is returning to us.

Try the following for resolution: try different cartidges; try
swapping tape drives; erase the tape twice before using; increase
-h parameter in eth3.sys line from 2 to 4.


Internal error 5. rc=xxx

This is a catch all error condition when the tape prepping routine fails
for some unexplained reason.  Tape prepping occurs before all tape
operations (Backup, Restore, Tape Directory, etc.) and includes
rewinding, erasing, etc.


Internal error 6. rc=xxx

Occurs while the program is waiting for the user to insert a new tape
and the LCD message displays an appropriate message like "Insert next
tape", "Change tape", etc.  The program needs to rewind the tape
cartridge every so often to check to see if the user has inserted a new
tape, and if this fails, Internal error 6 occurs.  This one is rare.


Internal error 7.

Occurs during a backup tape change point when we need to determine how
much "residue" is left in the tape buffer.  Residue is the amount of
data that was NOT written to the previous tape because it was at the end
of the tape.  This data must be written to the beginning of the next
tape.  This error will occur if the residue is not legal (for example,
<0 or greater than the size of the write request of the previous
write(s)).  I don't expect to ever see this error.


Internal error 9. rc=xxx

Same as internal error 4 except this occurs during tape change points of
backups.


Internal error 10. rc=xxx

Same as internal error 5 except this occurs during tape change points of
backups.

06/10/88
