Ref: 08720015
Title: 3+Backup Internal Errors
Date:    07/23/88

Copyright 3Com Corporation, 1991.  All rights reserved.

Internal errors are almost all errors from the tape drive that
were unexpected.  The exception is Internal error 1.  Some
internal errors generate return codes while others do not.  The
list of possible return codes is itemized at the end of this
file, but are represented in the list of Internal Errors 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 and should thus NEVER occur.

Internal error 2. rc=xxx:  Occurs if a backup of a disk partition fails
because of any tape drive reason.  This should never occur because we cover
almost all of the possible tape drive errors.

Internal error 3. rc=xxx:  Occurs if a data restore fails because of
any tape drive reason.  This should never occur because we cover almost all
of the possible tape drive errors that are expected.

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.

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. It may occur as an artifact after some
other error condition occurs.

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)).  Don't expect to ever see this error.

Internal error 8:  not valid.

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.

Return Codes
--------------------------
0   command completed ok
1   no cartridge in place
2   hit file mark during read command
3   at end of media
4   read error, no data detected
5   write protected cartridge
6   UNIT ATTENTION; new tape in drive
7   un-recoverable error r or w. BAD NEWS!
8   miscellaneous error, mechanical? BAD NEWS!
9   incorrect handle, access denied
10  device is not yet opened
11  tried to open device already open
12  no tape drive is present
13  gave bad command to tape driver
14  tape drive busy on other command
15  driver timed out while waiting for cmd to complete. BAD NEWS!
16  a SCSI bus selection error
17  miscellaneous, unexpected error
