User manual QUANTUM ATL SUPERLOADER DLT 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. Making copies or adaptations without prior written authorization of Quantum Corporation is prohibited by law and constitutes a punishable violation of the law. [. . . ] 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. 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. 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. Figure 38 Mode Select Page Descriptor Bit Byte 0 1 2-n 7 PS (0) 6 0 5 4 3 2 Page Code 1 0 Additional Page Length Page-Defined or Vendor Specific Parameter List 72 Quantum ATL SuperLoader Software Interface Guide Chapter 3 Media Changer Commands Mode Select (6) / (10) Command (15h / 55h) Table 31 Mode Select Page Descriptor Field Name PS Additional Page Length Page-Defined or Vendor Specific Parameter List Description Parameters Savable. 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. 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 Byte 0 1 2 3 4 5 7 6 5 4 3 2 1 0 Operation Code (1Ah) Logical Unit Number PC Reserved Allocation Length Unused Reserved Flag Link Rsv'd DBD Page Code Reserved 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 Byte 0 1 2 3­6 7 6 5 4 3 2 1 0 Operation Code (5Ah) Logical Unit Number PC Reserved (MSB) Rsv'd DBD Page Code Reserved 7-8 Unused Allocation Length (LSB) 9 Reserved Flag Link Table 32 Mode Sense Command Descriptor Block Field Name DBD PC Description Disable Block Descriptors. This device does not return a block descriptor regardless of this field. [. . . ] This bit is used in conjunction with Selftst and UnitOfl to specify the type of testing to be done. This bit must be set to 0. DevOfl 166 Quantum ATL SuperLoader Software Interface Guide Chapter 3 Media Changer Commands Send Diagnostic Command (1Dh) Field UnitOfl Description Unit Offline. This bit is used in conjunction with Selftst and DevOfl to specify the type of testing to be done. Not supported; must be 0. Parameter List Length Quantum ATL SuperLoader Software Interface Guide 167 Chapter 3 Media Changer Commands Set Device Identifier Command (A4h) Set Device Identifier Command (A4h) 3 The SET DEVICE IDENTIFIER command requests that the device identifier information in the logical unit be set to the value received in the SET DEVICE IDENTIFIER parameter list. [. . . ]