SCSI  SUPPORT

 
 

GLOBALNET™ Products


GLOBALNET™ products send commands to the SCSI controller, which in turn sends the command to the device. When a command is successfully completed, the device returns a status code of 00, or "command completed - no error returned." When a critical error occurs, the device sends an error code to the SCSI controller, which in turn is accounted for and saved by GLOBALNET in the SYS$LOG.ERR file. See the Chapter 5 Troubleshooting Section. You can view this file in the SYS:SYSTEM directory using a text editor or if using SYSCON, Select "View File Server Error Log" from the Supervisor Options Menu.


OptiDriver 2000 Products

OptiDriver 2000 products send commands to the SCSI controller, which in turn sends the command to the device. When a command is successfully completed, the device returns a status code of 00, or "command completed - no error returned." When a critical error occurs, the device sends an error code to the SCSI controller, which in turn is accounted for and saved by OptiDriver in the ERROR.LOG file. See the OPTIDRVR.CFG section for more information.


SYS$LOG.ERR or ERROR.LOG File

The LOG command is used to record commands issued to the SCSI device(s) attached to your system. If the LOG command is included in the OPTIDRVR.CFG file, all SCSI commands issued to, and errors received from the SCSI device(s) will be recorded in the file SYS$LOG.ERR or ERROR.LOG. If the LOG command is not included, or if it is REMarked out, only critical errors received from the device(s) will be recorded.
Through judicious use of the LOG command and its associated SYS$LOG.ERR or ERROR.LOG file, almost any SCSI condition can be monitored and almost any error can be diagnosed.


List of Critical Errors

Jukebox Error Conditions:
· Error Initializing Robotics
· Error Replacing Disk
· Error Taking Inventory
· Error Flipping Disk
· Error Loading Medium
· Error Unloading Medium
· Error Mounting Medium
· Error Dismounting Medium
· Error Moving Slot to Slot
Drive Error Conditions:
· Error Formatting Medium
· Error Reading Capacity of Medium
· Error Erasing Medium
Partitioning Error Conditions:
· Error Writing Mark Sector
· Error Writing Top of Data Mark
· Error Writing Root Sector
· Error Writing Root Directory
· Error Writing Partition Sector
Generic Error Conditions:
· An Unknown Error Occurred
· Critical Error Occurred


Sample SYS$LOG.ERR or ERROR.LOG File Entry

The error/command entries in the SYS$LOG.ERR or ERROR.LOG file conform to the SCSI-2 specifications. Proper interpretation and analysis of these entries presume a familiarity with the SCSI specifications and parameters. No attempt is made here to provide a tutorial or otherwise instruct the user in the interpretation of the data presented. The user is instead referred to the SCSI specification as published in the industry, and to the specific hardware and software manuals for the SCSI device(s) under investigation.


The following is a breakdown of a sample error entry taken from an actual SYS$LOG.ERR or ERROR.LOG file.
*** Critical Error Occurred ***
Err = 0002 <C> CID/LUN = 02/00 Fri Jun 2 13:11:45 1995
CDB = 28 00 00 06 EF F1 00 00 01 00
RQS = 00 00 08 00 06 EF F1 0A 00 00 00 00 14 00 00 00
00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00

This rather imposing collection of hexadecimal numbers is easily understood when broken down one byte (or group) at a time.
Error Condition
An error message based on the nature of the error that occurred, is shown here. It can help the user in troubleshooting the problem.
*** Critical Error Occurred ***
Err = 0002 <C> CID/LUN = 02/00 Fri Jun 2 13:11:45 1995
CDB = 28 00 00 06 EF F1 00 00 01 00
RQS = F0 00 08 00 06 EF F1 0A 00 00 00 00 14 00 00 00
00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00

Sense Key Code:
The sense key code is the error code passed through the host adapter by the device generating the error. It is located in the CPU's AL register. It is one of the most important statistics in the SYS$LOG.ERR or ERROR.LOG.
*** Critical Error Occurred ***
Err = 0002 <C> CID/LUN = 02/00 Fri Jun 2 13:11:45 1995
CDB = 28 00 00 06 EF F1 00 00 01 00
RQS = F0 00 08 00 06 EF F1 0A 00 00 00 00 14 00 00 00
00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00

Supported Sense Key Codes:
00 No Sense: Indicates no specific sense key information, command successful.
02 Not Ready: The SCSI device is tested and returns a Not Ready Error.
03 Medium Error: Indicates unrecovered error condition probably caused by a medium flaw, or corrupt data error.
04 Hardware Error: Indicates unrecoverable hardware error while executing command, or during self test.
05 Illegal Request: Indicates illegal parameter in SCSI command descriptor block, or in the additional parameters supplied as data for some commands.
06 Unit Attention: Indicates removable medium may have been changed, or the target may have been reset since the last command was issued to that device.
07 WRITE Protect: Indicates a write command was attempted to a write-protected medium.
08 Blank Check: Indicates a blank sector (one on which no data has been previously been written).
09 Vendor Specific Error: Indicates an error occurred, the nature of which depends on the device manufacture's specifications.
10 Unknown Error: Indicates an error occurred, the nature of which is unknown.
0B Aborted Command: Indicates the device aborted the command.
Processor Carry Flag Status:
The processor carry flag status indicates whether or not a CPU carry has occurred.
*** Critical Error Occurred ***
Err = 0002 <C> CID/LUN = 02/00 Fri Jun 2 13:11:45 1995
CDB = 28 00 00 06 EF F1 00 00 01 00
RQS = F0 00 08 00 06 EF F1 0A 00 00 00 00 14 00 00 00
00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00

SCSI Address:
The SCSI address is the address of the SCSI target device generating the error.
*** Critical Error Occurred ***
Err = 0002 <C> CID/LUN = 02/00 Fri Jun 2 13:11:45 1995
CDB = 28 00 00 06 EF F1 00 00 01 00
RQS = F0 00 08 00 06 EF F1 0A 00 00 00 00 14 00 00 00
00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00

Date and Time Stamp
Indicates the date and time the error occurred.
*** Critical Error Occurred ***
Err = 0002 <C> CID/LUN = 02/00 Fri Jun 2 13:11:45 1995
CDB = 28 00 00 06 EF F1 00 00 01 00
RQS = F0 00 08 00 06 EF F1 0A 00 00 00 00 14 00 00 00
00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00

SCSI Command Descriptor Block:
The SCSI command descriptor block is the actual SCSI command descriptor block that was issued to the device in question and caused the error to be returned.
*** Critical Error Occurred ***
Err = 0002 <C> CID/LUN = 02/00 Fri Jun 2 13:11:45 1995
CDB = 28 00 00 06 EF F1 00 00 01 00
RQS = F0 00 08 00 06 EF F1 0A 00 00 00 00 14 00 00 00
00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00

SCSI Command Issued:
The SCSI-command issued byte contains the code for the SCSI command. As there are many SCSI command codes, only a subset of which apply to any given SCSI target device, the user is directed to the documentation for the particular device for command interpretation.
*** Critical Error Occurred ***
Err = 0002 <C> CID/LUN = 02/00 Fri Jun 2 13:11:45 1995
CDB = 28 00 00 06 EF F1 00 00 01 00
RQS = F0 00 08 00 06 EF F1 0A 00 00 00 00 14 00 00 00
00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00

Reserved:
This byte is reserved by the SCSI specification.
*** Critical Error Occurred ***
Err = 0002 <C> CID/LUN = 02/00 Fri Jun 2 13:11:45 1995
CDB = 28 00 00 06 EF F1 00 00 01 00
RQS = F0 00 08 00 06 EF F1 0A 00 00 00 00 14 00 00 00
00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00
Sector Number:
These bytes contain the number of the sector being accessed when the error occurred. If more than one sector was being accessed, this is the number of the first sector of the block of sectors being accessed.
*** Critical Error Occurred ***
Err = 0002 <C> CID/LUN = 02/00 Fri Jun 2 13:11:45 1995
CDB = 28 00 00 06 EF F1 00 00 01 00
RQS = F0 00 08 00 06 EF F1 0A 00 00 00 00 14 00 00 00
00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00

Reserved:
This byte is reserved by the SCSI specification.
*** Critical Error Occurred ***
Err = 0002 <C> CID/LUN = 02/00 Fri Jun 2 13:11:45 1995
CDB = 28 00 00 06 EF F1 00 00 01 00
RQS = F0 00 08 00 06 EF F1 0A 00 00 00 00 14 00 00 00
00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00

Number of Sectors:
This byte contains the number of sectors being accessed.
*** Critical Error Occurred ***
Err = 0002 <C> CID/LUN = 02/00 Fri Jun 2 13:11:45 1995
CDB = 28 00 00 06 EF F1 00 00 01 00
RQS = F0 00 08 00 06 EF F1 0A 00 00 00 00 14 00 00 00
00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00

Reserved:
This byte is reserved by the SCSI specification.
*** Critical Error Occurred ***
Err = 0002 <C> CID/LUN = 02/00 Fri Jun 2 13:11:45 1995
CDB = 28 00 00 06 EF F1 00 00 01 00
RQS = F0 00 08 00 06 EF F1 0A 00 00 00 00 14 00 00 00
00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00

Request Sense Information Packet:
The request sense information packet contains the error code, the segment number, the logical block address, the sense key and its ancillary codes, and command-specific information.
*** Critical Error Occurred ***
Err = 0002 <C> CID/LUN = 02/00 Fri Jun 2 13:11:45 1995
CDB = 28 00 00 06 EF F1 00 00 01 00
RQS = F0 00 08 00 06 EF F1 0A 00 00 00 00 14 00 00 00
00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00

Error Code:
This byte contains the error code returned:
*** Critical Error Occurred ***
Err = 0002 <C> CID/LUN = 02/00 Fri Jun 2 13:11:45 1995
CDB = 28 00 00 06 EF F1 00 00 01 00
RQS = F0 00 08 00 06 EF F1 0A 00 00 00 00 14 00 00 00
00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00

Segment Number:
This byte contains the segment number.
*** Critical Error Occurred ***
Err = 0002 <C> CID/LUN = 02/00 Fri Jun 2 13:11:45 1995
CDB = 28 00 00 06 EF F1 00 00 01 00
RQS = F0 00 08 00 06 EF F1 0A 00 00 00 00 14 00 00 00
00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00

Sense Key:
This byte contains the sense key:
*** Critical Error Occurred ***
Err = 0002 <C> CID/LUN = 02/00 Fri Jun 2 13:11:45 1995
CDB = 28 00 00 06 EF F1 00 00 01 00
RQS = F0 00 08 00 06 EF F1 0A 00 00 00 00 14 00 00 00
00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00

Logical Block Address:
These bytes contain the logical block address. A logical block is usually (but not necessarily) the same as a sector, in which case these bytes are identical to the sector number.
*** Critical Error Occurred ***
Err = 0002 <C> CID/LUN = 02/00 Fri Jun 2 13:11:45 1995
CDB = 28 00 00 06 EF F1 00 00 01 00
RQS = F0 00 08 00 06 EF F1 0A 00 00 00 00 14 00 00 00
00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00

Additional Sense Length:
This byte contains the additional sense length, when required.
*** Critical Error Occurred ***
Err = 0002 <C> CID/LUN = 02/00 Fri Jun 2 13:11:45 1995
CDB = 28 00 00 06 EF F1 00 00 01 00
RQS = F0 00 08 00 06 EF F1 0A 00 00 00 00 14 00 00 00
00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00

Command-Specific Information:
These bytes contain command-specific information, when required.
*** Critical Error Occurred ***
Err = 0002 <C> CID/LUN = 02/00 Fri Jun 2 13:11:45 1995
CDB = 28 00 00 06 EF F1 00 00 01 00
RQS = F0 00 08 00 06 EF F1 0A 00 00 00 00 14 00 00 00
00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00

Additional Sense Code:
This byte contains the additional sense code, when used.
*** Critical Error Occurred ***
Err = 0002 <C> CID/LUN = 02/00 Fri Jun 2 13:11:45 1995
CDB = 28 00 00 06 EF F1 00 00 01 00
RQS = F0 00 08 00 06 EF F1 0A 00 00 00 00 14 00 00 00
00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00

Additional Sense Code Qualifier:
This byte contains the additional sense code qualifier, when used.
*** Critical Error Occurred ***
Err = 0002 <C> CID/LUN = 02/00 Fri Jun 2 13:11:45 1995
CDB = 28 00 00 06 EF F1 00 00 01 00
RQS = F0 00 08 00 06 EF F1 0A 00 00 00 00 14 00 00 00
00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00

Reserved:
These bytes are reserved by the SCSI specification.
*** Critical Error Occurred ***
Err = 0002 <C> CID/LUN = 02/00 Fri Jun 2 13:11:45 1995
CDB = 28 00 00 06 EF F1 00 00 01 00
RQS = F0 00 08 00 06 EF F1 0A 00 00 00 00 14 00 00 00
00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00

- NOTE! After a write error, OCHKDSK should be executed to insure that new data pointers have been properly set. Subsequent write operations may continue to fail if the pointers are not updated.

 

 
 

Back To Top

HOME