Log Sense (4Dh)
Log Sense (4Dh) returns library error logs and statistics.
- PPC (Parameter Pointer Control - not supported)
-
Set this to 0.
- SP (Save Parameters - not supported)
-
Set this to 0.
- PC (Page Control)
-
The library accepts values of 0 or 1.
- Page Code
-
00h = List supported pages
07h = List last n error events page
2Eh = Informational Exceptions TapeAlert page (0 or 1 in the PC field)
- Parameter Pointer
-
Set this to 0.
- Allocation Length
-
The library transfers either the number of bytes specified by the Allocation Length field or all of the available log sense data, whichever is less. The page lengths are:
-
00h = List Supported pages—length is 7h
-
07h = List Last n Error Events page—length is 3C4h
-
2Eh = Informational Exceptions TapeAlert page—length is 144h
-
Supported Pages Page
The Supported Pages Page lists all the Log Sense page codes supported by the library.
Last n Errors Events Page
The Last n Errors Events page provides a list of the most recent errors events logged on the library. Each event is an ASCII string that includes a time stamp, a fault symptom code (FSC), and an optional mechanism. Each error event is 48 bytes long, and can contain up to 20 events. Time is in universal time.
Informational Exceptions TapeAlert Page
The library provides the Informational Exceptions TapeAlert page at a minimum of:
-
At the beginning of a write/read job occurring on a device inside the library, even if media is not loaded in that device
-
Immediately after a fatal error during a write/read job occurring on a device inside the library
-
At the end of a write/read job occurring on a device inside the library
Though not mandatory, the host software may also poll the Log Sense page every 60 seconds while the tape library is idle. Each flag will be cleared to zero at library power on, when the TapeAlert Log page is read, or on a reset. The TapeAlert page returns A4h bytes in this format. The n represents a TapeAlert flag: currently, all values are set to default. Unsupported flags are also returned as defaults.
- Parameter Code
-
2-byte filed that represents the TaptAlert flag number.
- DU (Disable Update)
-
0 = the target updates the log parameter instead of the initiator
- DS (Disable Save)
-
1 = saving the log is not supported
- TSD (Target Save Disable)
-
Always set to 0.
- ETC (Enable Threshold Comparison)
-
Always set to 0
- TMC (Threshold Met Criteria)
-
Always set to 0.
- LBIN (Not used)
-
Library returns 0.
- LP (List Parameter)
-
0 = log parameter is a data counter
- Parameter Length
-
Always set to 0x01. All are 1-byte flags.
- Flag
-
0x01 = the flag that the Parameter Code points to is active. All other values are off.
TapeAlert Flags
Flags are in sequential order, have valid values of 0 (off) or 1 (on), and reports all 32.
Type codes indicate C (critical), W (warning), and I (informational)
| Code | Flag Name | Type |
|---|---|---|
|
0001h |
Media changer/data transfer device communication fault. Set when the operator removes a tape drive that has an assigned SCSI Element Address. If the library is partitioned, the tape alert is only set in the affected partition. |
C |
|
0002h |
Hardware Warning |
W |
|
0003h |
Mechanical Hardware Fault |
C |
|
0004h |
Hardware Fault |
C |
|
0005h |
Diagnostics Requested |
I |
|
0006h |
Host Interface Failure |
C |
|
0007h |
Predictive Failure |
W |
|
0008h |
Preventative Maintenance |
W |
|
0009h |
Humidity Limits |
C |
|
000Ah |
Temperature Limits |
C |
|
000Bh |
Voltage Limits |
C |
|
000Ch |
Unexpected Volume |
W |
|
000Dh |
Pick Retry |
W |
|
000Eh |
Place Retry |
W |
|
000Fh |
Load Retry |
W |
|
0010h |
Door Open |
C |
|
0011h |
Import/Export Element Fault |
C |
|
0012h |
Magazine Inaccessible |
C |
|
0013h |
Obsolete |
|
|
0014h |
Obsolete |
|
|
0015h |
Media Changer Offline |
I |
|
0016h |
Data Transfer Device Offline |
I |
|
0017h |
Barcode Scan Retry |
W |
|
0018h |
Inventory Information Inconsistent |
C |
|
0019h |
Media Changer Illegal Operation |
W |
|
001Ah |
Multi-port Interface Error on a Primary Port |
W |
|
001Bh |
Cooling Fan Failure |
W |
|
001Ch |
Power supply. Set when an operator either pulls a power supply or a power supply power cord. |
W |
|
001Dh |
Power Consumption |
W |
|
001Eh |
Pass-through Mechanism Failure |
C |
|
001Fh |
Obsolete |
|
|
0020h |
Unreadable Bar Code Labels |
I |