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. Making copies or adaptations without prior written authorization of Quantum Corporation is prohibited by law and constitutes a punishable violation of the law. [. . . ] It is an ILLEGAL REQUEST to have page parameters while the PF bit is 0. If set, this bit instructs the library to save all savable pages, and this is not supported. SP 74 Quantum PX500 Series Software Interface Guide Chapter 3 Media Changer Commands Mode Select (6) / (10) Command (15h / 55h) Mode Parameter List 3 The following figure shows the format of the Mode Parameter List that is passed by the initiator to the media changer during the command's DATA OUT phase. Table 51 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) Table 52 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 53 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. Quantum PX500 Series Software Interface Guide 75 Chapter 3 Media Changer Commands Mode Select (6) / (10) Command (15h / 55h) 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. Table 54 Mode Select (6) Parameter Header Bit Byte 0 1 2 3 7 6 5 4 3 2 1 0 Reserved Reserved Reserved Block Descriptor Length Table 55 Mode Select (10) Parameter Header Bit Byte 0-1 2 3 4-5 6-7 7 6 5 4 3 2 1 0 Reserved Reserved Reserved Reserved Block Descriptor Length Table 56 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. 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. 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). 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. 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. [. . . ] Indicates that a buffered peripheral device has reached the end of partition and data may remain in the buffer that has not been written to the medium. A RECOVER BUFFERED DATA command may be issued to read the unwritten data from the buffer. Indicates that the source data did not match the data read from medium. RESERVED. E F Table 156 Sense Data Values Sense Key 0 ASC 00 ASCQ 00 Message Name/Description NO ADDITIONAL SENSE INFORMATION No recovery necessary 2 2 04 04 00 01 LOGICAL UNIT IS NOT READY, CAUSE NOT REPORTABLE LOGICAL UNIT IS IN PROCESS OF BECOMING READY Wait for library to complete initialization 2 3E 00 LOGICAL UNIT HAS NOT SELF CONFIGURED YET Wait for library to complete initialization 2 2 2 80 80 80 00 01 02 LOGICAL UNIT IS NOT READY, A DOOR IS OPEN LOGICAL UNIT IS NOT READY, THE LIBRARY IS IN MENU MODE LOGICAL UNIT IS NOT READY, THE IMPORT/EXPORT DOOR IS OPEN 172 Quantum PX500 Series Software Interface Guide Appendix A Sense Data Values Sense Key 4 ASC 00 ASCQ 00 Message Name/Description NO ADDITIONAL SENSE INFORMATION No recovery necessary 4 15 01 MECHANICAL POSITIONING ERROR The robotics reported a malfunction. [. . . ]