Quantum SuperLoader User's Guide

ATL SuperLoader™ DLT and ATL
SuperLoader™ LTO
Software Interface
Guide
81-60220-01 A02
Quantum ATL SuperLoader DLT and ATL SuperLoader LTO Software Interface Guide, 81-60220-01 A02, March 2003. Made in USA.
COPYRIGHT STATEMENT
© 2003 Quantum Corporation. All rights reserved.
Your right to copy this manual is limited by copyright law. Making copies or adaptations without prior written authorization of Quantum Corporation is prohibited by law and constitutes a punishable violation of the law.
TRADEMARK STATEMENT
DLTtape, Super DLTtape, the Super DLTtape logo, and SuperLoader are trademarks, and Quantum and the Quantum logo are registered trademarks, of Quantum Corporation.
Other trademarks are the property of their respective owners.
6207947-00cN 98
Contents
Intended Audience...............................................................................xv
Purpose .................................................................................................xvi
Organization.........................................................................................xvi
Document Conventions.................................................................... xvii
Chapter 1 Theory of Operation 1
SuperLoader DLT...................................................................................2
SuperLoader LTO...................................................................................2
Medium Changer Elements .................................................................. 2
Medium Transport Element ...........................................................3
Data Transfer Element..................................................................... 3
Storage Elements.............................................................................. 3
Events .......................................................................................................3
Power Cycle ......................................................................................4
SuperLoader Offline ........................................................................4
Magazine Insertion/Removal........................................................4
Maximum Temperature Exceeded................................................ 5
Automatic Drive Cleaning .................................................................... 5
Element Status Information............................................................6
Automatic Cleaning Operation......................................................6
Quantum ATL SuperLoader Software Interface Guide iii
Chapter 2 Messages 9
Message Format......................................................................................9
Supported SCSI Messages...................................................................13
Abort (06h) ......................................................................................13
Bus Device Reset (0Ch)..................................................................13
Command Complete (00h) ...........................................................14
Disconnect (04h)............................................................................14
Identify (80h-FFh) ..........................................................................15
Ignore Wide Residue (23h) ........................................................... 16
Initiator Detected Error (05h) .......................................................17
Linked Command Complete (0Ah).............................................18
Linked Command Complete, Flag (0Bh)...................................19
Message Parity Error (09h) ........................................................... 19
Message Reject (07h).....................................................................19
No Operation (08h)........................................................................20
Restore Pointers (03h)....................................................................20
Save Data Pointer (02h).................................................................20
Synchronous Data Transfer Request (01h).................................21
Wide Data Transfer Request Extended Message (03h) ............23
Chapter 3 Media Changer Commands 27
Overview of Command and Status Processing................................27
Media Changer Command Descriptions ..........................................29
Initialize Element Status Command (07h) ........................................31
Inquiry Command (12h)......................................................................32
Standard Inquiry Data Page .........................................................33
Vital Product Data Page................................................................38
Command Support Data...............................................................42
Load Unload Command (1Bh) ........................................................... 45
Log Sense Command (4Dh) ................................................................46
Supported Pages Log Page (Page 00h)........................................49
Last n Error Events Page (07h).....................................................50
TapeAlert Page (2Eh).....................................................................52
Move Statistics Page (30h) ............................................................54
Hard/Soft Error Statistics Page (31h) .........................................56
Device Wellness Page (33h)..........................................................59
Device Status Page (3Eh)...............................................................62
iv Quantum ATL SuperLoader Software Interface Guide
Mode Select (6) / (10) Command (15h / 55h).................................. 66
Mode Parameter List ..................................................................... 68
Mode Sense (6) / (10) Command (1Ah/ 5Ah) ................................. 74
Mode Sense Data Headers............................................................76
Mode Sense Mode Pages............................................................... 78
TapeAlert Page (1Ch) .................................................................... 79
Element Address Assignment Page............................................82
Transport Geometry Parameters Page........................................85
Device Capabilities Page...............................................................86
Move Medium Command (A5h)........................................................89
Persistent Reserve In Command (5Eh)..............................................91
Persistent Reserve Out Command (5Fh)......................................... 101
Position to Element Command (2Bh) .............................................. 116
Prevent/Allow Medium Removal (1Eh) ........................................ 118
Read Buffer Command (3Ch) ...........................................................120
Combined Header and Data Mode (000b) ...............................122
Data Mode (0010b)....................................................................... 123
Descriptor Mode (0011b)............................................................. 123
Read Data from Echo Buffer (1010b).........................................123
Echo Buffer Descriptor Mode (1011b).......................................124
Read Element Status Command (B8h) ............................................126
Element Status Data..................................................................... 128
Element Status Page ....................................................................130
Medium Transport Element Descriptor ................................... 131
Storage Element Descriptor........................................................ 134
Import/Export Element Descriptor ..........................................135
Data Transfer Element Descriptor.............................................137
Release Element (10) Command (57h).............................................140
Release Unit (6) Command (17h) .....................................................143
Report Device Identifier Command (A3h) ..................................... 145
Report LUNS Command (A0h)........................................................148
Request Sense Command (03h)........................................................151
Reserve Element (10) Command (56h)............................................160
Reserve Element (6) Command (16h)..............................................163
Send Diagnostic Command (1Dh) ...................................................166
Set Device Identifier Command (A4h)............................................ 168
Test Unit Ready Command (00h).....................................................170
Quantum ATL SuperLoader Software Interface Guide v
Write Buffer Command (3Bh)...........................................................171
Write Combined Header and Data Mode (0000b) .................. 172
Write Data Mode (0010b)............................................................172
Download Microcode Mode (0100b).........................................173
Download Microcode and Save Mode (0101b)........................173
Write Data to Echo Buffer (1010b).............................................173
vi Quantum ATL SuperLoader Software Interface Guide
Figures
Figure 1 Extended Message ............................................................ 12
Figure 2 Identify Message...............................................................15
Figure 3 Ignore Wide Residue Message........................................17
Figure 4 Synchronous Data Transfer Request Message .............21
Figure 5 Wide Data Transfer Request Message ...........................24
Figure 6 Initialize Element Status Command ..............................31
Figure 7 Inquiry Command ............................................................ 32
Figure 8 Inquiry Command ............................................................ 33
Figure 9 Standard Inquiry Data (LTO)..........................................34
Figure 10 Standard Inquiry Data (DLT)..........................................35
Figure 11 Supported Vital Product Data.........................................39
Figure 12 Unit Serial Number Page (80h).......................................39
Figure 13 Device Identification Page (83h).....................................40
Figure 14 Identifier Descriptor .........................................................41
Figure 15 Command Support Data Page ........................................ 43
Figure 16 Load Unload Command Descriptor Block....................45
Quantum ATL SuperLoader Software Interface Guide vii
Figure 17 LOG SENSE Command Descriptor Block ..................... 46
Figure 18 Supported Pages Page......................................................49
Figure 19 Last n Error Events Log Sense Header ..........................50
Figure 20 Format for Last n Error Events Log Sense.....................51
Figure 21 TapeAlert Log Sense Header Format.............................52
Figure 22 TapeAlert Page Log Parameters Format .......................53
Figure 23 Move Statistics Format.....................................................54
Figure 24 Hard/Soft Move Error Statistics Format.......................57
Figure 25 Device Wellness Log Sense Header ...............................59
Figure 26 Device Wellness Log Sense (0000h-000Fh)....................60
Figure 27 Log Parameters for Device Wellness Log Sense...........61
Figure 28 Device Status Log Sense Header ....................................62
Figure 29 Parameters for Device Status Log Sense Page.............. 63
Figure 30 Device Status Log Sense Page (0001h) ........................... 64
Figure 31 Mode Select (6) Command Descriptor...........................67
Figure 32 Mode Select (10) Command Descriptor.........................67
Figure 33 Mode Select (6) Mode Parameter List............................68
Figure 34 Mode Select (10) Mode Parameter List.......................... 69
Figure 35 Mode Select (6) Parameter Header.................................70
Figure 36 Mode Select (10) Parameter Header...............................70
Figure 37 Mode Select Parameter.....................................................71
Figure 38 Mode Select Page Descriptor...........................................72
Figure 39 Mode Sense (6) Command Descriptor Block ................74
Figure 40 Mode Sense (10) Command Descriptor Block ..............75
Figure 41 Mode Sense (6) Data Header...........................................77
Figure 42 Mode Sense (10) Data Header.........................................77
Figure 43 Mode Sense Page Descriptor...........................................78
viii Quantum ATL SuperLoader Software Interface Guide
Figure 44 TapeAlert Page Format Descriptor ................................ 79
Figure 45 Element Address Assignment Page...............................83
Figure 46 Transport Geometry Parameters Page...........................85
Figure 47 Transport Geometry Descriptor ..................................... 86
Figure 48 Device Capabilities Page..................................................87
Figure 49 Move Medium Descriptor Block .................................... 89
Figure 50 Persistent Reserve In Descriptor Block..........................91
Figure 51 Read Keys Parameters......................................................93
Figure 52 Read Reservations Parameters........................................95
Figure 53 Persistent Reserve In Read Reservations.......................97
Figure 54 Persistent Reserve Out Descriptor ...............................102
Figure 55 Persistent Reserve Out Command ............................... 102
Figure 56 Persistent Reserve Out Parameter List ........................ 112
Figure 57 Position to Element Descriptor..................................... 116
Figure 58 Prevent/Allow Medium Removal ...............................118
Figure 59 Read Buffer Command Descriptor Block.................... 120
Figure 60 Read Buffer Header ........................................................ 122
Figure 61 Read Buffer Descriptor...................................................123
Figure 62 Echo Buffer Descriptor...................................................124
Figure 63 Read Element Status Descriptor ................................... 126
Figure 64 Element Status Data Header .........................................128
Figure 65 Element Status Page .......................................................130
Figure 66 Data................................................................................... 131
Figure 67 Medium Transport Element Descriptor ......................132
Figure 68 Storage Element Descriptor...........................................134
Figure 69 Import/Export Element Descriptor .............................136
Figure 70 Data Transfer Element Descriptor................................138
Quantum ATL SuperLoader Software Interface Guide ix
Figure 71 Release (10) Descriptor Block........................................140
Figure 72 Release (10) ID Only Parameter List ............................142
Figure 73 Release Unit (6) Descriptor Block (LTO) .....................143
Figure 74 Release Unit (6) Descriptor Block (DLT) .....................144
Figure 75 Report Device Identifier Descriptor .............................145
Figure 76 Report Device Identifier.................................................146
Figure 77 Report LUNS Descriptor................................................148
Figure 78 LUN Reporting Parameter List.....................................149
Figure 79 Request Sense Command Descriptor Block................151
Figure 80 Request Sense Command Data .....................................151
Figure 81 Request Sense ..................................................................152
Figure 82 Reserve Element (10) Descriptor ..................................160
Figure 83 Reserve (10) ID Only Parameter List............................162
Figure 84 Reserve Element (6) Descriptor (LTO).........................163
Figure 85 Reserve Element (6) Descriptor (DLT).........................164
Figure 86 Send Diagnostic Descriptor...........................................166
Figure 87 Set Device Identifier Descriptor....................................168
Figure 88 Set Device Identifier Parameter List.............................169
Figure 89 Test Unit Ready Descriptor ........................................... 170
Figure 90 Write Buffer Descriptor..................................................171
x Quantum ATL SuperLoader Software Interface Guide
Tables
Table 1 Message Format ................................................................ 10
Table 2 Supported Messages.........................................................10
Table 3 Extended Message ............................................................ 12
Table 4 Response to Disconnect Message ...................................15
Table 5 Identify Message...............................................................16
Table 6 Ignore Wide Residue........................................................17
Table 7 Response to Initiator Detected Error..............................18
Table 8 Transfer Rates.................................................................... 23
Table 9 Supported Media Changer Commands ........................28
Table 10 Standard Inquiry Data (LTO and DLT)......................... 36
Table 11 Unit Serial Number Page Field Descriptions................ 40
Table 12 Identifier Descriptor Field Descriptions ........................ 41
Table 13 Supported Identifiers ....................................................... 42
Table 14 Command Support Data Page ........................................43
Table 15 Unload Command Descriptor Block..............................45
Table 16 Log Sense Command Descriptor Block ......................... 47
Quantum ATL SuperLoader Software Interface Guide xi
Table 17 Last n Error Events Log Sense Header ..........................50
Table 18 Parameters Last n Error Events Log Sense....................51
Table 19 TapeAlert Log Sense Header Field Descriptions .........53
Table 20 TapeAlert Page Log Parameters.....................................54
Table 21 Move Statistics................................................................... 56
Table 22 Hard/Soft Error ................................................................58
Table 23 Device Wellness Log Sense Header ...............................59
Table 24 Device Status Log Sense Header ....................................63
Table 25 Parameters for Device Status Log Sense Page ..............63
Table 26 Device Status Log Sense (0001h)..................................... 65
Table 27 Mode Select (6)/(10) Command Descriptor.................. 68
Table 28 Mode Select Parameter List .............................................69
Table 29 Mode Select Parameter Header ......................................71
Table 30 Mode Select Parameter Block..........................................72
Table 31 Mode Select Page Descriptor...........................................73
Table 32 Mode Sense Command Descriptor Block......................75
Table 33 Mode Sense Data Heade ..................................................78
Table 34 Mode Sense Page Descriptor...........................................79
Table 35 TapeAlert Page Format Descriptor ................................80
Table 36 Element Address Assignment Page ...............................84
Table 37 Transport Geometry Parameters Page...........................86
Table 38 Device Capabilities Page.................................................. 88
Table 39 Move Medium Command ...............................................90
Table 40 Persistent Reserve In Command..................................... 92
Table 41 Read Keys Parameters...................................................... 94
Table 42 Read Reservations Parameters........................................96
Table 43 Persistent Reserve In Read Reservations Descriptor ...97
xii Quantum ATL SuperLoader Software Interface Guide
Table 44 Persistent Reservation Type Codes................................ 99
Table 45 Persistent Reserve Out Command Service Action.....105
Table 46 Persistent Reservation Type Codes.............................. 110
Table 47 Persistent Reserve Out Parameter List ........................113
Table 48 Device Server Interpretation of Service and Scope
Value.................................................................................115
Table 49 Position to Element Command ..................................... 117
Table 50 Prevent/Allow Medium Removal Command
Descriptor Block..............................................................119
Table 51 Read Buffer Command Descriptor Block.................... 121
Table 52 Read Buffer Header........................................................122
Table 53 Echo Buffer Descriptor...................................................125
Table 54 Read Element Status Command Descriptor Block.....127
Table 55 Element Status Data .......................................................129
Table 56 Medium Transport Element Descriptor ......................133
Table 57 Storage Element Descriptor...........................................135
Table 58 Import/Export Element Descriptor ............................. 137
Table 59 Data Transfer Element Descriptor................................139
Table 60 Release (10) Command...................................................141
Table 61 Report Device Identifier Command Descriptor
Block.................................................................................. 146
Table 62 Report Device Identifier Parameter Data....................147
Table 63 Report LUNS Command Descriptor Block................. 149
Table 64 Request Sense Data.........................................................153
Table 65 Supported Sense Keys for Request Sense....................155
Table 66 Supported ASC / ASCQ (Hex) for Request Sense..... 156
Table 67 Reserve Element (10) Command.................................. 161
Table 68 Send Diagnostic Command Data .................................166
Quantum ATL SuperLoader Software Interface Guide xiii
Table 69 Set Device Identifier Command Descriptor Block.....169
Table 70 Set Device Identifier Parameter List.............................169
Table 71 Write Buffer Command Data........................................172
xiv Quantum ATL SuperLoader Software Interface Guide

Preface

This section outlines the scope and contents of the Quantum ATL SuperLoader™ Software Interface Guide. It contains information about the intended audience, purpose, organization, and document conventions.

Intended Audience 0

This interface guide is a written for the following audiences:
Original Equipment Manufacturers (OEMs) that integrate the
Quantum ATL SuperLoader into a system or subsystem
System integrators that are responsible for the SCSI interface
End users that operate and troubleshoot the SuperLoader
Quantum ATL SuperLoader Software Interface Guide xv
Preface Purpose

Purpose 0

This interface guide describes the procedures and issues involved in the development of software applications and utilities to communicate with the Quantum ATL SuperLoader.
SCSI interfaces
SCSI Messages
Media Changer Commands

Organization 0

This reference manual is organized as follows:
Chapter 1, Theory of Operation the SuperLoader models, media changer elements, events, and automatic drive cleaning.
Chapter 2, Messages the SuperLoader.
Chapter 3, Media Changer Commands protocol features implemented in the media changer.
describes the SCSI messages supported by
describes differences between
describes the SCSI
xvi Quantum ATL SuperLoader Software Interface Guide
Preface

Document Conventions

Document Conventions 0
This manual uses the following conventions to designate specific elements:
Element Convention Example
Abbreviations Lowercase, except where standard usage
requires uppercase
Acronyms Uppercase SCSI
Binary Notation Number followed by lowercase b 101b
Commands Uppercase (unless case-sensitive) FORMAT UNIT
Decimal Notation Number followed without suffix 101
Field Initial Caps (unless case-sensitive) Application Data
Hexadecimal Notation Number followed by h 101h
Sense Key Uppercase (unless case-sensitive) ILLEGAL REQUEST
Mb (megabits) MB (megabytes)
Quantum ATL SuperLoader Software Interface Guide xvii
Preface Document Conventions
xviii Quantum ATL SuperLoader Software Interface Guide
Chapter 1

1Theory of Operation

The SuperLoader products are an integration of two separate devices, a tape drive and a media changer. The media changer consists of all the mechanics and electronics required to store and move tape cartridges while the tape drive provides the read/write functionality.
Each device has a separate interface for communication to the host. The SCSI command set supported by the tape drive is documented separately. The SCSI command set supported by the media changer device is detailed in xxx.
The SuperLoader is fully compliant with the ANSI SCSI-2 standard for tape drive and media changer devices and implements many optional features.
The SuperLoader does not act as an initiator on the SCSI bus. Therefore, it does not generate unsolicited interrupts to the bus, initiate its own SCSI commands, or assert bus reset.
Quantum ATL SuperLoader Software Interface Guide 1
Chapter 1 Theory of Operation SuperLoader DLT

SuperLoader DLT 1

The SuperLoader DLT family of products utilize a single SCSI ID and two logical units. The tape drive always resides at logical unit 0 and the media changer resides at logical unit 1. The SuperLoader supports narrow and wide, synchronous and asynchronous data transfers. Both LVD and single-ended versions are available.

SuperLoader LTO 1

The SuperLoader LTO family of products utilize two separate SCSI IDs. The tape drive and media changer each reside on a unique ID. The media changer device supports narrow and wide, asynchronous data transfers only. The tape drive device supports narrow and wide, synchronous and asynchronous data transfers.

Medium Changer Elements 1

The medium changer command set accesses the address space for the set of physical locations and mechanisms with the SuperLoader. This guide uses the SCSI-2 term element to refer to one member of the SuperLoader address space. Each element is a discrete physical entity that can hold a single tape cartridge. Each element within a SuperLoader is represented by a unique 16-bit element address. The SuperLoader consists of the following medium changer elements.
Medium transport element
Storage elements
Data transfer elements
2 Quantum ATL SuperLoader Software Interface Guide
Chapter 1 Theory of Operation

Events

You can issue the Mode Sense command to determine the SuperLoader configuration. You can also use this command to determine the first address and the number of elements of each type.
Although the SuperLoader does have a mailslot, it is not reported as an Import/Export element for use by the host system. It is strictly to allow users to access tape cartridges using the front panel or On-board Remote Management tool.

Medium Transport Element

Data Transfer Element

Storage Elements1

This mechanism can hold a single cartridge and is considered a
1
single medium transport element. It is used to move media between elements within the SuperLoader.
The SuperLoader is configured with a single tape drive.
1
All of the storage elements within the SuperLoader are contained within removable magazines. There are two magazines which hold eight tape cartridges each, for a total of 16 storage elements. Since the magazines are removable, a user may insert or remove a magazine at any time. Because of this, the SuperLoader always reports 16 storage elements, regardless of how many magazines are currently installed. When a magazine is removed, the corresponding storage elements are reported as inaccessible. This is done via the Read Element Status–Storage Element Descriptor on page 134–byte 2, bit 3.
Events 1
Events are system conditions created y operator actions or system failures. These events are recorded in sense data for the SCSI host to retrieve via the Request Sense command.
Quantum ATL SuperLoader Software Interface Guide 3
Chapter 1 Theory of Operation Events

Power Cycle 1

SuperLoader Offline

When the SuperLoader is powered-on, it goes through an initialization sequence, during which it:
Resets and initializes all hardware
Responds to SCSI commands which do not require movement
Responds to Test Unit Read and all movement type comands with a not ready, initialization in progress check condition (SK=02 ASC=29 ASCQ=02).
When the power on initialization is complete, it:
Generates a Power On/Reset Occurred event (SK=6 ASC=29 ASCQ=02)
If initialization is sucessful, it generates a note ready to ready transition (SK=6 ASC=28 ASCQ=00), otherwise, failure sense data is set accordingly.
When a user accesses the SuperLoader via the front panel or On-
1
board Remote Management in such a way that would cause conflict with a SCSI command, the SuperLoader is put into an offline state. If a SCSI command is received while in this offline state, a not ready check condition is reported (SK=01 ASC=04 ASCQ=07).

Magazine Insertion/ Removal

The SuperLoader must be powered-on with at least one magazine, otherwise a check condition is reported (SK=-2 ASC=04
1
ASCQ=03).
While the system is online, the user may remove a magazine blank and replace it with a magazine. The SuperLoader will calibrate the newly installed magazine and check the presence of tape cartridges in each of the storage elements. While this inventory is in progress, the SuperLoader LTO will report a not ready check condition (SK=02 ASC=04 ASCQ=01). The SuperLoader DLT does not provide any indication that the operation is in progress. Once the inventory is complete, all SuperLoaders report a unit attention (SK=06 ASC=3B ASCQ=13).
4 Quantum ATL SuperLoader Software Interface Guide
Chapter 1 Theory of Operation

Automatic Drive Cleaning

Similarly, while a magazine is in the process of being removed, a not ready check condition is reported (SK=02 ASC=04 ASCQ=07). Once the operation is complete, by replacing the magazine with a blank, a unit attention is reported (SK=06 ASC=3B ASCQ=12).
While one or both of the magazine bays are open, a not ready check condition is reported (SK=02 ASC=04 ASCQ=03).

Maximum Temperature Exceeded

The SuperLoader monitors the ambient temperature within the system. If the temperature exceeds the maximum safe temperature
1
for the media, the SuperLoader will disable all movement until the temperature decreases below a safe threshold. While the temperature remains excessive, SCSI commands that require movement will fail (SK=04 ASC=0B ASCQ=01).
Automatic Drive Cleaning 1
There are two modes of automatic drive cleaning support available:
Host-initiated cleaning
SuperLoader managed cleaning
Both modes provide automatic cleaning of the drive, but the first is managed by the host and the second is managed by the SuperLoader. These two modes are configured separately, and only one should be enabled at any given time.
When automatic drive cleaning of the drive is enabled, either the host of the SuperLoader is responsible for all cleaning functions such as:
Detecting when a drive requires cleaning
Tracking and selecting cleaning cartridges
Moving a cleaning cartridge to the drive
Quantum ATL SuperLoader Software Interface Guide 5
Chapter 1 Theory of Operation Automatic Drive Cleaning
Determining when a cleaning cartridge has used all of its
By default, the SuperLoader is configured to allow for host­initiated cleaning. If automatic cleaning is disabled from the host, the SuperLoader can be configured to manage the automatic cleaning of the drive. This is done by enabling the “Auto Clean” function. Please refer to the Quantum ATL SuperLoader Automated Tape Library User Manual for information on how this is done.
Note: There is no way for the host and SuperLoader to know
In host-initiated cleaning mode, the host tracks all cleaning cartridges and their use. When the SuperLoader Auto Clean feature is enabled, a “cleaning slot” is allocated and the cleaning cartridge is stored in this storage element. The SuperLoader assumes that any cartridge stored in this location is a cleaning cartridge and will attempt to use it as such.
available cleaning cycles
how the other is configured with respect to automatic drive cleaning. It is up to the user to make sure only one is enabled.
The SuperLoader does not keep track of the number of times a cleaning tape is used. Instead, it relies on the tape drive to report when the tape has expired. When this happens, the superLoader will notify the user via the front panel. The Auto Clean function is automatically disabled until the user inserts a new cleaning tape and re-enables the feature.

Element Status Information

When the SuperLoader Auto Clean feature is enabled, the
1
allocated storage element is reported as inaccessible to the host. This is done by setting the access bit to 0 in the Read Element Status Storage Element Descriptor page.

Automatic Cleaning Operation

when the SuperLoader Auto Clean feature is enabled, the SuperLoader checks if the drive needs cleaning after each
1
successful move from the drive. Therefore, each time the drive is unloaded, it is checked.
6 Quantum ATL SuperLoader Software Interface Guide
Chapter 1 Theory of Operation
Automatic Drive Cleaning
The movement of the cleaning tape is handled differently depending on the SuperLoader model.
SuperLoader DLT 1
If the move command, that unloaded the drive, was initiated from SCSI, the cleaning tape is moved from its storage slot, to the drive, the cleaning is performed and the cleaning tpae is returned to its storage slot, before command complete status is returned to the SCSI host. If an unrecoverable error occrus when moving a cleaning cartridge that prevents a subsequent host initiated command from completing, a check condition will be set in the returned status byte and sense data is set appropriately.
SuperLoader LTO 1
If the move command that unloaded the drive was initiated from SCSI, command complete is returned to the host when the move completes. The cleaning tape is then moved from its storage slot to the drive. The cleaning is performed and once complete, the cleaning tape is returned to its stoage location. If a SCSI command is received during this cleaning process, a not ready check condition is reported (SK=-2 ASC=30 ASCQ=03).
Quantum ATL SuperLoader Software Interface Guide 7
Chapter 1 Theory of Operation Automatic Drive Cleaning
8 Quantum ATL SuperLoader Software Interface Guide
Chapter 2

2Messages

The SCSI message system allows communication between an initiator and the SuperLoader for interface management and command qualification. Messages can be originated by either the initiator or the SuperLoader. This section contains a detailed description of the messages supported by the SuperLoader.

Message Format 2

A message can be one or more bytes in length. One or more messages can be sent during a single MESSAGE phase, but a message cannot be split over MESSAGE phases. The initiator is required to end the MESSAGE OUT phase (by negating ATN) when it sends certain messages that are identified in table 1
When a connection to the SuperLoader is established, for example the SuperLoader is selected with ATN asserted, the first message byte passed by the initiator must be either an IDENTIFY, ABORT, or BUS DEVICE RESET message. If not, the SuperLoader discards the message, saves no status information, and goes to the BUS FREE phase.
Quantum ATL SuperLoader Software Interface Guide 9
.
Chapter 2 Messages Message Format
If an initiator supplies an unsupported message, for example, COMMAND COMPLETE or a reserved or undefined message code, the SuperLoader returns a MESSAGE REJECT message and continues where it left off, possibly returning to MESSAGE OUT if ATN is raised.
Table 1 Message Format
The first byte of the message, as defined in table 1
, determines the
format of the message.
Message Code Message
00h One-byte message (COMMAND COMPLETE)
01h Extended message
02h – 1Fh One-byte message
20h – 2Fh Two-byte message
40h – 7Fh Reserved
80h – FFh One-byte message (IDENTIFY)
The SuperLoader supports the messages listed in table 2. The message code and the direction of the message flow is also included in the table (In = target to initiator, Out = initiator to target).
Table 2 Supported Messages
10 Quantum ATL SuperLoader Software Interface Guide
Message Message Code Direction
ABORT 06h Out
BUS DEVICE RESET 0Ch Out
COMMAND COMPLETE 00h In
DISCONNECT 04h In Out
Chapter 2 Messages
Message Format
Message Message Code Direction
EXTENDED MESSAGE (Synchronous Data and Wide Data Transfer Requests)
IDENTIFY 80h – FFh In Out
IGNORE WIDE RESIDUE 23h In
INITIATOR DETECTED ERROR
LINKED COMMAND COMPLETE
LINKED COMMAND COMPLETE (with flag)
MESSAGE PARITY ERROR 09h Out
MESSAGE REJECT 07h In Out
NO OPERATION 08h Out
RESTORE POINTERS 03h In
SAVE DATA POINTER 02h In
*
01h In Out
05h Out
0Ah In
0Bh In
*
Extended message (figure 1).
Two-byte messages consist of two consecutive bytes. The value of the first byte, as defined in table 1
, determines which message is to be transmitted. The second byte is a parameter byte that is used as defined in the message description.
A value of 1 in the first byte indicates the beginning of a multiple­byte extended message. The minimum number of bytes sent for an extended message is three. The extended message format is shown in figure 1
Quantum ATL SuperLoader Software Interface Guide 11
and the data fields are described in table 3.
Chapter 2 Messages Message Format
Figure 1 Extended Message
Bit Byte76543210
0
1
2
3 to n-1
Table 3 Extended Message
Field Description
Extended Message Length
This field specifies the length, in bytes, of the Extended Message Code plus the Extended Message Arguments that follow. Therefore, the total length of the message is equal to the Extended Message Length plus 2.
A value of 0 for the Extended Message Length indicates that 256 bytes follow.
Extended Message (01h)
Extended Message Length
Extended Message Code
Extended Message Arguments
Extended Message Code The SuperLoader supports the following Extended Messages:
01h SYNCHRONOUS DATA TRANSFER REQUEST 03h WIDE DATA TRANSFER REQUEST
12 Quantum ATL SuperLoader Software Interface Guide
Chapter 2 Messages

Supported SCSI Messages

Supported SCSI Messages 2
Following are descriptions of each of the messages supported by the SuperLoader.

Abort (06h) 2

Bus Device Reset (0Ch)

2
This message is sent from the initiator to the target to clear the current I/O process on the selected unit. The target goes directly to the BUS FREE phase after successful receipt of this message. Current settings of MODE SELECT parameters and reservations are not affected. Commands, data, and status for other initiators are not affected.
This message can be sent to a logical unit that is not currently performing an operation for the initiator. If no unit has been selected, the target goes to BUS FREE phase and no commands, data, or status on the target are affected.
If a command that causes movement of the media changer has started, the movement will complete and STATUS will not be sent to the initiator.
The BUS DEVICE RESET message is sent from an initiator to direct the SuperLoader to clear all I/O processes on the drive. The message causes the SuperLoader to execute a hard reset, leaving it as if a Bus Reset had occurred.
The SuperLoader creates a Unit Attention condition for all initiators after accepting and processing a Bus Device Reset message. The additional sense code is set to POWER ON, RESET, or BUS DEVICE RESET OCCURRED.
If a command that causes movement of the media changer has started, the movement will complete and STATUS will not be sent to the initiator.
Quantum ATL SuperLoader Software Interface Guide 13
Chapter 2 Messages Supported SCSI Messages

Command Complete (00h)

Disconnect (04h) 2

2
The COMMAND COMPLETE message is sent by the SuperLoader to an initiator to indicate that an I/O process has completed and that valid status has been sent to the initiator. After successfully sending this message, the SuperLoader goes to the BUS FREE phase by releasing the BSY signal. The SuperLoader considers the message transmission successful when it detects the negation of ACK for the COMMAND COMPLETE message with the ATN signal false. If a COMMAND COMPLETE message is received by the SuperLoader, it is handled as an illegal message: the SuperLoader returns MESSAGE REJECT and enters its STATUS phase, reporting CHECK CONDITION with the sense key set to COMMAND ABORTED.
The DISCONNECT message is sent from the SuperLoader to inform the initiator that the present connection is going to be broken, such as the SuperLoader plans to disconnect by releasing the BSY signal, and a later reconnect will be required to complete the current I/O process. The message does not cause the initiator to save the data pointer. After sending the message, the SuperLoader goes to the BUS FREE phase by releasing the BSY signal.
The DISCONNECT message can also be sent by the initiator to tell the SuperLoader to suspend the current phase and disconnect from the bus. The SuperLoader’s response to and its handling of a DISCONNECT message are based on when, in the I/O process, the initiator introduces the DISCONNECT message. Table 7 summarizes the SuperLoader’s response.
14 Quantum ATL SuperLoader Software Interface Guide
Chapter 2 Messages
Supported SCSI Messages
Table 4 Response to Disconnect Message
BUS Phase SuperLoader Response
SELECTION The SuperLoader discards the DISCONNECT message and goes to BUS
FREE.
COMMAND The SuperLoader discards the DISCONNECT message and goes to BUS
FREE. The ATTENTION request is ignored while the Command Descriptor Block is fetched. The SuperLoader does not switch to MESSAGE OUT until the current DMA completes.
DATA The ATTENTION request is ignored while the current data transfer
completes; that is, the SuperLoader does not switch to MESSAGE OUT until after the current DMA completes. The SuperLoader returns a MESSAGE REJECT message and responds with CHECK CONDITION status, indicating the command aborted because of an invalid message.
STATUS The SuperLoader sends a MESSAGE REJECT message, then sends
COMMAND COMPLETE.
MESSAGE IN The SuperLoader sends a MESSAGE REJECT message and switches to the
BUS FREE phase.
The IDENTIFY message is sent by either the initiator or the

Identify (80h-FFh)2

SuperLoader to establish or re-establish the physical connection path between an initiator and target for a particular logical unit under the conditions listed below. Figure 2 IDENTIFY message and table 5
Figure 2 Identify Message
Bit7 6 5 43210
Identify DiscPriv LUNTAR Reserved LUNTRN
Quantum ATL SuperLoader Software Interface Guide 15
describes the data field contents.
shows the format of the
Chapter 2 Messages Supported SCSI Messages
Table 5 Identify Message
Field Description
Identify The Identify bit must be set to 1. This identifies the message as an IDENTIFY
message.
DiscPriv Disconnect Privilege. The DiscPriv can be 0, provided that no other I/O
process is currently active in the SuperLoader. If not set to 1 and other I/O processes are currently active in the SuperLoader, the SuperLoader returns BUSY status.
LUNTAR The Logical Unit/Target Routine (LUNTAR) field must be set to zero. The
SuperLoader does not support target routines. A LUNTAR bit of one causes the drive to send a MESSAGE REJECT message and switch to the BUS FREE phase.
Reserved The Reserved bits must be zero. If a Reserved bit is non-zero, the
SuperLoader returns a MESSAGE REJECT message and switches to the BUS FREE phase.
LUNTRN Logical Unit Number. The SuperLoader has two logical units. The tape
drive is always logical unit 0, and the media changer device is always logical unit 1.

Ignore Wide Residue (23h)

The IGNORE WIDE RESIDUE message is sent by the target to the
2
initiator to indicate that the number of valid bytes sent during the last REQ/ACK handshake and REQB/ACKB handshake of a DATA IN phase is less than the negotiated transfer width. The Ignore field indicates the number of invalid data bytes transferred. This message is sent immediately following that DATA IN phase and prior to any other messages. Figure 3 format of an IGNORE WIDE RESIDUE message. Table 6
illustrates the data
describes
the Ignore field bit definitions.
16 Quantum ATL SuperLoader Software Interface Guide
Chapter 2 Messages
Supported SCSI Messages
Figure 3 Ignore Wide Residue Message
Bit Byte76543210
0
1
Table 6 Ignore Wide Residue

Initiator Detected Error (05h)

Message Code (23h)
Ignore (01h)
Ignore Invalid Data Bits (16-bit Transfers)
00h Reserved
01h DB(15-8)
02h - FFh Reserved
The INITIATOR DETECTED ERROR message is sent from an
2
initiator to inform the SuperLoader that an error has occurred that does not preclude the SuperLoader from retrying the operation (a bus parity error, for example). The source of the error may either be related to previous activities on the SCSI bus or may be only SuperLoader-related. When received, the SuperLoader attempts to re-transfer the last command, data, or status bytes by using the RESTORE POINTER message mechanism.
The SuperLoader’s response to and its handling of an INITIATOR DETECTED ERROR message are based on when, in the I/O process, the initiator introduces the message. Table 7
summarizes
the SuperLoader’s response.
Quantum ATL SuperLoader Software Interface Guide 17
Chapter 2 Messages Supported SCSI Messages
Table 7 Response to Initiator Detected Error
BUS Phase SuperLoader Response
SELECTION The SuperLoader discards the INITIATOR DETECTED ERROR
message and then goes to the BUS FREE phase.
COMMAND The SuperLoader discards any Command Descriptor Block bytes
fetched from the initiator, sets the Sense Key to ABORTED COMMAND, sets the Additional Sense Code to INITIATOR DETECTED ERROR MESSAGE RECEIVED. It sends the CHECK CONDITION status and the COMMAND COMPLETE message and then goes to the BUS FREE phase.
DATA The SuperLoader discards the INITIATOR DETECTED ERROR
message and sets the Sense Key to ABORTED COMMAND, sets the Additional Sense Code to INITIATOR DETECTED ERROR MESSAGE RECEIVED. It sends the CHECK CONDITION status and the COMMAND COMPLETE message and then goes to the BUS FREE phase.
STATUS The SuperLoader sends a RESTORE POINTERS message, returns to the
STATUS phase, resends the STATUS command, and continues the I/O process.
MESSAGE IN The SuperLoader discards the INITIATOR DETECTED ERROR
message and sets the Sense Key to ABORTED COMMAND, sets the Additional Sense Code to INITIATOR DETECTED ERROR MESSAGE RECEIVED. It sends the CHECK CONDITION status and the COMMAND COMPLETE message and then goes to the BUS FREE phase.

Linked Command Complete (0Ah)

This message is sent from a target to an initiator to indicate that the
2
execution of a linked command, with the FLAG bit set to zero, is complete and that status has been sent. The initiator then sets the pointers to the initial state for the next command.
If received by a target, this message is handled as an illegal message; the SuperLoader enters the MESSAGE IN phase and returns MESSAGE REJECT.
18 Quantum ATL SuperLoader Software Interface Guide
Chapter 2 Messages
Supported SCSI Messages

Linked Command Complete, Flag (0Bh)

Message Parity Error (09h)

This message is sent from a target to an initiator to indicate that the execution of a linked command, with the FLAG bit set to one, is
2
complete and that status has been sent.
This message is sent from the initiator to tell the SuperLoader that
2
the last message byte the SuperLoader passed on to the initiator contained a parity error.
To indicate that it intends to send the message, the initiator sets the ATN signal before it releases ACK for the REQ/ACK handshake of the message that has the parity error. This provides an interlock so that the target can determine which message has the parity error. If the target receives this message under any other condition, it proceeds directly to the BUS FREE state by releasing the BSY signal, signifying a catastrophic error.
The target’s response to this message is to switch to the MESSAGE IN phase and re-send from the beginning all the bytes of the message that precipitated the MESSAGE PARITY ERROR message.

Message Reject (07h)

This message is sent from the initiator or target to indicate that the
2
last message received was inappropriate or has not been implemented.
To indicate its intention to send this message, the initiator asserts the ATN signal before it releases ACK for the REQ/ACK handshake of the message that is to be rejected. MESSAGE REJECT is issued in response to any message the SuperLoader considers to be illegal or not supported. When sending to the initiator, the SuperLoader does so before requesting any additional message bytes.
Quantum ATL SuperLoader Software Interface Guide 19
Chapter 2 Messages Supported SCSI Messages

No Operation (08h)2

If a target requests a message, the initiator sends a NO OPERATION message if it does not currently have any other valid message to send. The message is accepted when the SuperLoader is acting as a target and may be sent when it is an initiator. If a NO OPERATION message is received during a selection, the SuperLoader proceeds to the COMMAND phase, provided ATN does not continue as asserted; the NO OPERATION message is ignored by the SuperLoader.

Restore Pointers (03h)

Save Data Pointer (02h)

The RESTORE POINTERS message is sent from the SuperLoader
2
to the initiator to direct the initiator to copy the most recently saved command, data, and status pointers for the I/O process to the corresponding current pointers. The command and status pointers are restored to the beginning of the present command and status areas. The data pointer is restored to the value at the beginning of the data area in the absence of a SAVE DATA POINTER message or to the value at the point at which the last SAVE DATA POINTER message occurred for that logical unit.
When the RESTORE POINTERS message is received as a target, the target switches to the MESSAGE IN phase and returns MESSAGE REJECT.
The SAVE DATA POINTER message is sent from the SuperLoader
2
to direct the initiator to copy the current data pointer to the saved data pointer for the current I/O process.
When functioning as a target, the SuperLoader sends this message before a DISCONNECT message during a data transfer. It does not send a SAVE DATA POINTER message if it intends to move directly to STATUS phase. When received as a target, it switches to MESSAGE IN phase and returns MESSAGE REJECT.
20 Quantum ATL SuperLoader Software Interface Guide
Chapter 2 Messages
Supported SCSI Messages

Synchronous Data Transfer Request (01h)

This extended message allows the target and initiator to agree on the values of the parameters relevant to synchronous transfers. The
2
SuperLoader will not initiate the SYNCHRONOUS DATA TRANSFER REQUEST message; it relies on the initiator to do so. The SYNCHRONOUS DATA TRANSFER REQUEST message has the format shown in figure 4
Note: The SuperLoader DLT supports initiating synchronous
.
transfer negotiations with the host, but this feature is disabled by default. To enable it, set the MODE SELECT VU EEROM parameter EnaInitSyncNeg.
Figure 4 Synchronous Data Transfer Request Message
Bit Byte76543210
0
Extended Message Identifier (01h) (see figure 1)
1
2
3
4
SYNCHRONOUS DATA TRANSFER REQUEST (01h)
Length (03h)
Transfer Period
Transfer REQ/ACK Offset
A SYNCHRONOUS DATA TRANSFER REQUEST message exchange is initiated by a SCSI device whenever a previously arranged transfer width agreement may have become invalid. The agreement becomes invalid after any condition that may leave the data transfer agreement in an indeterminate state such as:
After a hard reset condition
Quantum ATL SuperLoader Software Interface Guide 21
Chapter 2 Messages Supported SCSI Messages
After a BUS DEVICE RESET Message
After a power cycle.
After a WIDE DATA TRANSFER REQUEST message exchange.
The SYNCHRONOUS DATA TRANSFER REQUEST message exchange establishes an agreement between two SCSI devices on the clocking of the data used for DATA phase transfer between them. This agreement applies to DATA IN and DATA OUT phases only. All other information transfer phases must use asynchronous transfers.
The SuperLoader implements both wide data transfer option and synchronous data transfer option. Wide data transfer must be negotiated prior to negotiating the synchronous data transfer agreement. If a synchronous data transfer agreement is in effect, then after accepting a WIDE DATA TRANSFER REQUEST message, it resets the synchronous agreement to asynchronous mode.
If the Transfer Period requested is lower than the minimum value supported by the device, the return value will be adjusted up to the minimum supported value. All possible transfer periods between the minimum and maximum values are not supported. If the Transfer Period requested is between the minimum and maximum supported values, but not exactly achievable by the device, the returned value will be the request value and the SuperLoader will transmit data at the next lower speed it is capable of. The initiator may send data at the request speed. The maximum supported synchronous period is 5Dh (372 nsec). A request with a Transfer Period lower than this will return a request for asynchronous mode.
22 Quantum ATL SuperLoader Software Interface Guide
Chapter 2 Messages
Supported SCSI Messages
Table 8 Transfer Rates
Transfer Period Transfer Rate
0Ah 40 MHz, 25 nsec Transfer Period
0Bh 33 MHz, 30.3 nsec Transfer Period. LTO and SDLT uses 37.5 nsec period.
0Ch 20 MHz, 50 nsec Transfer Period
0Dh – 5Dh (4 * Transfer Period) nsecs.
The minimum supported value for Transfer Period is 0Ah when the bus is operating in LVD mode. When operating in HVD or Single-Ended mode, the minimum Transfer Period value is 0Ch.
The SuperLoader SDLT 220 and SuperLoader SDLT 320 Transfer REQ/ACK offset may be any value between 0 and 62. A value of 0 indicates asynchronous transfers. A request with a value greater than 62 will cause the device to return a request for 62.

Wide Data Transfer Request Extended Message (03h)

The SuperLoader DLT1 Transfer REQ/ACK offset may be any value between 0 and 15. A value of 0 indicates asynchronous transfers. A request with a value greater than 15 will cause the device to return a request for 15.
The SuperLoader LTO only supports a Transfer REQA/ACK offset of 0. This indicates asynchronous transfers.
The following figure illustrates the message format.
2
Quantum ATL SuperLoader Software Interface Guide 23
Chapter 2 Messages Supported SCSI Messages
Figure 5 Wide Data Transfer Request Message
Bit Byte76543210
0
1
2
3
Extended Message Identifier (01h) (see figure 1
Extended Message Length (02h)
WIDE DATA TRANSFER REQUEST (03h)
Transfer Width Exponent
)
A WIDE DATA TRANSFER REQUEST message exchange is initiated by a SCSI device whenever a previously arranged transfer width agreement may have become invalid. The agreement becomes invalid after any condition that may leave the data transfer agreement in an indeterminate state such as
After a hard reset condition
After a BUS DEVICE RESET Message
After a power cycle.
The WIDE DATA TRANSFER REQUEST message exchange establishes an agreement between two SCSI devices on the width of the data path to be used for DATA phase transfer between them. This agreement applies to DATA IN and DATA OUT phases only. All other information transfer phases must use an 8-bit data path.
The SuperLoader implements both wide data transfer option and synchronous data transfer option. It negotiates the wide data transfer agreement prior to negotiating the synchronous data transfer agreement. If a synchronous data transfer agreement is in effect, then after accepting a WIDE DATA TRANSFER REQUEST message, it resets the synchronous agreement to asynchronous mode.
24 Quantum ATL SuperLoader Software Interface Guide
Chapter 2 Messages
Supported SCSI Messages
The transfer width is expressed as 2n where n is the transfer width in bytes. The transfer width that is established applies to all logical units. Valid transfer widths for the SuperLoader are 8 bits (m = 00h) and 16 bits (m = 01h). Values of m greater than 01h are reserved.
Quantum ATL SuperLoader Software Interface Guide 25
Chapter 2 Messages Supported SCSI Messages
26 Quantum ATL SuperLoader Software Interface Guide
Chapter 3

3Media Changer Commands

This chapter describes the Media Changer SCSI protocol features implemented by the Media Changer device of the SuperLoader system. Note that the sections included in this chapter do not fully reiterate every ANSI SCSI option and/or command code specification; the sections do describe the supported commands and options.

Overview of Command and Status Processing 3

The SCSI feature set has been described as “SCSI-2 plus.” This means the SuperLoader supports:
All of the mandatory features of SCSI-2
Many of the optional features of SCSI-2
Some of the mandatory and optional features of SCSI-3
Quantum ATL SuperLoader Software Interface Guide 27
Chapter 3 Media Changer Commands Overview of Command and Status Processing
When conflicts arise between the features of SCSI-2 and SCSI-3, the SCSI-2 methods have been chosen in all cases where execution would differ without explicit knowledge of the host. That is, if a command would act differently in SCSI-3 implementation without any difference in the actual CDB, the SCSI-2 functionality is used. If SCSI-3 defined a new functionality of a command but only with a new field or value for a field as defined by a SCSI-3 document, this functionality may have been implemented. Please see individual command descriptions for the SCSI-3 features that have been implemented.
The SuperLoader device supports the Media Changer commands listed in table 9
Table 9 Supported Media Changer Commands
Command Operation Code
.
Initialize Element Status Command (07h)
Inquiry Command (12h)
Load Unload Command (1Bh)
Log Sense Command (4Dh)
Mode Select (6) / (10) Command (15h / 55h)
Mode Sense (6) / (10) Command (1Ah/ 5Ah)
Move Medium Command (A5h)
Persistent Reserve In Command (5Eh)
Persistent Reserve Out Command (5Fh)
Position to Element Command (2Bh)
Prevent/Allow Medium Removal (1Eh)
Read Buffer Command (3Ch)
28 Quantum ATL SuperLoader Software Interface Guide
on page 32 12h
on page 45 1Bh
on page 46 4Dh
on page 89 A5h
on page 120 3Ch
on page 31 07h
on page 66 15h / 55h
on page 74 1Ah / 5Ah
on page 91 (SCSI-3) 5Eh
on page 101 (SCSI-3) 5Fh
on page 116 2Bh
on page 118 1Eh
Chapter 3 Media Changer Commands

Media Changer Command Descriptions

Command Operation Code
Read Element Status Command (B8h) on page 126 B8h
Release Element (10) Command (57h)
Release Unit (6) Command (17h)
Report Device Identifier Command (A3h)
Report LUNS Command (A0h)
Request Sense Command (03h)
Reserve Element (10) Command (56h)
Reserve Element (6) Command (16h)
Send Diagnostic Command (1Dh)
Set Device Identifier Command (A4h)
Test Unit Ready Command (00h)
Write Buffer Command (3Bh)
on page 171 3Bh
on page 140 57h
on page 143 17h
on page 145 A3h
on page 148 A0h
on page 151 03h
on page 160 (SCSI-3) 56h
on page 163 16h
on page 166 1Dh
on page 168 (SCSI-3) A4h
on page 170 00h
Media Changer Command Descriptions 3
The Media Changer commands are presented in alphabetical order. Because information about a particular command may span multiple pages, the command name is repeated, at the top of every page that concerns that command.
Throughout this manual, multiple bytes that contain information about specific command parameters are portrayed as shown in the example of the Parameter List Length field (bytes 7 and 8) of the MODE SELECT command shown as follows:
Quantum ATL SuperLoader Software Interface Guide 29
Chapter 3 Media Changer Commands Media Changer Command Descriptions
Bit Byte76543210
(Bytes 0 - 6)
(MSB)
7 - 8
Parameter List Length
(LSB)
As shown, this sample indicates that the most significant bit (MSB) of the field is bit 7 of byte 7; the least significant bit is bit 0 of byte 8.
30 Quantum ATL SuperLoader Software Interface Guide
Chapter 3 Media Changer Commands

Initialize Element Status Command (07h)

Initialize Element Status Command (07h) 3
The INITIALIZE ELEMENT STATUS command allows the media changer to check all assigned element addresses for volume and any other status relevant to that element address. The intent of this command is to enable the Initiator to get a quick response from a subsequent READ ELEMENT STATUS command. It may be useful to issue this command after a power failure, if a volume has been changed by an operator, or if configurations have been changed.
Figure 6 Initialize Element Status Command
Bit Byte7654 3210
0
1
2-4
5
Operation Code (07h)
Logical Unit Number Reserved
Reserved
Unused Reserved Flag Link
Quantum ATL SuperLoader Software Interface Guide 31
Chapter 3 Media Changer Commands Inquiry Command (12h)

Inquiry Command (12h) 3

The INQUIRY command allows the initiator to determine the kind of SCSI devices attached to its SCSI BUS. It causes a device that is attached to a SCSI BUS to return information about itself. The SuperLoader identifies itself as a media changer that implements the SCSI-2 protocol.
The media changer can provide three categories of data in response to an INQUIRY command: Standard Inquiry Data, Vital Product Data, and Command Support Data. Standard Inquiry Data contains basic data about the device. Vital Product Data comprises several pages of additional data. Each Vital Product Data page requires a separate INQUIRY command from the initiator. Command Support Data indicates the fields in the CDB that are supported by opcode. An INQUIRY command is not affected by, nor does it clear, a Unit Attention condition.
Figure 7 Inquiry Command
Bit Byte76543210
0
1
2
3
4
5
32 Quantum ATL SuperLoader Software Interface Guide
Logical Unit Number Reserved CmdDt EVPD
Unused Reserved Flag Link
Operation Code (12h)
Page Code
Reserved
Allocation Length
Chapter 3 Media Changer Commands
Inquiry Command (12h)
Figure 8 Inquiry Command
Field Description
CmdDt Command Support Data. If CmdDt = 0 and EVPD (see below) = 0, the
media changer returns the Standard Inquiry Data. If CmdDt = 1 with EVPD = 0, the media changer returns the Command Data specified by Page Code/ Operation. Information about Command Support Data is provided in figure 15
on page 43 and table 14 on page 43.
EVPD Enable Vital Product Data. If EVPD = 0 and CmdDt (see above) = 0,
the media changer returns the Standard Inquiry Data. If EVPD = 1 and CmdDt = 0, the media changer returns the Vital Product Data Page specified by Page Code/Operation Code.
Page Code or Operation Code
Specifies the Vital Product Data Page which is to be returned by the media changer when EVPD is set. Specifies the SCSI Operation Code for command support data to be returned by the media changer when CmdDt is set. A CHECK CONDITION status is returned if this field specifies an unsupported Page or Operation Code or if both EVPD and CmdDt are set. Figure 11
on page 39 shows the Page
Codes for the Vital Product Pages supported by the media changer.
Allocation Length Specifies the number of bytes of inquiry information the media
changer is allowed to return to the initiator during the command's DATA IN phase. Error status is not returned if the value in this field truncates the requested information.

Standard Inquiry Data Page

Figure 9
3
returned by the media changer.
shows the format of the Standard Inquiry Data page
Quantum ATL SuperLoader Software Interface Guide 33
Chapter 3 Media Changer Commands Inquiry Command (12h)
Figure 9 Standard Inquiry Data (LTO)
Bit Byte 7 6 5 4 3 2 1 0
0
1
2
3
4
5
6
7
8-15
16-31
32-35
36
Peripheral Qualifier Peripheral Device Type
RMB Reserved
Version
AERC Obsolete NormACA HiSup Response Data Format
Additional Length (n-4)
SCCS Reserved
BQue EncServ Reserved MultiP MChngr Obsolete Obsolete Add16
RelAdr Obsolete Wbus16 Sync Linked Obsolete CmdQue Reserved
Vendor Identification (QUANTUM )
Product Identification (UHDL)
Product Revision Level (hhss)
Language
37
38-40
41
34 Quantum ATL SuperLoader Software Interface Guide
Reserved Image Type
Reserved
Firmware Personality
Chapter 3 Media Changer Commands
Inquiry Command (12h)
Bit Byte 7 6 5 4 3 2 1 0
42
43
Figure 10 Standard Inquiry Data (DLT)
Firmware Subpersonality
Vendor-Specific Subtype
Bit Byte 7 6 5 4 3 2 1 0
0
1
2
3
4
5
Peripheral Qualifier Peripheral Device Type
RMB Device Type Modifier
ISO Version ECMA Version ANSI Version
AENC TrmlOP Reserved Response Data Format
Additional Length (27h)
Reserved
6
7
8-15
16-31
32-35
36-40
Rsv’d MChangr Reserved
RelAdr Wbus32 Wbus16 Sync Linked Rsv’d CmdQue SftRe
Vendor Identification (QUANTUM)
Product Identification (UHDL)
Product Revision Level (hhss)
Reserved
Quantum ATL SuperLoader Software Interface Guide 35
Chapter 3 Media Changer Commands Inquiry Command (12h)
Bit Byte 7 6 5 4 3 2 1 0
41
42
43
Firmware Personality
Firmware Subpersonality
Vendor-Specific Subtype
The following table contains field descriptions for the data returned by the media changer.
Table 10 Standard Inquiry Data (LTO and DLT)
Field Name Value Description
Peripheral Qualifier 0 Non-zero if initiator selects an invalid logical unit (see below)
Peripheral Device Type
RMB 1 Removable Medium Bit. Set to 1.
8 8 indicates that this is a media changer device.
Device Type
0 This vendor specific field is set to 0.
Modifier (DLT)
Version (LTO) 2 ANSI SCSI Level 2 (SCSI-2) is supported.
ISO Version (DLT) 0 International Standardizaation Organization Version level. Set
to 0.
ANSI Version (DLT) 2 ANSI SCSI Level 2 (SCSI-2) is supported.
AENC (DLT) 0 Asynchronous Event Notification is not supported.
AERC (LTO) 0 Asynchronous Event Notification is not supported.
36 Quantum ATL SuperLoader Software Interface Guide
Chapter 3 Media Changer Commands
Inquiry Command (12h)
Field Name Value Description
TrmlOP (DLT) 0 Terminate I/O Process. The media changer does not support
the TERMINATE I/O PROCESS message.
NormACA (LTO) 0 The media changer does not support the NACA bit in the
control byte of the CDB.
HiSup (LTO) 0 The hierarchical addressing model is not used.
Response Data
2 This Standard Inquiry Data is in SCSI-2 format.
Format
Additional Length 27h This field indicates the number of additional bytes of
INQUIRY Response Data available.
SCCS (LTO) 0 This device does not contain an embedded storage array
controller.
BQue (LTO) 0 Basic queueing is not supported.
EncServ (LTO) 0 This device does not contain an embedded enclosure services
component.
MultiP (LTO) 0 This device does not implement multi-port requirements.
MChangr (LTO) 0 This device is not an attached media changer.
MChnger (DLT) 0 Set to 1 if a Media changer (loader) is present and EEPROM
parameter EnblngMedChgr is set to 1. this SCSI-3 bit indicates that the Read Element Status and Move Medium commands can be issued to the drive (LON0). By default, this bit is set to
0.
Add16 (LTO) 1 This devices supports 16-bit wide SCSI addresses.
RelAdr 0 This device does not support relative addressing.
WBUS32 (DLT) 0 Set to 0 since the media changer does not support 32-bit
transfer.
WBUS16 1 This device supports 16-bit wide data transfers.
Sync 0 This devices does not support synchronous data transfers.
Quantum ATL SuperLoader Software Interface Guide 37
Chapter 3 Media Changer Commands Inquiry Command (12h)
Field Name Value Description
Linked 1 This device supports linked commands.
CmdQue 0 This device does not support command queueing.
SftRe 0 The hard reset option is implemented in response to assertion
of the SCSI BUS reset line.
Vendor
Identification of vendor. Identification (QUANTUM)
Product
Identification of the product Identification (UHDL)
Product Revision Level (hhss)
This field contains 4 bytes of ASCII data that provides the
media changer’s firmware revision level.
Language (LTO) This field indicates the language used for the front panel and
On-board Remote Web Management.
Image Type This field indicates the type of firmware image required when
downloading a new image. SuperLoader LTO reports a 1 and
SuperLoader DLT reports a 0.
Firmware Personality
Firmware
Numeric indicator of firmware personality. Note that when
set to 4, this indicates OEM family.
Set to 1, indicating standard SCSI device firmware. Subpersonality
Vendor-Specific
Identification of product. Subtype

Vital Product Data Page

38 Quantum ATL SuperLoader Software Interface Guide
The following sections describe the Vital Product Data Pages for
3
the system.
Chapter 3 Media Changer Commands
Inquiry Command (12h)
Supported Vital Product Data Page 3
The Supported Vital Product Data Pages page provides a directory of the Vital Product Data Pages that are supported by the SuperLoader.
Figure 11 Supported Vital Product Data
Bit Byte76543210
0
1
2
3
4
5
6
Figure 12 Unit Serial Number Page (80h)
Peripheral Qualifier Peripheral Device Type
Page Code (00h)
Reserved
Page Length (03h)
00h - (this page)
80h - Unit Serial Number Page
83h – Device Identification Page
Bit Byte76543210
0
1
Peripheral Qualifier Peripheral Device Type
Page Code (80h)
Quantum ATL SuperLoader Software Interface Guide 39
Chapter 3 Media Changer Commands Inquiry Command (12h)
Bit Byte76543210
2
3
4 - 17
Table 11 Unit Serial Number Page Field Descriptions
Field Name Description
Serial Number
The serial number given is the serial number of the media changer typically starting with “PM”
Reserved
Page Length (0Eh)
Serial Number
indicating the site of manufacture.
Figure 13 Device Identification Page (83h)
Bit Byte76543210
0
1
2
3
4 - n
40 Quantum ATL SuperLoader Software Interface Guide
Peripheral Qualifier Peripheral Device Type
Page Code (83h)
Reserved
Page Length
Identification Descriptors
Chapter 3 Media Changer Commands
Inquiry Command (12h)
There are three different Identification Descriptors returned, in numerical order of the Identifier Type. Each Identification Descriptor takes the following form:
Figure 14 Identifier Descriptor
Bit Byte76543210
0
1
2
3
4 - n
Table 12 Identifier Descriptor Field Descriptions
Reserved Code Set
Reserved Association Identifier Type
Reserved
Identifier Length (n-3)
Identifier
Field Name Field Description
Code Set Indicates the type of data to be found in the
Identifier field. A value of 1 indicates binary data. A value of 2 indicates ASCII data.
Association Indicates whether the Identifier is associated with
the logical unit or the port. Always contains a 0, indicating the Identifier is associated with the logical unit.
Identifier Type Type of identifier.
Quantum ATL SuperLoader Software Interface Guide 41
Chapter 3 Media Changer Commands Inquiry Command (12h)
Field Name Field Description
Identifier Identifier data, based on the Identifier Type.
The following table describes the identifiers supported by the SuperLoader.
Value Description
1 Concatenation of the Vendor Name,
Product ID, and unit serial number
2 Canonical form of the IEEE Extended
Unique Identifier, 64 bit (EIU-64)
3 FC-PH Name_Identifier
Table 13 Supported Identifiers

Command Support Data

Identifier Type
1 2 24 QUANTUM UHDL, 12 ASCII space
2 1 8 8 bytes of binary data indicating the
3 1 8 8 bytes of binary data indicating the
Code Set Length Identifier
characters (20h), followed by the unit serial number in ASCII.
EUI-64 assigned to the drive.
64-bit, type 3, FC-PH Name_Identifer assigned to the drive.
An application client can request command support data by
3
setting the CmdDt bit of the INQUIRY command to 1, and specifying the SCSI operation code of the Command Descriptor Block (CDB) for which it wants information.
The format of the command support data and definitions of the fields follow.
42 Quantum ATL SuperLoader Software Interface Guide
Chapter 3 Media Changer Commands
Inquiry Command (12h)
Figure 15 Command Support Data Page
Bit Byte76543210
0
1
2
3 - 4
5
6 - n
Table 14 Command
Peripheral Qualifier Peripheral Device Type
Reserved Support
ISO Version ECMA Version ANSI - Approved Version
Reserved
CDB Size (m - 5)
CDB Usage Data
Support Data Page
Field Name Description
Support The value of the Support field describes the type of support that the
tape drive provides for Command Support Data.
Value Description
000b Data about the requested SCSI operation code is not
currently available. In this case, all data after Byte 1 is undefined.
001b The device does not support the SCSI operation code
requested. In this case, all data after Byte 1 is undefined.
010b Reserved
011b The device supports the SCSI operation code in
conformance with the SCSI standard.
Quantum ATL SuperLoader Software Interface Guide 43
Chapter 3 Media Changer Commands Inquiry Command (12h)
Field Name Description
100b Vendor-Specific
101b The device supports the SCSI operation code, but in a
110b Vendor-Specific
111b Reserved
ISO-Version Must be 0.
ECMA-Version Must be 0.
vendor-specific manner.
ANSI-Approved
2.
Version
CDB Size This field contains the number of bytes in the CDB for the Operation
Code being requested and the size of the CDB Usage Data in the data that is returned in response to the INQUIRY.
CDB Usage Data This field contains information about the CDB for the Operation
Code being queried. Note that the first byte of the CDB Usage Data contains the OpCode for the operation specified. All of the other bytes of the CDB Usage Data contain a map for bits in the CDB of the OpCode specified.
NOTE: The bits in the map have a 1-to-1 correspondence to the CDB for the OpCode being queried. That is, if the device senses a bit as the entire field or as part of the field of the operation, the map in CDB Usage Data contains a 1 in the corresponding bit position. If the device ignores a bit or declares a bit as “reserved” in the CDB for the OpCode being queried, the map has a 0 in that corresponding bit position.
44 Quantum ATL SuperLoader Software Interface Guide
Chapter 3 Media Changer Commands

Load Unload Command (1Bh)

Load Unload Command (1Bh) 3
The LOAD UNLOAD command tells the target to eject all magazines. If no magazines are present, UNLOAD returns a CHECK CONDITION status with an ILLEGAL REQUEST sense key.
This command will eject the magazine(s) regardless of the setting via the PREVENT/ALLOW MEDIUM REMOVAL command.
Figure 16 Load Unload Command Descriptor Block
Bit Byte76543210
0
1
2 - 4
5
Table 15 Unload Command Descriptor Block
Logical Unit Number Reserved Immed
Unused Reserved Flag Link
Operation Code (1Bh)
Reserved
Field Name Description
Immed Immediate. If this bit is set to 1, status is returned as
soon as the operation is started. If set to 0, status is returned after the operation has completed.
Quantum ATL SuperLoader Software Interface Guide 45
Chapter 3 Media Changer Commands Log Sense Command (4Dh)

Log Sense Command (4Dh) 3

The LOG SENSE command allows the host to retrieve statistical information maintained by the media changer about its own hardware parameters.
Figure 17 LOG SENSE Command Descriptor Block
Bit Byte76543210
0
1
2
3 - 4
5 - 6
7 - 8
9
Operation Code (4Dh)
Logical Unit Number Reserved PPC (0) SP(0)
PC Page Code
Reserved
(MSB)
Parameter Pointer
(LSB)
(MSB)
Allocation Length
(LSB)
Unused Reserved Flag Link
46 Quantum ATL SuperLoader Software Interface Guide
Chapter 3 Media Changer Commands
Log Sense Command (4Dh)
Table 16 Log Sense Command Descriptor Block
Field Name Description
PPC Parameter Pointer Control. A PPC of 0 indicates that the parameter data
requested from the device starts with the parameter code specified in the Parameter Pointer field (Bytes 5 - 6) and returns the number of bytes specified in the Allocation Length field (Bytes 7 - 8) in ascending order of parameter codes from the specified log page. Request for changed parameters is not supported. This field must be 0.
SP Save Parameters. Not supported, must be set to 0. If for some reason the Save
Parameters bit is set, the command terminates with a CHECK CONDITION status with a sense key of ILLEGAL REQUEST and an ASC of INVALID FIELD IN CDB.
PC Page Control. This field defines the type of parameter values to be returned:
PC Type of Parameter Values
00b Threshold Values
01b Cumulative Values
10b Default Threshold Values
11b Default Cumulative Values
The Default Threshold Values are the maximum values that each parameter can attain.
The Current Cumulative Values are the values computed since the last reset of the device (either via power-cycle, BUS DEVICE RESET, or SCSI RESET.)
The Default Cumulative Values are the values to which each parameter is initialized at a reset condition. Default values are zero.
By default, Current Threshold Values = Default Threshold Values.
Page Code The Page Code field identifies which log page is being requested by the
initiator. If the page is not supported, then the command terminates with a CHECK CONDITION status, sense key set to ILLEGAL REQUEST, and additional sense code of INVALID FIELD IN CDB. Supported pages are:
Quantum ATL SuperLoader Software Interface Guide 47
Chapter 3 Media Changer Commands Log Sense Command (4Dh)
Field Name Description
Page Code Page Definition
Parameter Pointer
00h Supported Pages Log Page (Page 00h)
07h Last n Error Events Page (07h)
2Eh TapeAlert Page (2Eh)
on page 52 (LTO only)
30h Move Statistics Page (30h)
on page 50
on page 54
31h Hard/Soft Error Statistics Page (31h)
33h Device Wellness Page (33h)
3Eh Device Status Page (3Eh)
on page 59
on page 62
on page 49
on page 56
SDLT and DLT must be 0.
For LTO only: The Parameter Pointer field allows the host to specify at which parameter within a log page the requested data should begin. For example, if a page supports parameters 0 through 5, and the Parameter Pointer contains 3, then only parameters 3, 4, and 5 are returned to the initiator. Similarly, if a page supports parameters 1, 3, and 6, and the Parameter Pointer contains 2, then only parameters 3 and 6 are returned to the initiator.
If the Parameter Pointer is larger than the highest numbered parameter on the page, then the target terminates the command with CHECK CONDITION status, sense key set to ILLEGAL REQUEST, and additional sense code set to INVALID FIELD IN CDB.
Note that parameters within a page are always returned in ascending order according to parameter code.
If the target does not support a parameter code within this page, then it does not return any data associated with this parameter.
Allocation Length
This field specifies the maximum number of bytes that the initiator has allocated for returning data. The host uses this field to limit the size of data transfers to its own internal buffer size.
48 Quantum ATL SuperLoader Software Interface Guide
Chapter 3 Media Changer Commands
Log Sense Command (4Dh)

Supported Pages Log Page (Page 00h)

Figure 18 Supported Pages Page
When page 00h is requested, the 4-byte page header is returned, followed by the pages supported in ascending order, one byte for
3
each.
Bit Byte76543210
0
1
Reserved Page Code (00h)
Reserved
(MSB)
2 – 3
Page Length (7h)
(LSB)
4
5
00h
07h
6
7
8
9
10
2Eh
30h
31h
33h
3Eh
Quantum ATL SuperLoader Software Interface Guide 49
Chapter 3 Media Changer Commands Log Sense Command (4Dh)

Last n Error Events Page (07h)

This page returns the ASCII text for the hard error event log. This
3
page consists of a page header, a parameter header and parameter value. The parameter value returned consists of the ASCII text for the EEROM Hard Error Log.
Figure 19 Last n Error Events Log Sense Header
Bit Byte76543210
0
1
2 - 3
Reserved Page Code (07h)
Reserved
(MSB)
Page Length (n)
(LSB)
Table 17 Last n Error Events Log Sense Header
Field Name Description
Page Code The Page Code echoes the page code that was
specified in the LOG SENSE command descriptor block.
Page Length The Page Length field specifies the total number of
bytes contained in this log page, not including the four bytes that make up the header.
50 Quantum ATL SuperLoader Software Interface Guide
Chapter 3 Media Changer Commands
Log Sense Command (4Dh)
Figure 20 Format for Last n Error Events Log Sense
Bit Byte76543210
(MSB)
0 -1
2
DU DS TSD ETC TMC Rsv’d LP
3
(MSB)
4 - n
Table 18 Parameters Last n Error Events Log Sense
Parameter Code
(LSB)
Parameter Length
ASCII String for Event n
(LSB)
Field Name Description
Parameter Code The Parameter Code value represents the relative
time at which the error occurred. It identifies the log parameter being transferred for that log page. Only the most recent 10 events are reported in the SuperLoader LTO and 5 events for the SuperLoader DLT..
DU Disable Update. Not supported, always 0.
DS Disable Save. Not supported, always 1.
TSD Target Save Disable. Not supported, always 1.
ETC Enable Threshold Comparison. Not supported,
always 0.
TMC Threshold Met Criteria. Not supported, always 0.
Quantum ATL SuperLoader Software Interface Guide 51
Chapter 3 Media Changer Commands Log Sense Command (4Dh)
Field Name Description
LP List Parameter. This bit is set to 1.

TapeAlert Page (2Eh)

Figure 21 TapeAlert Log Sense Header Format
Parameter Length
ASCII Strong for Event n
The length in bytes of the following parameter value.
The text includes the time of the event, the error code indentifying the event, and additional data specific to the event.
The TapeAlert Log page defines error and informational flags for
3
detailed device diagnostics. The TapeAlert data is event-based and the page control bits in the LOG SENSE command are not applicable and are ignored.
The SuperLoader LTO supports the definition of the flags for media changer devices as defined in SMC-2.
The SuperLoader DLT only supports the reporting of the TapeAlert Log page on logical unit 0. It supports the combined drive and media changer flags are defined in SSC-2.
Bit Byte76543210
0
52 Quantum ATL SuperLoader Software Interface Guide
Page Code (2Eh)
Chapter 3 Media Changer Commands
Log Sense Command (4Dh)
Bit Byte76543210
1
(MSB)
2 - 3
Table 19 TapeAlert Log Sense Header Field Descriptions
Figure 22 TapeAlert Page Log Parameters Format
Reserved
Page Length
(LSB)
Field Name Description
Page Code The Page Code echoes the page code that was
specified in the LOG SENSE command descriptor block.
Page Length The Page Length field specifies the total number of
bytes contained in this log page, not including the four bytes that make up the header.
Bit Byte76543210
MSB
5n – 1 to 5n
5n + 1
DU DS TSD ETC TMC Rsv’d LP
Quantum ATL SuperLoader Software Interface Guide 53
Parameter Code (n)
(LSB)
Chapter 3 Media Changer Commands Log Sense Command (4Dh)
Bit Byte76543210
5n + 2
5n + 3
Table 20 TapeAlert Page Log Parameters
Value of TapeAlert Flag (Flag is set when Bit 0 = 1; Bits 1 - 7 are Reserved)

Move Statistics Page (30h)

Parameter Length
Field Name Description
Parameter
This field contains the Flag code.
Code
Parameter
This field is set to 1.
Length
Value of TapeAlert Flag
If Bit 0 is set to 1, indicates that TapeAlert has sensed a problem. If Bit 0 is 0, the Flag is not set and no problem has been sensed.
This page consists of the Log Page Header followed by a count of
3
various movements of cartridges within the system. The entries in the log page are cumulative throughout the life of the unit and cannot be reset via SCSI or power cycle. Log Parameters are not supported for this page.
Figure 23 Move Statistics Format
Bit Byte76543210
0
1
54 Quantum ATL SuperLoader Software Interface Guide
Reserved Page Code (30h)
Reserved
Chapter 3 Media Changer Commands
Log Sense Command (4Dh)
Bit Byte76543210
(MSB)
2 - 3
4-7
8-11
12-15
16-19
Page Length (18h)
(LSB)
(MSB)
Total Moves
(LSB)
(MSB)
Drive Loads
(LSB)
(MSB)
Mail Slot Imports
(LSB)
(MSB)
Mail Slot Exports
(LSB)
(MSB)
20-23
24-27
Magazine Moves
(LSB)
(MSB)
Magazine Loads
(LSB)
Quantum ATL SuperLoader Software Interface Guide 55
Chapter 3 Media Changer Commands Log Sense Command (4Dh)
Table 21 Move Stati sti cs

Hard/Soft Error Statistics Page (31h)

Field Name Description
Page Code The page code is 30h.
Page Length The page length is 18h bytes.
Total Moves Total number of SuperLoader moves.
Drive Loads Number loads to the drive from magazines and
mail slot.
Mail Slot Imports Number times a cartridge was importing into the
system.
Mail Slot Exports Number of times a cartridge was exported from
the system.
Magazine Moves Number of moves between storage slots.
Magazine Loads Number of times a cartridge was moved from a
storage slot to the drive.
This page consists of the Log Page Header followed by a count of recovery actions performed. The entries in this log page are
3
cumulative throughout the life of the unit and cannot be reset via SCSI or power cycle. Log Parameters are not supported for this page. These numbers, in relation to the total number of moves performed, can provide an indication as to the health of the servo system.
56 Quantum ATL SuperLoader Software Interface Guide
Chapter 3 Media Changer Commands
Log Sense Command (4Dh)
Figure 24 Hard/Soft Move Error Statistics Format
Bit Byte76543210
0
1
2 - 3
4-5
6-9
10-13
Reserved Page Code (31h)
Reserved
(MSB)
Page Length (22h)
(LSB)
(MSB)
Servo Hard Errors
(LSB)
(MSB)
Drive Soft Error
(LSB)
(MSB)
Left Magazine Soft Error
(LSB)
(MSB)
14-17
18-21
Right Magazine Soft Error
(LSB)
(MSB)
Mail Slot Soft Error
(LSB)
Quantum ATL SuperLoader Software Interface Guide 57
Chapter 3 Media Changer Commands Log Sense Command (4Dh)
Bit Byte76543210
(MSB)
22-25
(MSB)
26-29
(MSB)
30-33
(MSB)
34-37
Table 22 Hard/Soft Error
Rotation Recovery Actions
(LSB)
Translation Recovery Actions
(LSB)
Left Magazine Recovery Actions
(LSB)
Right Magazine Recovery Actions
(LSB)
Field Name Description
Page Code The page code is 31h.
Page Length The page length is 22h bytes.
Servo Hard Errors The number of unrecoverable errors.
Soft Errors Each field is a count of the number of times
high-level recoverable error was reported for that component.
Recovery Actions Each field is a count of the number of times
recovery actions were required in that axis to perform an operation.
58 Quantum ATL SuperLoader Software Interface Guide
Chapter 3 Media Changer Commands
Log Sense Command (4Dh)

Device Wellness Page (33h)

The Device Wellness Page returns information about any check
3
conditions related to Sense Keys 4 and 9 logged by the media changer. Up to 16 entries (parameter code 0000h to 000Fh) can be contained in the page. Each entry records a hardware error (Sense Key = 4) or a code update event (Sense Key = 9). Note that parameter code 000h contains the oldest log information while parameter 000Fh contains the most recent.
This page begins with a 4-byte header followed by the log parameter blocks.
Figure 25 Device Wellness Log Sense Header
Bit Byte76543210
0
1
Reserved Page Code (33h)
Reserved
(MSB)
2 - 3
Table 23 Device Wellness Log Sense Header
Page Length
(LSB)
Field Name Description
Page Code The Page Code echoes the page code that was
specified in the LOG SENSE command descriptor block.
Page Length The Page Length field specifies the number of bytes
available and depends on the parameters requested.
Quantum ATL SuperLoader Software Interface Guide 59
Chapter 3 Media Changer Commands Log Sense Command (4Dh)
Figure 26 Device Wellness Log Sense (0000h-000Fh)
Bit Byte76543210
(MSB)
0-1
2
3
4-7
8 - 9 (LTO only)
10 - 11 (LTO only)
8-11 (SDLT/ DLT only)
Parameter Code
(LSB)
DU DS TSD ETC TMC Rsv’d LP
Parameter Length (0Ch)
(MSB)
Time Stamp
(LSB)
(MSB)
Source Element
(LSB)
(MSB)
Destination Element
(LSB)
Media ID
12
13
60 Quantum ATL SuperLoader Software Interface Guide
Sense Key
Additional Sense Code
Chapter 3 Media Changer Commands
Log Sense Command (4Dh)
Bit Byte76543210
14
15
Figure 27 Log Parameters for Device Wellness Log Sense
Additional Sense Code Qualifier
Additional Error Information
Field Name Description
Parameter Code
Parameter Codes 0000h through 000Fh are supported. This provides 16 log entries for error information capture.
DU Disable Update. Always 0.
DS Disable Save. Not supported. This bit always set to 1.
TSD Target Save Disable. Not supported. This bit always set to 1.
ETC Enable Threshold Comparison. Threshold checking is not supported on this
page. Always set to 0.
TMC Threshold Met Criteria. Always 0.
LP List Parameter. Always set to 0.
Parameter
The number of bytes to follow (0Ch).
Length
Time Stamp LTO: The Time Stamp is represented as number of power cycles and total
power on hours.
SDLT/DLT: Tape motion hours when check condition occurred (note that this is the number of power-on hours since the last time the unit was powered on, not total number of hours during the lifetime of the drive).
The time stamp counter is updated once per hour; if the tape drive is powered down before the hourly update occurs, the update will not occur until a full hour after power is reapplied.
Quantum ATL SuperLoader Software Interface Guide 61
Chapter 3 Media Changer Commands Log Sense Command (4Dh)
Field Name Description
Media ID SDLT/DLT only: Internal media identifier being used when check condition
occurred. 0 = no media or unknown media when event occurred. Note that this is not an applicable means of tracing media.
Source Element/ Destination
LTO only: These fields report the element addresses that were involved in the failure. These fields will be zero (0) if the failure did not involve a move command.
Element

Device Status Page (3Eh)

Figure 28 Device Status Log Sense Header
The Device Status Page describes the current status of the media
3
changer.
Bit Byte76543210
0
1
Reserved Page Code (3Eh)
Reserved
(MSB)
2 - 3
62 Quantum ATL SuperLoader Software Interface Guide
Page Length
(LSB)
Chapter 3 Media Changer Commands
Log Sense Command (4Dh)
Table 24 Device Status Log Sense Header
Field Name Description
Page Code The Page Code echoes the page code that was
specified in the LOG SENSE command descriptor block.
Page Length The Page Length field specifies the number of bytes
available and depends on the parameters requested.
Figure 29 Parameters for Device Status Log Sense Page
Bit Byte76543210
0 - 1
2
3
DU DS TSD ETC TMC Rsv’d LP
Parameter Code
Parameter Length (04h)
(MSB)
4 - 7
Table 25 Parameters for Device Status Log Sense Page
Parameter Value
Field Name Description
Parameter Code Parameter Codes 0000h through 0004h are supported:
Code Description
Quantum ATL SuperLoader Software Interface Guide 63
(LSB)
Chapter 3 Media Changer Commands Log Sense Command (4Dh)
Field Name Description
0000h Specifies device type. This value is always 0h.
0001h Specifies device status (figure 30
).
0002h Specifies the number of move operations over the lifetime of the device.
0003h Reserved for media changer device and shall contain 0.
0004h Vendor specific
DU Disable Update. Always 0.
DS Disable Save. Not supported. This bit always set to 1.
TSD Target Save Disable. Not supported. This bit always set to 1.
ETC Enable Threshold Comparison. Threshold checking is not supported on
this page. Always set to 0.
TMC Threshold Met Criteria. Always 0.
LP List Parameter. Always set to 0 (parameter codes treated as data
counter).
Figure 30 Device Status Log Sense Page (0001h)
Bit Byte76543210
0
1
Reserved Temperature Status
2 - 3
64 Quantum ATL SuperLoader Software Interface Guide
Reserved
Reserved
Chapter 3 Media Changer Commands
Log Sense Command (4Dh)
Table 26 Device Status Log Sense (0001h)
Field Name Description
Temperature These two bits indicate the temperature of the device. This field follows the
following format:
Bit 3 Bit 2 Description
0 0 Not supported
01OK
1 0 Warning: Safe temperature exceeded.
1 1 Maximum temperature exceeded.
Status These two bits indicate the overall condition of the device. The status of the
device follows the following format:
Bit 1 Bit 0 Description
0 0 Not supported
01OK
10Degraded
1 1 Failed
Quantum ATL SuperLoader Software Interface Guide 65
Chapter 3 Media Changer Commands Mode Select (6) / (10) Command (15h / 55h)

Mode Select (6) / (10) Command (15h / 55h) 3

The MODE SELECT command (available in either 6- or 10-byte format) enables the host to configure the media changer. Implementing MODE SELECT and MODE SENSE requires “handshaking” between the host and the media changer. Before configuring the media changer, the host should issue a MODE SENSE command to the media changer to obtain a report of the current configuration and determine what parameters are configurable. The host interprets this information and then may issue MODE SELECT to set the media changer to the host’s preferred configuration. The Mode Parameter List described in
Mode Parameter List
media changer during the command’s DATA OUT phase. The media changer device does not allow the host to save any values on any page.
Information for the media changer is carried on a number of pages, each of which serves to set the media changer’s operating parameters. The MODE SELECT pages supported, and the page within this manual that details each, are:
on page 68 is passed from the initiator to the
Page Code Description
1Ch TapeAlert Page (1Ch)
1Dh Element Address Assignment Page
1Eh Transport Geometry Parameters Page
1Fh Device Capabilities Page
66 Quantum ATL SuperLoader Software Interface Guide
on page 79 (LTO only)
on page 86
on page 82
on page 85
Chapter 3 Media Changer Commands
Mode Select (6) / (10) Command (15h / 55h)
Figure 31 Mode Select (6) Command Descriptor
Bit Byte76543210
0
1
Logical Unit Number PF Reserved SP (0)
2 – 3
4
5
Figure 32 Mode Select (10) Command Descriptor
Unused (00) Reserved Flag Link
Operation Code (15h)
Reserved
Parameter List Length
Bit Byte76543210
0
1
Logical Unit Number PF Reserved SP (0)
Operation Code (55h)
2 – 6
7 - 8
9
Reserved
Parameter List Length
Unused (00) Reserved Flag Link
Quantum ATL SuperLoader Software Interface Guide 67
Chapter 3 Media Changer Commands Mode Select (6) / (10) Command (15h / 55h)
Table 27 Mode Select (6)/(10) Command Descriptor

Mode Parameter List

Figure 33 Mode Select (6) Mode Parameter List
Field Name Description
PF Page Format. The Page Format bit indicates that the
data sent by the host after the MODE SELECT header and block descriptors complies with the definition of pages in the SCSI-2 specification. The SCSI-1 format will not be implemented so this bit must be set to 1. It is an ILLEGAL REQUEST to have page parameters while the PF bit is 0.
SP Save Parameters. Must be 0. If set, this bit instructs the
SuperLoader to save all savable pages, and this is not supported.
The following figure shows the format of the Mode Parameter List
3
that is passed by the initiator to the media changer during the command’s DATA OUT phase.
Bit Byte76543210
0 - 3
4 - 11
4 – 11 or
Mode Parameter Block Descriptor (Optional)
Mode Parameter Header
Page(s) (Optional)
12 - n
68 Quantum ATL SuperLoader Software Interface Guide
Chapter 3 Media Changer Commands
Mode Select (6) / (10) Command (15h / 55h)
Figure 34 Mode Select (10) Mode Parameter List
Bit Byte76543210
0 - 7
8 - 15
8 - n or 16 - n
Table 28 Mode Select Parameter List
Mode Parameter Header
Mode Parameter Block Descriptor (Optional)
Page(s) (Optional)
Field Name Description
Mode Parameter Header
4 or 8 bytes in length, contains information about the remainder of the Parameter List and is always present.
Mode Parameter Block Descriptor
8 bytes in length; not applicable to a media changer device.
Page(s) The Page Code(s) of the pages that are a part of
this MODE SELECT command.
Mode Parameter Header 3
The figures and table that follow provide an illustration and description of the fields that make up the MODE SELECT command’s Mode Parameter header.
Quantum ATL SuperLoader Software Interface Guide 69
Chapter 3 Media Changer Commands Mode Select (6) / (10) Command (15h / 55h)
Figure 35 Mode Select (6) Parameter Header
Bit Byte76543210
0
1
2
3
Figure 36 Mode Select (10) Parameter Header
Block Descriptor Length
Reserved
Reserved
Reserved
Bit Byte76543210
0 - 1
2
3
Reserved
Reserved
Reserved
4 - 5
6 - 7
70 Quantum ATL SuperLoader Software Interface Guide
Block Descriptor Length
Reserved
Chapter 3 Media Changer Commands
Mode Select (6) / (10) Command (15h / 55h)
Table 29 Mode Select Parameter Header
Figure 37 Mode Select Parameter
Field Name Description
Block Descriptor Length
This field specifies the length in bytes of all the block descriptors. Since the media changer only allows one block descriptor, the value must be either 0 or 8. A value of 0 indicates no block description is included; a value of 8 indicates a block descriptor is present and precedes the mode page data. Any other value other than 0 or 8 causes a CHECK CONDITION status with sense key of ILLEGAL REQUEST to be returned.
Mode Parameter Block Descriptor 3
The figure and table that follow provide an illustration and description of the fields that make up the MODE SELECT command’s Mode Parameter Block Descriptor.
Bit Byte76543210
0
Reserved
(MSB)
1 - 3
Number of Blocks
(LSB)
4
Reserved
(MSB)
5 - 7
Block Length
(LSB)
Quantum ATL SuperLoader Software Interface Guide 71
Chapter 3 Media Changer Commands Mode Select (6) / (10) Command (15h / 55h)
Table 30 Mode Select Parameter Block
Figure 38 Mode Select Page Descriptor
Field Name Description
Number of Blocks
This field is sent as 0. It is not applicable to media changer devices.
Block Length This field is sent as 0. It is not applicable to media
changer devices.
Mode Page Descriptors 3
Following the MODE SELECT command’s Mode Parameter Block Descriptor are the MODE SELECT pages, each of which sets a different device parameter. Each mode page has a 2-byte header that identifies the page code and indicates the number of bytes in that page.
Bit Byte76543210
0
1
2 - n
72 Quantum ATL SuperLoader Software Interface Guide
PS (0) 0 Page Code
Additional Page Length
Page-Defined or Vendor Specific Parameter List
Chapter 3 Media Changer Commands
Mode Select (6) / (10) Command (15h / 55h)
Table 31 Mode Select Page Descriptor
Field Name Description
PS Parameters Savable. For the MODE SELECT (6)
(10) commands, this field is reserved (0).
Additional Page Length
Page-Defined or Vendor Specific Parameter List
Indicates number of bytes in that page (not including bytes 0 and 1).
Information in this field depends on the mode page. Refer to Element Address Assignment Page on page 82 to Device Capabilities Page
on
page 86.
Quantum ATL SuperLoader Software Interface Guide 73
Chapter 3 Media Changer Commands Mode Sense (6) / (10) Command (1Ah/ 5Ah)

Mode Sense (6) / (10) Command (1Ah/ 5Ah) 3

The MODE SENSE command allows the media changer to report its current or changeable configuration parameters to the host. It is a complementary command to MODE SELECT.
The command descriptor block for the 6-byte MODE SENSE (1Ah) is shown below. An illustration of the command descriptor block for the 10-byte MODE SENSE (5Ah) follows on the next page.
Figure 39 Mode Sense (6) Command Descriptor Block
Bit Byte76543210
0
1
2
3
4
5
Logical Unit Number Rsv’d DBD Reserved
PC Page Code
Unused Reserved Flag Link
Operation Code (1Ah)
Reserved
Allocation Length
The MODE SENSE (10) command returns descriptor data in a different format than MODE SENSE (6).
74 Quantum ATL SuperLoader Software Interface Guide
Chapter 3 Media Changer Commands
Mode Sense (6) / (10) Command (1Ah/ 5Ah)
Figure 40 Mode Sense (10) Command Descriptor Block
Bit Byte76543210
0
1
2
3 – 6
Logical Unit Number Rsv’d DBD Reserved
PC Page Code
Operation Code (5Ah)
Reserved
(MSB)
7 - 8
Allocation Length
(LSB)
9
Table 32 Mode Sense Command Descriptor Block
Unused Reserved Flag Link
Field Name Description
DBD Disable Block Descriptors. This field is ignored. This device does not return
a block descriptor regardless of this field.
PC Page Control. The Page Control field indicates the type of page parameter
values to be returned to the host:
PC Type of Parameter Values
00 Report Current Values
01 Report Changeable Values
Quantum ATL SuperLoader Software Interface Guide 75
Chapter 3 Media Changer Commands Mode Sense (6) / (10) Command (1Ah/ 5Ah)
Field Name Description
10 Report Default Values
11 Report Saved Values
Note that the media changer device does not support saved values.
Page Code This field allows the host to select any specific page or all of the pages
supported by the media changer.
Page Code Description
Allocation Length

Mode Sense Data Headers

1Ch TapeAlert Page (1Ch)
1Dh Element Address Assignment Page
1Eh Transport Geometry Parameters Page
1Fh Device Capabilities Page
3Fh Return all pages
This field specifies the number of bytes that the host has allocated for returned MODE SENSE data. An allocation length of zero indicates that the media changer will return no MODE SENSE data. This is not considered an error, and GOOD status is returned.
on page 79 (LTO only)
on page 82
on page 85
on page 86
MODE SENSE may be either MODE SENSE (6) or MODE SENSE (10). MODE SENSE (6) data contains a 4-byte header followed by one 8-byte block descriptor, followed by zero or more variable length pages, depending on the Page Code and Allocation Length.
The MODE SENSE (6) and MODE SENSE (10) headers are
3
illustrated in the following figures.
76 Quantum ATL SuperLoader Software Interface Guide
Chapter 3 Media Changer Commands
Mode Sense (6) / (10) Command (1Ah/ 5Ah)
Figure 41 Mode Sense (6) Data Header
Bit Byte76543210
0
1
2
3
Figure 42 Mode Sense (10) Data Header
Mode Sense Data Length
Reserved
Reserved
Block Descriptor Length (0)
Bit Byte76543210
(MSB)
0 - 1
Mode Sense Data Length
(LSB)
2
Reserved
3
4 - 5
6 - 7
Reserved
Reserved
(MSB)
Block Descriptor Length (0)
(LSB)
Quantum ATL SuperLoader Software Interface Guide 77
Chapter 3 Media Changer Commands Mode Sense (6) / (10) Command (1Ah/ 5Ah)
Table 33 Mode Sense Data Heade
Field Name Description
Mode Sense Data Length
This field specifies the length (in bytes) of the MODE SENSE data that is available to be transferred during the DATA IN phase. Note that the Mode Sense Data Length does not include itself.

Mode Sense Mode Pages

Figure 43 Mode Sense Page Descriptor
Block Descriptor Length
The following figure depicts the variable length page descriptor.
3
This field specifies the length (in bytes) of all of the block descriptors. This value will be 0, indicating no Block Descriptors were sent.
Bit Byte76543210
0
1
2
PS 0 Page Code
Additional Page Length
Page Defined or Vendor Specific Parameter Bytes
Descriptions of the MODE SENSE page descriptor fields are provided in the following table. Detailed descriptions of each of the MODE SENSE Pages follow.
78 Quantum ATL SuperLoader Software Interface Guide
Chapter 3 Media Changer Commands
Mode Sense (6) / (10) Command (1Ah/ 5Ah)
Table 34 Mode Sense Page Descriptor

TapeAlert Page (1Ch)

Figure 44 TapeAlert Page Format Descriptor
Field Name Description
PS Parameters Savable. When 0, the supported
parameters cannot be saved (savable pages are not supported). When set to 1, it indicates that the page can be saved in nonvolatile memory by the media changer.
Additional Page Length
This field indicates the number of bytes in the page. Note that this value does not include bytes 0 and 1. The length is returned on MODE SENSE and must subsequently be set to the same value when performing MODE SELECT.
LTO only: The SuperLoader supports the TapeAlert Page that is
3
used to set/change the supported TapeAlert configuration options. Use the MODE SENSE command to read the settings of the TapeAlert page.
Bit Byte76543210
0
1
2
3
PS (0) 0 Page Code (1Ch)
Additional Page Length (0Ah)
Perf Reserved DExcpt Test Rsvd LogErr
Reserved MRIE
Quantum ATL SuperLoader Software Interface Guide 79
Chapter 3 Media Changer Commands Mode Sense (6) / (10) Command (1Ah/ 5Ah)
Bit Byte76543210
(MSB)
Interval Timer
4 - 7
(LSB)
MSB)
Report Count/Test Flag Number
8 - 11
Table 35 TapeAlert Page Format Descriptor
(LSB)
Field Name Description
PS Parameters Savable. Not supported, this bit must be 0.
Additional Page Length
This field indicates the number of bytes in the page. However, this value does not include bytes 0 and 1. The length is returned on MODE SENSE and must subsequently be set to the same value when performing MODE SELECT. If the page length does not match that expected by the drive, a CHECK CONDITION status is returned, sense key set to ILLEGAL REQUEST.
The device returns a CHECK CONDITION status with sense key set to ILLEGAL REQUEST if it receivees an unsupported Page Code or a Page field with values not supported or changeable. In such cases, no parameters are changed as a result of the command.
Perf Performance bit. Performance Impacting Exceptions are acceptable. This
bit is ignored.
DExcpt Disable Information Exception Operations. If = 0, the reporting method
specified by the contents of MRIE is selected. When this bit is set to 1, all information exception conditions are disabled regardless of the contents for the MRIE field. To enable CHECK CONDITION mode, DExcpt should = 0. Default setting = 1.
80 Quantum ATL SuperLoader Software Interface Guide
Chapter 3 Media Changer Commands
Mode Sense (6) / (10) Command (1Ah/ 5Ah)
Field Name Description
Test Test bit. Used to generate false TapeAlert conditions to test the response
to failure conditions. See the Report Count/Test Flag Number description for more information. If both Test and DExcpt are set to 1, the drive will return CHECK CONDITION status, with a send key ILLEGAL REQUEST, and additional sense data of INVALID FIELD IN PARAMETER LIST.
LogErr Error Log. Not supported.
MRIE Method for Reporting Information Exceptions. The tape drive uses the
contents of this field to report information about exception conditions.
Value Met hod
00h No reporting of Informational Exception Conditions.
The device server does not report information exception conditions.
03h Conditionally Generate Recovered Error. The device
server reports information exception conditions, if such reports of recovered errors is allowed, by returning CHECK CONDITION status on the next SCSI command (except INQUIRY and REQUEST SENSE commands) following detection of the condition. The Sense Key is set to RECOVERED ERROR with an additional sense code of 5D 00 (TapeAlert Event). The SCSI command with CHECK CONDITION completes without error prior to the report of any exception condition, and does not need to be repeated.
04h Unconditionally Generate Recoevered Error. The drive
reports information exception conditions by returning CHECK CONDITION status on the next SCSI command (except INQUIRY and REQUEST SENSE commands) following detection of the condition. The Sense Key is set to RECOVERED ERROR with an additional sense code of 5D 00 (TapeAlert Event). The SCSI command with CHECK CONDITION completes without error prior to the report of any exception condition, and does not need to be repeated.
Quantum ATL SuperLoader Software Interface Guide 81
Chapter 3 Media Changer Commands Mode Sense (6) / (10) Command (1Ah/ 5Ah)
Field Name Description
06h Only Report Informational Exception Condition on
Interval Timer Not supported.
Request. The device server preserves informational exception data. To access the data, a poll can be taken by issuing an unsolicited REQUEST SENSE command. The Sense Key is set to NO SENSE with an additional sense code of 5D 00 (TapeAlert Event).
The additional sense code of 5D 00 for values 03h, 04h, and 06h signals that a TapeAlert event has occurred. Information about the event is stored in the TapeAlert Log Page. The setting of MRIE does not impact logging of events in the TapeAlert Log Page.
Report Count/Test Flag Number

Element Address Assignment Page

Report Count or Test Flag Number. This field must be set to 0 unless the Test bit is set. When the Test bit is set, this field indicates that a test condition to be generated as follows:
Value Result
0 Change no TapeAlert Flag but report an exception
condition based on the setting of the MRIE field.
1 to 64 Set the TapeAlert flag indicated in the value and
generate an exception condition based on the MRIE field.
-1 to -64 Clear the TapeAlert flag in an equivalent manner to taking corrective action of indicated by the absolute number of the value.
32767 Set all TapeAlert flags and generate and exception
condition based on the setting of the MRIE field.
The element address assignment page is used to report element
3
address assignments to the host. This page also defines the number of each type of element present. None of the fields in this page are changeable.
82 Quantum ATL SuperLoader Software Interface Guide
Loading...