User manual QUANTUM PX500 SOFTWARE INTERFACE GUIDE 81-81289-02

[. . . ] Quantum PX500 Series Software Interface Guide, 81-81289-02 A01, December 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. [. . . ] The setting of MRIE does not impact logging of events in the TapeAlert Log Page. Interval Timer Report Count/Test Flag Number Not supported. Report Count or Test Flag Number. When the Test bit is set, this field indicates that a test condition to be generated as follows: Value 0 Result Change no TapeAlert Flag but report an exception condition based on the setting of the MRIE field. Set the TapeAlert Flag indicated in the value and generate an exception condition based on the MRIE field. Clear the TapeAlert Flag in an equivalent manner to taking corrective action of indicated by the absolute number of the value. Set all TapeAlert Flags and generate and exception condition based on the setting of the MRIE field. 1 to 64 -1 to -64 32767 Quantum PX500 Series Software Interface Guide 81 Chapter 3 Media Changer Commands Mode Sense (6) / (10) Command (1Ah/ 5Ah) Element Address Assignment Page 3 The element address assignment page is used to report element address assignments to the host. None of the fields in this page are changeable. Table 72 Element Address Assignment Page Bit 7 Byte 0 1 2-3 4-5 6-7 8-9 10 - 11 12 - 13 14 - 15 16 - 17 18 - 19 6 5 4 3 2 1 0 PS (0) 0 (MSB) (MSB) (MSB) (MSB) (MSB) (MSB) (MSB) (MSB) Page Code (1Dh) Parameter List Length (12h) First Medium Transport Element Address Number of Medium Transport Elements First Storage Element Address Number of Storage Elements First Import/Export Element Address Number of Import/Export Address First Data Transfer Element Address Number of Data Transfer Elements Reserved (LSB) (LSB) (LSB) (LSB) (LSB) (LSB) (LSB) (LSB) Table 73 Element Address Assignment Page Field Name First Medium Transport Element Address Description Identifies the address of the first medium transport element contained in the media changer. The library uses the default address of 0. Quantum PX500 Series Software Interface Guide 82 Chapter 3 Media Changer Commands Mode Sense (6) / (10) Command (1Ah/ 5Ah) Field Name Number of Medium Transport Elements First Storage Element Address Number of Storage Elements First Import/ Export Element Address Number of Import/Export Elements First Data Transfer Element Address Number of Data Transfer Elements Description Defines the total number of medium transport elements contained in the media changer. Identifies the address of the first medium storage element contained in the media changer. Defines the total number of storage elements contained in the media changer. Identifies the address of the first import/export element that is accessible both by the medium transport device and also by an operator from outside the media changer. Defines the total number of import/export elements contained in the media changer. Identifies the address of the first data transfer element contained in the media changer. Defines the total number of data transport elements contained in the media changer. Transport Geometry Parameters Page 3 The transport geometry parameters page defines whether each medium transport element of a media changer is a member of a set of elements that share a common robotics subsystem and whether the element is capable of media rotation. One transport geometry descriptor is transferred for each medium transport element, beginning with the first medium transport element. None of the fields in the page are changeable. Table 74 Transport Geometry Parameters Page Bit 7 Byte 0 1 2-n 6 5 4 3 2 1 0 PS 0 Page Code (1Eh) Parameter Length (02h) Transport Geometry Descriptor(s) Quantum PX500 Series Software Interface Guide 83 Chapter 3 Media Changer Commands Mode Sense (6) / (10) Command (1Ah/ 5Ah) The geometry of each medium transport element is defined using a twobyte field as defined in figure 75. Table 75 Transport Geometry Descriptor Bit 7 Byte 0 1 6 5 4 3 2 1 0 Reserved Member Number In Transport Element Set Rotate Table 76 Transport Geometry Parameters Page Field Name Parameter length Rotate Member Number in Transport Element Set Description Specifies the number of bytes of transport geometry descriptors to follow. There is only one medium transport element and robotic subsystem. Device Capabilities Page 3 The device capabilities page defines characteristics of the element types of a media changer. This information may be employed by the initiator to determine functions permitted by the MOVE MEDIUM command. None of the fields in the page are changeable. Quantum PX500 Series Software Interface Guide 84 Chapter 3 Media Changer Commands Mode Sense (6) / (10) Command (1Ah/ 5Ah) Table 77 Device Capabilities Page Bit 7 Byte 0 1 6 5 4 3 2 1 0 PS (0) RSVD Page Code (1Fh) Parameter Length (12h) Reserved STOR STORI STOR STOR DT /E ST MT (1) Reserved Reserved MT>DT (1) ST>DT (1) I/E>DT (0) DT>DT (1) Reserved (0) (1) (1) ACE VTRP S2C MT>I/E MT>ST MT>MT (1) ST>MT (1) I/E>MT (0) DT>MT (1) 2 3 4 Reserved 5 (1) (0) ST->I/ ST>ST E (0) I/E>I/E (0) DT>I/E (0) (1) I/E>ST (0) DT>ST (1) Reserved 6 Reserved 7 8 - 11 Quantum PX500 Series Software Interface Guide 85 Chapter 3 Media Changer Commands Mode Sense (6) / (10) Command (1Ah/ 5Ah) Bit 7 Byte 6 5 4 3 2 1 0 Reserved 12 MT<> MT<> MT<> MT<> DT I/E ST MT (0) ST<> DT (0) I/ E<>D T (0) (0) (0) ST<>I ST<>S ST<> /E T MT (0) I/ E<>M T (0) DT<> MT (0) Reserved 13 Reserved 14 Reserved 15 16 - 19 (0) (0) I/ I/ E<>I/ E<>ST E (0) (0) (0) DT<> DT<>I DT<> ST /E DT (0) (0) (0) Reserved The field names in figure 77 use the following element type abbreviations: · · · · MT -- a medium transport element ST -- a storage element I/E -- an import/export element DT -- a data transfer element In the descriptions, XX and YY are any of the element type abbreviations. Table 78 Device Capabilities Page Field Name PS Description Parameters Savable. Saved parameters are not supported and must be 0 for MODE SENSE. STORXX These bits are sent as 1 for all element types to indicate that each element type provides storage for a unit of media. Quantum PX500 Series Software Interface Guide 86 Chapter 3 Media Changer Commands Move Medium Command (A5h) Field Name XX->YY Description These bits are sent as 1 for all element types to indicate that the media changer supports all MOVE MEDIUM commands between all types of elements. These bits are sent as 0 to indicate that the media changer does not support the EXCHANGE MEDIUM command for any combination of element types. This bit shall be set to 1 when the VTRP, ACE, XX-RA, and XX-WA fields are supported. The S2C bit shall be set to 0 when any of these fields are not supported. [. . . ] 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 160 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. [. . . ]