Page 1: Software Interface
ATL SuperLoader™ DLT and ATL SuperLoader™ LTO Software Interface Guide 81-60220-01 A02...
Page 2 Quantum ATL SuperLoader DLT and ATL SuperLoader LTO Software Interface Guide, 81-60220-01 A02, March 2003. Made in USA. Quantum Corporation provides this publication “as is” without warranty of any kind, either express or implied, including but not limited to the implied warranties of merchantability or fitness for a particular purpose.
Page 3: Table Of Contents
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 Contents...
Page 4 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 Quantum ATL SuperLoader Software Interface Guide...
Page 5 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...
Page 6 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 Quantum ATL SuperLoader Software Interface Guide...
Page 7 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 Figures...
Page 8 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...
Page 9 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...
Page 10 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 Quantum ATL SuperLoader Software Interface Guide...
Page 11 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 Tables...
Page 12 Table 40 Table 41 Table 42 Table 43 Quantum ATL SuperLoader Software Interface Guide Last n Error Events Log Sense Header ...50 Parameters Last n Error Events Log Sense...51 TapeAlert Log Sense Header Field Descriptions ...53 TapeAlert Page Log Parameters ...54 Move Statistics...56...
Page 13 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...
Page 14 Table 69 Table 70 Table 71 Quantum ATL SuperLoader Software Interface Guide Set Device Identifier Command Descriptor Block ...169 Set Device Identifier Parameter List...169 Write Buffer Command Data ...172...
Page 15: Intended Audience
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 This interface guide is a written for the following audiences: •...
Page 16: Purpose
Preface Purpose Purpose 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 This reference manual is organized as follows: •...
Page 17: Document Conventions
Decimal Notation Number followed without suffix Field Initial Caps (unless case-sensitive) Hexadecimal Notation Number followed by h Sense Key Uppercase (unless case-sensitive) Quantum ATL SuperLoader Software Interface Guide Preface Document Conventions Example Mb (megabits) MB (megabytes) SCSI 101b FORMAT UNIT...
Page 18 Preface Document Conventions xviii Quantum ATL SuperLoader Software Interface Guide...
Page 19: Chapter 1 Theory Of Operation
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...
Page 20: Theory Of Operation Superloader Dlt
Chapter 1 Theory of Operation SuperLoader DLT SuperLoader DLT 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.
Page 21: Medium Transport Element
Storage Elements 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.
Page 22: Power Cycle
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).
Page 23: Maximum Temperature Exceeded
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 Chapter 1 Theory of Operation Automatic Drive Cleaning...
Page 24: Element Status Information
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.
Page 25 SuperLoader DLT 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.
Page 26 Chapter 1 Theory of Operation Automatic Drive Cleaning Quantum ATL SuperLoader Software Interface Guide...
Page 27: Chapter 2 Messages
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...
Page 28: Table 1 Message Format
(In = target to initiator, Out = initiator to target). Table 2 Supported Message Messages ABORT BUS DEVICE RESET COMMAND COMPLETE DISCONNECT Quantum ATL SuperLoader Software Interface Guide table Message One-byte message (COMMAND COMPLETE) Extended message One-byte message Two-byte message Reserved One-byte message (IDENTIFY)
Page 29 The minimum number of bytes sent for an extended message is three. The extended message format is shown figure 1 and the data fields are described in Quantum ATL SuperLoader Software Interface Guide Chapter 2 Messages Message Format Message Code Direction 80h –...
Page 30: Figure 1 Extended Message
A value of 0 for the Extended Message Length indicates that 256 bytes follow. Extended Message Code 01h SYNCHRONOUS DATA TRANSFER REQUEST 03h WIDE DATA TRANSFER REQUEST Quantum ATL SuperLoader Software Interface Guide Extended Message (01h) Extended Message Length Extended Message Code Extended Message Arguments...
Page 31: Supported Scsi Messages
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 Chapter 2 Messages Supported SCSI Messages...
Page 32: Command Complete (00H)
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. summarizes the SuperLoader’s response. Quantum ATL SuperLoader Software Interface Guide Table 7...
Page 33: Identify (80H-Ffh)
IDENTIFY message and Figure 2 Identify Message Identify DiscPriv Quantum ATL SuperLoader Software Interface Guide Figure 2 table 5 describes the data field contents. LUNTAR Reserved Chapter 2 Messages...
Page 34: Ignore Wide Residue (23H)
This message is sent immediately following that DATA IN phase and prior to any other messages. format of an IGNORE WIDE RESIDUE message. the Ignore field bit definitions. Quantum ATL SuperLoader Software Interface Guide Figure 3 illustrates the data Table 6...
Page 35: Initiator Detected Error (05H)
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. the SuperLoader’s response. Quantum ATL SuperLoader Software Interface Guide Message Code (23h) Ignore (01h) Invalid Data Bits (16-bit Transfers)
Page 36: Linked Command Complete (0Ah)
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. Quantum ATL SuperLoader Software Interface Guide...
Page 37: Linked Command Complete, Flag (0Bh)
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 Chapter 2 Messages Supported SCSI Messages...
Page 38: No Operation (08H)
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. Quantum ATL SuperLoader Software Interface Guide...
Page 39: Synchronous Data Transfer Request (01H)
• After a hard reset condition Quantum ATL SuperLoader Software Interface Guide figure 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.
Page 40 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. Quantum ATL SuperLoader Software Interface Guide...
Page 41: Wide Data Transfer Request Extended Message (03H)
The SuperLoader LTO only supports a Transfer REQA/ACK offset of 0. This indicates asynchronous transfers. The following figure illustrates the message format. Wide Data Transfer Request Extended Message (03h) Quantum ATL SuperLoader Software Interface Guide Chapter 2 Messages Supported SCSI Messages...
Page 42: Figure 5 Wide Data Transfer Request Message
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. Quantum ATL SuperLoader Software Interface Guide Extended Message Identifier (01h) (see Extended Message Length (02h) WIDE DATA TRANSFER REQUEST (03h)
Page 43 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...
Page 44 Chapter 2 Messages Supported SCSI Messages Quantum ATL SuperLoader Software Interface Guide...
Page 45: Chapter 3 Media Changer Commands
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...
Page 46: Table 9 Supported Media Changer Commands
Persistent Reserve In Command (5Eh) Persistent Reserve Out Command (5Fh) Position to Element Command (2Bh) Prevent/Allow Medium Removal (1Eh) Read Buffer Command (3Ch) Quantum ATL SuperLoader Software Interface Guide table on page 31 on page 45 on page 46 on page 66...
Page 47: Media Changer Command Descriptions
Parameter List Length field (bytes 7 and 8) of the MODE SELECT command shown as follows: Quantum ATL SuperLoader Software Interface Guide on page 126 on page 140...
Page 48 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. Quantum ATL SuperLoader Software Interface Guide (Bytes 0 - 6)
Page 49: Initialize Element Status Command (07H)
Figure 6 Initialize Element Status Command Byte Logical Unit Number Unused Quantum ATL SuperLoader Software Interface Guide Initialize Element Status Command (07h) Operation Code (07h) Reserved Reserved Chapter 3 Media Changer Commands Reserved...
Page 50: Inquiry Command (12H)
An INQUIRY command is not affected by, nor does it clear, a Unit Attention condition. Figure 7 Inquiry Command Byte Logical Unit Number Unused Quantum ATL SuperLoader Software Interface Guide Operation Code (12h) Reserved Page Code Reserved Allocation Length Reserved...
Page 51: Standard Inquiry Data Page
Figure 9 Standard Inquiry returned by the media changer. Data Page Quantum ATL SuperLoader Software Interface Guide Chapter 3 Media Changer Commands figure 15 on page 43 and Figure 11 shows the format of the Standard Inquiry Data page...
Page 52: Figure 9 Standard Inquiry Data (Lto)
Byte Peripheral Qualifier AERC Obsolete SCCS BQue EncServ RelAdr Obsolete 8-15 16-31 32-35 Reserved 38-40 Quantum ATL SuperLoader Software Interface Guide Reserved Version NormACA HiSup Additional Length (n-4) Reserved Reserved MultiP MChngr Wbus16 Sync Linked Vendor Identification (QUANTUM ) Product Identification (UHDL)
Page 53: Figure 10 Standard Inquiry Data (Dlt)
Peripheral Qualifier ISO Version AENC TrmlOP Rsv’d MChangr RelAdr Wbus32 8-15 16-31 32-35 36-40 Quantum ATL SuperLoader Software Interface Guide Firmware Subpersonality Vendor-Specific Subtype Peripheral Device Type Device Type Modifier ECMA Version Reserved Additional Length (27h) Reserved Wbus16 Sync Linked...
Page 54: Table 10 Standard Inquiry Data (Lto And Dlt)
Modifier (DLT) Version (LTO) ISO Version (DLT) ANSI Version (DLT) AENC (DLT) AERC (LTO) Quantum ATL SuperLoader Software Interface Guide Firmware Personality Firmware Subpersonality Vendor-Specific Subtype Description Non-zero if initiator selects an invalid logical unit (see below) 8 indicates that this is a media changer device.
Page 55 Add16 (LTO) RelAdr WBUS32 (DLT) WBUS16 Sync Quantum ATL SuperLoader Software Interface Guide Chapter 3 Media Changer Commands Description Terminate I/O Process. The media changer does not support the TERMINATE I/O PROCESS message. The media changer does not support the NACA bit in the control byte of the CDB.
Page 56: Vital Product Data Page
The following sections describe the Vital Product Data Pages for Vital Product Data the system. Page Quantum ATL SuperLoader Software Interface Guide Description This device supports linked commands. This device does not support command queueing. The hard reset option is implemented in response to assertion of the SCSI BUS reset line.
Page 57: Figure 11 Supported Vital Product Data
Vital Product Data Byte Peripheral Qualifier Figure 12 Unit Serial Number Page (80h) Byte Peripheral Qualifier Quantum ATL SuperLoader Software Interface Guide Chapter 3 Media Changer Commands Peripheral Device Type Page Code (00h) Reserved Page Length (03h) 00h - (this page) 80h - Unit Serial Number Page 83h –...
Page 58: Figure 13 Device Identification Page (83H)
Figure 13 Device Identification Page (83h) Byte Peripheral Qualifier 4 - n Quantum ATL SuperLoader Software Interface Guide Reserved Page Length (0Eh) Serial Number Description The serial number given is the serial number of the media changer typically starting with “PM”...
Page 59: Figure 14 Identifier Descriptor
Table 12 Identifier Field Name Descriptor Field Descriptions Code Set Association Identifier Type Quantum ATL SuperLoader Software Interface Guide Chapter 3 Media Changer Commands Association Reserved Identifier Length (n-3) Identifier Field Description Indicates the type of data to be found in the Identifier field.
Page 60: Command Support Data
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. Quantum ATL SuperLoader Software Interface Guide Field Description Value Description Concatenation of the Vendor Name,...
Page 61: Figure 15 Command Support Data Page
The value of the Support field describes the type of support that the tape drive provides for Command Support Data. Value 000b 001b 010b 011b Quantum ATL SuperLoader Software Interface Guide Chapter 3 Media Changer Commands Peripheral Device Type Reserved ECMA Version Reserved CDB Size (m - 5)
Page 62 “reserved” in the CDB for the OpCode being queried, the map has a 0 in that corresponding bit position. Quantum ATL SuperLoader Software Interface Guide Vendor-Specific The device supports the SCSI operation code, but in a vendor-specific manner.
Page 63: Load Unload Command (1Bh)
2 - 4 Unused Table 15 Unload Field Name Command Descriptor Block Immed Quantum ATL SuperLoader Software Interface Guide Chapter 3 Media Changer Commands Operation Code (1Bh) Reserved Reserved Reserved Description Immediate. If this bit is set to 1, status is returned as soon as the operation is started.
Page 64: Log Sense Command (4Dh)
SENSE Command Descriptor Block Byte Logical Unit Number 3 - 4 (MSB) 5 - 6 (MSB) 7 - 8 Unused Quantum ATL SuperLoader Software Interface Guide Operation Code (4Dh) Reserved Page Code Reserved Parameter Pointer Allocation Length Reserved PPC (0) SP(0)
Page 65: Table 16 Log Sense Command Descriptor Block
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 Chapter 3 Media Changer Commands Log Sense Command (4Dh)
Page 66 Length allocated for returning data. The host uses this field to limit the size of data transfers to its own internal buffer size. Quantum ATL SuperLoader Software Interface Guide Page Definition Supported Pages Log Page (Page 00h) Last n Error Events Page (07h)
Page 67: Supported Pages Log Page (Page 00H)
00h) each. Figure 18 Supported Pages Page Byte Reserved (MSB) 2 – 3 Quantum ATL SuperLoader Software Interface Guide Chapter 3 Media Changer Commands Page Code (00h) Reserved Page Length (7h) Log Sense Command (4Dh) (LSB)
Page 68: Last N Error Events Page (07H)
Table 17 Last n Error Field Name Events Log Sense Header Page Code Page Length Quantum ATL SuperLoader Software Interface Guide Page Code (07h) Reserved Page Length (n) Description The Page Code echoes the page code that was specified in the LOG SENSE command descriptor block.
Page 69: Figure 20 Format For Last N Error Events Log Sense
4 - n Table 18 Parameters Field Name Last n Error Events Log Sense Parameter Code Quantum ATL SuperLoader Software Interface Guide Chapter 3 Media Changer Commands Parameter Code Parameter Length ASCII String for Event n Description The Parameter Code value represents the relative time at which the error occurred.
Page 70: Tapealert Page (2Eh)
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.
Page 71: Figure 22 Tapealert Page Log Parameters Format
Figure 22 TapeAlert Page Log Parameters Format Byte 5n – 1 5n + 1 Quantum ATL SuperLoader Software Interface Guide Chapter 3 Media Changer Commands Reserved Page Length Description The Page Code echoes the page code that was specified in the LOG SENSE command descriptor block.
Page 72: Move Statistics Page (30H)
Figure 23 Move Statistics Format Byte Reserved Quantum ATL SuperLoader Software Interface Guide Parameter Length Description This field contains the Flag code. This field is set to 1. If Bit 0 is set to 1, indicates that TapeAlert has sensed a problem.
Page 73 8-11 (MSB) 12-15 (MSB) 16-19 (MSB) 20-23 (MSB) 24-27 Quantum ATL SuperLoader Software Interface Guide Chapter 3 Media Changer Commands Page Length (18h) Total Moves Drive Loads Mail Slot Imports Mail Slot Exports Magazine Moves Magazine Loads Log Sense Command (4Dh)
Page 74: Hard/Soft Error Statistics Page (31H)
These numbers, in relation to the total number of moves performed, can provide an indication as to the health of the servo system. Quantum ATL SuperLoader Software Interface Guide Description The page code is 30h. The page length is 18h bytes.
Page 75: Figure 24 Hard/Soft Move Error Statistics Format
(MSB) (MSB) (MSB) 10-13 (MSB) 14-17 (MSB) 18-21 Quantum ATL SuperLoader Software Interface Guide Chapter 3 Media Changer Commands Page Code (31h) Reserved Page Length (22h) Servo Hard Errors Drive Soft Error Left Magazine Soft Error Right Magazine Soft Error...
Page 76: Table 22 Hard/Soft Error
Field Name Error Page Code Page Length Servo Hard Errors Soft Errors Recovery Actions Quantum ATL SuperLoader Software Interface Guide Rotation Recovery Actions Translation Recovery Actions Left Magazine Recovery Actions Right Magazine Recovery Actions Description The page code is 31h.
Page 77: Device Wellness Page (33H)
Table 23 Device Field Name Wellness Log Sense Header Page Code Page Length Quantum ATL SuperLoader Software Interface Guide Chapter 3 Media Changer Commands Page Code (33h) Reserved Page Length Description The Page Code echoes the page code that was specified in the LOG SENSE command descriptor block.
Page 78: Figure 26 Device Wellness Log Sense (0000H-000Fh)
8 - 9 (LTO only) (MSB) 10 - 11 (LTO only) 8-11 (SDLT/ only) Quantum ATL SuperLoader Software Interface Guide Parameter Code Parameter Length (0Ch) Time Stamp Source Element Destination Element Media ID Sense Key Additional Sense Code (LSB) Rsv’d...
Page 79: Figure 27 Log Parameters For Device Wellness Log Sense
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 Chapter 3 Media Changer Commands Additional Sense Code Qualifier...
Page 80: Device Status Page (3Eh)
The Device Status Page describes the current status of the media Device Status Page changer. (3Eh) Figure 28 Device Status Log Sense Header Byte Reserved (MSB) 2 - 3 Quantum ATL SuperLoader Software Interface Guide Page Code (3Eh) Reserved Page Length (LSB)
Page 81: Figure 29 Parameters For Device Status Log Sense Page
Description Parameter Code Parameter Codes 0000h through 0004h are supported: Code Description Quantum ATL SuperLoader Software Interface Guide Chapter 3 Media Changer Commands Description The Page Code echoes the page code that was specified in the LOG SENSE command descriptor block.
Page 82: Figure 30 Device Status Log Sense Page (0001H)
Threshold Met Criteria. Always 0. List Parameter. Always set to 0 (parameter codes treated as data counter). Figure 30 Device Status Log Sense Page (0001h) Byte Reserved 2 - 3 Quantum ATL SuperLoader Software Interface Guide (figure 30). Reserved Temperature Reserved Status...
Page 83: Table 26 Device Status Log Sense (0001H)
Bit 3 Status These two bits indicate the overall condition of the device. The status of the device follows the following format: Bit 1 Quantum ATL SuperLoader Software Interface Guide Chapter 3 Media Changer Commands Bit 2 Description Not supported Warning: Safe temperature exceeded.
Page 84: Mode Select (6) / (10) Command (15H / 55H)
The MODE SELECT pages supported, and the page within this manual that details each, are: Page Code Quantum ATL SuperLoader Software Interface Guide on page 68 is passed from the initiator to the Description TapeAlert Page (1Ch)
Page 85: Figure 31 Mode Select (6) Command Descriptor
Descriptor Byte Logical Unit Number 2 – 6 7 - 8 Unused (00) Quantum ATL SuperLoader Software Interface Guide Chapter 3 Media Changer Commands Mode Select (6) / (10) Command (15h / 55h) Operation Code (15h) Reserved Parameter List Length...
Page 86: Mode Parameter List
0 - 3 4 - 11 4 – 11 or 12 - n Quantum ATL SuperLoader Software Interface Guide Description 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.
Page 87: Figure 34 Mode Select (10) Mode Parameter List
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 Mode Select (6) / (10) Command (15h / 55h) Mode Parameter Header...
Page 88: Figure 35 Mode Select (6) Parameter Header
Select (6) Parameter Header Byte Figure 36 Mode Select (10) Parameter Header Byte 0 - 1 4 - 5 6 - 7 Quantum ATL SuperLoader Software Interface Guide Reserved Reserved Reserved Block Descriptor Length Reserved Reserved Reserved Reserved Block Descriptor Length...
Page 89: Figure 37 Mode Select Parameter
(MSB) 1 - 3 (MSB) 5 - 7 Quantum ATL SuperLoader Software Interface Guide Chapter 3 Media Changer Commands Mode Select (6) / (10) Command (15h / 55h) Description This field specifies the length in bytes of all the block descriptors.
Page 90: Figure 38 Mode Select
Descriptor Byte PS (0) 2 - n Quantum ATL SuperLoader Software Interface Guide Description This field is sent as 0. It is not applicable to media changer devices. This field is sent as 0. It is not applicable to media changer devices.
Page 91: Table 31 Mode Select
Additional Page Length Page-Defined or Vendor Specific Parameter List Quantum ATL SuperLoader Software Interface Guide Chapter 3 Media Changer Commands Mode Select (6) / (10) Command (15h / 55h) Description Parameters Savable. For the MODE SELECT (6) (10) commands, this field is reserved (0).
Page 92: Mode Sense (6) / (10) Command (1Ah/ 5Ah)
Sense (6) Command Descriptor Block Byte Logical Unit Number Unused The MODE SENSE (10) command returns descriptor data in a different format than MODE SENSE (6). Quantum ATL SuperLoader Software Interface Guide Operation Code (1Ah) Rsv’d Page Code Reserved Allocation Length Reserved...
Page 93: Figure 40 Mode Sense (10) Command Descriptor Block
Page Control. The Page Control field indicates the type of page parameter values to be returned to the host: Quantum ATL SuperLoader Software Interface Guide Mode Sense (6) / (10) Command (1Ah/ 5Ah) Operation Code (5Ah) Rsv’d...
Page 94: Mode Sense Data Headers
Page Code and Allocation Length. The MODE SENSE (6) and MODE SENSE (10) headers are Mode Sense Data illustrated in the following figures. Headers Quantum ATL SuperLoader Software Interface Guide Report Default Values Report Saved Values Description TapeAlert Page (1Ch)
Page 95: Figure 41 Mode Sense (6) Data Header
Byte (MSB) 0 - 1 4 - 5 (MSB) 6 - 7 Quantum ATL SuperLoader Software Interface Guide Chapter 3 Media Changer Commands Mode Sense (6) / (10) Command (1Ah/ 5Ah) Mode Sense Data Length Reserved Reserved Block Descriptor Length (0)
Page 96: Mode Sense Mode
Descriptions of the MODE SENSE page descriptor fields are provided in the following table. Detailed descriptions of each of the MODE SENSE Pages follow. Quantum ATL SuperLoader Software Interface Guide Description This field specifies the length (in bytes) of the MODE SENSE data that is available to be transferred during the DATA IN phase.
Page 97: Tapealert Page (1Ch)
Descriptor Byte PS (0) Perf Reserved Quantum ATL SuperLoader Software Interface Guide Chapter 3 Media Changer Commands Mode Sense (6) / (10) Command (1Ah/ 5Ah) Description Parameters Savable. When 0, the supported parameters cannot be saved (savable pages are not supported).
Page 98: Table 35 Tapealert Page Format Descriptor
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. Quantum ATL SuperLoader Software Interface Guide Interval Timer Report Count/Test Flag Number (LSB)
Page 99 Method for Reporting Information Exceptions. The tape drive uses the contents of this field to report information about exception conditions. Value Quantum ATL SuperLoader Software Interface Guide Chapter 3 Media Changer Commands Mode Sense (6) / (10) Command (1Ah/ 5Ah) Method No reporting of Informational Exception Conditions.
Page 100: Element Address Assignment Page
Assignment Page of each type of element present. None of the fields in this page are changeable. Quantum ATL SuperLoader Software Interface Guide Only Report Informational Exception Condition on Request. The device server preserves informational exception data. To access the data, a poll can be taken by issuing an unsolicited REQUEST SENSE command.
Page 101: Figure 45 Element Address Assignment Page
(MSB) (MSB) (MSB) 10-11 (MSB) 12-13 Quantum ATL SuperLoader Software Interface Guide Chapter 3 Media Changer Commands Mode Sense (6) / (10) Command (1Ah/ 5Ah) Page Code (1Dh) Parameter List Length (12h) First Medium Transport Element Address Number of Medium Transport Elements...
Page 102: Table 36 Element Address Assignment Page
Number of Storage Elements First Import/Export Element Address Number of Import/Export Elements Quantum ATL SuperLoader Software Interface Guide First Data Transfer Element Address Number of Data Transfer Elements Reserved Description Identifies the address of the first medium transport element contained in the media changer. The SuperLoader uses the default address of 0.
Page 103: Transport Geometry Parameters Page
RSVD The geometry of each medium transport element is defined using a two-byte field as defined in Quantum ATL SuperLoader Software Interface Guide Mode Sense (6) / (10) Command (1Ah/ 5Ah) Description Identifies the address of the first data transfer element contained in the media changer.
Page 104: Device Capabilities Page
This information may be employed by Page the initiator to determine functions permitted by the MOVE MEDIUM command. None of the fields in the page are changeable. Quantum ATL SuperLoader Software Interface Guide Reserved Member Number In Transport Element Set Description Specifies the number of bytes of transport geometry descriptors to follow.
Page 105: Figure 48 Device Capabilities Page
PS (0) RSVD Reserved Reserved Reserved Reserved Reserved 8-11 Reserved Reserved Reserved Quantum ATL SuperLoader Software Interface Guide Mode Sense (6) / (10) Command (1Ah/ 5Ah) Page Code (1Fh) Parameter Length (12h) STORDT STORI/E Reserved MT->DT MT->I/E ST->DT ST->I/E I/E->DT I/E->I/E...
Page 106: Table 38 Device Capabilities Page
In the descriptions, XX and YY are any of the element type abbreviations. Table 38 Device Field Name Capabilities Page STORXX XX->YY XX<>YY Quantum ATL SuperLoader Software Interface Guide DT<>DT DT<>I/E Reserved figure 48 on page 87 use the following element Description Parameters Savable. This bit is reserved for MODE SELECT and must be 0.
Page 107: Move Medium Command (A5H)
Figure 49 Move Medium Descriptor Block Byte Logical Unit Number (MSB) (MSB) (MSB) Unused Quantum ATL SuperLoader Software Interface Guide Operation Code (A5h) Medium Transport Address Source Address Destination Address Reserved Reserved Reserved Chapter 3 Media Changer Commands Move Medium Command (A5h)
Page 108: Table 39 Move Medium Command
The device capabilities MODE SENSE page provides a matrix with the supported source element or destination element combinations for the MOVE MEDIUM command. Quantum ATL SuperLoader Software Interface Guide Description Must be set to 0. Specifies the medium transport element that is to be used in executing this command.
Page 109: Persistent Reserve In Command (5Eh)
Reserve In Descriptor Block Byte Reserved 2 - 6 (MSB) 7 – 8 Unused Quantum ATL SuperLoader Software Interface Guide Operation Code (5Eh) Reserved Allocation Length Reserved Chapter 3 Media Changer Commands Persistent Reserve In Command (5Eh) Service Action (LSB)
Page 110: Table 40 Persistent Reserve In Command
PERSISTENT RESERVE IN command with an Allocation Length field large enough to contain the entire list of parameters. Quantum ATL SuperLoader Software Interface Guide Name Description Read Keys...
Page 111: Figure 51 Read Keys Parameters
4 - 7 (MSB) 8 - 15 â (MSB) n – 7 Quantum ATL SuperLoader Software Interface Guide Generation Additional Length (n – 7) (Reservation Key List Follows in Bytes 8 – n) First Reservation Key Last Reservation Key Chapter 3 Media Changer Commands...
Page 112: Table 41 Read Keys Parameters
Key service actions. Each key can be examined by the application client for correlation with a set of initiators and SCSI ports. The following figure and table illustrate and describe the data fields of Read Reservations data parameters. Quantum ATL SuperLoader Software Interface Guide...
Page 113: Figure 52 Read Reservations Parameters
Parameters Byte (MSB) 0 - 3 (MSB) 4 - 7 (MSB) 8 - n Quantum ATL SuperLoader Software Interface Guide Generation Additional Length (n – 7) Reservation Descriptors Chapter 3 Media Changer Commands Persistent Reserve In Command (5Eh) (LSB) (LSB)
Page 114: Table 42 Read Reservations Parameters
97 detail the contents of each Reservation Descriptors field. The figure and table below illustrate and describe the data fields of each Read Reservations descriptor’s data fields. Quantum ATL SuperLoader Software Interface Guide Figure 53 on page 97 and...
Page 115: Figure 53 Persistent Reserve In Read Reservations
The SuperLoader does not support reservations of elements, so this field is always 0. Quantum ATL SuperLoader Software Interface Guide Chapter 3 Media Changer Commands Persistent Reserve In Command (5Eh)
Page 116 Each of the codes provides handling instructions for READ operations, for WRITE operations, and for subsequent attempts to establish persistent reservations, referred to as “Additional Reservations Allowed” in the table. Quantum ATL SuperLoader Software Interface Guide Name Description Logical Unit. Persistent reservation applies to the full logical unit.
Page 117: Table 44 Persistent Reservation Type Codes
Obsolete Quantum ATL SuperLoader Software Interface Guide Chapter 3 Media Changer Commands Persistent Reserve In Command (5Eh)
Page 118 ADDITIONAL RESERVATIONS: Allowed; any initiator may reserve the logical unit, extents, or elements as long as the persistent reservations to not conflict with any reservations already known to the device server. 7h-Fh Reserved Not applicable Quantum ATL SuperLoader Software Interface Guide...
Page 119: Persistent Reserve Out Command (5Fh)
“greedy” initiators. The figure that follows illustrates the format of the PERSISTENT RESERVE OUT command; the table that follows explains the data fields of the command. Quantum ATL SuperLoader Software Interface Guide...
Page 120: Figure 54 Persistent Reserve Out Descriptor
Service actions that require information about persistent reservation and registrations may require enabling of nonvolatile memory within the logical unit. Service action codes available are: Code Quantum ATL SuperLoader Software Interface Guide Operation Code (5Fh) Reserved Parameter List Length (18h) Reserved...
Page 121 The value in this field indicates whether a persistent reservation applies to an entire logical unit or to an element. The values for the Scope field are: Code Quantum ATL SuperLoader Software Interface Guide Reserve Create a persistent reservation using a reservation key...
Page 122 The following table provides detailed descriptions of each of the PERSISTENT RESERVE OUT command’s seven possible service actions. Service Action codes appear in bits 0–4 of Byte 1. Quantum ATL SuperLoader Software Interface Guide Element Persistent reservation applies to the specified element.
Page 123: Table 45 Persistent Reserve Out Command Service Action
PERSISTENT RESERVE OUT command that specifies a Release, Clear, Pre-empt, or Pre-empt and Clear service action. Quantum ATL SuperLoader Software Interface Guide Chapter 3 Media Changer Commands Persistent Reserve Out Command (5Fh)
Page 124 Clear, Pre-empt, or Pre- empt and Clear. Note that a Release service action should not be performed if any operations interlocked by the persistent reservation have not yet completed. Quantum ATL SuperLoader Software Interface Guide...
Page 125 The sense key is set to UNIT ATTENTION; the additional sense data is set to RESERVATIONS PREEMPTED. Commands that follow are subject to the persistent reservation restrictions set by the pre-empting initiator. Quantum ATL SuperLoader Software Interface Guide Chapter 3 Media Changer Commands Persistent Reserve Out Command (5Fh)
Page 126 PERSISTENT RESERVE OUT that specifies either the Pre-empt or the Pre-empt and Clear service actions. New persistent reservations that do not conflict with an existing persistent reservation execute normally. Quantum ATL SuperLoader Software Interface Guide...
Page 127 Pre-empt or Pre-empt & Clear service action. New persistent reservations not in conflict with an existing persistent reservation execute normally. Quantum ATL SuperLoader Software Interface Guide Chapter 3 Media Changer Commands Persistent Reserve Out Command (5Fh)
Page 128: Table 46 Persistent Reservation Type Codes
WRITES: Exclusive; any command from any initiator other than the initiator holding the persistent reservation that attempts a transfer to the storage medium results in a reservation conflict. Quantum ATL SuperLoader Software Interface Guide...
Page 129 Only WRITES: Exclusive; any command from an initiator that has not previously performed a Register service action with the device server that attempts a transfer to the storage medium results in a reservation conflict. Exclusive READS: Exclusive; any command from an initiator that has not...
Page 130: Figure 56 Persistent Reserve Out Parameter List
Persistent Reserve Out Command (5Fh) Figure 56 Persistent Reserve Out Parameter List Byte (MSB) (MSB) 8-15 (MSB) 16-19 22-23 Quantum ATL SuperLoader Software Interface Guide Reservation Key Service Action Reservation Key Scope-Specific Address Reserved Reserved Obsolete (LSB) (LSB) (LSB) APTPL...
Page 131: Table 47 Persistent Reserve Out Parameter List
Service Action Reservation Key to match any registered keys results in the device server returning a RESERVATION CONFLICT status. Quantum ATL SuperLoader Software Interface Guide Chapter 3 Media Changer Commands Persistent Reserve Out Command (5Fh)
Page 132 The following table illustrates which fields are set by the application client and interpreted by the device server for each Service and Scope value. Quantum ATL SuperLoader Software Interface Guide...
Page 133: Table 48 Device Server Interpretation Of Service And Scope Value
Ignored Pre-empt Valid Pre-empt & Valid Clear Register Ignored Ignored and Ignore Existing Quantum ATL SuperLoader Software Interface Guide Chapter 3 Media Changer Commands Persistent Reserve Out Command (5Fh) Service Action Reservation Key Valid Ignored Ignored Ignored Valid Valid Valid...
Page 134: Position To Element Command (2Bh)
Transport Address element and the Destination Address element. Figure 57 Position to Element Descriptor Byte Logical Unit Number (MSB) (MSB) Unused Quantum ATL SuperLoader Software Interface Guide Operation Code (2Bh) Medium Transport Address Destination Address Reserved Reserved Reserved Reserved (LSB)
Page 135: Table 49 Position To Element Command
Medium Transport Address Destination Address Invert Quantum ATL SuperLoader Software Interface Guide Chapter 3 Media Changer Commands Position to Element Command (2Bh) Description Address of the medium transport element to position. Must be set to 0. Address of the element in which to position the medium transport element.
Page 136: Prevent/Allow Medium Removal (1Eh)
On-board Remote Management control. It does not prevent removal via the SCSI Load Unload command. Figure 58 Prevent/ Allow Medium Removal Byte Logical Unit Number 2 - 3 Unused Quantum ATL SuperLoader Software Interface Guide Operation Code (1Eh) Reserved Reserved Reserved Reserved Prevent Flag Link...
Page 137: Table 50 Prevent/Allow Medium Removal Command Descriptor Block
Field Name Allow Medium Removal Command Prevent Descriptor Block Quantum ATL SuperLoader Software Interface Guide Chapter 3 Media Changer Commands Prevent/Allow Medium Removal (1Eh) Description When set to 1, removal via operator control is disabled. A MOVE MEDIUM command with a destination address equal to the mail slot would return a CHECK CONDITION status.
Page 138: Read Buffer Command (3Ch)
Figure 59 Read Buffer Command Descriptor Block Byte Logical Unit Number (MSB) 3 - 5 (MSB) 6 - 8 Unused Quantum ATL SuperLoader Software Interface Guide Operation Code (3Ch) Reserved Buffer ID Buffer Offset Allocation Length Reserved Mode (LSB) (LSB)
Page 139: Table 51 Read Buffer Command Descriptor Block
Offset/Allocation Length fields of the CDB. Once the size of the buffer is known, Mode 2 (Data Only, see page 123) can be used to transfer the data across the SCSI Bus. Quantum ATL SuperLoader Software Interface Guide Chapter 3 Media Changer Commands Description...
Page 140: Combined Header And Data Mode (000B)
This number is not reduced to reflect the allocation length, nor is it reduced to reflect the actual number bytes written using the WRITE BUFFER command. Following the READ BUFFER header, the target transfers data from its data buffer. Quantum ATL SuperLoader Software Interface Guide Reserved Available Length (LSB)
Page 141: Data Mode (0010B)
WRITE BUFFER command with the mode field set to Echo Buffer was issued. The Buffer ID and Buffer Offset fields are ignored in this mode. Quantum ATL SuperLoader Software Interface Guide Chapter 3 Media Changer Commands Offset Boundaries (0h)
Page 142: Echo Buffer Descriptor Mode (1011B)
The allocation length should be set to four or greater. The device shall transfer the lesser of the allocation length or four bytes of READ BUFFER descriptor. Figure 62 Echo Buffer Descriptor Byte Reserved Quantum ATL SuperLoader Software Interface Guide Reserved Reserved Buffer Capacity Buffer Capacity EBOS...
Page 143: Table 53 Echo Buffer Descriptor
Table 53 Echo Buffer Field Name Descriptor EBOS Buffer Capacity Quantum ATL SuperLoader Software Interface Guide Chapter 3 Media Changer Commands Read Buffer Command (3Ch) Description Echo Buffer Overwritten Supported. Set to 1 to indicate the drive will return the ECHO BUFFER...
Page 144: Read Element Status Command (B8H)
Figure 63 Read Element Status Descriptor Byte Logical Unit Number (MSB) (MSB) (MSB) Unused Quantum ATL SuperLoader Software Interface Guide Operation Code (B8h) VOLTAG Starting Element Address Number Of Elements Reserved Allocation Length Reserved Reserved Element Type Code...
Page 145: Table 54 Read Element Status Command Descriptor Block
When set to 1, the SuperLoader will return the current element status information. When set to 0, the SuperLoader may cause device motion to confirm element status data. Quantum ATL SuperLoader Software Interface Guide Chapter 3 Media Changer Commands Read Element Status Command (B8h)
Page 146: Element Status Data
Figure 64 Element Status Data Header Byte (MSB) Quantum ATL SuperLoader Software Interface Guide figure 64 Element Status Page on page 137. Element status data First Element Address Reported Number Of Elements Available...
Page 147: Table 55 Element Status Data
Elements Available Byte Count Of Report Available Quantum ATL SuperLoader Software Interface Guide Byte Count Of Report Available (all pages, n-7) Element status page(s) The READ ELEMENT STATUS command can be issued with an Allocation Length of eight bytes in order to determine the Allocation Length required to transfer all the element status data specified by the command.
Page 148: Element Status Page
Figure 65 Element Status Page Byte PVOLTAG AVOLTAG (MSB) (MSB) Quantum ATL SuperLoader Software Interface Guide Element Type Code Element Descriptor Length Reserved Byte Count Of Descriptor Data Available (all pages, y-7) Element descriptor(s) figure 65. Each element...
Page 149: Medium Transport Element Descriptor
Transport Element Descriptor Element Descriptor Figure 67 Medium Transport Element Descriptor Quantum ATL SuperLoader Software Interface Guide Chapter 3 Media Changer Commands Read Element Status Command (B8h) Description Indicates the element type (see reported by this page. When set to 1, indicates that the Primary Volume Tag Information field is present in each of the following element descriptor blocks.
Page 150: Figure 67 Medium Transport Element Descriptor
Byte SVALID Invert 10-11 (36 bytes) (1 byte) (1 byte) (1 byte) (1 byte) Quantum ATL SuperLoader Software Interface Guide Element Address Reserved Reserved Additional Sense Code Additional Sense Code Qualifier Reserved Source Storage Element Address ••• Primary Volume Tag Information (field omitted if PVOLTAG=0) •••...
Page 151: Table 56 Medium Transport Element Descriptor
Except bit is one. SVALID When set to 1, indicates that the Source Storage Element Address field and the Invert bit information are valid. A value of zero indicates that the values in these fields are not valid.
Page 152: Storage Element Descriptor
Storage Element Descriptor Figure 68 Storage Element Descriptor Byte SVALID Invert 10-11 (36 bytes) Quantum ATL SuperLoader Software Interface Guide defines the storage element descriptor. Element Address Reserved Access Reserved Additional Sense Code Additional Sense Code Qualifier Reserved Source Storage Element Address •••...
Page 153: Import/Export Element Descriptor
Storage Element Address NOTE: For fields not defined in this table, see Figure 69 Import/Export Element Descriptor Quantum ATL SuperLoader Software Interface Guide ••• Reserved Reserved Reserved Identifier Length Description Indicates that access to the element by a medium transport element is allowed. An Access bit of zero indicates that access to the element by the medium transport element is denied.
Page 154: Figure 69 Import/Export Element Descriptor
Byte Reserved SVALID Invert 10-11 (36 bytes) (1 byte) (1 byte) (1 byte) (1 byte) Quantum ATL SuperLoader Software Interface Guide Element Address INENAB EXENAB Access Reserved Additional Sense Code Additional Sense Code Qualifier Reserved Source Storage Element Address •••...
Page 155: Data Transfer Element Descriptor
NOTE: For fields not defined in this table, see Figure 70 Data Transfer Element Descriptor Quantum ATL SuperLoader Software Interface Guide Chapter 3 Media Changer Commands Read Element Status Command (B8h) Description This field is sent as 1 to indicate that the import/ export element supports movement of media into the scope of the media changer device.
Page 156: Figure 70 Data Transfer Element Descriptor
Figure 70 Data Transfer Element Descriptor Byte Not BUS SVALID 10-11 (36 bytes) (1 byte) (1 byte) Quantum ATL SuperLoader Software Interface Guide Element Address Reserved Reserved Additional Sense Code Additional Sense Code Qualifier RSVD Valid Valid SCSI BUS Address...
Page 157: Table 59 Data Transfer Element Descriptor
LU Valid Logical Unit Number SCSI BUS Address NOTE: For fields not defined in this table, see Quantum ATL SuperLoader Software Interface Guide Chapter 3 Media Changer Commands Read Element Status Command (B8h) Reserved Identifier Length Description When set to 1 it indicates access to the data transfer element by the medium transport element is allowed.
Page 158: Release Element (10) Command (57H)
Figure 71 Release (10) Descriptor Block Byte Reserved 4 - 6 (MSB) 7 - 8 Unused Quantum ATL SuperLoader Software Interface Guide Operation Code (57h) 3rdPty Reserved Reservation Identification Third Party Device ID Reserved Parameter List Length Reserved...
Page 159: Table 60 Release (10) Command
Element Reservation Identification Third Party Device ID Quantum ATL SuperLoader Software Interface Guide Chapter 3 Media Changer Commands Release Element (10) Command (57h) Description 3rdPty Release allows an initiator to release a logical unit that was previously reserved. If the value in this field is 0, third party release is not requested.
Page 160: Figure 72 Release (10) Id Only Parameter List
(10) ID Only Parameter List Byte (MSB) 0 - 7 Quantum ATL SuperLoader Software Interface Guide Description The contents of this field specify the length, in bytes, of the parameter list that will be transferred from the initiator to the target.
Page 161: Release Unit (6) Command (17H)
RELEASE ELEMENT (10) should be used instead. Figure 73 Release Unit (6) Descriptor Block (LTO) Byte Logical Unit Number 2 - 4 Unused Quantum ATL SuperLoader Software Interface Guide Chapter 3 Media Changer Commands Operation Code (17h) Obsolete Reserved Reserved Release Unit (6) Command (17h) Rsv’d...
Page 162: Figure 74 Release Unit (6) Descriptor Block (Dlt)
Release Unit (6) Command (17h) Figure 74 Release Unit (6) Descriptor Block (DLT) Byte Logical Unit Number 2 - 4 Unused Quantum ATL SuperLoader Software Interface Guide Operation Code (17h) 3rdPty Third Party Device ID Reserved Reserved Rsv’d Flag Link...
Page 163: Report Device Identifier Command (A3H)
Device Identifier Descriptor Byte Reserved 2 - 5 (MSB) 6 - 9 Unused Quantum ATL SuperLoader Software Interface Guide Report Device Identifier Command (A3h) Operation Code (A3h) Service Action (05h) Reserved Allocation Length Reserved Reserved Chapter 3 Media Changer Commands...
Page 164: Figure 76 Report Device Identifier
Device Identifier Byte (MSB) 0 - 3 4 - n Quantum ATL SuperLoader Software Interface Guide Description Must be 05h. Any other value will return Check Condition, Illegal request. If the Allocation Length is not sufficient to contain all the parameter data, the first portion of the data shall be returned.
Page 165: Table 62 Report Device Identifier Parameter Data
Device Identifier Parameter Data Identifier Length Identifier Quantum ATL SuperLoader Software Interface Guide Chapter 3 Media Changer Commands Report Device Identifier Command (A3h) Description Specifies the length in bytes of the Identifier field. If the Allocation Length field in the CDB is too small to transfer all of the identifier, the length is not adjusted to reflect the truncation.
Page 166: Report Luns Command (A0H)
Figure 77 Report LUNS Descriptor Byte 1 - 5 (MSB) 6 – 9 Unused Quantum ATL SuperLoader Software Interface Guide Operation Code (A0h) Reserved Allocation Length Reserved Reserved (LSB) Flag...
Page 167: Figure 78 Lun Reporting Parameter List
0 - 3 4 - 7 (MSB) 8 - 15 n-7 – n Quantum ATL SuperLoader Software Interface Guide Chapter 3 Media Changer Commands LUN List Length (n – 7) Reserved LUN (first LUN) LUN (last LUN, if more than one)
Page 168 If the allocation length in the CDB is too small to allow transfer of information about all of the logical units configured, the LUN list length value is not adjusted to reflect the truncation. Quantum ATL SuperLoader Software Interface Guide...
Page 169: Request Sense Command (03H)
2 - 3 Unused Figure 80 Request Field Sense Command Data Allocation Length Quantum ATL SuperLoader Software Interface Guide Chapter 3 Media Changer Commands Operation Code (03h) Reserved Allocation Length Reserved Description This field specifies the maximum number of sense bytes to be returned.
Page 170: Figure 81 Request Sense
Figure 81 Request Sense Byte Valid Filemark (MSB) 3 - 6 (MSB) 8 - 11 Quantum ATL SuperLoader Software Interface Guide Error Code Obsolete Reserved Information Bytes Additional Sense Length (0Ah) Command-Specific Information Bytes Additional Sense Code (ASC) Sense Key...
Page 171: Table 64 Request Sense Data
Indicates generic information describing an error or exception condition. Sense keys are defined in Information Bytes Not applicable to a media changer device. This field should always be 0. Quantum ATL SuperLoader Software Interface Guide Chapter 3 Media Changer Commands Additional Sense Code Qualifier (ASCQ) Sub-Assembly Code (0)
Page 172 For a multi-bit field, it points to the most significant bit of the field. Field Pointer This field indicates which byte of the Command Descriptor Block or Parameter List is in error. For a multi-byte field, the most significant byte is indicated. Quantum ATL SuperLoader Software Interface Guide...
Page 173: Table 65 Supported Sense Keys For Request Sense
The following table provides the additional sense codes (ASCs) and additional sense code qualifiers (ASCQs) that may be reported. Additional information, explanations, or suggestions for action are included in some of the descriptions. Quantum ATL SuperLoader Software Interface Guide Chapter 3 Media Changer Commands Request Sense Command (03h)
Page 174: Table 66 Supported Asc / Ascq (Hex) For Request Sense
Request Sense Sense Key NO SENSE RECOVERED ERROR NOT READY HARDWARE ERROR Quantum ATL SuperLoader Software Interface Guide ASCQ Description No Additional Sense Code SCSI Parity Error IDE Message Received Failure Predictive Threshold Exceeded Failure Predictive Threshold Exceeded (False) Unit Not Ready, Calibration/Initialization in...
Page 175 Sense Key ILLEGAL REQUEST Quantum ATL SuperLoader Software Interface Guide Chapter 3 Media Changer Commands ASCQ Description POST Soft Error Media Load Failure Media Unload Failure Parameter List Length Error Illegal Opcode Invalid Element Address Invalid CDB Field Invalid Offset...
Page 176 Chapter 3 Media Changer Commands Request Sense Command (03h) Sense Key UNIT ATTENTION Quantum ATL SuperLoader Software Interface Guide ASCQ Description Media Source Element Empty Magazine Not Accessible Magazine Removed Media Removal Prevented Insufficient Registration Resources Not Ready To Ready Transition...
Page 177 Sense Key COMMAND ABORTED Quantum ATL SuperLoader Software Interface Guide Chapter 3 Media Changer Commands ASCQ Description Device Identifier Changed Operating Conditions have Changed Echo Buffer Overwritten Message Error Unexpected Selection Interrupt Command Complete Sequence Failure SCSI Chip, Gross Error/ Illegal – Command...
Page 178: Reserve Element (10) Command (56H)
Figure 82 Reserve Element (10) Descriptor Byte Reserved 4 - 6 (MSB) 7 - 8 Unused Quantum ATL SuperLoader Software Interface Guide figure table 67 on page 161. Operation Code (56h) 3rdPty Reserved Reservation Identification Third Party Device ID Reserved...
Page 179: Table 67 Reserve Element (10) Command
If the LongID bit = 1 and the Element bit = 0, then the parameter list length is eight and the parameter list has the following format. Quantum ATL SuperLoader Software Interface Guide Chapter 3 Media Changer Commands Reserve Element (10) Command (56h)
Page 180: Figure 83 Reserve (10) Id Only Parameter List
Chapter 3 Media Changer Commands Reserve Element (10) Command (56h) Figure 83 Reserve (10) ID Only Parameter List Byte (MSB) 0 - 7 Quantum ATL SuperLoader Software Interface Guide Third Party Device ID (LSB)
Page 181: Reserve Element (6) Command (16H)
The Reserve Element (10) must be used instead. Figure 84 Reserve Element (6) Descriptor (LTO) Byte Logical Unit Number 2 - 4 Unused Quantum ATL SuperLoader Software Interface Guide Chapter 3 Media Changer Commands Operation Code (16h) Obsolete Reserved Reserved Reserve Element (6) Command (16h) Rsv’d...
Page 182: Figure 85 Reserve Element (6) Descriptor (Dlt)
If, after honoring the reservation, any other initiator attempts to perform any command except INQUIRY, REQUEST SENSE, or RELEASE ELEMENT, the command is rejected with a Quantum ATL SuperLoader Software Interface Guide Operation Code (16h) 3rdPty Third Party Device ID...
Page 183 Chapter 3 Media Changer Commands Reserve Element (6) Command (16h) RESERVATION CONFLICT status. That logical unit ignores a RELEASE ELEMENT command issued by another initiator. Quantum ATL SuperLoader Software Interface Guide...
Page 184: Send Diagnostic Command (1Dh)
(MSB) 3 - 4 Unused Table 68 Send Field Diagnostic Command Data Selftst DevOfl Quantum ATL SuperLoader Software Interface Guide Operation Code (1Dh) PF (0) Reserved Reserved Parameter List Length Reserved Description Page Format. Not supported; must be 0. Self Test. A Selftst bit of 1 directs the media changer to perform its default self test.
Page 185 DevOfl to specify the type of testing to be done. This bit must be set to 0. Parameter Not supported; must be 0. List Length Quantum ATL SuperLoader Software Interface Guide Chapter 3 Media Changer Commands Send Diagnostic Command (1Dh)
Page 186: Set Device Identifier Command (A4H)
(MSB) 6 - 9 Unused The Identifier field shall be a vendor specific value, to be returned in subsequent REPORT DEVICE IDENTIFIER commands. Quantum ATL SuperLoader Software Interface Guide Operation Code (A4h) Service Action (06h) Reserved Parameter List Length Reserved...
Page 187: Figure 88 Set Device Identifier Parameter List
Table 70 Set Device Field Identifier Parameter List Identifier Quantum ATL SuperLoader Software Interface Guide Chapter 3 Media Changer Commands Description Must be 06h. Any other value will return Check Condition, Illegal request. Specifies the length in bytes of the Identifier that shall be transferred from the application client to the device server.
Page 188: Test Unit Ready Command (00H)
Due to power cycle and code update, it is possible to get multiple check conditions on a TEST UNIT READY command. Figure 89 Test Unit Ready Descriptor Byte Logical Unit Number 2 - 4 Unused Quantum ATL SuperLoader Software Interface Guide Operation Code (00h) Reserved Reserved Reserved Flag Link...
Page 189: Write Buffer Command (3Bh)
Descriptor Byte Logical Unit Number (MSB) 3 - 5 (MSB) 6 - 8 Unused Quantum ATL SuperLoader Software Interface Guide Operation Code (3Bh) Reserved Buffer ID Buffer Offset Transfer Length Reserved Chapter 3 Media Changer Commands Write Buffer Command (3Bh)
Page 190: Write Combined Header And Data Mode (0000B)
Write Data Mode header in the data passed to the target. Any potential buffer (0010b) overruns are detected and the command is rejected. Quantum ATL SuperLoader Software Interface Guide Description Write Combined Header and Data Mode (0000b) only) Write Data Mode (0010b)
Page 191: Download Microcode Mode (0100B)
WRITE BUFFER command the data shall be preserved in the Echo Buffer unless there is an intervening command to write the Echo Buffer or the device is reset in anyway. Quantum ATL SuperLoader Software Interface Guide Chapter 3 Media Changer Commands During the actual reprogramming of the FLASH...
Page 192 Chapter 3 Media Changer Commands Write Buffer Command (3Bh) Quantum ATL SuperLoader Software Interface Guide...
Page 193 ASC/ASCQ codes Request Sense (media changer) Bus Device Reset message 13 Command Complete message 14 Commands media changer 27 Quantum ATL SuperLoader Software Interface Guide Index Disconnect message 14 Identify message 15 Ignore Wide Residue message 16 Initialize Element Status command...
Page 194 Message Reject message 19 Messages Abort 13 Command Complete 14 Disconnect 14 Identify 15 Quantum ATL SuperLoader Software Interface Guide Ignore Wide Residue 16 Initiator Detected Error 17 Linked Command Complete 18 Linked Command Complete with flag 19 message format 9...
Page 195 Set Device Identifier command 168 Tape drive commands Load Unload 45 Read Buffer 120 Set Device Identifier 168 Test Unit Ready command Quantum ATL SuperLoader Software Interface Guide media changer 170 Wide Data Transfer Request extended message 23 Write Buffer command media changer 171...
Page 196 Index Quantum ATL SuperLoader Software Interface Guide...

This manual is also suitable for:

Atl superloader dlt Atl superloader atl Superloader lto

Quantum SuperLoader DLT User Manual

Chapter 1 Theory of Operation

Chapter 2 Messages

Chapter 3 Media Changer Commands

Quick Links

Software Interface

Related Manuals for Quantum SuperLoader DLT

Summary of Contents for Quantum SuperLoader DLT