User manual QUANTUM PX500 SOFTWARE INTERFACE GUIDE 81-81289-01 B01

[. . . ] Quantum PX500 Series Software Interface Guide, 81-81289-01 B01, August 2005, 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. Quantum Corporation may revise this publication from time to time without notice. COPYRIGHT STATEMENT Copyright 2005 by Quantum Corporation. [. . . ] 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. 76 Quantum PX500 Series Software Interface Guide Chapter 3 Media Changer Commands Mode Select (6) / (10) Command (15h / 55h) 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. Table 57 Mode Select Parameter Bit Byte 0 1-3 4 5-7 7 6 5 4 3 2 1 0 Reserved (MSB) Number of Blocks Reserved (MSB) Block Length (LSB) (LSB) Table 58 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. 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. Quantum PX500 Series Software Interface Guide 77 Chapter 3 Media Changer Commands Mode Select (6) / (10) Command (15h / 55h) Table 59 Mode Select Page Descriptor Bit Byte 0 1 2-n 7 PS (0) 6 0 5 4 3 2 1 0 Page Code Additional Page Length Page-Defined or Vendor Specific Parameter List Table 60 Mode Select Page Descriptor Field Name PS Additional Page Length Page-Defined or Vendor Specific Parameter List Description Parameters Savable. For the MODE SELECT (6) (10) commands, this field is reserved (0). 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 87 to Device Capabilities Page on page 90. 78 Quantum PX500 Series Software Interface Guide Chapter 3 Media Changer Commands Mode Sense (6) / (10) Command (1Ah/ 5Ah) Mode Sense (6) / (10) Command (1Ah/ 5Ah) 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. 3 The command descriptor block for the 6-byte MODE SENSE (1Ah) is shown below. An illustration of the command descriptor block for the 10byte MODE SENSE (5Ah) follows on the next page. Table 61 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 Rsv'd PC DBD Page Code Reserved Allocation Length Unused Reserved Flag Link Reserved The MODE SENSE (10) command returns descriptor data in a different format than MODE SENSE (6). Table 62 Mode Sense (10) Command Descriptor Block Bit Byte 0 1 2 3 7-8 9 7 6 5 4 3 2 1 0 Operation Code (5Ah) Logical Unit Number Rsv'd PC (MSB) Unused DBD Page Code Reserved Allocation Length Reserved Flag (LSB) Link Reserved Quantum PX500 Series Software Interface Guide 79 Chapter 3 Media Changer Commands Mode Sense (6) / (10) Command (1Ah/ 5Ah) Table 63 Mode Sense Command Descriptor Block Field Name DBD Description Disable Block Descriptors. 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 00 01 10 11 Type of Parameter Values Report Current Values Report Changeable Values Report Default Values 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 1Ch 1Dh 1Eh 1Fh Description TapeAlert Page (1Ch) on page 83 (LTO only) Element Address Assignment Page on page 87 Transport Geometry Parameters Page on page 89 Device Capabilities Page on page 90 80 Quantum PX500 Series Software Interface Guide Chapter 3 Media Changer Commands Mode Sense (6) / (10) Command (1Ah/ 5Ah) Field Name Description 3Fh Return all pages Allocation Length 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. 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. Mode Sense Data Headers 3 The MODE SENSE (6) and MODE SENSE (10) headers are illustrated in the following figures. Table 64 Mode Sense (6) Data Header Bit Byte 0 1 2 3 7 6 5 4 3 2 1 0 Mode Sense Data Length Reserved Reserved Block Descriptor Length (0) Quantum PX500 Series Software Interface Guide 81 Chapter 3 Media Changer Commands Mode Sense (6) / (10) Command (1Ah/ 5Ah) Table 65 Mode Sense (10) Data Header Bit Byte 0-1 2 3 4-5 6-7 7 (MSB) 6 5 4 3 2 1 0 Mode Sense Data Length Reserved Reserved Reserved (LSB) (MSB) Block Descriptor Length (0) (LSB) Table 66 Mode Sense Data Header Field Name Mode Sense Data Length Description 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. This field specifies the length (in bytes) of all of the block descriptors. This value will be 0, indicating no Block Descriptors were sent. Block Descriptor Length Mode Sense Mode Pages 3 Table 67 Mode Sense Page Descriptor The following figure depicts the variable length page descriptor. Bit Byte 0 1 2 7 PS 6 0 5 4 3 2 1 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. 82 Quantum PX500 Series Software Interface Guide Chapter 3 Media Changer Commands Mode Sense (6) / (10) Command (1Ah/ 5Ah) Table 68 Mode Sense Page Descriptor Field Name PS Description Parameters Savable. [. . . ] The FSC bytes provide more details. 5 1A 00 PARAMETER LIST LENGTH ERROR Invalid parameter list length field specified by command. 5 20 00 INVALID COMMAND OPERATION CODE Verify the host command format 5 24 00 INVALID FIELD IN COMMAND DATA BLOCK Ensure all reserve fields are set to zero 5 25 00 LOGICAL UNIT NOT SUPPORTED Verify that the logical unit field specified in the command contains a legitimate logical unit number. Check the cabling to the logical unit. 5 26 00 INVALID FIELD IN PARAMETER LIST Verify Mode Select page fields. Verify that fields comply with the command format described in this guide 5 26 02 PARAMETER VALUE INVALID Verify Mode Select page fields. Verify that fields comply with the command format described in this guide. 5 30 03 CLEANING CARTRIDGE INSTALLED A cleaning cartridge cannot be removed from a drive because it is being used in a cleaning operation A cartridge cannot be placed into the drive because the drive is being cleaned Quantum PX500 Series Software Interface Guide 173 Appendix A Sense Data Values Sense Key 5 ASC 39 ASCQ 00 Message Name/Description SAVING PARAMETERS NOT SUPPORTED Verify that the Save Parameter field in the Mode Sense command complies with the command format described in this guide. 5 3B 0D MEDIUM DESTINATION ELEMENT FULL The destination element address already contains a cartridge. [. . . ]