User manual QUANTUM ATL SUPERLOADER LTO SOFTWARE INTERFACE GUIDE 03-2003

[. . . ] ATL SuperLoaderTM DLT and ATL SuperLoaderTM 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. 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. Quantum Corporation may revise this publication from time to time without notice. COPYRIGHT STATEMENT © 2003 Quantum Corporation. [. . . ] Threshold checking is not supported on this page. Always set to 0 (parameter codes treated as data counter). Figure 30 Device Status Log Sense Page (0001h) Bit Byte 0 1 2-3 7 6 5 4 3 Reserved 2 1 0 Reserved Temperature Reserved Status 64 Quantum ATL SuperLoader Software Interface Guide Chapter 3 Media Changer Commands Log Sense Command (4Dh) Table 26 Device Status Log Sense (0001h) Field Name Temperature Description These two bits indicate the temperature of the device. This field follows the following format: Bit 3 0 0 1 1 Bit 2 0 1 0 1 Description Not supported OK Warning: Safe temperature exceeded. 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 0 0 1 1 Bit 0 0 1 0 1 Description Not supported OK Degraded 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 on page 68 is passed from the initiator to the 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: Page Code 1Ch 1Dh 1Eh 1Fh Description TapeAlert Page (1Ch) on page 79 (LTO only) Element Address Assignment Page on page 82 Transport Geometry Parameters Page on page 85 Device Capabilities Page on page 86 66 Quantum ATL SuperLoader Software Interface Guide Chapter 3 Media Changer Commands Mode Select (6) / (10) Command (15h / 55h) Figure 31 Mode Select (6) Command Descriptor Bit Byte 0 1 2­3 4 5 7 6 5 4 3 2 1 0 Operation Code (15h) Logical Unit Number PF Reserved Parameter List Length Unused (00) Reserved Flag Link Reserved SP (0) Figure 32 Mode Select (10) Command Descriptor Bit Byte 0 1 2­6 7-8 9 7 6 5 4 3 2 1 0 Operation Code (55h) Logical Unit Number PF Reserved Parameter List Length Unused (00) Reserved Flag Link Reserved SP (0) 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 Field Name PF 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. 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. If set, this bit instructs the SuperLoader to save all savable pages, and this is not supported. SP Mode Parameter List 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. Figure 33 Mode Select (6) Mode Parameter List Bit Byte 0-3 4 - 11 4 ­ 11 or 12 - n 7 6 5 4 3 2 1 0 Mode Parameter Header Mode Parameter Block Descriptor (Optional) Page(s) (Optional) 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 Byte 0-7 8 - 15 8-n or 16 - n 7 6 5 4 3 2 1 0 Mode Parameter Header Mode Parameter Block Descriptor (Optional) Page(s) (Optional) Table 28 Mode Select Parameter List Field Name Mode Parameter Header Mode Parameter Block Descriptor Page(s) Description 4 or 8 bytes in length, contains information about the remainder of the Parameter List and is always present. 8 bytes in length; not applicable to a media changer device. 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 Byte 0 1 2 3 7 6 5 4 3 Reserved Reserved Reserved 2 1 0 Block Descriptor Length Figure 36 Mode Select (10) Parameter Header Bit Byte 0-1 2 3 4-5 6-7 7 6 5 4 3 Reserved Reserved Reserved Reserved 2 1 0 Block Descriptor Length 70 Quantum ATL SuperLoader Software Interface Guide Chapter 3 Media Changer Commands Mode Select (6) / (10) Command (15h / 55h) Table 29 Mode Select Parameter Header Field Name Block Descriptor Length Description 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. Figure 37 Mode Select Parameter Bit Byte 0 7 6 5 4 3 Reserved 2 1 0 (MSB) 1-3 Number of Blocks (LSB) 4 (MSB) 5-7 Block Length (LSB) Reserved 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 Field Name Number of Blocks Block Length Description This field is sent as 0. It is not applicable to media changer devices. [. . . ] 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. The maximum value for this field shall be 64 bytes. A parameter list length of zero indicates that no data shall be transferred, and that subsequent REPORT DEVICE IDENTIFIER commands shall return an Identifier length of zero. [. . . ]