Home

Quantum superloader 3 User's Guide

1. ect ra Sue tog Field Name Description Page Code The Page Code echoes the page code that was specified in the LOG SENSE command descriptor block Page Length The Page Length field specifies the number of bytes available and depends on the parameters requested Figure 23 Parameters for Device Status Log Sense Page Bit Byte 7 6 5 4 3 1 0 0 1 Parameter Code 2 DU DS TSD ETC TMC Rsv d LP 3 Parameter Length 04h MSB 4 7 Parameter Value LSB Quantum SuperLoader 3 Software Interface Guide 38 Table 17 Parameters for Chapter 2 Media Changer Commands Log Sense Command 4Dh Device Status Log Sense Page Field Name Description Parameter Code Parameter Codes 0000h through 0004h are supported Code Description 0000h Specifies device type This value is always Oh 0001h Specifies device status figure 24 0002h Specifies the number of move operations over the lifetime of the device 0003h Reserved for media changer device and shall contain 0 0004h Vendor specific DU Disable Update Always 0 DS Save not supported always 1 TSD Target Save Disable not supported always 1 ETC Enable Threshold Comparison Threshold checking is not supported on this page Always set to 0 TMC Threshold Met Criteria Always 0 LP List Parameter Always set to 0 parameter codes treated as data counter Figure 24 Device Status Log Sense Page 0
2. Parameters Bit Byte 6 5 4 3 2 1 0 MSB 0 3 Generation LSB MSB 4 7 Additional Length n 7 LSB Reservation Key List Follows in Bytes 8 n MSB 8 15 First Reservation Key LSB Quantum SuperLoader 3 Software Interface Guide 71 Chapter 2 Media Changer Commands Persistent Reserve In Command 5Eh Bit Byte 7 6 5 4 3 2 1 0 MSB n 7 f to Last Reservation Key n LSB Table 34 Read Keys Parameters Field Name Description Generation The value in this field is a 32 bit counter in the device server that is incremented each time a PERSISTENT RESERVE OUT command requests a Register Clear Pre empt or Pre empt and Clear operation Note that PERSISTENT RESERVE IN commands do not increment the counter nor do PERSISTENT RESERVE OUT commands that perform a Reserve or Release service action or by a PERSISTENT RESERVE OUT command that is not done due to an error or a reservation conflict The value in the Generation field is set to 0 as part of the power on or reset processes The value in the Generation field allows the application client that examines the value to verify that the configuration of the initiators attached to a logical unit has not been modified by another application client without any notification of the application client doing the examination Additional Length This field contains the count of the number of bytes that are in the Reserva
3. 100b Vendor Specific 101b The device supports the SCSI operation code but ina vendor specific manner 110b Vendor Specific 111b Reserved ISO Version Must be 0 Quantum SuperLoader 3 Software Interface Guide 20 Chapter 2 Media Changer Commands Inquiry Command 12h Field Name Description ECMA Version Must be 0 ANSI Approved 2 Version CDB Size This field contains the number of bytes in the CDB for the Operation Code being requested and the size of the CDB Usage Data in the data that is returned in response to the INQUIRY CDB Usage Data This field contains information about the CDB for the Operation Code being queried Note that the first byte of the CDB Usage Data contains the OpCode for the operation specified All of the other bytes of the CDB Usage Data contain a map for bits in the CDB of the OpCode specified NOTE The bits in the map have a 1 to 1 correspondence to the CDB for the OpCode being queried That is if the device senses a bit as the entire field or as part of the field of the operation the map in CDB Usage Data contains a 1 in the corresponding bit position If the device ignores a bit or declares a bit as reserved in the CDB for the OpCode being queried the map has a 0 in that corresponding bit position Quantum SuperLoader 3 Software Interface Guide 21 Chapter 2 Media Changer Commands Load Unload Command 1Bh Load Unload Command 1Bh
4. 1h Medium transport element 2h Storage element 3h Import export element 4h Data transfer element 5h Fh Reserved Starting Element Address Specifies the minimum element address to report Only elements with an element type code permitted by the Element Type Code field and an element address greater than or equal to this address shall be reported Element descriptor blocks are not generated for undefined element addresses Number of Elements Specifies the maximum number of element descriptors to be reported CURDATA When set to 1 the SuperLoader 3 will return the current element status information When set to 0 the SuperLoader 3 may cause device motion to confirm element status data DVCID Allocation Length When set to 1 the SuperLoader 3 will return the supported device identifiers When set to 0 the SuperLoader 3 will not return the device identifiers Specifies the number of bytes to be returned If it is not sufficient to transfer all the requested element descriptors the SuperLoader 3 will only transfer those descriptors that can be completely transferred and this shall not be considered an error Quantum SuperLoader 3 Software Interface Guide 101 Element Status Data Figure 59 Element Status Data Header Chapter 2 Media Changer Commands Read Element Status Command B8h The data returned by the READ ELEMENT STATUS command is defined in figure 59 and Element
5. Reserved 5 Unused Reserved Flag Link Quantum SuperLoader 3 Software Interface Guide 139 Chapter 2 Media Changer Commands Write Buffer Command 3Bh Write Buffer Command 3Bh The WRITE BUFFER command is used with READ BUFFER as a diagnostic function and for downloading and updating microcode firmware Figure 83 Write Buffer Descriptor Bit Byte 7 6 5 4 3 2 1 0 0 Operation Code 3Bh 1 Logical Unit Number Reserved Mode 2 Buffer ID MSB 3 5 Buffer Offset LSB MSB 6 8 Transfer Length LSB 9 Unused Reserved Flag Link Table 64 Write Buffer Command Data Field Description Mode The media changer supports the following values within the field If any other value is set the media changer terminates the command with CHECK CONDITION status and an ILLEGAL REQUEST sense key set Quantum SuperLoader 3 Software Interface Guide 140 Chapter 2 Media Changer Commands Write Buffer Command 3Bh Field Description Mode Description 0000b Write Combined Header and Data Mode 0000b 0010b Write Data Mode 0010b 0100b Download Microcode Mode 0100b 0101b Download Microcode and Save Mode 0101b 1010b Write Data to Echo Buffer 1010b Buffer ID For all of the modes described for the Mode field only a Buffer ID of 0 is buffer supported If the Buffer ID field is a value other than 0 the command is re
6. ssonarovrrnenrvrrrvrrnrvevenne 43 Mode Select 10 Mode Parameter List sonarornrnonrvorrvrrvrreneen 43 Mode Select 6 Parameter Header snrunvrnnvavevrvvenvvenrvsrrevevenne 44 Mode Select 10 Parameter Header srrvenavevrvvnnvverrvrrvrvevenne 44 Mode Select Parameter srsnsnrns es vrerereaverererevavesesesesevevasesesevesenee 46 Mode Select Page Descriptor nnseseravarerererevavaerererereveseserevenene 47 Mode Sense 6 Command Descriptor Block eee 48 Mode Sense 10 Command Descriptor Block 49 Mode Sense 6 Data Header nmsnrnrvrvavvvrrvevaverrvernrversvrrneveverenne 51 Mode Sense 10 Data Header msrvorevnvrvnrveravrvrrrevrversvrrsereveene 51 Mode Sense Page Descriptor inssnsasrerereraseserereveveseseserevesesee 52 TapeAlert Page Format Descriptor msorrervrerererevevererereveveren 53 Element Address Assignment Page srsnvrvvrrvrvrerererrvrverererrenn 56 Transport Geometry Parameters Page mmurnnsnrarvrrvrrvrrerervvrnrer 59 Transport Geometry Descriptor nnrnrervrvrverererervrreserervereverenne 59 Device Capabilities Page mmsnrnrerrererorervrererernvevererereveverererevenene 60 Extended Device Capabilities Page rsrsrrrrnrrvrvvrrrererrrvrervrrvrene 62 Move Medium Descriptor Block soonorovrrnenrverrvrvvrversvrvrvveverne 67 Persistent Reserve In Descriptor Block sanrvnvnrnvvrnevrverere 69 Read Keys Parameters ssevnsrsrsvvevesrvrsrrrreverevrsrrrsrsvsrevsrsrer
7. Quantum SuperLoader 3 Software Interface Guide 28 TapeAlert Page 2Eh Figure 15 TapeAlert Log Sense Header Format Chapter 2 Media Changer Commands Log Sense Command 4Dh Field Name Description ASCII Strong for The text includes the time of the event the error Event n code identifying the event and additional data specific to the event The TapeAlert Log page defines error and informational flags for detailed device diagnostics The TapeAlert data is event based and the page control bits in the LOG SENSE command are not applicable and are ignored The SuperLoader 3 supports the definition of the flags for media changer devices as defined in SMC 2 Bit Byte 7 6 5 4 3 2 1 0 0 Page Code 2Eh 1 Reserved MSB 2 3 Page Length LSB Table 11 TapeAlert Log Sense NE Header Field Descriptions Field Name Description Page Code The Page Code echoes the page code that was specified in the LOG SENSE command descriptor block Page Length The Page Length field specifies the total number of bytes contained in this log page not including the four bytes that make up the header Quantum SuperLoader 3 Software Interface Guide 29 Figure 16 TapeAlert Page Log Parameters Format Chapter 2 Media Changer Commands Log Sense Command 4Dh Bit Byte 7 6 5 4 3 2 1 0 MSB 5n 1 to Parameter Code n Sn
8. Quantum SuperLoader 3 Software Interface Guide 48 Figure 34 Mode Sense 10 Command Descriptor Block Chapter 2 Media Changer Commands Mode Sense 6 10 Command 1Ah 5Ah Bit Byte 7 5 4 3 2 1 0 0 Operation Code 5Ah 1 Logical Unit Number Rsv d DBD Reserved 2 PC Page Code 3 SubPage 4 6 Reserved MSB 7 8 Allocation Length LSB Table 24 Mode Sense Command Descriptor Block Field Name Description DBD Disable Block Descriptors This field is ignored 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 Type of Parameter Values 00 Report Current Values 01 Report Changeable Values 10 Report Default Values Quantum SuperLoader 3 Software Interface Guide 49 Chapter 2 Media Changer Commands Mode Sense 6 10 Command 1Ah 5Ah Field Name Description 11 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 Description 1Ch TapeAlert Page 1Ch on page 53 1Dh Element Address Assignment Page on page 56 1Eh Transport Geometry Parameters Page on page 58 1Fh Device Capabilities Pa
9. 1Ah 5Ah Table 25 Mode Sense Data ei Field Name Description Mode Sense Data Length 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 Block Descriptor Length This field specifies the length in bytes of all of the block descriptors This value will be 0 indicating no Block Descriptors were sent Mode Sense Mode Pages Figure 37 Mode Sense Page Descriptor The following figure depicts the variable length page descriptor Page Code 1 Additional Page Length 2 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 Table 26 Mode Sense Page Descriptor Field Name Description PS Parameters Savable When 0 the supported parameters cannot be saved savable pages are not supported When set to 1 it indicates that the page can be saved in nonvolatile memory by the media changer Quantum SuperLoader 3 Software Interface Guide 52 TapeAlert Page 1Ch Figure 38 TapeAlert Page Format Descriptor Chapter 2 Media Changer Commands Mode Sense 6 10 Command 1Ah 5Ah Field Name Description Additional Page This field indicates the number of bytes in the page L
10. Figures A Tables Table 1 Supported Media Changer Commands 0 eee 8 Table 2 Standard Inquiry Data ooerersvrrvorrrvrerererrsrsererereeserererrveseserrerene 14 Table 3 Unit Serial Number Page Field Descriptions 00 ee 17 Table 4 Identifier Descriptor Field Descriptions cece 18 Table 5 Supported Identifiers nossrnorevrrrvnrvevrvrvvrveveverrevevevsvsvsrvevevsverser 19 Table 6 Command Support Data Page rrvrvrrrvrvrrrvvrvrvrrrrsvrvrerrerrenee 20 Table 7 Unload Command Descriptor Block sssr 22 Table 8 Log Sense Command Descriptor Block eee eee 24 Table 9 Last n Error Events Log Sense Header srsnvnvarvrvrnvnvrvvvererernne 27 Table 10 Parameters Last n Error Events Log Sense nrrrernvrrvverereren 28 Table11 TapeAlert Log Sense Header Field Descriptions 29 Table 12 TapeAlert Page Log Parameters esmrvrvvvrrvrvrrrrrrvrvrvrrrrenn 30 Table13 Move Statistics sssnusaseenns n 32 Table 14 Hard S ft Error cerei a 34 Table 15 Device Wellness Log Sense Header rrvrrnrnvrvvvrvrvererevererererere 35 Table 16 Device Status Log Sense Header enrvrvrvvvvvvrrvrvvrvrrrvrrevrvrvrverenn 38 Table 17 Parameters for Device Status Log Sense Page snrnrvvereveren 39 Quantum SuperLoader 3 Software Interface Guide xX Table 18 Table 19 Table 20 Table 21 Table 22 Table 23 Table 24 Table 25 Table 26 Table 27 Table 28 Table 29 Table 30 Table 31 Table 32 Table 33 Table 3
11. zero indicates that the media changer does not open the import export element for operator access whenever a command is issued to move media with an import export element as a destination element address USRCL A user control import export element close USRCL bit set to one indicates that the media changer requires the operator to manually close an open import export element An USRCL bit set to zero indicates that the media changer does not require the operator to manually close an open import export element Quantum SuperLoader 3 Software Interface Guide 63 Chapter 2 Media Changer Commands Mode Sense 6 10 Command 1Ah 5Ah Field Name Description USROP A user control import export element open USROP bit set to one indicates that the media changer requires the operator to manually open a closed import export element An USROP bit set to zero indicates that the media changer does not require the operator to manually open a closed import export element TEST An import export element state IEST bit set to one indicates that the media changer is able to detect medium presence in all import export elements An IEST bit set to zero indicates that the media changer is not able to detect medium presence in all import export elements DTEDA A data transfer element empty on door access DTEDA bit set to one indicates that the media changer requires all data transfer elements not contain media before acce
12. 1 this field indicates that the information bytes contain valid information as defined in the ANSI SCSI 2 specification Error Code A value of 70h indicates a current error the report is associated with the most recently received command A value of 71h indicates a deferred error the report is associated with a previous command and not as a result of the current command No other values are returned in this field Filemark This bit indicates that the current command has read a Filemark Not applicable to a media changer device EOM End of Medium Not applicable to a media changer device ILI Incorrect Length Indicator Not applicable to a media changer device Sense Key Indicates generic information describing an error or exception condition Sense keys are defined in table 58 Information Bytes Not applicable to a media changer device This field should always be 0 Additional Sense Length This field specifies the number of additional sense bytes to follow If the Allocation Length of the Command Descriptor Block is too small to transfer all of the Additional Sense bytes the Additional Sense Length is not adjusted to reflect the truncation Command Specific Command Specific Information Bytes depend on the command executed Information Bytes This field is not used Additional Sense This field and the field for Additional Sense Code Qualifier provides Code ASC additional information about the Sense Key
13. 69 Persistent Reserve Out 78 Position to Element 92 Prevent Allow Medium Removal 94 Read Element Status 100 Release Element 113 Release Unit 116 Report Device Identifier 117 Report LUNS 120 Quantum SuperLoader 3 Software Interface Guide Index Request Sense 122 Reserve Element 130 133 Send Diagnostic 135 Test Unit Ready 139 Write Buffer 140 Mode Select command media changer 41 Mode Sense command media changer 48 Move Medium command 67 P Persistent Reserve In command media changer 69 Persistent Reserve out command media changer 78 Position to Element command 92 Prevent Allow Medium Removal command media changer 94 143 Index R media changer 139 Read Buffer command 95 Read Element Status command 100 Ww Release Element command 113 Release Unit command Write Buffer command media changer 116 media changer 140 Report Device Identifier command media changer 117 Report LUNS command media changer 120 Request Sense command media changer 122 sense keys media changer 125 supported ASC ASCQ codes media changer 126 Reserve Element command 130 media changer 133 S Send Diagnostic command media changer 135 Sense keys Request Sense media changer 125 Set Device Identifier command 137 T Tape drive commands Load Unload 22 Read Buffer 95 Set Device Identifier 137 Test Unit Ready command Quantum SuperLoader 3 Software Interface Guide 144
14. 8 11 Scope Specific Address LSB 12 Reserved 13 Scope Type 14 15 Obsolete Quantum SuperLoader 3 Software Interface Guide 74 Chapter 2 Media Changer Commands Persistent Reserve In Command 5Eh Table 36 Persistent Reserve In Read Reservations Descriptor Field Name Description Reservation Key The Reservation Key field contains an 8 byte value that identifies the reservation key under which the persistent reservation is held Scope Specific Used to indicate the element that is the reservation affects when a Address reservation is for an element rather than a logical unit The SuperLoader 3 does not support reservations of elements so this field is always 0 Scope The value in this field indicates whether a persistent reservation applies to an entire logical unit to a part of the logical unit defined as an extent or to an element The values for the Scope field are Code Name Description Oh LU Logical Unit Persistent reservation applies to the full logical unit The LU scope is therefore implemented by all device servers that implement PERSISTENT RESERVE OUT 1h Obsolete 2h Element Persistent reservation applies to an element Reservations of elements Is not supported 3h Fh Reserved Reserved Type The value of the Type field specifies the characteristics of the persistent reservation being established for all data blocks within the extent or within the logic
15. Check Action Condition Illegal Request Quantum SuperLoader 3 Software Interface Guide 117 Chapter 2 Media Changer Commands Report Device Identifier Command A3h Field Description Allocation Length If the Allocation Length is not sufficient to contain all the parameter data the first portion of the data shall be returned This shall not be considered an error The actual length of the parameter data is available in the Identifier Length field in the parameter data If the remainder of the parameter data is required the application client should send a new REPORT DEVICE IDENTIFIER command with an Allocation Length field large enough to contain all the data The REPORT DEVICE IDENTIFIER parameter list contains a four byte field that contains the length in bytes of the parameter list and the logical unit s identifier Figure 70 Report Device Identifier Bit Byte 7 6 5 4 3 2 1 0 MSB 0 3 Identifier Length n 4 LSB 4 n Identifier Table 55 Report Device bak Identifier Parameter Data Field Description Identifier Specifies the length in bytes of the Identifier field If the Length Allocation Length field in the CDB is too small to transfer all of the identifier the length is not adjusted to reflect the truncation The identifier length is initially equal to zero and is changed only by a successful SET DEVICE IDENTIFIER command Quantum SuperLoade
16. LSB 5n 1 DU DS TSD ETC TMC Rsv d LP 5n 2 Parameter Length 5n 3 Value of TapeAlert Flag Flag is set when Bit 0 1 Bits 1 7 are Reserved Table 12 TapeAlert Page Log Parameters Field Name Description Parameter Code This field contains the Flag code DU Disable Update DS Save not supported always 1 TSD ETC Target Save Disable not supported always 0 Enable Threshold Comparison TMC Threshold Met Criteria LP Parameter Length List Parameter This field is set to 1 Value of TapeAlert Flag If Bit 0 is set to 1 indicates that TapeAlert has sensed a problem If Bit 0 is 0 the Flag is not set and no problem has been sensed Quantum SuperLoader 3 Software Interface Guide 30 Move Statistics Page 30h Figure 17 Move Statistics Chapter 2 Media Changer Commands Log Sense Command 4Dh This page consists of the Log Page Header followed by a count of various movements of cartridges within the system The entries in the log page are cumulative throughout the life of the unit and cannot be reset via SCSI or power cycle Log Parameters are not supported for this page Format Bit Byte 7 6 5 4 3 2 1 0 0 Reserved Page Code 30h 1 Reserved MSB 2 3 Page Length 18h LSB MSB 4 7 Total Moves LSB MSB 8 11 Drive Loads LSB MSB 12 15 Mail Slot Imports LSB MSB 16 19 Mail Slot Export
17. Number Obsolete Rsv d Reserved 5 Unused Reserved Flag Link A reservation via the RESERVE ELEMENT command remains in effect until one of the following conditions is met e The initiator that made the reservation sends another RESERVE ELEMENT command e The device is released via a RELEASE ELEMENT command from the same initiator A BUS DEVICE RESET message is received from any initiator A hard reset occurs The occurrence of the last two conditions is indicated by the media changer returning a CHECK CONDITION status sense key of UNIT ATTENTION on the next command following the condition It is not an error to issue a RESERVE ELEMENT command to a media changer that is currently reserved by the requesting initiator Quantum SuperLoader 3 Software Interface Guide 133 Chapter 2 Media Changer Commands Reserve Element 6 Command 16h If another initiator has previously reserved the logical unit the target returns a RESERVATION CONFLICT status If after honoring the reservation any other initiator attempts to perform any command except INQUIRY REQUEST SENSE or RELEASE ELEMENT the command is rejected with a RESERVATION CONFLICT status That logical unit ignores a RELEASE ELEMENT command issued by another initiator Quantum SuperLoader 3 Software Interface Guide 134 Chapter 2 Media Changer Commands Send Diagnostic Command 1Dh Send Diagnostic Command 1Dh Figure 79 Send Diagnostic
18. PS bit set to one indicates that the device server is capable of saving the page in a nonvolatile vendor specific location A PS bit set to zero indicates that the device server is not able to save the page SPF A SubPage Format SPF bit set to one indicates that the subpage mode page format is being used MVPRV A move prevented to import export element MVPRV bit set to one indicates that the media changer prevents moves with the import export element as destination element address when medium removal is prevented with the PREVENT ALLOW MEDIUM REMOVAL command An MVPRV bit set to zero indicates that the media changer does not prevent moves with the import export element as destination element address when medium removal is prevented with the PREVENT ALLOW MEDIUM REMOVAL command MVCL A move closes import export element MVCL bit set to one indicates that the media changer will closes the import export element whenever a command is issued to move media from an open import export element An MVCL bit set to zero indicates that the media changer does not close the import export element whenever a command is issued to move media from an open import export element MVOP A move opens import export element MVOP bit set to one indicates that the media changer opens the import export element for operator access whenever a command is issued to move media with an import export element as a destination element address An MVOP bit set to
19. Sense 6 10 Command 1Ah 5Ah Field Name Description TREXC A true exchange capable TREXC bit set to one indicates that the media changer allows an EXCHANGE MEDIUM command that has the second destination element address equal to the source element address A TREXC bit set to zero indicates that the media changer does not allow an EXCHANGE MEDIUM command that has the second destination element address equal to the source element address LCKIE A lock import export element LCKIE bit set to one indicates that the PREVENT ALLOW MEDIUM REMOVAL command with the PREVENT field set to 01b secures the media changer import export element s An LCKIE bit set to zero indicates that the PREVENT ALLOW MEDIUM REMOVAL command with the PREVENT field set to 01b does not secure the media changer import export element s LCKD A lock door LCKD bit set to one indicates that the PREVENT ALLOW MEDIUM REMOVAL command with the PREVENT field set to 01b secures the media changer door s An LCKD bit set to zero indicates that the PREVENT ALLOW MEDIUM REMOVAL command with the PREVENT field set to 01b does not secure the media changer door s SPMER A source pre move eject required SPMER bit set to one indicates that the media changer requires the application client to send an explicit command to the data transfer element to eject the medium before the media changer is able to move the medium from the data transfer element A SP
20. The geometry of each medium transport element is defined using a two byte field as defined in figure 41 Bit Byte 7 6 5 3 2 1 0 0 Reserved Rotate 1 Member Number In Transport Element Set Table 29 Transport Geometry Parameters Page Field Name Description Parameter Specifies the number of bytes of transport geometry length descriptors to follow This field has a value of 2 Rotate This bit is sent as 0 Rotation of the medium transport element is not supported Member This field is sent as 0 There is only one medium Number in transport element and robotic subsystem Transport Element Set Quantum SuperLoader 3 Software Interface Guide 59 Device Capabilities Page Figure 42 Device Capabilities Chapter 2 Media Changer Commands Mode Sense 6 10 Command 1Ah 5Ah 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 Page Bit Byte 7 6 3 2 1 0 0 PS 0 SPF 0 Page Code 1Fh 1 Parameter Length 12h Reserved STORDT STORI E STORST STORMT 2 1 0 1 1 3 Reserved Reserved MT gt DT MT gt I E MT gt ST MT gt MT 4 1 0 1 1 Reserved ST gt DT ST gt I E ST gt ST ST gt MT 5 1 0 1 1 R
21. 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 XX lt gt YY 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 Quantum SuperLoader 3 Software Interface Guide 61 Extended Device Capabilities Page Figure 43 Extended Device Capabilities Page Chapter 2 Media Changer Commands Mode Sense 6 10 Command 1Ah 5Ah The extended device capabilities page defines characteristics of the media changer This information may be employed by the application client to determine functions permitted by the media changer Bit Byte 7 6 5 4 3 2 1 0 0 PS 0 SPF 1 Page Code 1Fh 1 SubPage Code 41h MSB 2 3 Page Length 10h LSB 4 Reserved MVPRV MVCL MVOP USRCL USROP JEST 5 Reserved DTEDA RSSEA MVTRY IEMGZ SMGZ 6 Reserved TREXC LCKIE LCKD 7 Reserved SPMER DPMER PEPOS 8 Reserved UCST 9 19 Reserved Quantum SuperLoader 3 Software Interface Guide 62 Chapter 2 Media Changer Commands Mode Sense 6 10 Command 1Ah 5Ah Table 31 Extended Device Capabilities Page Field Name Description PS The parameters savable PS bit is only used with the MODE SENSE command This bit is reserved with the MODE SELECT command
22. all initiators All reservation keys are also removed Any commands from any initiator that have been accepted by the device server as non conflicting continue their normal executions A UNIT ATTENTION condition is established for all registered initiators for the logical unit The sense key is set to UNIT ATTENTION the additional sense data is set to RESERVATIONS PREEMPTED Note that applications should not use the Clear action service except during recoveries associated with initiator or system reconfiguration since data integrity may be compromised 04h Pre empt A PERSISTENT RESERVE OUT command with a successful Pre empt service action removes all persistent reservations for all initiators that have been registered with the Service action Reservation key specified in the PERSISTENT RESERVE OUT command s parameter list A persistent reservation is also established for the pre empting initiator Any commands from any initiator that have been accepted by the device server as non conflicting continue their normal executions If a PERSISTENT RESERVE OUT command is sent that specifies a Pre empt service action and no persistent reservation exists for the initiator identified by the Service action Reservation key it is not an error condition A UNIT ATTENTION condition is established for the pre empted initiators The sense key is set to UNIT ATTENTION the additional sense data is set to RESERVATIONS PREEMPTED Commands that follow
23. and cause of a CHECK CONDITION status Additional Sense Codes are discussed in detail later in this section Additional Sense This field and the field for Additional Sense Code provides additional Code Qualifier information about the Sense Key and cause of a CHECK CONDITION ASCQ status Additional Sense Code Qualifiers are discussed in detail later in this chapter Sub Assembly Code Not used Returned as 0 Quantum SuperLoader 3 Software Interface Guide 124 Chapter 2 Media Changer Commands Request Sense Command 03h Field Description SKSV Sense Key Specific Valid When 1 indicates that the Sense Key specific field is as defined by the International Standard C D Command Data When set to 1 this field indicates that the illegal parameter is contained in the Command Descriptor Block A C D set to 0 indicates that the illegal parameter is in the Parameter List from the initiator BPV Bit Pointer Valid When set to 1 this field indicates that the Bit Pointer field is valid and designates which bit of the byte designated by the field pointer is in error For a multi bit field it points to the most significant bit of the field Field Pointer This field indicates which byte of the CDB or Parameter List is in error For a multi byte field the most significant byte is indicated Table 58 Supported Sense Keys for Request Sense Sense Key Description Oh NO S
24. are subject to the persistent reservation restrictions set by the pre empting initiator Quantum SuperLoader 3 Software Interface Guide 84 Chapter 2 Media Changer Commands Persistent Reserve Out Command 5Fh Code Name Description 04h Pre empt The persistent reservation thus created by the pre empting initiator is cont defined by the Scope and Type fields of the PERSISTENT RESERVE OUT command and the corresponding fields of the command s parameter list The registration keys for the pre empted initiators are removed by the Pre empt service action the reservation key for an initiator that has performed a Pre empt service action with its own Reservation key specified in the Service action Reservation key remains unchanged although all other specified releasing actions and reservation actions are performed Note that persistent reservations are not superseded by a new persistent reservation from any initiator except by the execution of a PERSISTENT RESERVE OUT that specifies either the Pre empt or the Pre empt and Clear service actions New persistent reservations that do not conflict with an existing persistent reservation execute normally Quantum SuperLoader 3 Software Interface Guide 85 Chapter 2 Media Changer Commands Persistent Reserve Out Command 5Fh Code Name Description 05h Pre empt and Clear A PERSISTENT RESERVE OUT command with a Pre empt and Clear service action removes
25. by any other initiator For example if ID7 sends ID2 a Third Party reservation on behalf of ID6 the target at ID2 gets reserved for the initiator ID6 then only ID7 can release the target at ID2 using a Third Party release ID6 cannot release the reservation even though the reservation was made on its behalf Parameter List Length This field specifies the length in bytes of the parameter list that will be transferred from the initiator If the LongID bit 1 and the Element bit 0 then the parameter list length is eight and the parameter list has the following format Quantum SuperLoader 3 Software Interface Guide 131 Chapter 2 Media Changer Commands Reserve Element 10 Command 56h Figure 77 Reserve 10 ID Only Parameter List Bit Byte 7 6 5 4 3 2 1 0 MSB 0 7 Third Party Device ID LSB Quantum SuperLoader 3 Software Interface Guide 132 Chapter 2 Media Changer Commands Reserve Element 6 Command 16h Reserve Element 6 Command 16h Figure 78 Reserve Element 6 Descriptor The RESERVE ELEMENT command reserves the specified media changer for exclusive use by the requesting initiator or for another specified SCSI device Element reservations are not supported Third party reservations are not supported by this command The Reserve Element 10 must be used instead Bit Byte 7 6 5 4 3 2 1 0 Operation Code 16h 1 Logical Unit
26. contains valid information Quantum SuperLoader 3 Software Interface Guide 111 Chapter 2 Media Changer Commands Read Element Status Command B8h Field Name Description Logical Unit If it is valid it provides the logical unit number within Number the SCSI bus device of the primary device served by the media changer at this element address This field is always 0 SCSI BUS If valid it provides the SCSI address of the primary Address device served by the media changer at this element address Code Set Set to 2 ASCII Identifier Set to 0 Serial Number only Type Identifier When set to 0 the Drive Serial Number field is Length omitted When set to 16 the Drive Serial Number field is included Drive Serial Number A 16 byte field containing the drive serial number padded with zeros drive serial numbers range from 10 to 14 bytes NOTE For fields not defined in this table see table 49 on page 106 Quantum SuperLoader 3 Software Interface Guide 112 Release Element 10 Command 57h Figure 66 Release 10 Descriptor Block Chapter 2 Media Changer Commands Release Element 10 Command 57h The RELEASE and the RESERVE commands are used for contention resolution in multiple initiator systems The RELEASE 10 command is used to release a previously reserved logical unit The media changer will not return an error if the initiator attempts to release a reservation that is
27. logging of events in the TapeAlert Log Page Interval Timer Not supported Report Count Test Report Count or Test Flag Number This field must be set to 0 unless the Flag Number Test bit is set When the Test bit is set this field indicates that a test condition to be generated as follows Quantum SuperLoader 3 Software Interface Guide 55 Chapter 2 Media Changer Commands Mode Sense 6 10 Command 1Ah 5Ah Field Name Description Value Result 0 Change no TapeAlert Flag but report an exception condition based on the setting of the MRIE field 1 to 64 Set the TapeAlert Flag indicated in the value and generate an exception condition based on the MRIE field 1 to 64 Clear the TapeAlert Flag in an equivalent manner to taking corrective action as indicated by the absolute number of the value 32767 Set all TapeAlert Flags and generate and exception condition based on the setting of the MRIE field Element Address Assignment Page The element address assignment page is used to report element address assignments to the host This page also defines the number of each type of Figure 39 Element Address Assignment Page element present None of the fields in this page are changeable Bit Byte 7 6 4 3 2 1 0 0 PS 0 RSVD Page Code 1Dh 1 Parameter List Length 12h MSB 2 3 First Medium Transport Element Address LSB Quantum SuperL
28. 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 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 Quantum SuperLoader 3 Software Interface Guide 45 Figure 31 Mode Select Parameter Chapter 2 Media Changer Commands Mode Select 6 10 Command 15h 55h Bit Byte 7 5 4 3 2 1 0 0 Reserved MSB 1 3 Number of Blocks LSB 4 Reserved MSB 5 7 Block Length LSB Table 22 Mode Select i ao Parameter Block Field Name Description Number of This field is sent as 0 It is not applicable to media Blocks changer devices Block Length This field is sent as 0 It is not applicable to media changer devices Mode Page Descriptors Following the MODE SELECT command s Mode Parameter Block Descriptor are the MODE SELECT pages each of which sets a different device parameter Fach mode page has a 2 byte header that identifies the page code and indicates the number of bytes in that page Quantum SuperLoader 3 Software Interface Guide 46 Chapter 2 Media Changer Commands Mode Select 6 10 Command 15h 55h Figure 32 Mode Select Page Descriptor Bit Byte 7 6 5 4 3 2 1 0 0 PS 0 0 Page Code 1 Addition
29. not currently valid Bit Byte 7 6 5 4 3 2 1 0 0 Operation Code 57h 1 Reserved 3rdPty Reserved LongID Element 2 Reservation Identification 3 Third Party Device ID 4 6 Reserved MSB 7 8 Parameter List Length LSB 9 Unused Reserved Flag Link Quantum SuperLoader 3 Software Interface Guide 113 Chapter 2 Media Changer Commands Release Element 10 Command 57h Table 53 Release 10 Sad Field Name Description 3rdPty 3rdPty Release allows an initiator to release a logical unit that was previously reserved If the value in this field is 0 third party release is not requested If 3rdPty 1 then the device server shall release the specified logical unit but only if the initiator ID 3rdPty bit and third party device ID are identical when compared to the RESERVE command that established the reservation Long ID If the Long ID bit is set to 1 the Parameter List Length is 8 and the eight bytes of the parameter list carry the device ID of the third party device the contents of the Third Party Device ID in the CDB byte 3 are ignored Element The SuperLoader 3 supports reservations only on entire logical units The value must be 0 Reservation Identification Any value in this field is ignored by the SuperLoader 3 Third Party Device ID If the Third Party Device ID value that is connected with the reservation release is s
30. subsystem may become unusable and the unit must be replaced This mode is used to download and save the entire image at once or to download the image and save it or to cause a save operation after the image data has been downloaded using the Download Microcode mode without the Save This mode of the WRITE BUFFER command causes the image data to be verified and the Flash EEPROM firmware area to be updated During the reprogramming front panel displays progress information Also when it is updating the Flash it disconnects from the SCSI bus and will not respond until the update is complete and the system has reset In this mode the drive transfers data from the application client and stores it in an Echo Buffer The Buffer ID and Buffer Offset fields are ignored in this mode Upon successful completion of a WRITE BUFFER command the data shall be preserved in the Echo Buffer unless there is an intervening command to write the Echo Buffer or the device is reset in anyway Quantum SuperLoader 3 Software Interface Guide 142 ASC ASCQ codes Request Sense media changer 126 C Commands media changer 7 Initialize Element Status command 10 Inquiry command media changer 11 L Load Unload command 22 Log Sense command media changer 23 Media changer commands Initialize Element Status 10 Inquiry 11 Log Sense 23 Mode Select 41 Mode Sense 48 Move Medium 67 overview 7 Persistent Reserve In
31. supported or changeable In such cases no parameters are changed as a result of the command Perf Performance bit Performance Impacting Exceptions are acceptable This bit is ignored DExcpt Test Disable Information Exception Operations If 0 the reporting method specified by the contents of MRIE is selected When this bit is set to 1 all information exception conditions are disabled regardless of the contents for the MRIE field To enable CHECK CONDITION mode DExcpt should 0 Default setting 1 Test bit Used to generate false TapeAlert conditions to test the response to failure conditions See the Report Count Test Flag Number description for more information If both Test and DExept are set to 1 the drive will return CHECK CONDITION status with a send key ILLEGAL REQUEST and additional sense data of INVALID FIELD IN PARAMETER LIST LogErr Error Log Not supported MRIE Method for Reporting Information Exceptions The tape drive uses the contents of this field to report information about exception conditions Value Method 00h No reporting of Informational Exception Conditions The device server does not report information exception conditions Quantum SuperLoader 3 Software Interface Guide 54 Chapter 2 Media Changer Commands Mode Sense 6 10 Command 1Ah 5Ah Field Name Description 03h Conditionally Generate Recovered Error The device server reports informat
32. to the host whichever is less The sense data is CONFLICT status valid for a CHECK CONDITION or RESERVATION returned on the previous command The sense data bytes are preserved by the media changer until retrieved by a REQUEST SENSE command or until the receipt of any other command from the same initiator though some commands such as INQUIRY do not change sense data Quantum SuperLoader 3 Software Interface Guide 122 Chapter 2 Media Changer Commands Request Sense Command 03h If the media changer receives an unsolicited REQUEST SENSE it returns sense data with the appropriate values in the Sense Key Additional Sense Code and Additional Sense Code Qualifier The following illustration portrays the format of REQUEST SENSE DATA Figure 75 Request Sense Bit Byte 7 6 5 4 3 2 1 0 0 Valid Error Code 1 Obsolete 2 Filemark EOM ILI Reserved Sense Key MSB 3 6 Information Bytes LSB 7 Additional Sense Length MSB 8 11 Command Specific Information Bytes LSB 12 Additional Sense Code ASC 13 Additional Sense Code Qualifier ASCQ 14 Sub Assembly Code 0 15 SKSV C D Reserved BPV Bit Counter MSB 16 17 Field Pointer LSB Quantum SuperLoader 3 Software Interface Guide 123 Chapter 2 Media Changer Commands Request Sense Command 03h Table 57 Request Sense Data Field Description Valid When set to
33. 001h Bit Byte 7 6 5 4 3 2 1 0 0 Reserved 1 Reserved Temperature Status 2 3 Reserved Quantum SuperLoader 3 Software Interface Guide 39 Table 18 Device Status Log Sense 0001h Chapter 2 Media Changer Commands Log Sense Command 4Dh Field Name Description Temperature These two bits indicate the temperature of the device This field follows the following format Bit 3 Bit 2 Description 0 0 Not supported 0 1 OK 1 0 Warning Safe temperature exceeded 1 1 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 Bit 0 Description 0 0 Not supported 0 OK 1 0 Degraded 1 1 Failed Quantum SuperLoader 3 Software Interface Guide 40 Chapter 2 Media Changer Commands Mode Select 6 10 Command 15h 55h Mode Select 6 10 Command 15h 55h 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 m
34. 1h Obsolete 2h Element Persistent reservation applies to the specified element When Element is the scope it indicates that the persistent reservation applies to the element of the logical unit defined by the Scope Specific Address field in the PERSISTENT RESERVE OUT parameter list Element reservations are not supported 3h 3F Reserved Reserved Quantum SuperLoader 3 Software Interface Guide 80 Chapter 2 Media Changer Commands Persistent Reserve Out Command 5Fh Field Name Description Type The value of the Type field specifies the characteristics of the persistent reservation being established for all data blocks within the extent or within the logical unit Refer to table 37 on page 76 for the applicable Type codes and their meanings HP drives only support Type codes 3h 6h and 8h Parameter List Length Fields contained in the PERSISTENT RESERVE OUT parameter list specify the reservation keys and extent information required to perform a persistent reservation service action The parameter list is 24 bytes in length the Parameter List Length field contains 24 18h bytes The following table provides detailed descriptions of each of the PERSISTENT RESERVE OUT command s seven possible service actions Service Action Codes appear in bits 0 4 of Byte 1 Quantum SuperLoader 3 Software Interface Guide 81 Chapter 2 Media Changer Commands Persistent Reserve Out Comma
35. 4 Table 35 Table 36 Table 37 Table 38 Table 39 Table 40 Table 41 Table 42 Table 43 Table 44 Table 45 Device Status Log Sense 0001h nrnrvrrrvrernvevrvvererevevrvvrrrerrern 40 Mode Select 6 10 Command Descriptor eee 42 Mode Select Parameter List n rnsnsnrrrerorererernvesererereraveseserevenenre 43 Mode Select Parameter Header snsnrnrvrererernvavererereravaserererevene 45 Mode Select Parameter Block srnarevrrrvnrvevrvevrvvenrversvrrnenevenne 46 Mode Select Page Descriptor nnsnsernsarererereraveverereveveveseserevesene 47 Mode Sense Command Descriptor Block esrrrvrrvrvovrvevnrven 49 Mode Sense Data Header rnsnrvrerererevavererererevaveveresesevaveseserevevene 52 Mode Sense Page Descriptor mnsssasarererereravarereserevavaseserevevenee 52 TapeAlert Page Format Descriptor rnrnrvrvvvrrvrvrvrvrrnrevrvrrerenn 54 Element Address Assignment Page usnrnrarvrererevavevererererevereren 58 Transport Geometry Parameters Page urwrnrrsnrarurrnrrvrrererrvvnrer 59 Device Capabilities Page mmunrrvrvvvrrvrvrrrrrrerrvrsrvrrrrrrrrrrrerrrrerenee 61 Extended Device Capabilities Page 63 Move Medium Command eoevrnrvevovevnrrevavevrvveveversvsrvevevsvsrsevevenee 68 Persistent Reserve In Command enarevrvrvnrvevavevrvveveversvsrvesensene 70 Read Keys Parameters ssssasrsrserevavrvrsrserevevsvrserevevessveserereressn 72 Read Reservations Parameters rrsrsernvvvnrvevavevrvvenvvev
36. 7h The RELEASE UNIT command releases the media changer if it is currently reserved by the requesting initiator It is not an error to release the media changer if it is not currently reserved by the requesting initiator If the media changer is reserved by another initiator however it is not released the media changer is only released from the initiator that issued the RELEASE command Element reservations are not supported Third party reservations are not supported by this command RELEASE ELEMENT 10 should be used instead Bit Byte 7 6 5 4 3 2 1 0 0 Operation Code 17h 1 Logical Unit Number Obsolete Rsv d 2 4 Reserved 5 Unused Reserved Flag Link Quantum SuperLoader 3 Software Interface Guide 116 Chapter 2 Media Changer Commands Report Device Identifier Command A3h Report Device Identifier Command A3h Figure 69 Report Device Identifier Descriptor The REPORT DEVICE IDENTIFIER command requests that the device server send device identification information to the applicable client Bit Byte 7 6 5 4 3 2 1 0 0 Operation Code A3h 1 Reserved Service Action 05h 2 5 Reserved MSB 6 9 Allocation Length LSB 10 Reserved 11 Unused Reserved Flag Link Table 54 Report Device ae Identifier Command Descriptor Field Description Block ue Service Must be 05h Any other value will return
37. 8 bytes of binary data indicating the EUI 64 assigned to the drive 3 1 8 8 bytes of binary data indicating the 64 bit type 3 FC PH Name Identifier assigned to the drive An application client can request command support data by setting the CmdDt bit of the INQUIRY command to 1 and specifying the SCSI operation code of the CDB for which it wants information The format of the command support data and definitions of the fields follow Bit Byte 7 6 5 3 2 1 0 0 Peripheral Qualifier Peripheral Device Type 1 Reserved Quantum SuperLoader 3 Software Interface Guide Support Chapter 2 Media Changer Commands Inquiry Command 12h Bit Byte 7 6 5 4 3 2 1 0 2 ISO Version ECMA Version ANSI Approved Version 3 4 Reserved 5 CDB Size m 5 6 n CDB Usage Data Table 6 Command Support Data Page Field Name Description Support The value of the Support field describes the type of support that the tape drive provides for Command Support Data Value Description 000b Data about the requested SCSI operation code is not currently available In this case all data after Byte 1 is undefined 001b The device does not support the SCSI operation code requested In this case all data after Byte 1 is undefined 010b Reserved 011b The device supports the SCSI operation code in conformance with the SCSI standard
38. Additional Reservations Allowed in the table Table 39 Persistent Reservation Type Codes Code Name Description Oh Obsolete 1h WRITE READS Shared any application client on any initiator may execute Exclusive commands that perform transfers from the storage medium to the initiator WRITES Exclusive any command from any initiator other than the initiator that holds the persistent reservation that attempts a transfer to the storage medium results in a reservation conflict 2h Obsolete 3h Exclusive READS Exclusive any command from any initiator other than the Access initiator holding the persistent reservation that attempts a transfer from the storage medium results in a reservation conflict WRITES Exclusive any command from any initiator other than the initiator holding the persistent reservation that attempts a transfer to the storage medium results in a reservation conflict 4h Obsolete Quantum SuperLoader 3 Software Interface Guide 87 Chapter 2 Media Changer Commands Persistent Reserve Out Command 5Fh Code Name Description 5h WRITE READS Shared any application client on any initiator may execute Exclusive commands that perform transfers from the storage medium to the Registrants nee Only WRITES Exclusive any command from an initiator that has not previously performed a Register service action with the device server that attempts a transfer to the storage medium results in a reservatio
39. CQ 00 otherwise failure sense data is set accordingly When a user accesses the SuperLoader 3 via the front panel or On board Remote Management in such a way that would cause conflict with a SCSI command the SuperLoader 3 is put into an off line state If a SCSI command is received while in this off line state a not ready check condition is reported SK 02 ASC 04 ASCQ 07 The SuperLoader 3 must be powered on with at least one magazine otherwise a check condition is reported SK 02 ASC 04 ASCQ 03 While the system is on line the user may remove a magazine blank and replace it with a magazine The SuperLoader 3 will calibrate the newly installed magazine and check the presence of tape cartridges in each of the storage elements While this inventory is in progress the SuperLoader 3 will report a not ready check condition SK 02 ASC 04 ASCQ 01 Once the inventory is complete the SuperLoader 3 reports a unit attention SK 06 ASC 3B ASCQ 13 Similarly while a magazine is in the process of being removed a not ready check condition is reported SK 02 ASC 04 ASCQ 07 Once the operation is complete by replacing the magazine with a blank a unit attention is reported SK 06 ASC 3B ASCQ 12 While one or both of the magazine bays are open a not ready check condition is reported SK 02 ASC 04 ASCQ 03 The SuperLoader 3 monitors the ambient temperature within the system If the temperature exceeds the maximum safe temperature for the med
40. Commands Prevent Allow Medium Removal 1Eh Prevent Allow Medium Removal 1Eh Figure 53 Prevent Allow Medium Removal This command enables or disables the removal of the magazines as well as removal of tape cartridges through the mail slot via front panel and On board Remote Management control It does not prevent removal via the SCSI Load Unload command Bit Byte 7 6 5 4 3 2 1 0 0 Operation Code 1Eh 1 Logical Unit Number Reserved 2 3 Reserved 4 Reserved Prevent 5 Unused Reserved Flag Link Table 43 Prevent Allow Field Name Description Medium Removal Command i Prevent When set to 1 removal via operator control is Descriptor Block Quantum SuperLoader 3 Software Interface Guide disabled A MOVE MEDIUM command with a destination address equal to the mail slot would return a CHECK CONDITION status The sense key shall be ILLEGAL REQUEST with the additional sense code MEDIA REMOVAL PREVENTED The PREVENT ALLOW status in the device is maintained separately by each initiator When set to 0 the prevent state corresponding to that initiator is cleared By default after power up a hard reset or BUS Device Reset message the prevent medium removal function is cleared 94 Read Buffer Command 3Ch Chapter 2 Media Changer Commands Read Buffer Command 3Ch The READ BUFFER command is used in conjunction with WRITE BUFFER as a diagnostic function for
41. ENSE 1h RECOVERED ERROR This can be caused by rounding of Mode Parameters on a MODE SELECT or may report that recovery algorithms were required to complete a move operation The device may still be able to continue to function without any unrecovered errors for a long period of time however 2h NOT READY The media changer is not ready for move operation commands Initialization or calibration may be in progress or may have failed 4h HARDWARE ERROR The Additional Sense Code Additional Sense Code Qualifier fields may present more specific information 5h ILLEGAL REQUEST The CDB or supplied parameter data had an unsupported or illegal operation specified Check bytes 15 16 and 17 6h UNIT ATTENTION Unit Attentions are created after a device reset if the medium asynchronously becomes ready to the initiator if another initiator changes Mode Parameters and or if the firmware is updated Quantum SuperLoader 3 Software Interface Guide 125 Chapter 2 Media Changer Commands Request Sense Command 03h Sense Key Description Bh COMMAND ABORTED This key is generated when a command has been aborted by the media changer for some reason Check the Additional Sense Code Additional Sense Code Qualifier bytes Table 59 Supported ASC ASCQ Hex for Request Sense The following table provides the additional sense codes ASCs and additional sense code qualifiers ASCQs that may be reported Additional informat
42. Elements The medium changer command set accesses the address space for the set of physical locations and mechanisms within the SuperLoader 3 This guide uses the SCSI 2 term element to refer to one member of the SuperLoader 3 address space Each element is a discrete physical entity that can hold a single tape cartridge Each element within a SuperLoader 3 is represented by a unique 16 bit element address The SuperLoader 3 consists of the following medium changer elements Medium transport element Storage elements Data transfer elements You can issue the Mode Sense command to determine the SuperLoader 3 configuration You can also use this command to determine the first address and the number of elements of each type Although the SuperLoader 3 does have a mailslot it is not reported as an Import Export element for use by the host system It is strictly to allow users to access tape cartridges using the front panel or On board Remote Management tool Quantum SuperLoader 3 Software Interface Guide 2 Medium Transport Element Data Transfer Element Storage Elements Chapter 1 Theory of Operation Events This mechanism can hold a single cartridge and is considered a single medium transport element It is used to move media between elements within the SuperLoader 3 The SuperLoader 3 is configured with a single tape drive All of the storage elements within the SuperLoader 3 are contained within removabl
43. Figure 10 Load Unload Command Descriptor Block The LOAD UNLOAD command tells the target to eject all magazines If no magazines are present UNLOAD returns a CHECK CONDITION status with an ILLEGAL REQUEST sense key This command will eject the magazine s regardless of the setting via the PREVENT ALLOW MEDIUM REMOVAL command Bit Byte 7 6 5 4 3 2 1 0 0 Operation Code 1Bh 1 Logical Unit Number Reserved Immed 2 4 Reserved 5 Unused Reserved Flag Link Lee Mel dal Field Name Description Immed Immediate If this bit is set to 1 status is returned as soon as the operation is started If set to 0 status is returned after the operation has completed Quantum SuperLoader 3 Software Interface Guide 22 Chapter 2 Media Changer Commands Log Sense Command 4Dh Log Sense Command 4Dh The LOG SENSE command allows the host to retrieve statistical information maintained by the media changer about its own hardware parameters Figure 11 LOG SENSE Command Descriptor Block Bit Byte 7 6 5 4 3 2 1 0 0 Operation Code 4Dh 1 Logical Unit Number Reserved PPC 0 SP 0 2 PC Page Code 3 4 Reserved MSB 5 6 Parameter Pointer LSB MSB 7 8 Allocation Length LSB 9 Unused Reserved Flag Link Quantum SuperLoader 3 Software Interface Guide 23 Chapter 2 Media Changer Commands Log Sense Command 4Dh Tab
44. Figure 3 Inquiry Command Field Description CmdDt Command Support Data If CmdDt 0 and EVPD see below 0 the media changer returns the Standard Inquiry Data If CmdDt 1 with EVPD 0 the media changer returns the Command Data specified by Page Code Operation Information about Command Support Data is provided in figure 9 on page 19 and table 6 on page 20 EVPD Enable Vital Product Data If EVPD 0 and CmdDt see above 0 the media changer returns the Standard Inquiry Data If EVPD 1 and CmdDt 0 the media changer returns the Vital Product Data Page specified by Page Code Operation Code Page Code or Operation Code Specifies the Vital Product Data Page which is to be returned by the media changer when EVPD is set Specifies the SCSI Operation Code for command support data to be returned by the media changer when CmdDt is set A CHECK CONDITION status is returned if this field specifies an unsupported Page or Operation Code or if both EVPD and CmdDt are set Figure Figure 5 on page 16 shows the Page Codes for the Vital Product Pages supported by the media changer Allocation Length Specifies the number of bytes of inquiry information the media changer is allowed to return to the initiator during the command s DATA IN phase Error status is not returned if the value in this field truncates the requested information Standard Inquiry Data Page Figure 4 shows the format of the Standard In
45. ION status with the sense key set to ILLEGAL REQUEST and an additional sense code of INVALID FIELD IN CDB The SET DEVICE IDENTIFIER parameter list contains the identifier to be set by the addressed logical unit Figure 81 Set Device Identifier Parameter List Bit Byte 7 6 5 4 3 2 1 0 0 n Identifier Table 63 Set Device Identifier g Parameter List Field Description Identifier Data to be returned by all subsequent REPORT DEVICE IDENTIFIER commands until replaced by another valid SET DEVICE IDENTIFIER command Quantum SuperLoader 3 Software Interface Guide 138 Chapter 2 Media Changer Commands Test Unit Ready Command 00h Test Unit Ready Command 00h Figure 82 Test Unit Ready Descriptor The TEST UNIT READY command checks the media changer to ensure that the unit is ready for commands involving cartridge movement If the media changer has successfully completed its initialization process and the unit is not in an error state the command returns a GOOD status Otherwise CHECK CONDITION is reported Some conditions that would cause a CHECK CONDITION include over temperature no magazines installed or user access via front panel or On board Remote Management interfaces Due to power cycle and code update it is possible to get multiple check conditions on a TEST UNIT READY command Bit Byte 7 6 5 4 3 2 1 0 Operation Code 00h 1 Logical Unit Number Reserved
46. ITTEN additional sense code if the data being read from the Echo Buffer is not the data previously written by the same initiator Buffer Capacity Returns 252 indicating the size of the Echo Buffer in bytes Quantum SuperLoader 3 Software Interface Guide 99 Chapter 2 Media Changer Commands Read Element Status Command B8h Read Element Status Command B8h The READ ELEMENT STATUS command requests that the target report the status of its internal elements to the initiator Figure 58 Read Element Status Descriptor Bit Byte 7 6 5 4 3 2 1 0 0 Operation Code B8h 1 Logical Unit Number VOLTAG Element Type Code MSB 2 3 Starting Element Address LSB MSB 4 5 Number Of Elements LSB 6 Reserved CURDATA DVCID MSB 7 9 Allocation Length LSB 10 Reserved 11 Unused Reserved Flag Link Quantum SuperLoader 3 Software Interface Guide 100 Chapter 2 Media Changer Commands Read Element Status Command B8h Table 47 Read Element Status Command Descriptor Block Field Name Description VOLTAG When set to 1 the SuperLoader 3 will report volume tag information When set to 0 no volume tag information will be reported Element Type Code Specifies the particular element type s selected for reporting by this command The element type codes are defined as follows Code Description Oh All element types reported valid in CDB only
47. MER bit set to zero indicates that the application client does not need to send an explicit command to the data transfer element to eject the medium before the media changer is able to move the medium from a data transfer element DPMER A destination pre move eject required DPMER bit set to one indicates that the media changer requires the application client to send an explicit command to the data transfer element to extend the drive mechanism before the media changer is able to move the medium to the data transfer element e g a CD ROM changer that requires the tray to be presented before the MOVE MEDIUM operation starts A DPMER bit set to zero indicates that the application client does not need to send an explicit command to the data transfer element before the media changer is able to move the medium to the data transfer element Quantum SuperLoader 3 Software Interface Guide 65 Chapter 2 Media Changer Commands Mode Sense 6 10 Command 1Ah 5Ah Field Name Description PEPOS An pre eject position PEPOS bit set to one indicates that the media changer requires a POSITION TO ELEMENT command to position the medium transport element to a data transfer element before an eject see SSC 3 An PEPOS bit set to zero indicates that the media changer does not require a POSITION TO ELEMENT command to position the medium transport element to a data transfer element before an eject UCST An unassigned clean
48. QUEST and the additional sense code Medium Destination Element Full Table 32 Move Medium ee Field Name Description Medium Transport Address Must be set to 0 Specifies the medium transport element that is to be used in executing this command Source Address Destination Address These fields can be any valid element address If it is not valid the media changer shall return CHECK CONDITION status The sense key shall be ILLEGAL REQUEST and the additional sense code INVALID ELEMENT ADDRESS INV Must be set to 0 Inverting and rotating are not supported The device capabilities MODE SENSE page provides a matrix with the supported source element or destination element combinations for the MOVE MEDIUM command Quantum SuperLoader 3 Software Interface Guide 68 Chapter 2 Media Changer Commands Persistent Reserve In Command 5Eh Persistent Reserve In Command 5Eh Figure 45 Persistent Reserve In Descriptor Block The PERSISTENT RESERVE IN command is a 10 byte command used to obtain information about persistent reservations and registrations that are active within a device server It is used in conjunction with the PERSISTENT RESERVE OUT command Note Support for Persistent Reserve is drive type dependent See individual drive documentation for complete details The following figure illustrates the format of the PERSISTENT RESERVE IN command the table that follows explains the data
49. Quantum Q D OG 9 Software Interface Guide Software Interface Guide Software Interface Guide Quantum SuperLoader 3 N M me m Q Q M WwW 81 81300 03 A01 Quantum SuperLoader 3 Software Interface Guide 81 81300 03 A01 May 2008 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 2008 by Quantum Corporation All rights reserved Your right to copy this manual is limited by copyright law Making copies or adaptations without prior written authorization of Quantum Corporation is prohibited by law and constitutes a punishable violation of the law TRADEMARK STATEMENT SuperLoader is a trademark of Quantum Corporation Quantum and the Quantum logo are registered trademarks of Quantum Corporation Other trademarks may be mentioned herein which belong to other companies D m Contents n Preface xiii Chapter 1 Theory of Operation 1 S uperLoader gerres ne r e E EA SEEE E EI 2 Medium Changer Elements sorvrerererorererererevevevererevevavevererevevssesereveseveseserevesene 2 Medium Transport Element sonorvrvovevovvrvavevrvsvnrveravsrsrreveversvsrvevevsvsrrevevene 3 Data Transfer Element sivc scicsss
50. Status Page through Data Transfer Element Descriptor Element status data consists of an eight byte header followed by zero or more element status pages Bit Byte 7 6 5 4 3 2 1 0 0 1 First Element Address Reported MSB 2 3 Number Of Elements Available LSB 4 Reserved MSB 5 7 Byte Count Of Report Available all pages n 7 LSB 8 n Element status page s Table 48 Element Status Data Note The READ ELEMENT STATUS command can be issued with an Allocation Length of eight bytes in order to determine the Allocation Length required to transfer all the element status data specified by the command Field Name Description First Element Address Reported Indicates the element address of the element with the smallest element address found to meet the CDB request Quantum SuperLoader 3 Software Interface Guide 102 Element Status Page Figure 60 Element Status Page Chapter 2 Media Changer Commands Read Element Status Command B8h Field Name Description Number Of Indicates the number of elements meeting the request Elements in the command descriptor block The status for these Available elements is returned if sufficient Allocation Length was specified Byte Count Indicates the number of bytes of element status page Of Report data available for all elements meeting the request in Available the command descriptor block This value shal
51. The SEND DIAGNOSTIC command directs the media changer to perform its self diagnostic tests Descriptor Bit Byte 7 5 3 2 1 0 0 Operation Code 1Dh 1 Logical Unit Number PF 0 Reserved Selftst DevOfl UnitOfl 2 Reserved MSB 3 4 Parameter List Length LSB 5 Unused Reserved Flag Link Vane re Diagnostic Field Description PF Page Format Not supported must be 0 Selftst Self Test A Selftst bit of 1 directs the media changer to perform its default self test A Selftst bit of 0 is not supported DevOfl Device Off line 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 Quantum SuperLoader 3 Software Interface Guide 135 Chapter 2 Media Changer Commands Send Diagnostic Command 1Dh Field Description UnitOfl Unit Off line This bit is used in conjunction with Selftst and DevOfl to specify the type of testing to be done This bit must be set to 0 Parameter Not supported must be 0 List Length Quantum SuperLoader 3 Software Interface Guide 136 Set Device Identifier Command A4h Chapter 2 Media Changer Commands Set Device Identifier Command A4h 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 This command is optional for
52. The reservation key for the other initiators pre empted are removed by the Pre empt and Clear service action The reservation key for an initiator that has sent a Pre empt and Clear action with its own reservation key specified in the service action s reservation key remains unchanged although all other specified clearing actions releasing actions and reservation actions are performed Persistent reservations are not superseded by a new persistent reservation from any initiator except via execution of a PERSISTENT RESERVE OUT that specifies either the Pre empt or Pre empt and Clear service action New persistent reservations not in conflict with an existing persistent reservation execute normally Quantum SuperLoader 3 Software Interface Guide 86 Chapter 2 Media Changer Commands Persistent Reserve Out Command 5Fh Code Name Description 06h Register This service action functions the same as the Register 00h action except and the reservation key in the parameter list is ignored and treated as if it Ignore matched the current registration if one exists for the initiator Keys The following table presents the definitions of the characters of the available Type values from the Type field of the PERSISTENT RESERVE IN Read Reservations parameters Each of the codes provides handling instructions for READ operations for WRITE operations and for subsequent attempts to establish persistent reservations referred to as
53. al Page Length 2 n Page Defined or Vendor Specific Parameter List Table 23 Mode Select Page Descriptor Field Name Description PS Parameters Savable For the MODE SELECT 6 10 commands this field is reserved 0 Additional Page Indicates number of bytes in that page not Length including bytes 0 and 1 Page Defined or Information in this field depends on the mode Vendor Specific page Refer to Element Address Assignment Parameter List Page on page 56 to Device Capabilities Page on page 60 Quantum SuperLoader 3 Software Interface Guide 47 Chapter 2 Media Changer Commands Mode Sense 6 10 Command 1Ah 5Ah Mode Sense 6 10 Command 1Ah 5Ah Figure 33 Mode Sense 6 Command Descriptor Block 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 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 Bit Byte 7 6 5 4 3 2 1 0 0 Operation Code 1Ah 1 Logical Unit Number Rsv d DBD Reserved 2 PC Page Code 3 SubPage 4 Allocation Length 5 Unused Reserved Flag Link The MODE SENSE 10 command returns descriptor data in a different format than MODE SENSE 6
54. al unit Refer to table 39 on page 87 for the applicable Type codes and their meanings The following table describes the available Type values from the Type field of the PERSISTENT RESERVE IN Read Reservations parameters Each of the codes provides handling instructions for READ operations for WRITE operations and for subsequent attempts to establish persistent reservations referred to as Additional Reservations Allowed in the table Quantum SuperLoader 3 Software Interface Guide 75 Chapter 2 Media Changer Commands Persistent Reserve In Command 5Eh Table 37 Persistent Reservation Type Codes Code Name Description Oh Obsolete 1h WRITE READS Shared any application client on any initiator may execute Exclusive commands that perform transfers from the target to the initiator WRITES Exclusive any command from any initiator other than the initiator that holds the persistent reservation that attempts a transfer to the target results in a reservation conflict ADDITIONAL RESERVATIONS Allowed any initiator may reserve the logical unit extents or elements as long as the persistent reservations do not conflict with any reservations already known to the device server 2h Obsolete 3h Exclusive READS Exclusive any command from any initiator other than the Access initiator holding the persistent reservation that attempts a transfer from the target results in a reservation conflict WRITES E
55. all device types On successful completion of a SET DEVICE IDENTIFIER command a unit attention shall be generated for all initiators except the one that issued the service action When reporting the unit attention condition the additional sense code shall be set to DEVICE IDENTIFIER CHANGED Figure 80 Set Device Identifier Descriptor Bit Byte 7 6 5 4 3 2 1 0 0 Operation Code A4h 1 Reserved Service Action 06h 9 5 Reserved MSB 6 9 Parameter List Length LSB 10 Reserved 11 Unused Reserved Flag Link The Identifier field shall be a vendor specific value to be returned in subsequent REPORT DEVICE IDENTIFIER commands Quantum SuperLoader 3 Software Interface Guide 137 Chapter 2 Media Changer Commands Set Device Identifier Command A4h Table 62 Set Device Identifier Command Descriptor Block Field Description Service Must be 06h Any other value will return Check Action Condition Illegal Request Parameter Specifies the length in bytes of the Identifier that shall List Length 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 If the parameter list length exceeds 64 bytes then the drive will return CHECK CONDIT
56. all persistent reservations for all initiators that have been registered with the Service action Reservation key specified in the PERSISTENT RESERVE OUT command s parameter list It also establishes a persistent reservation for the pre empting initiator Any commands from the initiators being pre empted are terminated as if an ABORT TASK management function had been performed by the pre empted initiator If a PERSISTENT RESERVE OUT command is sent that specifies a Pre empt and Clear service action and no persistent reservation exists for the initiator identified by the Service action Reservation key it is not an error condition If the key is registered however the Clear portion of the action executes normally A UNIT ATTENTION condition is established for the pre empted initiators The sense key is set to UNIT ATTENTION the additional sense data is set to RESERVATIONS PREEMPTED Commands that follow and retries of commands that timed out because there were cleared are subject to the persistent reservation restrictions set by the pre empting initiator The persistent reservation thus created by the pre empting initiator is defined by the Scope and Type fields of the PERSISTENT RESERVE OUT command and the corresponding fields of the command s parameter list The Pre empt and Clear service action clears any ACA or CA condition associated with the initiator that is pre empted and clears any tasks with an ACA attribute from that initiator
57. ameters within a page are always returned in ascending order according to parameter code If the target does not support a parameter code within this page then it does not return any data associated with this parameter Allocation This field specifies the maximum number of bytes that the initiator has Length allocated for returning data The host uses this field to limit the size of data transfers to its own internal buffer size Quantum SuperLoader 3 Software Interface Guide 25 Supported Pages Log Page 00h Figure 12 Supported Pages Chapter 2 Media Changer Commands Log Sense Command 4Dh When page 00h is requested the 4 byte page header is returned followed by the pages supported in ascending order one byte for each Page Bit Byte 7 6 5 4 3 2 1 0 0 Reserved Page Code 00h 1 Reserved MSB 2 3 Page Length 7h LSB 4 00h 5 07h 6 2Eh 7 30h 8 31h 9 33h 10 3Eh Quantum SuperLoader 3 Software Interface Guide 26 Last n Error Events Page Chapter 2 Media Changer Commands Log Sense Command 4Dh This page returns the ASCII text for the hard error event log This page 07h consists of a page header a parameter header and parameter value The parameter value returned consists of the ASCII text for the EEROM Hard Error Log Figure 13 Last n Error Events Log Sense Header Bit Byte 7 6 5 3 2 1 0 0 R
58. ansfer Element Descriptor Bit Byte 7 6 5 4 3 2 1 0 0 1 Element Address 2 Reserved Access Except RSVD Full 3 Reserved 4 Additional Sense Code 5 Additional Sense Code Qualifier Not BUS RSVD ID LU RSVD Logical Unit Number 6 0 Valid Valid 7 SCSI BUS Address 8 Reserved 9 SVALID Invert Reserved Quantum SuperLoader 3 Software Interface Guide 110 Chapter 2 Media Changer Commands Read Element Status Command B8h Bit Byte 7 6 5 4 3 2 1 0 10 11 Source Storage Element Address Primary Volume Tag Information 36 bytes field omitted if PVOLTAG 0 1 byte Reserved Code Set 1 byte Reserved Identifier Type 1 byte Reserved 1 byte Identifier Length Drive Serial Number 16 bytes field omitted if Identifier Length 0 Table 52 Data Transfer Element Descriptor Field Name Description Access When set to 1 it indicates access to the data transfer element by the medium transport element is allowed When set to 0 it indicates access is denied This may occur if the device is performing an auto clean operation Not Bus This field is sent as 0 The data transfer element is on the same bus as the media changer device ID Valid When set to 1 it indicates that the SCSI BUS address field contains valid information LU Valid When set to 1 it indicates that the Logical Unit Number field
59. ates a persistent reservation with a specified Scope and Type Persistent reservations are not superseded by a new persistent reservation from any initiator except by the execution of a PERSISTENT RESERVE OUT command that specifies a Release Clear Pre empt or Pre empt and Clear service action Quantum SuperLoader 3 Software Interface Guide 82 Chapter 2 Media Changer Commands Persistent Reserve Out Command 5Fh Code Name Description 02h Release A PERSISTENT RESERVE OUT command with Release service action removes a persistent reservation held by the same initiator The fields associated with a Release service action match fields of the active persistent reservation Sending of a PERSISTENT RESERVE OUT command that specifies a Release service action when no persistent reservation exists from that initiator does not result in an error Instead the device server returns a GOOD message without altering any other reservation the reservation key is not changed by the Release service action The device server returns a CHECK CONDITION status for any PERSISTENT RESERVE OUT command that specifies the release of a persistent reservation held by the requesting initiator that does not match the Scope and Type The sense key is set to ILLEGAL REQUEST and additional sense data is set to INVALID RELEASE OF ACTIVE PERSISTENT RESERVATION Attempts to release persistent reservations in which none of the Scope Type Reservatio
60. being requested by the initiator If the page is not supported then the command terminates with a CHECK CONDITION status sense key set to ILLEGAL REQUEST and additional sense code of INVALID FIELD IN CDB Supported pages are Page Code Page Definition 00h Supported Pages Log Page 00h Quantum SuperLoader 3 Software Interface Guide 24 Chapter 2 Media Changer Commands Log Sense Command 4Dh Field Name Description 07h Last n Error Events Page 07h 2Eh TapeAlert Page 2Eh on page 29 30h Move Statistics Page 30h on page 31 31h Hard Soft Error Statistics Page 31h on page 32 33h Device Wellness Page 33h on page 34 3Eh Device Status Page 3Eh on page 37 Parameter The Parameter Pointer field allows the host to specify at which parameter Pointer within a log page the requested data should begin For example if a page supports parameters 0 through 5 and the Parameter Pointer contains 3 then only parameters 3 4 and 5 are returned to the initiator Similarly if a page supports parameters 1 3 and 6 and the Parameter Pointer contains 2 then only parameters 3 and 6 are returned to the initiator If the Parameter Pointer is larger than the highest numbered parameter on the page then the target terminates the command with CHECK CONDITION status sense key set to ILLEGAL REQUEST and additional sense code set to INVALID FIELD IN CDB Note that par
61. ce Guide 120 Figure 72 LUN Reporting Parameter List Chapter 2 Media Changer Commands Report LUNS Command AO0h Bit Byte 7 5 4 3 2 1 0 MSB 0 3 LUN List Length n 7 LSB 4 7 Reserved MSB LSB n 7 n LUN last LUN if more than one The LUN List Length field contains the length in bytes of the LUN list that can be transferred The LUN List Length equals the number of logical unit numbers reported multiplied by eight If the allocation length in the CDB is too small to allow transfer of information about all of the logical units configured the LUN List Length value is not adjusted to reflect the truncation Quantum SuperLoader 3 Software Interface Guide 121 Chapter 2 Media Changer Commands Request Sense Command 03h Request Sense Command 03h Figure 73 Request Sense Command Descriptor Block The REQUEST SE NSE command causes the media changer to transfer detailed sense data to the initiator Bit Byte 7 5 4 3 2 1 0 0 Operation Code 03h 1 Logical Unit Number Reserved 2 3 Reserved 4 Allocation Length 5 Unused Reserved Flag Link JR d PE Field Description Allocation This field specifies the maximum number of sense Length bytes to be returned The media changer terminates the transfer when this number of bytes has been transferred or when all available sense data has been transferred
62. d 10 11 Source Storage Element Address Primary Volume Tag Information 36 bytes filed omitted if PVOLTAG 0 1 byte Reserved Code Set 1 byte Reserved Identifier Type 1 byte Reserved 1 byte Identifier Length Table 51 E 3 anis te ee apa Field Name Description INENAB This field is sent as 1 to indicate that the import export element supports movement of media into the scope of the media changer device EXENAB This field is sent as 1 to indicate that the import export element supports movement of media out of the scope of the media changer Access When set to 1 it indicates that access to the element by a medium transport is allowed When set to 0 it indicates that access is denied This may occur if the user is performing an operation from the front panel or Ethernet connection that prohibits access from SCSI Quantum SuperLoader 3 Software Interface Guide 109 Chapter 2 Media Changer Commands Read Element Status Command B8h Field Name Description IMPEXP When set to 1 it indicates that the unit of media in the import export element was placed there by an operator When set to 0 it indicates that it was placed there by the medium transport element When the Except bit is 1 the value of the IMPEXP bit is invalid NOTE For fields not defined in this table see table 49 on page 106 Data Transfer Element Figure 65 defines the data transfer element descriptor Descriptor Figure 65 Data Tr
63. e magazines There are two magazines which hold eight tape cartridges each for a total of 16 storage elements The number of storage elements is either 8 or 16 depending on how the magazines are configured via the front panel or the On board Remote Manager When a configured magazine is removed the corresponding storage elements are reported as inaccessible This is done via the Read Element Status Storage Element Descriptor on page 107 byte 2 bit 3 Events Power Cycle Events are system conditions created by operator actions or system failures These events are recorded in sense data for the SCSI host to retrieve via the Request Sense command When the SuperLoader 3 is powered on it goes through an initialization sequence during which it e Resets and initializes all hardware e Responds to SCSI commands which do not require movement Responds to Test Unit Ready and all movement type commands with a not ready initialization in progress check condition SK 02 ASC 29 ASCQ 02 When the power on initialization is complete it Generates a Power On Reset Occurred event SK 6 ASC 29 ASCQ 02 Quantum SuperLoader 3 Software Interface Guide 3 SuperLoader 3 Offline Magazine Insertion Removal Maximum Temperature Exceeded Quantum SuperLoader 3 Software Interface Guide Chapter 1 Theory of Operation Events e If initialization is successful it generates a not ready to ready transition SK 6 ASC 28 AS
64. edia changer to the host s preferred configuration The Mode Parameter List described in Mode Parameter List 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 Description 1Ch TapeAlert Page 1Ch on page 53 1Dh Element Address Assignment Page on page 56 1Eh Transport Geometry Parameters Page on page 58 1Fh Device Capabilities Page on page 60 Figure 25 Mode Select 6 Command Descriptor Bit Byte 7 5 4 3 2 1 0 0 Operation Code 15h 1 Logical Unit Number PF Reserved SP 0 Quantum SuperLoader 3 Software Interface Guide 41 Chapter 2 Media Changer Commands Mode Select 6 10 Command 15h 55h Bit Byte 7 6 5 4 3 2 1 0 2 3 Reserved 4 Parameter List Length 5 Unused 00 Reserved Flag Link Figure 26 Mode Select 10 Command Descriptor Bit Byte 7 6 5 4 3 2 1 0 0 Operation Code 55h 1 Logical Unit Number PF Reserved SP 0 2 6 Reserved 7 8 Parameter List Length 9 Unused 00 Reserved Flag Li
65. eempted 3B 12 Magazine Removed 3B 13 Magazine Inserted 3F 01 Microcode has been Changed 3F 05 Device Identifier Changed OBh 08 00 Command Aborted LUN Communication COMMAND Failure ABORTED 08 01 Command Aborted LUN Communication Time out 3F 00 Operating Conditions have Changed 3F OF Echo Buffer Overwritten 43 00 Message Error 44 80 Unexpected Selection Interrupt 44 82 Command Complete Sequence Failure 44 83 SCSI Chip Gross Error Illegal Command Status 44 84 Unexpected Unexplained Residue Count in Transfer Register 44 87 Disconnect SDP Sequence Failed 45 00 Select Reselect Failure 47 00 SCSI Parity Error check SCSI bus configuration and connections 48 00 IDE Message Error 49 00 Invalid Message Error 4A 00 Command Phase Error 4B 00 Data Phase Error Quantum SuperLoader 3 Software Interface Guide 129 Chapter 2 Media Changer Commands Reserve Element 10 Command 56h Sense Key ASC ASCQ Description 4E 00 Overlapped Commands Attempted Reserve Element 10 Command 56h Figure 76 Reserve Element 10 Descriptor The RESERVE and RELEASE commands are used for contention resolution in multiple initiator systems The RESERVE command is used to reserve a logical unit The RESERVE 10 Command Descriptor Block is shown in figure 76 and the data fields are described in table 60 Bit Byte 0 Operation Code 56h 1 Reserved 3rdPty Reserved LongID Ele
66. eiesssssenesssnsestvovsnnissessdesssssscveesistesssveseenensdoeve 3 Storage HlEMeEMts saise ccieossvensiosetscensvesotecasstets lecenatens ssenseveesebentvtenctbensienassobass 3 Even S 2cc5 cg ttehits cess tesa vtte et E E A E O 3 Power Cycle voirai iene AEE AE 3 SuperL ader 3 Olin rerssnsereii nerriet nii nE NEKEEN N 4 Magazine Insertion Removal nsnrvrvvvrvrvrrvrvrrvrvvrvrvrerrrrrrvrerrrerevverererene 4 Maximum Temperature Exceeded nunervrvavevrvernrvevavsrsvveverersvsrvevevsvsrsevevenn 4 Atitomatic Drive Cleaning sccciisscscsssssserssnssoaseessesenersenessbanssesnisenotoestesssbveesseaioss 5 Element Status Information evervrrvrrverrvrvvrererrvvvvrrrerrsrsrerrererrsrverveveverene 6 Automatic Cleaning Operation rmrrvvvrvrvrrvrerrrvevrvrvrrerrvrvrvrrererererererererene 6 Quantum SuperLoader 3 Software Interface Guide iii Chapter 2 Contents Media Changer Commands 7 Overview of Command and Status Processing sesnvarerevererererererereraverevererene 7 Media Changer Command Descriptions rrernrvrvvevvreveveveveverereveverererevereverenne 9 Initialize Element Status Command O7h ervrrrvrnorevrvevorvevrvevrvreveversvsrsevevenne 10 Inquiry Command 120 csssssconstesensssestssvssssessensessucseassvsbsossansosotseaassonsteebedes 11 Standard Inquiry Data Page rorvrvrvrrevrvrvvrrvrrrvrvrserererrrsvrvrerrrservrrrrrrrenee 12 Vital Product Data Page is c sccccvesscseensecsseisancnetseanassnstecnssvenorsepessv
67. element descriptor Of data available for elements of this element type Descriptor meeting the request in the CDB This value shall not be Data adjusted to match the Allocation Length available Available Each element descriptor includes the element address and status flags it may also contain sense code information as well as other information depending on the element type see Medium Transport Element Descriptor through Data Transfer Element Descriptor on page 110 Quantum SuperLoader 3 Software Interface Guide 104 Medium Transport Element Descriptor Figure 62 Medium Transport Element Descriptor Chapter 2 Media Changer Commands Read Element Status Command B8h Figure 62 defines the medium transport element descriptor Bit Byte 7 6 5 4 3 2 1 0 0 1 Element Address 2 Reserved Except RSVD Full 3 Reserved 4 Additional Sense Code 5 Additional Sense Code Qualifier 6 8 Reserved SVALID Invert Reserved s 0 10 11 Source Storage Element Address Primary Volume Tag Information 36 bytes field omitted if PVOLTAG 0 1 byte Reserved Code Set 1 byte Reserved Identifier Type 1 byte Reserved 1 byte Identifier Length Quantum SuperLoader 3 Software Interface Guide 105 Chapter 2 Media Changer Commands Read Element Status Command B8h Table 49 Medium Transport Element Descriptor Fie
68. ength Note that this value does not include bytes 0 and 1 The length is returned on MODE SENSE and must subsequently be set to the same value when performing MODE SELECT The SuperLoader 3 supports the TapeAlert Page that is used to set change the supported TapeAlert configuration options Use the MODE SENSE command to read the settings of the TapeAlert page Bit Byte 7 6 5 4 3 2 1 0 0 PS 0 0 Page Code 1Ch 1 Additional Page Length 0Ah 2 Perf Reserved DExcpt Test Rsvd LogErr 3 Reserved MRIE MSB Interval Timer 4 7 LSB MSB Report Count Test Flag Number 8 11 LSB Quantum SuperLoader 3 Software Interface Guide 53 Chapter 2 Media Changer Commands Mode Sense 6 10 Command 1Ah 5Ah Table 27 TapeAlert Page Format Descriptor Field Name Description PS Parameters Savable Not supported this bit must be 0 Additional Page Length This field indicates the number of bytes in the page However this value does not include bytes 0 and 1 The length is returned on MODE SENSE and must subsequently be set to the same value when performing MODE SELECT If the page length does not match that expected by the drive a CHECK CONDITION status is returned sense key set to ILLEGAL REQUEST The device returns a CHECK CONDITION status with sense key set to ILLEGAL REQUEST if it receives an unsupported Page Code or a Page field with values not
69. er 2 Media Changer Commands Read Element Status Command B8h Field Name Description Access Indicates that access to the element by a medium transport element is allowed An Access bit of zero indicates that access to the element by the medium transport element is denied When a magazine is removed from the SuperLoader 3 the corresponding storage elements shall have an Access bit of 0 Access will also be denied if the storage element is configured as the location of a cleaning tape when auto clean is enabled When the Except bit is one the value of the Access bit is not valid Source Storage Element Address Provides the address of the last storage element this unit of media occupied This element address value may or may not be the same as this element This field is valid only if the SVALID bit is one NOTE For fields not defined in this table see table 49 Figure 64 defines the import export element descriptor Bit Byte 7 6 5 4 3 2 1 0 0 1 Element Address Reserved INENAB EXENAB Access Except IMPEXP Full 2 1 1 3 Reserved 4 Additional Sense Code 5 Additional Sense Code Qualifier Quantum SuperLoader 3 Software Interface Guide 108 Chapter 2 Media Changer Commands Read Element Status Command B8h Bit Byte 7 6 5 4 3 2 1 0 6 8 Reserved 9 SVALID Invert Reserve
70. er Commands Command Operation Code Initialize Element Status Command 07h 07h Inquiry Command 12h on page 11 12h Load Unload Command 1Bh on page 22 1Bh Log Sense Command 4Dh on page 23 4Dh Mode Select 6 10 Command 15h 55h on page 41 15h 55h Mode Sense 6 10 Command 1Ah 5Ah on page 48 1Ah SAh Move Medium Command A5h on page 67 A5h Persistent Reserve In Command 5Eh on page 69 SCSI 3 5Eh Persistent Reserve Out Command 5Fh on page 78 SCSI 3 5Fh Position to Element Command 2Bh on page 92 2Bh Prevent Allow Medium Removal 1Eh on page 94 1Eh Read Buffer Command 3Ch on page 95 3Ch Read Element Status Command B8h on page 100 B8h Release Element 10 Command 57h on page 113 57h Release Unit 6 Command 17h on page 116 17h Report Device Identifier Command A3h on page 117 A3h Report LUNS Command A0h on page 120 AOh Request Sense Command 03h on page 122 03h Reserve Element 10 Command 56h on page 130 SCSI 3 56h Reserve Element 6 Command 16h on page 133 16h Send Diagnostic Command 1Dh on page 135 1Dh Set Device Identifier Command A4h on page 137 SCSI 3 A4h Test Unit Ready Command 00h on page 139 00h Quantum SuperLoader 3 Software Interface Guide 8 Chapter 2 Media Change
71. ererene 71 Read Reservations Parameters ssennsrsrserevevrvrvvrererrvrrrrererrerenn 73 Persistent Reserve In Read Reservations 74 Quantum SuperLoader 3 Software Interface Guide Figures vii Figure 49 Figure 50 Figure 51 Figure 52 Figure 53 Figure 54 Figure 55 Figure 56 Figure 57 Figure 58 Figure 59 Figure 60 Figure 61 Figure 62 Figure 63 Figure 64 Figure 65 Figure 66 Figure 67 Figure 68 Figure 69 Figure 70 Figure 71 Figure 72 Figure 73 Figure 74 Figure 75 Figure 76 Figure 77 Figure 78 Persistent Reserve Out Descriptor nrrarvrvrvvrvavrrvavvrnrvvrnrvvrnee 79 Persistent Reserve Out Command sserrvevorvevavevrvvevevevsvsvsevevenee 79 Persistent Reserve Out Parameter List eee 88 Position to Element Descriptor renarevnvnvnrveravevrvvevrversvsrvenevenne 92 Prevent Allow Medium Removal rornrrnrnrronrovervrnnrnrrnrrnrrsenne 94 Read Buffer Command Descriptor Block eee 95 Read Buffer Header inier a ne a EENE 97 Read Buffer Descriptor r rrvevrvnrrvrrvrravrvrrrevaversvsrvrversvsrvesevevense 98 Echo Buffer Descriptor s rnrersvvvvnvervvnrsvvevevrrsenrsererenvesserrsvensvenne 99 Read Element Status Descriptor sesnnnvvrvevavsvrvvenrverrvrrnvserevne 100 Element Status Data Header rsesvrnrarervrerevavavesererevavaseseserevenre 102 Element Status Page snrerervrererarerererevevaveverernvevsvrserevevevevesereveren 103 D tauiessspsepneGrensdessnn E EE EEEE 104 Medium Transport Ele
72. eserved I E gt DT I E gt I E I E gt ST I E gt MT 6 0 0 0 0 Reserved DT gt DT DT gt I E DT gt ST DT gt MT 7 1 0 1 1 8 11 Reserved Reserved MT lt gt DT MT lt gt I E MT lt gt ST MT lt gt MT 12 0 0 0 0 Reserved ST lt gt DT ST lt gt I E ST lt gt ST ST lt gt MT 13 0 0 0 0 Quantum SuperLoader 3 Software Interface Guide 60 Chapter 2 Media Changer Commands Mode Sense 6 10 Command 1Ah 5Ah Bit Byte 6 5 4 3 2 1 0 Reserved I E lt gt DT I E lt gt I E I E lt gt ST I E lt gt MT 0 0 0 0 Reserved DT lt gt DT DT lt gt I E DT lt gt ST DT lt gt MT 3 0 0 0 0 16 19 Reserved Table 30 Device Capabilities Page The field names in figure 42 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 Field Name Description PS Parameters Savable This bit is reserved for MODE SELECT and must be 0 Saved parameters are not supported and must be 0 for MODE SENSE SPF A SubPage Format bit set to zero indicates that the subpage format is not used for this page STORXX These bits are sent as 1 for all element types to indicate that each element type provides storage for a unit of media XX gt YY
73. eserved Page Code 07h 1 Reserved MSB 2 3 Page Length n LSB Table 9 Last n Error Events sae Log Sense Header Field Name Description Page Code The Page Code echoes the page code that was specified in the LOG SENSE command descriptor block Page Length The Page Length field specifies the total number of bytes contained in this log page not including the four bytes that make up the header Quantum SuperLoader 3 Software Interface Guide 27 Figure 14 Format for Last n Error Events Log Sense Chapter 2 Media Changer Commands Log Sense Command 4Dh Bit Byte 7 6 5 4 3 2 1 0 MSB 0 1 Parameter Code LSB 2 DU DS TSD ETC TMC Rsv d LP 3 Parameter Length MSB 4 n ASCII String for Event n LSB Table 10 Parameters Last n Field Name Description Error Events Log Sense Parameter Code The Parameter Code value represents the relative time at which the error occurred It identifies the log parameter being transferred for that log page The most recent 10 events will be reported DU Disable Update not supported always 0 DS Save not supported always 1 TSD Target Save Disable not supported always 1 ETC Enable Threshold Comparison not supported always 0 TMC Threshold Met Criteria not supported always 0 LP List Parameter This bit is set to 1 Parameter The length in bytes of the following parameter Length value
74. eturning a RESERVATION CONFLICT status Scope Specific Ignored Address APTPL Activate Persist Through Power Loss This bit is valid only for Register and Register and Ignore Existing Key service actions it is ignored for all other types of service actions If the last valid APTPL bit value received by the device server is 0 the loss of power in the target releases any persistent reservations and removes all reservation keys If the last valid APTPL bit value is 1 the logical unit retains all persistent reservations and all reservation keys for all initiators even if power is lost and later returned The most recently received valid APTPL value from any initiator governs the logical unit s behavior in the event of a power loss The following table illustrates which fields are set by the application client and interpreted by the device server for each Service and Scope value Quantum SuperLoader 3 Software Interface Guide 90 Table 41 Device Server Interpretation of Service and Chapter 2 Media Changer Commands Persistent Reserve Out Command 5Fh Scope Value Parameters Service Allowed Service Action Action Scope Type Reservation Key Reservation Key Register Ignored Ignored Valid Valid Reserve LU Valid Ignored Valid Release LU Valid Ignored Valid Clear Ignored Ignored Ignored Valid Pre empt LU Valid Valid Valid Pre empt LU Valid Valid Valid and Clear Register Ignored Ignored Valid I
75. fields of the command Bit Byte 7 6 5 4 3 2 1 0 0 Operation Code 5Eh 1 Reserved Service Action 2 6 Reserved MSB 7 8 Allocation Length LSB 9 Unused Reserved Flag Link Quantum SuperLoader 3 Software Interface Guide 69 Chapter 2 Media Changer Commands Persistent Reserve In Command 5Eh Note The original SCSI specification allowed users to specify the LUN Logical Unit Number in bits 7 5 in byte 1 Systems still set the LUN on the initial INQUIRY when talking to a newer than SCSI 2 device There are systems drivers in the field that set the legacy LUN field in all CDBs HP drives ignore the legacy LUN field in all CDBs that identify bits 7 5 in byte 1 as reserved These values will vary depending on the drive type Table 33 Persistent Reserve In Command Field Name Description Service Service actions that require information about persistent reservation and Action registrations may require enabling of nonvolatile memory within the logical unit Service action codes available are Code Name Description 00h Read Keys Reads all registered reservation keys olh Read Reservations Reads all current persistent reservations 02 1Fh Reserved Reserved A Read Keys service action requests that the device server return a parameter list that includes a header and a complete list of all of the reservation keys currently registered wit
76. ge on page 60 3Fh Return all pages SubPage This field can have three values 41h Extended Device Capabilities SubPage FFh All SubPages 00h No SubPage format Allocation This field specifies the number of bytes that the host has allocated for Length 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 The MODE SENSE 6 and MODE SENSE 10 headers are illustrated in the Headers following figures Quantum SuperLoader 3 Software Interface Guide 50 Figure 35 Mode Sense 6 Data Header Chapter 2 Media Changer Commands Mode Sense 6 10 Command 1Ah 5Ah Bit Byte 7 6 5 4 3 0 Mode Sense Data Length 1 3 Block Descriptor Length 0 Figure 36 Mode Sense 10 Data Header Bit Byte 7 6 5 MSB 0 1 Mode Sense Data Length LSB Reserved Reserved Reserved MSB 6 7 Block Descriptor Length 0 LSB Quantum SuperLoader 3 Software Interface Guide 51 Chapter 2 Media Changer Commands Mode Sense 6 10 Command
77. gnored and Ignore Existing Key Quantum SuperLoader 3 Software Interface Guide 91 Position to Element Command 2Bh Chapter 2 Media Changer Commands Position to Element Command 2Bh The POSITION TO ELEMENT command shall position the Medium Transport Address element such that further motion of the Medium Transport Address element is unnecessary to execute an appropriate MOVE MEDIUM command between the Medium Transport Address element and the Destination Address element Figure 52 Position to Element Descriptor Bit Byte 7 6 5 4 3 2 1 0 0 Operation Code 2Bh 1 Logical Unit Number Reserved MSB 2 3 Medium Transport Address LSB MSB 4 5 Destination Address LSB 6 7 Reserved Reserved Invert 0 9 Unused Reserved Flag Link Quantum SuperLoader 3 Software Interface Guide 92 Chapter 2 Media Changer Commands Position to Element Command 2Bh Table 42 Position to Element Command Field Name Description Medium Transport Address Address of the medium transport element to position Must be set to 0 Destination Address Address of the element in which to position the medium transport element This can be any valid element address Invert Must be set to 0 Inverting or rotating of the Medium Transport Element is not supported Quantum SuperLoader 3 Software Interface Guide 93 Chapter 2 Media Changer
78. h the device server If multiple initiators have registered with the same key then the key is listed multiple times once for each registration Refer to figure 46 and table 34 for information about Read Keys parameter data A Read Reservation service action requests that the device server return a parameter list that contains a header and a complete list of all persistent reservations that are presently active in the device server Refer to figure 47 on page 73 and table 35 on page 73 for information about Read Reservations parameter data Quantum SuperLoader 3 Software Interface Guide 70 Chapter 2 Media Changer Commands Persistent Reserve In Command 5Eh Field Name Description Allocation This field indicates how much space has been reserved for the returned Length parameter list Read Keys or Read Reservations parameters The actual length of the parameter data is indicated in the parameter data field for those parameters If the Allocation Length is not sufficient to contain the entire list of parameters the first portion of the list that does fit is returned If it is determined that the remainder of the list is required the client should send a new PERSISTENT RESERVE IN command with an Allocation Length field large enough to contain the entire list of parameters The figure and table below illustrate and describe the data fields of Read Key data parameters Figure 46 Read Keys
79. host uses this field to limit the size of data transfers to its own internal buffer size The host should first send a READ BUFFER command in Descriptor mode to determine the size of the buffer being returned In response to the READ BUFFER command the device returns four bytes of data three of which contain the size of the buffer The host can then use this data to establish the Buffer Offset Allocation Length fields of the CDB Once the size of the buffer is known Mode 2 Data Only see Data Mode 0010b can be used to transfer the data across the SCSI Bus Combined Header and In this mode the device returns a 4 byte header followed by data bytes Data Mode 000b The device terminates the DATA IN phase when the Allocation Length bytes of header and data have been transferred or when all available data has been transferred to the initiator whichever is less The 4 byte READ Quantum SuperLoader 3 Software Interface Guide 96 Chapter 2 Media Changer Commands Read Buffer Command 3Ch BUFFER header is followed by data bytes from the target data buffer The figure below illustrates the format of the header The buffer ID must be set to 0 The buffer offset must be less than the size of the buffer Figure 55 Read Buffer Header Bit Byte 7 6 5 4 3 2 1 0 0 Reserved MSB 1 3 Available Length LSB Table 45 Read Buffer Header Field Description Available This field specifies the total numbe
80. ia the SuperLoader 3 will disable all movement until the temperature decreases below a safe threshold While the temperature remains excessive SCSI commands that require movement will fail SK 04 ASC 0B ASCQ 01 Chapter 1 Theory of Operation Automatic Drive Cleaning Automatic Drive Cleaning There are two modes of automatic drive cleaning support available e Host initiated cleaning SuperLoader 3 managed cleaning Both modes provide automatic cleaning of the drive but the first is managed by the host and the second is managed by the SuperLoader 3 These two modes are configured separately and only one should be enabled at any given time When automatic drive cleaning of the drive is enabled either the host or the SuperLoader 3 is responsible for all cleaning functions such as e Detecting when a drive requires cleaning Tracking and selecting cleaning cartridges Moving a cleaning cartridge to the drive e Determining when a cleaning cartridge has used all of its available cleaning cycles By default the SuperLoader 3 is configured to allow for host initiated cleaning If automatic cleaning is disabled from the host the SuperLoader 3 can be configured to manage the automatic cleaning of the drive This is done by enabling the Auto Clean function Please refer to the Quantum SuperLoader 3 User s Guide for information on how this is done Note There is no way for the host and SuperLoader 3 to know how the other is co
81. ields are supported AERC Asynchronous Event Notification is not supported NormACA The media changer does not support the NACA bit in the control byte of the CDB HiSup The hierarchical addressing model is not used Response Data This Standard Inquiry Data is in SCSI 2 format Note that Format although the loader reports SCSI 2 here the additional SCSI 3 fields as indicated in the description of the page are supported Additional Length This field indicates the number of additional bytes of INQUIRY Response Data available SCCS This device does not contain an embedded storage array controller BQue Basic queueing is not supported EncServ This device does not contain an embedded enclosure services component MultiP This device does not implement multi port requirements Note that the value and support of this function is determined by the drive installed MChngr This device is not an attached media changer Quantum SuperLoader 3 Software Interface Guide 14 Chapter 2 Media Changer Commands Inquiry Command 12h Field Name Description Add16 This devices supports 16 bit wide SCSI addresses RelAdr This device does not support relative addressing WBUS16 This device supports 16 bit wide data transfers Sync Refer to the drive interface guide to find out if synchronous data transfers are supported Linked This device does not support linked commands CmdQue This device does n
82. ing Code Update 24 91 Bad Autoloader Image EDC 25 00 Ilegal LUN 26 00 Parameter List Error Invalid Field Quantum SuperLoader 3 Software Interface Guide 127 Chapter 2 Media Changer Commands Request Sense Command 03h Sense Key ASC ASCQ Description 26 01 Parameter List Error Parameter Not Supported 26 02 Parameter List Error Parameter Value Invalid 26 03 Threshold Parameters Not Supported 26 04 Invalid Release of Persistent Reservation 39 00 Saving Parameters Not Supported 3B 0D Media Destination Element Full 3B OE Media Source Element Empty 3B 11 Magazine Not Accessible 3B 12 Magazine Removed 53 02 Media Removal Prevented 55 04 Insufficient Registration Resources 06h 28 00 Not Ready To Ready Transition UNIT ATTENTION 28 01 Import Export Element Accessed 29 00 Reset Occurred 29 01 Power On Occurred 29 02 SCSI BUS Reset Occurred 29 03 BUS Device Reset Function Occurred 29 04 Device Internal Reset 29 05 Transceiver Mode Changed to Single Ended 29 06 Transceiver Mode Changed to LVD 2A 01 Mode Parameters Changed 2A 02 Log Parameters Changed 2A 03 Reservations Preempted 2A 04 Reservations Released Quantum SuperLoader 3 Software Interface Guide 128 Chapter 2 Media Changer Commands Request Sense Command 03h Sense Key ASC ASCQ Description 2A 05 Registrations Pr
83. ing storage UCST bit set to one indicates that the device server does not assign element addresses to the physical entities that contain cleaning media These unassigned physical entities are not reported in the READ ELEMENT STATUS data A UCST bit set to zero indicates that the device server assigns element addresses to physical entities that contain cleaning media Quantum SuperLoader 3 Software Interface Guide 66 Chapter 2 Media Changer Commands Move Medium Command A5h Move Medium Command A5h The MOVE MEDIUM command requests that the SuperLoader 3 move a volume from a source element to a destination element Figure 44 Move Medium Descriptor Block Bit Byte 7 6 5 4 3 2 1 0 0 Operation Code A5h 1 Logical Unit Number Reserved MSB 2 3 Medium Transport Address LSB MSB 4 5 Source Address LSB MSB 6 7 Destination Address LSB 8 9 Reserved 10 Reserved INV 11 Unused Reserved Flag Link Quantum SuperLoader 3 Software Interface Guide 67 Chapter 2 Media Changer Commands Move Medium Command A5h If the Source Address element is empty the target shall return CHECK CONDITION status The sense key shall be ILLEGAL REQUEST and the additional sense code Medium Source Element Empty If the Destination Address element is full and different from the Source Address element the target shall return CHECK CONDITION status The sense key shall be ILLEGAL RE
84. integration of two separate devices a tape drive and a media changer The media changer consists of all the mechanics and electronics required to store and move tape cartridges while the tape drive provides the read write functionality Each device has a separate interface for communication to the host The SCSI command set supported by the tape drive is documented separately The SCSI command set supported by the media changer Gi device is detailed in Media Changer Command Descriptions on page 9 The SuperLoader 3 is fully compliant with the mandatory commands for the ANSI SCSI 3 standard for tape drive and media changer devices and implements many optional features The SuperLoader 3 does not act as an initiator on the SCSI bus Therefore it does not generate unsolicited interrupts to the bus initiate its own SCSI commands or assert bus reset Quantum SuperLoader 3 Software Interface Guide 1 Chapter 1 Theory of Operation SuperLoader 3 SuperLoader 3 SuperLoader 3 has one SCSI ID and two logical units LUN The tape drive always resides at logical unit 0 and the media changer resides at logical unit 1 Because the drive supports the physical interface the user needs to reference the drive s documentations for specific support For example the sync bit in the Standard Inquiry Data Page see Standard Inquiry Data Page on page 12 requires the drive hardware to report the proper function kN EEE E Medium Changer
85. ion explanations or suggestions for action are included in some of the descriptions Sense Key ASC ASCQ Description 00 00 00 No Additional Sense Code NO SENSE 44 00 Internal Target Error 01 RECOVERED ERROR 47 00 SCSI Parity Error 48 00 IDE Message Received 5D 00 Failure Predictive Threshold Exceeded 5D FF Failure Predictive Threshold Exceeded False 02h NOT READY 04 00 Logical Unit Not Ready Cause Unreportable 04 01 Unit Not Ready Calibration Initialization in Process 04 03 Unit Not Ready Manual Intervention Needed no magazine is present or a mechanical failure has occurred Quantum SuperLoader 3 Software Interface Guide 126 Chapter 2 Media Changer Commands Request Sense Command 03h Sense Key ASC ASCQ Description 04 07 Unit Not Ready Operation in Progress 44 00 Internal Target Failure 04h 08 00 LUN Communication Failure HARDWARE ERROR 08 01 LUN Communication Timeout Failure 0B 01 Over Temperature Condition Error 15 01 Mechanical Positioning Error 40 83 Diagnostic Failure 40 84 POST Soft Error 53 00 Media Load Failure 53 01 Media Unload Failure 05h 1A 00 Parameter List Length Error ILLEGAL REQUEST 20 00 Illegal Opcode 21 01 Invalid Element Address 24 00 Invalid CDB Field 24 86 Invalid Offset 24 87 Invalid Size 24 89 Image Data Over Limit 24 8B Image Personality is Bad 24 8C Not Immediate Command dur
86. ion exception conditions if such reports of recovered errors is allowed by returning CHECK CONDITION status on the next SCSI command except INQUIRY and REQUEST SENSE commands following detection of the condition The Sense Key is set to RECOVERED ERROR with an additional sense code of 5D 00 TapeAlert Event The SCSI command with CHECK CONDITION completes without error prior to the report of any exception condition and does not need to be repeated 04h Unconditionally Generate Recovered Error The drive reports information exception conditions by returning CHECK CONDITION status on the next SCSI command except INQUIRY and REQUEST SENSE commands following detection of the condition The Sense Key is set to RECOVERED ERROR with an additional sense code of 5D 00 TapeAlert Event The SCSI command with CHECK CONDITION completes without error prior to the report of any exception condition and does not need to be repeated 06h Only Report Informational Exception Condition on Request The device server preserves informational exception data To access the data a poll can be taken by issuing an unsolicited REQUEST SENSE command The Sense Key is set to NO SENSE with an additional sense code of 5D 00 TapeAlert Event The additional sense code of 5D 00 for values 03h 04h and 06h signals that a TapeAlert event has occurred Information about the event is stored in the TapeAlert Log Page The setting of MRIE does not impact
87. jected The target detects and rejects commands that would overrun the Buffer Offset See Download Microcode Mode 0100b and Download Microcode and Save Mode 0101b for the appropriate settings Write Combined Header and Data Mode 0000b Write Data Mode 0010b Download Microcode Mode 0100b The data to be transferred is preceded by a 4 byte header consisting entirely of reserved bytes This header is discarded not stored within the buffer The buffer offset field must be 0 for this mode Similar to Header and Data Mode except there is no header in the data passed to the target Any potential buffer overruns are detected and the command is rejected Using buffer offsets the host can download the firmware image into the target s buffer in pieces These commands do not cause the new image to become active A Download and Save Mode WRITE BUFFER command must be issued for the image to become active Quantum SuperLoader 3 Software Interface Guide 141 Download Microcode and Save Mode 0101b Write Data to Echo Buffer 1010b Chapter 2 Media Changer Commands Write Buffer Command 3Bh Any error on a WRITE BUFFER command causes any downloaded image data to be discarded and the download must be restarted from the beginning Caution During the actual reprogramming of the FLASH EEPROM if any type of power fail occurs or if the reprogramming fails before completion the SuperLoader 3
88. l not be adjusted to match the Allocation Length available The element status page is defined in figure 60 Each element status page includes an eight byte header followed by zero or more element descriptor blocks The header includes the element type code the length of each descriptor block and the number of bytes of element descriptor information that follow the header for this element type Bit Byte 7 6 5 4 3 2 1 0 0 Element Type Code PVOLTAG AVOLTAG Reserved 1 0 2 3 Element Descriptor Length 4 Reserved MSB Byte Count Of Descriptor Data Available 5 7 all pages y 7 LSB Quantum SuperLoader 3 Software Interface Guide 103 Chapter 2 Media Changer Commands Read Element Status Command B8h Bit Byte 7 6 5 4 3 2 1 0 MSB 8 y Element descriptor s LSB PENGE Pea Field Name Description Element Indicates the element type see table 47 reported by Type Code this page PVOLTAG When set to 1 indicates that the Primary Volume Tag Information field is present in each of the following element descriptor blocks A value of zero indicates that these bytes are omitted from the element descriptors that follow AVOLTAG This field is sent as 0 Alternate volume tag information is not supported Element Indicates the number of bytes in each element Descriptor descriptor Length Byte Count Indicates the number of bytes of
89. ld Name Description Element Address Specifies the address of the media changer element whose status is reported by this element descriptor block Except An exception bit of 0 indicates the element is in a normal state If this bit is 1 information on the abnormal state may be available in the Additional Sense Code and Additional Sense Code Qualifier fields Full When set to 1 indicates that the element contains a unit of media A value of zero indicates that the element does not contain a unit of media When the Except bit is one the value of the Full bit is not valid Additional Sense Provides specific information on an abnormal element state The values in Code this field are as defined for the Additional Sense Code field of REQUEST SENSE command response data This field is valid only if the Except bit is one Additional Sense Provides more detailed information on an abnormal element state The Code Qualifier values in this field are as defined for the Additional Sense Code Qualifier field of REQUEST SENSE command response data This field is valid only if the Except bit is one SVALID When set to 1 indicates that the Source Storage Element Address field and the Invert bit information are valid A value of zero indicates that the values in these fields are not valid Invert This field is sent as 0 Inverting and rotating of media is not supported Source Storage Element Address Provides the address of the last storage elemen
90. le 8 Log Sense Command Descriptor Block Field Name Description PPC Parameter Pointer Control A PPC of 0 indicates that the parameter data requested from the device starts with the parameter code specified in the Parameter Pointer field Bytes 5 6 and returns the number of bytes specified in the Allocation Length field Bytes 7 8 in ascending order of parameter codes from the specified log page Request for changed parameters is not supported This field must be 0 SP Save Parameters Not supported must be set to 0 If for some reason the Save Parameters bit is set the command terminates with a CHECK CONDITION status with a sense key of ILLEGAL REQUEST and an ASC of INVALID FIELD IN CDB PC Page Control This field defines the type of parameter values to be returned PC Type of Parameter Values 00b Threshold Values 01b Cumulative Values 10b Default Threshold Values 11b Default Cumulative Values The Default Threshold Values are the maximum values that each parameter can attain The Current Cumulative Values are the values computed since the last reset of the device either via power cycle BUS DEVICE RESET or SCSI RESET The Default Cumulative Values are the values to which each parameter is initialized at a reset condition Default values are 0 By default Current Threshold Values Default Threshold Values Page Code The Page Code field identifies which log page is
91. maller than 255 the LongID bit may be 0 and the ID value sent in the CDB If LongID bit 0 the Parameter List Length field also 0 If the Third Party Device ID value is greater than 255 LongID 1 Device servers that support device IDs greater than 255 will accept commands with LongID 1 device servers that do not support IDs greater than 255 may reject commands with LongID set 1 Device ID formats are protocol specific Parameter List Length The contents of this field specify the length in bytes of the parameter list that will be transferred from the initiator to the target NOTE Assuming that the RELEASE Command Descriptor Block is valid the SuperLoader 3 always returns a GOOD status for this command An actual release only happens if the initiator has the unit reserved for itself or a third party initiator Quantum SuperLoader 3 Software Interface Guide 114 Chapter 2 Media Changer Commands Release Element 10 Command 57h If the LongID bit 1 and the Element bit 0 then the parameter list length is eight and the parameter list has the following format Figure 67 Release 10 ID Only Parameter List Bit Byte 7 6 5 4 3 2 1 0 MSB 0 7 Third Party Device ID LSB Quantum SuperLoader 3 Software Interface Guide 115 Release Unit 6 Command 17h Figure 68 Release Unit 6 Descriptor Block Chapter 2 Media Changer Commands Release Unit 6 Command 1
92. ment 2 Reservation Identification 3 Third Party Device ID 4 6 Reserved MSB 7 8 Parameter List Length LSB 9 Unused Reserved Flag Link Quantum SuperLoader 3 Software Interface Guide 130 Chapter 2 Media Changer Commands Reserve Element 10 Command 56h Table 60 Reserve Element 10 Command Field Description 3rd Pty When set to 1 it indicates that the Third Party Device ID field is valid LongID When 0 indicates that the third party device associated with the reservation release has a number smaller than 255 and the ID value can be sent within the CDB If set 1 indicates that the third party device ID is greater than 255 the ID value within the CDB is ignored and the parameter list length is at least eight Element Not supported Must be 0 Reservation Ignored Identification Third Party Required and used only when the 3rdPty bit is set in which case this field Device ID specifies the SCSI ID of the initiator to be granted the reservation of the logical unit The drive preserves the reservation until one of the following occurs e It is superseded by another valid RESERVE command from the initiator Itis released by the same initiator Itis released by a TARGET RESET message from any initiator It is released by a TARGET RESET message from any initiator or Itis released by a hard reset condition The media changer ignores any attempt to release the reservation made
93. ment Descriptor ieee 105 Storage Element Descriptor mnssarasesvsereravasesereravavesererevevenee 107 Import Export Element Descriptor rsornvvrvrnovevrvvenrverrvrverne 108 Data Transfer Element Descriptor srrnrvrvavvvrvvevavevrvervrvevevne 110 Release 10 Descriptor Block smrornrnrvvvrvevnrvenavsvrvreveverenne 113 Release 10 ID Only Parameter List cece 115 Release Unit 6 Descriptor Block 116 Report Device Identifier Descriptor ssesarvrrrvevrverrvrrvvverevne 117 Report Device Identifier ssosarernrnrvvvnvrvnrvevavevrvsvnrversvsrsesevevne 118 Report LUNS Descriptor eee cese cess ceeseseeseseeseeeenees 120 LUN Reporting Parameter List rnsnrarvrvrrererervrrrvrrerervrrererenne 121 Request Sense Command Descriptor Block eee 122 Request Sense Command Data srevrvrvovevorvrvrverrvsrnrversvrrvesevevne 122 Request SENse vvs iris ses oaesdasesceavacesnitesbaresesesiustesvacuiesbesestescotens 123 Reserve Element 10 Descriptor s es 130 Reserve 10 ID Only Parameter List 0 eee 132 Reserve Element 6 Descriptor srrornrnrvevrvrvnrvevavrvrvveveversnne 133 Quantum SuperLoader 3 Software Interface Guide Figures viii Figure 79 Send Diagnostic Descriptor Figure 80 Set Device Identifier Descriptor Figure 81 Set Device Identifier Parameter List Figure 82 Test Unit Ready Descriptor Figure 83 Write Buffer Descriptor Quantum SuperLoader 3 Software Interface Guide
94. mmand to preempt those reservations if necessary Note that since persistent reservations are not reset by the TARGET RESET task management function or other global actions they can be used to enact device sharing among multiple initiators The PERSISTENT RESERVE OUT and PERSISTENT RESERVE IN commands provide the means for resolving contentions in multiple initiator systems with multiple port target By using the reservation key to identify persistent reservations it is possible to determine which ports hold conflicting persistent reservations and to take over such reservations from failing or greedy initiators Note Support for Persistent Reserve is drive type dependent See individual drive documentation for complete details The following figure illustrates the format of the PERSISTENT RESERVE OUT command the table that follows explains the data fields of the command Quantum SuperLoader 3 Software Interface Guide 78 Chapter 2 Media Changer Commands Persistent Reserve Out Command 5Fh Figure 49 Persistent Reserve Out Descriptor Bit Byte 7 6 5 4 3 2 1 0 0 Operation Code 5Fh 1 Reserved Service Action 2 Scope Type 3 6 Reserved MSB 7 8 Parameter List Length 18h LSB Figure 50 Persistent Reserve Out Command Field Name Description Service Action Service actions that require information about persistent reservation and registrations may require e
95. n conflict 6h Exclusive READS Exclusive any command from an initiator that has not Access previously performed a Register service action with the device server Revi that attempts a transfer from the storage medium results in a egistrants P reservation conflict Only WRITES Exclusive any command from an initiator that has not previously performed a Register service action with the device server that attempts a transfer to the storage medium results in a reservation conflict 7h Fh Reserved N A The PERSISTENT RESERVE OUT command requires a parameter list illustrated in the following figure and defined in the following table Each of the fields of the parameter list are sent for every PERSISTENT RESERVE OUT command even if the field is not required for the specific Service action and or Scope values Figure 51 Persistent Reserve Out Parameter List Bit Byte 7 6 5 4 3 2 1 0 MSB 0 7 Reservation Key LSB Quantum SuperLoader 3 Software Interface Guide 88 Chapter 2 Media Changer Commands Persistent Reserve Out Command 5Fh Bit Byte 7 6 5 4 3 2 1 0 MSB 8 15 Service Action Reservation Key LSB MSB 16 19 Scope Specific Address LSB 20 Reserved APTPL 21 Reserved 22 23 Obsolete Table 40 Persistent Reserve Out Parameter List Field Name Reservation Key Description This field contains an 8 byte token that i
96. n Key and extent values match an existing persistent reservation held by the initiator making the request are not errors An active persistent reservation may also be released by Powering off When the most recent APTPL value received by the device server is 0 a power off performs a hard reset clears all persistent reservations and removes all registered reservation keys or Executing a PERSISTENT RESERVE OUT command from another initiator with a persistent reserve service action of Clear Pre empt or Pre empt and Clear Note that a Release service action should not be performed if any operations interlocked by the persistent reservation have not yet completed Powering off When the most recent APTPL value received by the device server is 0 a power off performs a hard reset clears all persistent reservations and removes all registered reservation keys or Executing a PERSISTENT RESERVE OUT command from another initiator with a persistent reserve service action of Clear Pre empt or Pre empt and Clear Note that a Release service action should not be performed if any operations interlocked by the persistent reservation have not yet completed Quantum SuperLoader 3 Software Interface Guide 83 Chapter 2 Media Changer Commands Persistent Reserve Out Command 5Fh Code Name Description 03h Clear A PERSISTENT RESERVE OUT command with a successful Clear service action removes all persistent reservations for
97. nabling of nonvolatile memory within the logical unit Service action codes available are Code Name Description 00h Register Register a reservation key with the device server 01h Reserve Create a persistent reservation using a reservation key 02h Release Release a persistent reservation 03h Clear Clear all reservation keys and all persistent reservations Quantum SuperLoader 3 Software Interface Guide 79 Chapter 2 Media Changer Commands Persistent Reserve Out Command 5Fh Field Name Description 04h Pre empt Pre empt persistent reservations from another initiator 05h Pre emptand Pre empt persistent reservations from another Clear initiator and clear the task set for the pre empted initiator 06h Register and Register a reservation key with the device server Ignore Existing reservation key is ignored Existing Key 07 1Fh Reserved Reserved HP drives support Service Action 07h Register and Move Refer to table 40 on page 89 for detailed descriptions of each of the service action codes Scope The value in this field indicates whether a persistent reservation applies to an entire logical unit or to an element The values for the Scope field are Code Name Description Oh LU Logical Unit Persistent reservation applies to the full logical unit The LU scope is therefore implemented by all device servers that implement PERSISTENT RESERVE OUT
98. nd 4Dh Bit Byte 7 6 4 3 2 1 0 0 Reserved Page Code 31h 1 Reserved MSB 2 3 Page Length 22h LSB MSB 4 5 Servo Hard Errors LSB MSB 6 9 Drive Soft Error LSB MSB 10 13 Left Magazine Soft Error LSB MSB 14 17 Right Magazine Soft Error LSB MSB 18 21 Mail Slot Soft Error LSB MSB 99 25 Rotation Recovery Actions LSB Quantum SuperLoader 3 Software Interface Guide 33 Chapter 2 Media Changer Commands Log Sense Command 4Dh Bit Byte 7 5 4 3 2 1 0 MSB 26 29 Translation Recovery Actions LSB MSB 30 33 Left Magazine Recovery Actions LSB MSB 34 37 Right Magazine Recovery Actions LSB Table 14 Hard Soft Error Device Wellness Page 33h Field Name Description Page Code The page code is 31h Page Length The page length is 22h bytes Servo Hard Errors The number of unrecoverable errors Soft Errors Each field is a count of the number of times high level recoverable error was reported for that component Recovery Actions Each field is a count of the number of times recovery actions were required in that axis to perform an operation The Device Wellness Page returns information about any check conditions related to Sense Keys 4 and 9 logged by the media changer Up to 16 entries parameter code 0000h to 000Fh can be contained in the page Each ent
99. nd 5Fh Table 38 Persistent Reserve Out Command Service Action Code Name Description 00h Register When the command executes a Register service action it registers a reservation key with a device server without generating a reservation The device server holds these reservation keys from each initiator that performs a PERSISTENT RESERVE OUT command with a Register service action until the key is changed by a new PERSISTENT RESERVE OUT command with Register service action from the same initiator or until the initiator registration is removed by Powering down the logical unit if the last Activate Persist Through Power Loss APTPL see figure 51 on page 88 and table 40 on page 89 received by the device server was 0 Performing a Clear service action Performing a Pre empt service action Performing a Pre empt and Clear service action or Performing a Register service action from the same initiator with the value of the service action reservation key set to 0 When a reservation key has not yet been established or when the reservation key has been removed a reservation key of 0 is used when the initiator performs a PERSISTENT RESERVE OUT with the Register service action When the reservation has been removed no information is reported for the initiator in the Read Keys service action of the resulting PERSISTENT RESERVE IN command olh Reserve A PERSISTENT RESERVE OUT command with Reserve service action cre
100. nfigured with respect to automatic drive cleaning It is up to the user to make sure only one is enabled In host initiated cleaning mode the host tracks all cleaning cartridges and their use When the SuperLoader 3 Auto Clean feature is enabled a cleaning slot is allocated and the cleaning cartridge is stored in this storage element The SuperLoader 3 assumes that any cartridge stored in this location is a cleaning cartridge and will attempt to use it as such Quantum SuperLoader 3 Software Interface Guide 5 Element Status Information Automatic Cleaning Operation Quantum SuperLoader 3 Software Interface Guide Chapter 1 Theory of Operation Automatic Drive Cleaning The SuperLoader 3 does not keep track of the number of times a cleaning tape is used Instead it relies on the tape drive to report when the tape has expired When this happens the SuperLoader 3 will notify the user via the front panel The Auto Clean function is automatically disabled until the user inserts a new cleaning tape and re enables the feature When the SuperLoader 3 Auto Clean feature is enabled the allocated storage element is reported as inaccessible to the host This is done by setting the access bit to 0 in the Read Element Status Storage Element Descriptor page When the SuperLoader 3 Auto Clean feature is enabled the SuperLoader 3 checks if the drive needs cleaning after each successful move from the drive Therefore each time
101. nk Table 19 M 1 er ed a GM Field Name Description PF 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 SP Save Parameters Must be 0 If set this bit instructs the SuperLoader 3 to save all savable pages and this is not supported Quantum SuperLoader 3 Software Interface Guide 42 Chapter 2 Media Changer Commands Mode Select 6 10 Command 15h 55h The following figure shows the format of the Mode Parameter List that is Mode Parameter List passed by the initiator to the media changer during the command s DATA OUT phase Figure 27 Mode Select 6 Mode Parameter List Bit Byte 7 6 5 4 3 2 1 0 0 3 Mode Parameter Header 4 11 Mode Parameter Block Descriptor Optional 4 11 or Page s Optional 12 n Figure 28 Mode Select 10 Mode Parameter List Bit Byte 7 6 5 4 3 2 1 0 0 7 Mode Parameter Header 8 15 Mode Parameter Block Descriptor Optional 8 n Page s Optional or 16 n TAa e MOTE SEG Field Name Description Parameter List ModeParameter 4 or 8 bytes in length contains information about Header the remainder of the Parameter List and is alway
102. oader 3 Software Interface Guide 56 Chapter 2 Media Changer Commands Mode Sense 6 10 Command 1Ah 5Ah Bit Byte 7 5 4 3 2 1 0 MSB 4 5 Number of Medium Transport Elements LSB MSB 6 7 First Storage Element Address LSB MSB 8 9 Number of Storage Elements LSB MSB 10 11 First Import Export Element Address LSB MSB 12 13 Number of Import Export Address LSB MSB 14 15 First Data Transfer Element Address LSB MSB 16 17 Number of Data Transfer Elements LSB 18 19 Reserved Quantum SuperLoader 3 Software Interface Guide 57 Chapter 2 Media Changer Commands Mode Sense 6 10 Command 1Ah 5Ah Table 28 Element Address Assignment Page Field Name Description First Medium Transport Identifies the address of the first medium transport element Element Address contained in the media changer The SuperLoader 3 uses the default address of 0 Number of Medium Defines the total number of medium transport elements Transport Elements contained in the media changer The SuperLoader 3 contains 1 First Storage Element Identifies the address of the first medium storage element Address contained in the media changer Number of Storage Defines the total number of storage elements contained in the Elements media changer There are 16 total although since the magazines are removable eight of them may be inaccessible at times Fir
103. operator or if configurations have been changed Bit Byte 7 5 4 3 2 1 0 0 Operation Code 07h 1 Logical Unit Number Reserved 9 4 Reserved 5 Unused Reserved Flag Link Quantum SuperLoader 3 Software Interface Guide 10 Chapter 2 Media Changer Commands Inquiry Command 12h Inquiry Command 12h Figure 2 Inquiry Command The INQUIRY command allows the initiator to determine the kind of SCSI devices attached to its SCSI BUS It causes a device that is attached to a SCSI BUS to return information about itself The SuperLoader 3 identifies itself as a media changer that implements the SCSI 3 protocol The media changer can provide three categories of data in response to an INQUIRY command Standard Inquiry Data Vital Product Data and Command Support Data Standard Inquiry Data contains basic data about the device Vital Product Data comprises several pages of additional data Each Vital Product Data page requires a separate INQUIRY command from the initiator Command Support Data indicates the fields in the CDB that are supported by opcode An INQUIRY command is not affected by nor does it clear a Unit Attention condition Bit Byte 7 5 4 3 2 1 0 0 Operation Code 12h 1 Logical Unit Number Reserved CmdDt EVPD 2 Page Code MSB 3 4 Allocation Length LSB Quantum SuperLoader 3 Software Interface Guide 11 Chapter 2 Media Changer Commands Inquiry Command 12h
104. ot support command queueing Vendor Identification QUANTUM Identification of vendor Product Identification UHDL Identification of the product Product Revision Level xxxx This field contains 4 bytes of ASCII hex data that provides the media changer s firmware revision level Language This field indicates the language used for the front panel and On board Remote Management Image Type This field indicates the type of firmware image required when downloading a new image SuperLoader 3 reports a 2 Firmware Personality Numeric indicator of firmware personality Note that when set to 4 this indicates OEM family Firmware Subpersonality Set to 2 indicating standard SCSI device firmware Vendor Specific Subtype Identification of product The BQue and CmdQue bits are set on HP drives even though these options are not supported It is necessary to set these bits for Adaptec HBAs to support Ultra 320 These values will vary depending on the drive type in the autoloader Vital Product Data Page The following sections describe the Vital Product Data Pages for the system Quantum SuperLoader 3 Software Interface Guide 15 Chapter 2 Media Changer Commands Inquiry Command 12h Supported Vital Product Data Page The Supported Vital Product Data Pages page provides a directory of the Vital Product Data Pages that are supported by the SuperLoader 3 Figure 5 Suppo
105. ously performed a Register service action with the device Regi server that attempts a transfer from the target results ina egistrants i reservation conflict Only WRITES Exclusive any command from an initiator that has not previously performed a Register service action with the device server that attempts a transfer to the target results in a reservation conflict ADDITIONAL RESERVATIONS Allowed any initiator may reserve the logical unit extents or elements as long as the persistent reservations to not conflict with any reservations already known to the device server 7h Fh Reserved Not applicable Quantum SuperLoader 3 Software Interface Guide 77 Chapter 2 Media Changer Commands Persistent Reserve Out Command 5Fh E Persistent Reserve Out Command 5Fh The PERSISTENT RESERVE OUT command is a 10 byte command used to reserve a logical unit for the exclusive or shared use by an initiator The command is used in conjunction with the PERSISTENT RESERVE IN command it is not used with the RESERVE and RELEASE commands Persistent reservations conflict with reservations made via the RESERVE command Initiators that perform PERSISTENT RESERVE OUT actions are identified by a reservation key assigned by the application client The client may use the PERSISTENT RESERVE IN command to identify which other initiators within a system hold conflicting or invalid persistent reservations and use the PERSISTENT RESERVE OUT co
106. quiry Data page returned by the media changer Quantum SuperLoader 3 Software Interface Guide 12 Chapter 2 Media Changer Commands Inquiry Command 12h Figure 4 Standard Inquiry Data Bit Byte 7 6 5 4 3 2 1 0 0 Peripheral Qualifier Peripheral Device Type 1 RMB Reserved 2 Version 3 AERC Obsolete NormACA HiSup Response Data Format 4 Additional Length n 4 5 SCCS Reserved 6 BQue EncServ Reserved MultiP MChngr Obsolete Obsolete Add16 7 RelAdr Obsolete Whbus16 Sync Linked Obsolete CmdQue Reserved 8 15 Vendor Identification QUANTUM 16 31 Product Identification UHDL 32 35 Product Revision Level xxxx 36 Language 37 Reserved Image Type 38 40 Reserved 41 Firmware Personality 42 Firmware Subpersonality 43 Vendor Specific Subtype Quantum SuperLoader 3 Software Interface Guide 13 Chapter 2 Media Changer Commands Inquiry Command 12h The following table contains field descriptions for the data returned by the media changer Table 2 Standard Inquiry Data Field Name Description Peripheral Qualifier Non zero if initiator selects an invalid logical unit see below Peripheral Device Type 8 indicates that this is a media changer device RMB Removable Medium Bit Set to 1 Version ANSI SCSI Level 2 SCSI 2 is supported Note that some SCSI 3 features and f
107. r 3 Software Interface Guide 118 Chapter 2 Media Changer Commands Report Device Identifier Command A3h Field Description Identifier The value reported is the last value written by a successful SET DEVICE IDENTIFIER command The value of the identifier is changed only by a successful SET DEVICE IDENTIFIER command The identifier value persists through resets and power cycles Quantum SuperLoader 3 Software Interface Guide 119 Report LUNS Command AOh Figure 71 Report LUNS Chapter 2 Media Changer Commands Report LUNS Command AOh The REPORT LUNS command requests that the peripheral device logical unit numbers of known logical units in the target be sent to the applications client The command only returns information about the logical units to which commands may be sent Descriptor Bit Byte 7 6 5 4 3 2 1 0 0 Operation Code AOh 1 5 Reserved MSB 6 9 Allocation Length LSB 10 Reserved 11 Unused Reserved Flag Link Table 56 Report LUNS Command Descriptor Block Field Description Allocation If the Allocation Length is not sufficient to contain the logical unit number Length values for all configured logical units the device server still reports as many logical number values as will fit in the Allocation Length The format of the report of configured logical units is shown in figure 72 Quantum SuperLoader 3 Software Interfa
108. r Commands Media Changer Command Descriptions Command Operation Code Write Buffer Command 3Bh on page 140 3Bh Media Changer Command Descriptions The Media Changer commands are presented in alphabetical order Because information about a particular command may span multiple pages the command name is repeated at the top of every page that concerns that command Throughout this manual multiple bytes containing information about specific command parameters are portrayed as shown in the following example of the Parameter List Length field bytes 7 and 8 of the MODE SELECT command Bit Byte 7 6 5 4 3 2 1 0 Bytes 0 6 MSB 7 8 Parameter List Length LSB As shown this sample indicates that the most significant bit MSB of the field is bit 7 of byte 7 the least significant bit is bit 0 of byte 8 Quantum SuperLoader 3 Software Interface Guide 9 Chapter 2 Media Changer Commands Initialize Element Status Command 07h Initialize Element Status Command 07h Figure 1 Initialize Element Status Command The INITIALIZE ELEMENT STATUS command allows the media changer to check all assigned element addresses for volume and any other status relevant to that element address The intent of this command is to enable the Initiator to get a quick response from a subsequent READ ELEMENT STATUS command It may be useful to issue this command after a power failure if a volume has been changed by an
109. r Information Figure 21 Log Parameters for Device Wellness Log Sense Field Name Description Parameter Parameter Codes 0000h through 000Fh are supported This provides 16 log Code entries for error information capture DU Disable Update Always 0 DS Save not supported always 1 Quantum SuperLoader 3 Software Interface Guide 36 Chapter 2 Media Changer Commands Log Sense Command 4Dh Field Name Description TSD Target Save Disable not supported always 1 ETC Enable Threshold Comparison Threshold checking is not supported on this page Always set to 0 TMC Threshold Met Criteria Always 0 LP List Parameter Always set to 0 Parameter The number of bytes to follow OCh Length Time Stamp The Time Stamp is represented as number of power cycles and total power on hours Source Element Destination Element These fields report the element addresses that were involved in the failure These fields will be zero 0 if the failure did not involve a move command Device Status Page 3Eh Figure 22 Device Status Log Sense Header The Device Status Page describes the current status of the media changer Bit Byte 7 6 4 3 2 1 0 0 Reserved Page Code 3Eh 1 Reserved MSB 2 3 Page Length LSB Quantum SuperLoader 3 Software Interface Guide 37 Chapter 2 Media Changer Commands Log Sense Command 4Dh
110. r Release service action or by a PERSISTENT RESERVE OUT command that is not done due to an error or a reservation conflict The value in the Generation field is set to 0 as part of the power on or reset processes The value in the Generation field allows the application client that examines the value to verify that the configuration of the initiators attached to a logical unit has not been modified by another application client without any notification of the application client doing the examination Quantum SuperLoader 3 Software Interface Guide 73 Chapter 2 Media Changer Commands Persistent Reserve In Command 5Eh Field Name Description Additional This field contains the count of the number of bytes of Reservation descriptors Length bytes 8 n Note that this field contains the number of bytes regardless of the value prescribed by the Allocation Length field in the command s CDB Reservations One Reservation descriptor is reported for each unique persistent reservation Descriptors on the logical unit when the PERSISTENT RESERVE IN command has indicated a Read Reservations action Figure 48 and table 36 detail the contents of each Reservation Descriptors field The figure and table below illustrate and describe the data fields of each Read Reservations descriptor s data fields Figure 48 Persistent Reserve In Read Reservations Bit Byte 7 6 5 4 3 2 1 0 0 7 Reservation Key LSB MSB
111. r of data bytes available in the target s Length buffer This number is not reduced to reflect the allocation length nor is it reduced to reflect the actual number bytes written using the WRITE BUFFER command Following the READ BUFFER header the target transfers data from its data buffer In this mode the DATA IN phase contains only buffer data The buffer ID Data Mode 0010b must be set to 0 The buffer offset must be less than the size of the buffer Descriptor Mode 0011b In this mode a maximum of four bytes of READ BUFFER descriptor information is returned The device returns the descriptor information for the buffer specified by the Buffer ID In this mode the device does not reject the invalid Buffer IDs with a CHECK CONDITION status but returns all zeros in the READ BUFFER descriptor Quantum SuperLoader 3 Software Interface Guide 97 Chapter 2 Media Changer Commands Read Buffer Command 3Ch Figure 56 Read Buffer Descriptor Bit Byte 7 6 5 4 3 2 1 0 0 Offset Boundaries 0h MSB 1 3 Buffer Capacity LSB Read Data from Echo In this mode the device transfers data to the application client from the Buffer 1010b Echo Buffer The Echo Buffer will transfer the same data as when the WRITE BUFFER command with the mode field set to Echo Buffer was issued The Buffer ID and Buffer Offset fields are ignored in this mode The READ BUFFER command will return the same n
112. riptor Block eee 23 Supported Pages Page mrrrrrvvvnvrsrsrrereverrsrrererrvrsrrerererrsrsvrererrenn 26 Last n Error Events Log Sense Header rsrsrvrvnvrvvvrerrvervvvrernnr 27 Format for Last n Error Events Log Sense 0 0 0 0 scenes 28 TapeAlert Log Sense Header Format ieee eee 29 TapeAlert Page Log Parameters Format eee 30 Move Statistics Format sesrrvrserrervereserevrrveserervrveveveserervesererere 31 Hard Soft Move Error Statistics Format ssnrnernrrnrnrrrvenvrnnnn 33 Quantum SuperLoader 3 Software Interface Guide vi Figure 19 Figure 20 Figure 21 Figure 22 Figure 23 Figure 24 Figure 25 Figure 26 Figure 27 Figure 28 Figure 29 Figure 30 Figure 31 Figure 32 Figure 33 Figure 34 Figure 35 Figure 36 Figure 37 Figure 38 Figure 39 Figure 40 Figure 41 Figure 42 Figure 43 Figure 44 Figure 45 Figure 46 Figure 47 Figure 48 Device Wellness Log Sense Header srsrsrrrrnvnvrvrererevevrvrverererer 35 Device Wellness Log Sense 0000h 000Fh ssesererer ever rrerene 35 Log Parameters for Device Wellness Log Sense rrrrrsernrne 36 Device Status Log Sense Header nrnrrvrernrennvaverererernvaverererevene 37 Parameters for Device Status Log Sense Page rrrrvrrvrvrrrenn 38 Device Status Log Sense Page OOOTN eee 39 Mode Select 6 Command Descriptor rsesarevrrvevrverrvrrvrvevenne 41 Mode Select 10 Command Descriptor eects 42 Mode Select 6 Mode Parameter List
113. rted Vital Product Data Bit Byte 7 6 5 4 3 2 1 0 0 Peripheral Qualifier Peripheral Device Type 1 Page Code 00h 2 Reserved 3 Page Length 03h 4 00h this page 5 80h Unit Serial Number Page 6 83h Device Identification Page Figure 6 Unit Serial Number Page 80h Bit Byte 7 6 5 4 3 2 1 0 0 Peripheral Qualifier Peripheral Device Type 1 Page Code 80h 2 Reserved 3 Page Length 0Eh Quantum SuperLoader 3 Software Interface Guide 16 Chapter 2 Media Changer Commands Inquiry Command 12h Bit Byte 7 6 5 4 3 2 1 0 4 17 Serial Number Table 3 Unit Serial Number Page Field Descriptions Field Name Description Serial The serial number given is the serial number of the Number media changer typically starting with PM indicating the site of manufacture Figure 7 Device Identification Page 83h Bit Byte 7 6 5 4 3 2 1 0 0 Peripheral Qualifier Peripheral Device Type 1 Page Code 83h 2 Reserved 3 Page Length 4 n Identification Descriptors Quantum SuperLoader 3 Software Interface Guide 17 Chapter 2 Media Changer Commands Inquiry Command 12h There are three different Identification Descriptors returned in numerical order of the Identifier Type Each Identification Descriptor takes the following form Figure 8 Iden
114. ry records a hardware error Sense Key 4 or a code update event Sense Key 9 Note that parameter code 000h contains the oldest log information while parameter 000Fh contains the most recent Quantum SuperLoader 3 Software Interface Guide 34 Chapter 2 Media Changer Commands Log Sense Command 4Dh This page begins with a 4 byte header followed by the log parameter blocks Figure 19 Device Wellness Log Sense Header Bit Byte 7 6 5 4 3 2 1 0 0 Reserved Page Code 33h 1 Reserved MSB 2 3 Page Length LSB Table 15 Device Wellness Log Se Sansa Header Field Name Description Page Code The Page Code echoes the page code that was specified in the LOG SENSE command descriptor block Page Length The Page Length field specifies the number of bytes available and depends on the parameters requested Figure 20 Device Wellness Log Sense 0000h 000Fh Bit Byte 7 6 5 4 3 2 1 0 MSB 0 1 Parameter Code LSB Quantum SuperLoader 3 Software Interface Guide 35 Chapter 2 Media Changer Commands Log Sense Command 4Dh Bit Byte 7 6 5 4 3 2 1 0 2 DU DS TSD ETC TMC Rsv d LP 3 Parameter Length 0Ch MSB 4 7 Time Stamp LSB MSB 8 9 Source Element LSB MSB 10 11 Destination Element LSB 12 Sense Key 13 Additional Sense Code 14 Additional Sense Code Qualifier 15 Additional Erro
115. s LSB Quantum SuperLoader 3 Software Interface Guide 31 Chapter 2 Media Changer Commands Log Sense Command 4Dh Bit Byte 7 6 5 4 3 2 1 0 MSB 20 23 Magazine Moves LSB MSB 24 27 Magazine Loads LSB Table 13 Move Statistics Hard Soft Error Statistics Page 31h Field Name Description Page Code The page code is 30h Page Length The page length is 18h bytes Total Moves Total number of SuperLoader 3 moves Drive Loads Number loads to the drive from magazines and mail slot Mail Slot Imports Number times a cartridge was importing into the system Mail Slot Exports Number of times a cartridge was exported from the system Magazine Moves Number of moves between storage slots Magazine Loads Number of times a cartridge was moved from a storage slot to the drive This page consists of the Log Page Header followed by a count of recovery actions performed The entries in this log page are cumulative throughout the life of the unit and cannot be reset via SCSI or power cycle Log Parameters are not supported for this page These numbers in relation to the total number of moves performed can provide an indication as to the health of the servo system Quantum SuperLoader 3 Software Interface Guide 32 Figure 18 Hard Soft Move Error Statistics Format Chapter 2 Media Changer Commands Log Sense Comma
116. s present Quantum SuperLoader 3 Software Interface Guide 43 Chapter 2 Media Changer Commands Mode Select 6 10 Command 15h 55h Field Name Description Mode Parameter 8 bytes in length not applicable to a media Block Descriptor changer device Page s The Page Code s of the pages that are a part of this MODE SELECT command Mode Parameter Header 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 Figure 29 Mode Select 6 Parameter Header Bit Byte 7 0 0 Reserved 1 Reserved 2 Reserved 3 Block Descriptor Length Figure 30 Mode Select 10 Parameter Header Bit Byte 7 6 5 4 3 2 1 0 0 1 Reserved 2 Reserved Quantum SuperLoader 3 Software Interface Guide 44 Chapter 2 Media Changer Commands Mode Select 6 10 Command 15h 55h Bit Byte 7 6 5 4 3 2 1 0 3 Reserved 4 5 Reserved 6 7 Block Descriptor Length Table 21 Mode Select a Parameter Header Field Name Description Block This field specifies the length in bytes of all the block Descriptor descriptors Since the media changer only allows one Length 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
117. s provided by the application client to the device server to identify which initiator is the source of the PERSISTENT RESERVE OUT command For all service actions except Register and Ignore Existing Key the device server verifies that the Reservation Key in the PERSISTENT RESERVE OUT command matches the Reservation Key that is registered for the initiator from which the command is received If there is no match the device server returns a RESERVATION CONFLICT status The Reservation Key of the initiator is valid for all Service action and Scope values Quantum SuperLoader 3 Software Interface Guide 89 Chapter 2 Media Changer Commands Persistent Reserve Out Command 5Fh Field Name Description Service Action Reservation Key This field contains information needed for 3 service actions the Register service action the Pre empt service action and the Pre empt and Clear service action The Service Action Reservation Key is ignored for all other service actions For the Register service action the Service Action Reservation Key field contains the new Reservation Key to be registered For the Pre empt and the Pre empt and Clear service actions the Service Action Reservation Key contains the reservation key of the persistent reservations that are being pre empted For the Pre empt and the Pre empt and Clear actions any failure of the Service Action Reservation Key to match any registered keys results in the device server r
118. sereveree 139 Write Buffer Command 3Bh oervororoorovovrrvonevrvrvnrvevevevsrvevavevsvsrvrversvsrvesevsvee 140 Write Combined Header and Data Mode O000b 0 eee 141 Write Data Mode 0010b rnrvorvonovovornenvvevrvnrvrvavsvnrvevevevsvsrnevevsesrvesevsvee 141 Download Microcode Mode 0100b sorrrvovrvorrrnrnvvrvrvnvvevavevrvsrverevsve 141 Download Microcode and Save Mode 0101Bb ornerrvorrrnovevrvrvnvreveve 142 Write Data to Echo Buffer 1010b sosnnrrvrvorrvovnvnrvevrvrvnrvenavsvrvsrveverevne 142 Quantum SuperLoader 3 Software Interface Guide Figures Figure 1 Figure 2 Figure 3 Figure 4 Figure 5 Figure 6 Figure 7 Figure 8 Figure 9 Figure 10 Figure 11 Figure 12 Figure 13 Figure 14 Figure 15 Figure 16 Figure 17 Figure 18 Initialize Element Status Command srerrererevrvvrerereverrsrserererens 10 Inquiry Command sensns 11 niquiry Commanderie areetan 12 Standard Inquiry Data eoeororvrvvverrvrrrrrrerrvrsrrererrrrervrerrrsrrvvrnene 13 Supported Vital Product Data ssrenrrvorverrvrvrvvevavevrvernrvereversrser 16 Unit Serial Number Page 80h rrrrnrrvrvrrrrrrrvrvrvvrrrvrrrrnvrvrernennr 16 Device Identification Page 83h srvrnrrvrrrvrrrvrvrvrvererrvrvrveverene 17 Identifier Descriptor uuarisursannseneaddrssnkenine 18 Command Support Data Page rrrrvvvrvrvvrvrvrrrrrvrvrerrrrvrvrerernnr 19 Load Unload Command Descriptor Block svrvnvovorvovrverrvnr 22 LOG SENSE Command Desc
119. ss via the door is possible A DTEDA bit set to zero indicates that the door may be opened while data transfer elements contain media RSSEA A return to source storage element address RSSEA bit set to one indicates that the media changer requires the application client to return the medium to the element address specified in the SOURCE STORAGE ELEMENT ADDRESS field An RSSEA bit set to zero indicates that the application client does not need to return the medium to the element address specified in the SOURCE STORAGE ELEMENT ADDRESS field MVTRY A move tray MVTRY bit set to one indicates that the media changer uses removable trays in its elements which requires the medium to be placed in a tray and the tray moved to the desired position An MVTRY bit set to zero indicates that the media changer does not use trays in its elements IEMGZ An import export magazine IEMGZ bit set to one indicates that the media changer uses medium magazines for some import export elements An IEMGZ bit set to zero indicates that the media changer does not use medium magazines for any import export element SMGZ A storage magazine SMGZ bit set to one indicates that the media changer uses medium magazines for some storage elements A SMGZ bit set to zero indicates that the media changer does not use medium magazines for any storage element Quantum SuperLoader 3 Software Interface Guide 64 Chapter 2 Media Changer Commands Mode
120. ssignment Page rnrvrvvvvrrvrvvrvrvrrrrvvrvrvrrrrerrrvrrrrerenenee 56 Transport Geometry Parameters Page srnnsnvarrrrererererrrvrrerererrerererenee 58 Device Capabilities Pagers iscisiescisivicsissiiiiessssisiascasendeets toversevensecandeseeotien 60 Extended Device Capabilities Page rrvrnrrvrrvvnrnvrvevevrvererevevevererereesereren 62 Move Medium Command ASh evrvrvovevrrvvvrversveversevevsvseveveversverveversvsrsevevenee 67 Persistent Reserve In Command SEh rnrnrnrrorvrvrvevrvevorversvsrrvreveversvsrvereveee 69 Persistent Reserve Out Command 5Fh nrororvovrverrvnvnvverevnrrerrverrvsvnrvesverenee 78 Position to Element Command 2Bh rrnrnororovovvevavevrvevnrvevsversvreveversvsrsevevere 92 Prevent Allow Medium Removal 1Eh eeorvorrvorrrrrvrverrvnrrerrverrvsvnrversverenee 94 Read Buffer Command 3Ch rervrvororvovrvrvrvvnvevevrvnrveveveversevavevsvsrneversvsrvevevsvanee 95 Combined Header and Data Mode 000b sororvrvovevrvrvervevrvevrvveveversver 96 Data Mode 0010b srnovorverovverversvernvevvennvnensnvrnvnensnersvensvavnevevenesnvrnvnensnene 97 Descriptor Mode 0011D sctsssecccecssiceeicertesn etrisiv ana ia 97 Read Data from Echo Buffer 1010b eserornrrorevrvrvnrvevrvrvrvvevsvrvrevevevenee 98 Echo Buffer Descriptor Mode 1011 soenononrrnrnrrvevnrveravevrvvevrvevevsverser 98 Quantum SuperLoader 3 Software Interface Guide Contents Read Element Status Command B8h rnrnoro
121. sstonbtecsect 15 Command Support Data eosororvovovorrvveverevsvsrvevevevsrseveversvsesrversvevsrsevavevsvsee 19 Load Unload Command 1Bh oororrrvorrrrrrorneverevervevavevrvvevevevsvsrvevevsvrvsevevevense 22 Log Sense Command 4Dhy despres ereere ren ar 23 Supported Pages Log Page 00h rrrrrvrvrnrrvrrrvernvnreveveverereveveverevevevesereren 26 Last n Error Events Page 07h rrrrrvrrrrvnrrvrrvvrvernverevevevererevevevevererevevereren 27 TapeAlert Page 2Eh csicssessstessevescuescscsssssguevesasotecentunssassossunncssnssdaesssexonaes 29 Move Statistics Page 30h orrrvrvrvrrrvrvrvrvvrvrrererrvrvrerrsrererrvrrsrrrrvrrrersrenee 31 Hard Soft Error Statistics Page 31h rnrrrvrvrnrrrrrrrvvrvrvrrrverrvrvrvrverenenne 32 Device Wellness Page 33h rorvrvrvvrnvrvrvvrvrerrvrvvnvrererrersvrvrrsrsrrrvrrrrsverenee 34 Device Status Page SEN cccsvses lt ccssecesscsussuesesesens teccs cutee ds vovessvesevaestanstesos cx 37 Mode Select 6 10 Command 15h 55h wee cesses eeeeeeeeeeeeees 41 Mode Parameter List nrc eniinn e R 43 Mode Sense 6 10 Command 1Ah SAD esnrnrnrrorvevrvevrvernrversvsvreveverenne 48 Mode Sense Data Headers rnrvrvvrvrrvrvvvvrvrvrrvrrrrvrvrerrevrervrrererservrrrersrenee 50 Mode Sens Mode Pages 3 5 s isc cscuisssisiabieisassceosesassstascovessnine sheaseneuouncaee 52 TapeAlert Page VCH iscsesssestscvessysatecess csssesevonsss chazasvebeebsssonebentiesonsvesnaesovess 53 Element Address A
122. st Import Export Identifies the address of the first import export element that is Element Address accessible both by the medium transport device and also by an operator from outside the media changer Number of Import Export Defines the total number of import export elements contained in Elements the media changer First Data Transfer Element Identifies the address of the first data transfer element contained Address in the media changer The first element is 0020h Number of Data Transfer Defines the total number of data transport elements contained in Elements the media changer The SuperLoader 3 contains 1 Transport Geometry The transport geometry parameters page defines whether each medium Parameters Page 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 Quantum SuperLoader 3 Software Interface Guide 58 Figure 40 Transport Geometry Parameters Page Chapter 2 Media Changer Commands Mode Sense 6 10 Command 1Ah 5Ah Bit Byte 7 6 5 3 2 1 0 0 PS 0 RSVD Page Code 1Eh 1 Parameter Length 02h 2 n Transport Geometry Descriptor s Figure 41 Transport Geometry Descriptor
123. svsrrevevenne 73 Persistent Reserve In Read Reservations Descriptor 75 Persistent Reservation Type Codes rsrrrrnrrvrvrrrrrrnrrvrvernrrrrenenne 76 Persistent Reserve Out Command Service Action 82 Persistent Reservation Type Codes rsrrrrnrrvrnrrvrererrvrvrrrrrerenenne 87 Persistent Reserve Out Parameter List 0 0 eee 89 Device Server Interpretation of Service and Scope Value 91 Position to Element Command mueveresrsrvrerrsrsrrrerrrrsrvrrrrererenee 93 Prevent Allow Medium Removal Command Descriptor Block ssonarvvrrvevrvvrrvrrverevrvrvresrversvsvnrven 94 Read Buffer Command Descriptor Block ener 96 Read Butfer Header sc vit ietcoss tesegs otnthiieusit stl taeen teen 97 Quantum SuperLoader 3 Software Interface Guide Tables xi Table 46 Table 47 Table 48 Table 49 Table 50 Table 51 Table 52 Table 53 Table 54 Table 55 Table 56 Table 57 Table 58 Table 59 Table 60 Table 61 Table 62 Table 63 Table 64 Echo Buffer Descriptor ssnrvevrenrrvrrvrravrvrrrevavevrvervvvevsversevavevense 99 Read Element Status Command Descriptor Block 101 Element Status Data sresvrororervrerereerevererereveseserereveveseseserevene 102 Medium Transport Element Descriptor ieee 106 Storage Element Descriptor ssvnvnrrsrserernvevrvrsererrvvsvrvrererrenn 108 Import Export Element Descriptor eee eee teens 109 Data Transfer Element Descriptor srrvrvevavvvrvveva
124. t this unit of media occupied This field is valid only if the SVALID bit is one Primary Volume Tag Information This field contains the bar code label information of the media currently stored in this element This is only included if VOLTAG was set and label information is available In which case the PVOLTAG field shall be set on the Element Status page header Code Set This field is 0 Identifier Type This field is 0 Identifier Length This field contains the length in bytes of the Identifier field Quantum SuperLoader 3 Software Interface Guide 106 Chapter 2 Media Changer Commands Read Element Status Command B8h Storage Element Figure 63 defines the storage element descriptor Descriptor Figure 63 Storage Element Descriptor Bit Byte 7 6 5 4 3 2 1 0 0 1 Element Address 2 Reserved Access Except RSVD Full 3 Reserved 4 Additional Sense Code 5 Additional Sense Code Qualifier 6 8 Reserved 9 SVALID Invert Reserved 10 11 Source Storage Element Address Primary Volume Tag Information 36 bytes field omitted if PVOLTAG 0 1 byte Reserved Code Set 1 byte Reserved Identifier Type 1 byte Reserved 1 byte Identifier Length Quantum SuperLoader 3 Software Interface Guide 107 Table 50 Storage Element Descriptor Import Export Element Descriptor Figure 64 Import Export Element Descriptor Chapt
125. testing the device s data buffer for possible diagnostic data and for checking the integrity of the SCSI bus Figure 54 Read Buffer Command Descriptor Block Bit Byte 7 6 5 4 3 2 1 0 0 Operation Code 3Ch 1 Logical Unit Number Reserved Mode 2 Buffer ID MSB 3 5 Buffer Offset LSB MSB 6 8 Allocation Length LSB 9 Unused Reserved Flag Link Quantum SuperLoader 3 Software Interface Guide 95 Table 44 Read Buffer Chapter 2 Media Changer Commands Read Buffer Command 3Ch Command Descriptor Block Field Name Description Mode The SuperLoader 3 supports the following values within this field If any non supported value is set the drive terminates the command with a CHECK CONDITION status ILLEGAL REQUEST sense key set Mode Description 0000b Combined Header and Data Mode 000b 0010b Data Mode 0010b 0011b Descriptor Mode 0011b 1010b Read Data from Echo Buffer 1010b 1011b Echo Buffer Descriptor Mode 1011b on page 98 Buffer ID This field is ignored in some modes and reserved in others Refer to the specific mode description for more detail Buffer Offset This field is ignored in some modes reserved in others and valid in mode 0010b Refer to the specific mode description for more detail Allocation Length This field specifies the maximum number of bytes that the initiator has allocated for returning data The
126. the drive is unloaded it is checked The movement of the cleaning tape is handled differently depending on the SuperLoader 3 model If the move command that unloaded the drive was initiated from SCSI command complete is returned to the host when the move completes The cleaning tape is then moved from its storage slot to the drive The cleaning is performed and once complete the cleaning tape is returned to its storage location If a SCSI command is received during this cleaning process a not ready check condition is reported SK 2 ASC 30 ASCQ 03 m Chapter 2 A Media Changer Commands E This chapter describes the Media Changer SCSI protocol features implemented by the Media Changer device of the SuperLoader 3 system Note that the sections included in this chapter do not fully reiterate every ANSI SCSI option and or command code specification the sections do describe the supported commands and options Note The original SCSI specification allowed users to specify the LUN Logical Unit Number in bits 7 5 in byte 1 These legacy reserved bits are ignored by the autoloader but will not be rejected if set Overview of Command and Status Processing The SuperLoader 3 supports all mandatory SCSI 3 commands and the Media Changer commands listed in table 1 Quantum SuperLoader 3 Software Interface Guide Chapter 2 Media Changer Commands Overview of Command and Status Processing Table 1 Supported Media Chang
127. tifier Descriptor Bit Byte 7 0 Reserved Code Set 1 Reserved Association Identifier Type Reserved Identifier Length n 3 Identifier Table 4 Identifier Descriptor Field Descriptions Field Name Field Description Code Set Indicates the type of data to be found in the Identifier field A value of 1 indicates binary data A value of 2 indicates ASCII data Association Indicates whether the Identifier is associated with the logical unit or the port Always contains a 0 indicating the Identifier is associated with the logical unit Identifier Type Type of identifier Value Description 1 Concatenation of the Vendor Name Product ID and unit serial number 2 Canonical form of the IEEE Extended Unique Identifier 64 bit EIU 64 3 FC PH Name_Identifier Quantum SuperLoader 3 Software Interface Guide Table 5 Supported Identifiers Command Support Data Figure 9 Command Support Data Page Chapter 2 Media Changer Commands Inquiry Command 12h Field Name Field Description Identifier Identifier data based on the Identifier Type The following table describes the identifiers supported by the SuperLoader 3 Identifier Code Type Set Length Identifier 1 2 38 QUANTUM UHDL 12 ASCII space characters 20h followed by the unit serial number in ASCII 14 bytes 2 1 8
128. tion Key list bytes 8 n Note that this field contains the number of bytes in the reservation key list regardless of the value prescribed by the Allocation Length field in the command s CDB Reservation Keys Each of the Reservation Keys appear as items in a list as bytes 8 through n Each entry reflects an 8 byte reservation key registered with the device server via the PERSISTENT RESERVE OUT Register or Register and Ignore Existing Key service actions Each key can be examined by the application client for correlation with a set of initiators and SCSI ports The following figure and table illustrate and describe the data fields of Read Reservations data parameters Quantum SuperLoader 3 Software Interface Guide 72 Chapter 2 Media Changer Commands Persistent Reserve In Command 5Eh Figure 47 Read Reservations Parameters Bit Byte 7 6 5 4 3 2 1 0 MSB 0 3 Generation LSB MSB 4 7 Additional Length n 7 LSB MSB 8 n Reservation Descriptors LSB Table 35 Read Reservations Parameters Field Name Description Generation The value in this field is a 32 bit counter in the device server that is incremented each time a PERSISTENT RESERVE OUT command requests a Register Clear Pre empt or Pre empt and Clear operation Note that PERSISTENT RESERVE IN commands do not increment the counter nor do PERSISTENT RESERVE OUT commands that perform a Reserve o
129. umber of bytes of data as received in the prior echo buffer mode WRITE BUFFER command from the same initiator If a prior Echo Buffer mode WRITE BUFFER command was not successfully completed the Echo Buffer mode READ BUFFER command will terminate with a CHECK CONDITION status the sense key shall be set to ILLEGAL REQUEST and the additional sense code to COMMAND SEQUENCE ERROR If the data in the Echo Buffer has been overwritten by another initiator the drive will terminate the command with a CHECK CONDITION status the sense key will be set to ABORTED COMMAND and the additional sense code to ECHO BUFFER OVERWRITTEN Echo Buffer Descriptor In this mode a maximum of four bytes of READ BUFFER descriptor Mode 1011b information is returned The device will return the descriptor information for the Echo Buffer The Buffer Offset field is reserved in this mode The allocation length should be set to four or greater The device shall transfer the lesser of the allocation length or four bytes of READ BUFFER descriptor Quantum SuperLoader 3 Software Interface Guide 98 Figure 57 Echo Buffer Chapter 2 Media Changer Commands Read Buffer Command 3Ch Descriptor Bit Byte 7 6 5 4 3 2 1 0 0 Reserved EBOS 1 Reserved 2 Reserved Buffer Capacity 3 Buffer Capacity kr one Field Name Description EBOS Echo Buffer Overwritten Supported Set to 1 to indicate the drive will return the ECHO BUFFER OVERWR
130. vevrvrrvrsevevne 111 Release 10 Command sorerorvevavevrvervevevsvsrrevevevsvsrvrsevsversevevenee 114 Report Device Identifier Command Descriptor Block 117 Report Device Identifier Parameter Data eee 118 Report LUNS Command Descriptor Block 120 Request Sense Dalane nerra eann E A ONA 124 Supported Sense Keys for Request Sense srsrrrrrrnvrvrvrrevnrnn 125 Supported ASC ASCQ Hex for Request Sense 126 Reserve Element 10 Command orernverorvevsvrvrvvevaversvsrvevevsene 131 Send Diagnostic Command Data sorvrvrrvrrvrrvrrrvrrrrvrvrererrrenee 135 Set Device Identifier Command Descriptor Block 138 Set Device Identifier Parameter List 00 0 0 cece 138 Write Buffer Command Data r sosorororesvrererovasesererevaveseserevenene 140 Quantum SuperLoader 3 Software Interface Guide Tables xii D f Preface Q This section outlines the scope and contents of the Quantum SuperLoader 3 Software Interface Guide It contains information about the intended audience purpose organization and document conventions MEET EEE EEE Intended Audience This interface guide is a written for the following audiences Original Equipment Manufacturers OEMs that integrate the Quantum SuperLoader 3 into a system or subsystem e System integrators that are responsible for the SCSI interface End users that operate and troubleshoot the SuperLoader 3 Quantum SuperLoader 3 Soft
131. vrrernrvnvrvernrvevrvrvrevaveversesrsevever 100 Element Status Datarsciccsissssccsicsssscssesessascesvessaiersnsneseteseesnssetovensvososetensye 102 Element Status Pagesos inii akoni iiaei 103 Medium Transport Element Descriptor 105 Storage Element Descriptor se sssissesiserssisresresreesesresstenierresrrrenrereesee 107 Import Export Element Descriptor s sornrnrvrvovevnrnevavevrvernrversverrevevene 108 Data Transfer Element Descriptor esosernrvvnrverrvrrnrvevsversvsrverevsvsssevever 110 Release Element 10 Command 57h errvenovovrvvenrvorrvernrvevsvrvrevevevevsesrvevere 113 Release Unit 6 Command 17h renrrrrrrrrorenrvevrvvevrvevrvervevevsvevreveveversesrveverne 116 Report Device Identifier Command A3h sorrrnrvrvnvrvnrveravevrvernrverrvsrvrsevevne 117 Report LUNS Command AOh errvenrvrrrvrnrverrvrvrvvevsversvervevevsvevsevevevevsesrveverne 120 Request Sense Command 03h rervrvorevororvnvrvrvrververnvsvnrvevavsvrevevsversessvevevssne 122 Reserve Element 10 Command 56h sorvonovovnrvovrvrrrrnrvevavevrvvevaverrvsrvevevsvee 130 Reserve Element 6 Command 16h sorvonovorrrnrnernvevnvvevaverrvervvrerrvsrvevevsve 133 Send Diagnostic Command 1Dh rorvrvrorerererevererereveverererareserererereresererenener 135 Set Device Identifier Command A4h sorenovovrrvenrverrvernrrevsvnrnevevsvevsessvevere 137 Test Unit Ready Command 00h eorerrrvnvnvorererernvenrvrsererevenevrsereveveveve
132. ware Interface Guide xiii Preface EE Purpose This interface guide describes the procedures and issues involved in the development of software applications and utilities to communicate with the Quantum SuperLoader 3 e SCSI interfaces Media Changer Commands 7 Organization This reference manual is organized as follows e Chapter 1 Theory of Operation describes differences between the SuperLoader 3 models media changer elements events and automatic drive cleaning e Chapter 2 Media Changer Commands describes the SCSI protocol features implemented in the media changer Quantum SuperLoader 3 Software Interface Guide xiv Preface A Document Conventions This manual uses the following conventions to designate specific elements Element Convention Example Abbreviations Lowercase except where standard usage Mb megabits requires uppercase MB megabytes Acronyms Uppercase SCSI Binary Notation Number followed by lowercase b 101b Commands Uppercase unless case sensitive FORMAT UNIT Decimal Notation Number followed without suffix 101 Field Initial Caps unless case sensitive Application Data Hexadecimal Notation Number followed by h 101h Sense Key Uppercase unless case sensitive ILLEGAL REQUEST Quantum SuperLoader 3 Software Interface Guide XV Preface Quantum SuperLoader 3 Software Interface Guide xvi Chapter 1 2 m Theory of Operation Q The SuperLoader 3 product is an
133. xclusive any command from any initiator other than the initiator holding the persistent reservation that attempts a transfer to the target results in a reservation conflict ADDITIONAL RESERVATIONS Restricted any PERSISTENT RESERVE OUT command with the Reserve service action from any initiator other than the initiator holding the persistent reservation results in a reservation conflict The initiator that holds the persistent reservation can reserve the logical unit extents or elements as long as the persistent reservations do not conflict with any reservations already known to the device server 4h Obsolete Quantum SuperLoader 3 Software Interface Guide 76 Chapter 2 Media Changer Commands Persistent Reserve In Command 5Eh Code Name Description 5h WRITE READS Shared any application client on any initiator may execute Exclusive commands that perform transfers from the target to the initiator Registrants WRITES Exclusive any command from an initiator that has not Only previously performed a Register service action with the device server that attempts a transfer to the target results in a reservation conflict ADDITIONAL RESERVATIONS Allowed any initiator may reserve the logical unit extents or elements as long as the persistent reservations to not conflict with any reservations already known to the device server 6h Exclusive READS Exclusive any command from an initiator that has not Access previ

Quantum superloader 3 User's Guide

Contents

Download Pdf Manuals

Related Search

Related Contents