Software Interface Guide Software Interface Guide Software Interface Guide TM TM Quantum SuperLoader 3 SuperLoader 3 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.
Contents Preface Chapter 1 xiii Theory of Operation 1 SuperLoader 3..................................................................................................... 2 Medium Changer Elements .............................................................................. 2 Medium Transport Element ...................................................................... 3 Data Transfer Element................................................................................ 3 Storage Elements............
Contents Chapter 2 Media Changer Commands 7 Overview of Command and Status Processing .............................................7 Media Changer Command Descriptions ........................................................9 Initialize Element Status Command (07h) ....................................................10 Inquiry Command (12h)..................................................................................11 Standard Inquiry Data Page ......................................................
Contents Read Element Status Command (B8h) ........................................................100 Element Status Data................................................................................102 Element Status Page................................................................................103 Medium Transport Element Descriptor...............................................105 Storage Element Descriptor ...................................................................
Figures Figure 1 Initialize Element Status Command ........................................ 10 Figure 2 Inquiry Command ...................................................................... 11 Figure 3 Inquiry Command ...................................................................... 12 Figure 4 Standard Inquiry Data ............................................................... 13 Figure 5 Supported Vital Product Data ..................................................
Figures Figure 19 Device Wellness Log Sense Header .........................................35 Figure 20 Device Wellness Log Sense (0000h-000Fh)..............................35 Figure 21 Log Parameters for Device Wellness Log Sense.....................36 Figure 22 Device Status Log Sense Header ..............................................37 Figure 23 Parameters for Device Status Log Sense Page ........................38 Figure 24 Device Status Log Sense Page (0001h) ...........................
Figures Figure 49 Persistent Reserve Out Descriptor ...........................................79 Figure 50 Persistent Reserve Out Command ...........................................79 Figure 51 Persistent Reserve Out Parameter List ....................................88 Figure 52 Position to Element Descriptor .................................................92 Figure 53 Prevent/Allow Medium Removal ...........................................94 Figure 54 Read Buffer Command Descriptor Block....
Figures Figure 79 Send Diagnostic Descriptor.....................................................135 Figure 80 Set Device Identifier Descriptor..............................................137 Figure 81 Set Device Identifier Parameter List ......................................138 Figure 82 Test Unit Ready Descriptor .....................................................139 Figure 83 Write Buffer Descriptor............................................................
Tables Table 1 Supported Media Changer Commands .................................... 8 Table 2 Standard Inquiry Data ............................................................... 14 Table 3 Unit Serial Number Page Field Descriptions ......................... 17 Table 4 Identifier Descriptor Field Descriptions.................................. 18 Table 5 Supported Identifiers ................................................................. 19 Table 6 Command Support Data Page..................
Tables Table 18 Device Status Log Sense (0001h)...............................................40 Table 19 Mode Select (6)/(10) Command Descriptor ...........................42 Table 20 Mode Select Parameter List .......................................................43 Table 21 Mode Select Parameter Header ................................................45 Table 22 Mode Select Parameter Block....................................................46 Table 23 Mode Select Page Descriptor .............
Tables Table 46 Echo Buffer Descriptor...............................................................99 Table 47 Read Element Status Command Descriptor Block ..............101 Table 48 Element Status Data .................................................................102 Table 49 Medium Transport Element Descriptor ................................106 Table 50 Storage Element Descriptor.....................................................108 Table 51 Import / Export Element Descriptor .........
Preface 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.
Preface 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. • SCSI interfaces • Media Changer Commands Organization This reference manual is organized as follows: • Chapter 1, Theory of Operation describes differences between the SuperLoader 3 models, media changer elements, events, and automatic drive cleaning.
Preface Document Conventions This manual uses the following conventions to designate specific elements: Element Convention Example Abbreviations Lowercase, except where standard usage requires uppercase Mb (megabits) 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 No
Preface Quantum SuperLoader 3 Software Interface Guide xvi
Chapter 1 1 Theory of Operation The SuperLoader 3 product is an 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.
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.
Chapter 1 Theory of Operation Events Medium Transport Element 1 Data Transfer Element 1 Storage Elements 1 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 removable magazines.
Chapter 1 Theory of Operation Events • If initialization is successful, it generates a not-ready to ready transition (SK=6 ASC=28 ASCQ=00), otherwise, failure sense data is set accordingly. SuperLoader 3 Offline 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.
Chapter 1 Theory of Operation Automatic Drive Cleaning Automatic Drive Cleaning There are two modes of automatic drive cleaning support available: • 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.
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.
Chapter 2 2 Media Changer Commands 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.
Chapter 2 Media Changer Commands Overview of Command and Status Processing Table 1 Supported Media Changer 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 / 5Ah “Move Medium Command (A5h)” on page 67 A5h “Persistent Res
Chapter 2 Media Changer 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.
Chapter 2 Media Changer Commands Initialize Element Status Command (07h) Initialize Element Status Command (07h) 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.
Chapter 2 Media Changer Commands Inquiry Command (12h) Inquiry Command (12h) 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.
Chapter 2 Media Changer Commands Inquiry Command (12h) 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.
Chapter 2 Media Changer Commands Inquiry Command (12h) Figure 4 Standard Inquiry Data Bit Byte 7 5 4 3 Peripheral Qualifier 0 1 6 1 0 Peripheral Device Type RMB Reserved Version 2 3 2 AERC Obsolete NormACA HiSup Response Data Format Additional Length (n-4) 4 5 SCCS Reserved 6 BQue EncServ Reserved MultiP MChngr Obsolete Obsolete Add16 7 RelAdr Obsolete Wbus16 Sync Linked Obsolete CmdQue Reserved 8-15 Vendor Identification (QUANTUM) 16-31 Product Identification
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 fields are supported.
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 not support command queueing.
Chapter 2 Media Changer Commands Inquiry Command (12h) 2 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.
Chapter 2 Media Changer Commands Inquiry Command (12h) Bit Byte 7 6 5 4 3 2 1 0 Serial Number 4 - 17 Table 3 Unit Serial Number Page Field Descriptions Field Name Description Serial Number The serial number given is the serial number of the media changer typically starting with “PM” indicating the site of manufacture.
Chapter 2 Media Changer Commands Inquiry Command (12h) There are three different Identification Descriptors returned, in numerical order of the Identifier Type.
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. Table 5 Supported Identifiers Command Support Data 2 Identifier Type Code Set Length Identifier 1 2 38 QUANTUM UHDL, 12 ASCII space characters (20h), followed by the unit serial number in ASCII (14 bytes).
Chapter 2 Media Changer Commands Inquiry Command (12h) Bit Byte 7 2 ISO Version 6 5 4 3 ECMA Version 2 1 0 ANSI - Approved Version Reserved 3-4 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. ISO-Version Value Description 000b Data about the requested SCSI operation code is not currently available.
Chapter 2 Media Changer Commands Inquiry Command (12h) Field Name Description ECMA-Version Must be 0. ANSI-Approved Version 2. 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.
Chapter 2 Media Changer Commands Load Unload Command (1Bh) Load Unload Command (1Bh) 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.
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.
Chapter 2 Media Changer Commands Log Sense Command (4Dh) Table 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.
Chapter 2 Media Changer Commands Log Sense Command (4Dh) Field Name Parameter Pointer 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 The Parameter Pointer field allows the host to specify at which parameter within a log page the requested data should begin.
Chapter 2 Media Changer Commands Log Sense Command (4Dh) Supported Pages Log Page (00h) 2 When page 00h is requested, the 4-byte page header is returned, followed by the pages supported in ascending order, one byte for each.
Chapter 2 Media Changer Commands Log Sense Command (4Dh) Last n Error Events Page (07h) 2 This page returns the ASCII text for the hard error event log. This page 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.
Chapter 2 Media Changer Commands Log Sense Command (4Dh) Figure 14 Format for Last n Error Events Log Sense Bit Byte 7 6 5 4 3 2 1 0 (MSB) Parameter Code 0 -1 (LSB) 2 DU DS TSD ETC TMC Rsv’d LP Parameter Length 3 (MSB) ASCII String for Event n 4-n (LSB) Table 10 Parameters Last n Error Events Log Sense Field Name Description Parameter Code The Parameter Code value represents the relative time at which the error occurred.
Chapter 2 Media Changer Commands Log Sense Command (4Dh) TapeAlert Page (2Eh) 2 Field Name Description ASCII Strong for Event n The text includes the time of the event, the error 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.
Chapter 2 Media Changer Commands Log Sense Command (4Dh) Figure 16 TapeAlert Page Log Parameters Format Bit Byte 7 6 5 4 3 2 1 0 MSB 5n – 1 to 5n 5n + 1 Parameter Code (n) (LSB) 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.
Chapter 2 Media Changer Commands Log Sense Command (4Dh) Move Statistics Page (30h) 2 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.
Chapter 2 Media Changer Commands Log Sense Command (4Dh) Bit Byte 7 6 5 4 3 2 1 0 (MSB) Magazine Moves 20-23 (LSB) (MSB) Magazine Loads 24-27 (LSB) Table 13 Move Statistics Hard/Soft Error Statistics Page (31h) 2 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.
Chapter 2 Media Changer Commands Log Sense Command (4Dh) Figure 18 Hard/Soft Move Error Statistics Format Bit Byte 0 7 6 5 4 Reserved 3 2 1 0 Page Code (31h) Reserved 1 (MSB) Page Length (22h) 2-3 (LSB) (MSB) Servo Hard Errors 4-5 (LSB) (MSB) Drive Soft Error 6-9 (LSB) (MSB) Left Magazine Soft Error 10-13 (LSB) (MSB) Right Magazine Soft Error 14-17 (LSB) (MSB) Mail Slot Soft Error 18-21 (LSB) (MSB) 22-25 Rotation Recovery Actions (LSB) Quantum SuperLoader 3 Software Interface Gui
Chapter 2 Media Changer Commands Log Sense Command (4Dh) Bit Byte 7 6 5 4 3 2 1 0 (MSB) Translation Recovery Actions 26-29 (LSB) (MSB) Left Magazine Recovery Actions 30-33 (LSB) (MSB) Right Magazine Recovery Actions 34-37 (LSB) Table 14 Hard/Soft Error Device Wellness Page (33h) 2 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.
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 Reserved 0 3 2 1 0 Page Code (33h) Reserved 1 (MSB) Page Length 2-3 (LSB) Table 15 Device Wellness 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.
Chapter 2 Media Changer Commands Log Sense Command (4Dh) Bit Byte 2 7 6 5 4 DU DS TSD ETC 3 2 TMC 1 0 Rsv’d LP Parameter Length (0Ch) 3 (MSB) Time Stamp 4-7 (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 Error Information Figure 21 Log Parameters for Device Wellness Log Sense Field Name Description Parameter Code Parameter Codes 0000h through 000Fh are supp
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 Length The number of bytes to follow (0Ch). Time Stamp The Time Stamp is represented as number of power cycles and total power on hours.
Chapter 2 Media Changer Commands Log Sense Command (4Dh) Table 16 Device Status 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 number of bytes available and depends on the parameters requested.
Chapter 2 Media Changer Commands Log Sense Command (4Dh) Table 17 Parameters for 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 0h. 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.
Chapter 2 Media Changer Commands Log Sense Command (4Dh) Table 18 Device Status Log Sense (0001h) Field Name Description Temperature These two bits indicate the temperature of the device. This field follows the following format: Status Bit 3 Bit 2 Description 0 0 Not supported 0 1 OK 1 0 Warning: Safe temperature exceeded. 1 1 Maximum temperature exceeded. These two bits indicate the overall condition of the device.
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.
Chapter 2 Media Changer Commands Mode Select (6) / (10) Command (15h / 55h) Bit Byte 7 6 5 4 2 1 0 Flag Link 1 0 Reserved 2–3 Parameter List Length 4 5 3 Unused (00) Reserved Figure 26 Mode Select (10) Command Descriptor Bit Byte 7 6 5 3 Logical Unit Number PF Reserved 2–6 Reserved 7-8 Parameter List Length 9 2 Operation Code (55h) 0 1 4 Unused (00) Table 19 Mode Select (6)/(10) Command Descriptor Reserved SP (0) Flag Link Field Name Description PF Page Format.
Chapter 2 Media Changer Commands Mode Select (6) / (10) Command (15h / 55h) Mode Parameter List The following figure shows the format of the Mode Parameter List that is passed by the initiator to the media changer during the command’s DATA OUT phase.
Chapter 2 Media Changer Commands Mode Select (6) / (10) Command (15h / 55h) Field Name Description Mode Parameter Block Descriptor 8 bytes in length; not applicable to a media changer device. Page(s) The Page Code(s) of the pages that are a part of this MODE SELECT command. 2 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.
Chapter 2 Media Changer Commands Mode Select (6) / (10) Command (15h / 55h) Bit Byte 7 6 5 4 3 3 Reserved 4-5 Reserved 6-7 Block Descriptor Length Table 21 Mode Select Parameter Header 2 1 0 Field Name Description Block Descriptor Length This field specifies the length in bytes of all the block descriptors. Since the media changer only allows one block descriptor, the value must be either 0 or 8.
Chapter 2 Media Changer Commands Mode Select (6) / (10) Command (15h / 55h) Figure 31 Mode Select Parameter Bit Byte 7 6 5 4 3 2 1 0 Reserved 0 (MSB) Number of Blocks 1-3 (LSB) Reserved 4 (MSB) Block Length 5-7 (LSB) Table 22 Mode Select Parameter Block Field Name Description Number of Blocks This field is sent as 0. It is not applicable to media changer devices. Block Length This field is sent as 0. It is not applicable to media changer devices.
Chapter 2 Media Changer Commands Mode Select (6) / (10) Command (15h / 55h) Figure 32 Mode Select Page Descriptor Bit Byte 0 7 6 PS (0) 0 5 Table 23 Mode Select Page Descriptor 3 2 1 0 Page Code Additional Page Length 1 2-n 4 Page-Defined or Vendor Specific Parameter List Field Name Description PS Parameters Savable. For the MODE SELECT (6) (10) commands, this field is reserved (0). Additional Page Length Indicates number of bytes in that page (not including bytes 0 and 1).
Chapter 2 Media Changer Commands Mode Sense (6) / (10) Command (1Ah/ 5Ah) Mode Sense (6) / (10) Command (1Ah/ 5Ah) The MODE SENSE command allows the media changer to report its current or changeable configuration parameters to the host. It is a complementary command to MODE SELECT. The command descriptor block for the 6-byte MODE SENSE (1Ah) is shown below. An illustration of the command descriptor block for the 10byte MODE SENSE (5Ah) follows on the next page.
Chapter 2 Media Changer Commands Mode Sense (6) / (10) Command (1Ah/ 5Ah) Figure 34 Mode Sense (10) Command Descriptor Block Bit Byte 7 6 5 4 3 2 1 0 Operation Code (5Ah) 0 Logical Unit Number 1 Rsv’d DBD PC 2 Reserved Page Code 3 SubPage 4–6 Reserved (MSB) Allocation Length 7-8 (LSB) 9 Unused Reserved Flag Link Table 24 Mode Sense Command Descriptor Block Field Name Description DBD Disable Block Descriptors. This field is ignored.
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.
Chapter 2 Media Changer Commands Mode Sense (6) / (10) Command (1Ah/ 5Ah) Figure 35 Mode Sense (6) Data Header Bit Byte 7 6 5 4 3 0 Mode Sense Data Length 1 Reserved 2 Reserved 3 Block Descriptor Length (0) 2 1 0 2 1 0 Figure 36 Mode Sense (10) Data Header Bit Byte 7 6 5 4 3 (MSB) Mode Sense Data Length 0-1 (LSB) 2 Reserved 3 Reserved 4-5 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 (1Ah/ 5Ah) Table 25 Mode Sense Data Header Mode Sense Mode Pages2 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.
Chapter 2 Media Changer Commands Mode Sense (6) / (10) Command (1Ah/ 5Ah) TapeAlert Page (1Ch) 2 Field Name Description Additional Page Length This field indicates the number of bytes in the page. 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.
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.
Chapter 2 Media Changer Commands Mode Sense (6) / (10) Command (1Ah/ 5Ah) Field Name Description 03h Conditionally Generate Recovered Error. The device server reports information 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).
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.
Chapter 2 Media Changer Commands Mode Sense (6) / (10) Command (1Ah/ 5Ah) Bit Byte 7 6 5 4 3 2 1 0 (MSB) Number of Medium Transport Elements 4-5 (LSB) (MSB) First Storage Element Address 6-7 (LSB) (MSB) Number of Storage Elements 8-9 (LSB) (MSB) First Import/Export Element Address 10-11 (LSB) (MSB) Number of Import/Export Address 12-13 (LSB) (MSB) First Data Transfer Element Address 14-15 (LSB) (MSB) 16-17 Number of Data Transfer Elements (LSB) 18-19 Quantum SuperLoader 3 Software I
Chapter 2 Media Changer Commands Mode Sense (6) / (10) Command (1Ah/ 5Ah) Table 28 Element Address Assignment Page Field Name Description First Medium Transport Element Address Identifies the address of the first medium transport element contained in the media changer. The SuperLoader 3 uses the default address of 0. Number of Medium Transport Elements Defines the total number of medium transport elements contained in the media changer. The SuperLoader 3 contains 1.
Chapter 2 Media Changer Commands Mode Sense (6) / (10) Command (1Ah/ 5Ah) Figure 40 Transport Geometry Parameters Page Bit Byte 0 7 6 PS (0) RSVD 5 4 3 2 1 0 Page Code (1Eh) Parameter Length (02h) 1 Transport Geometry Descriptor(s) 2-n The geometry of each medium transport element is defined using a twobyte field as defined in figure 41.
Chapter 2 Media Changer Commands Mode Sense (6) / (10) Command (1Ah/ 5Ah) Device Capabilities Page 2 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.
Chapter 2 Media Changer Commands Mode Sense (6) / (10) Command (1Ah/ 5Ah) Bit Byte 7 6 5 4 3 2 1 0 I/E<>DT I/E<>I/E I/E<>ST I/E<>MT (0) (0) (0) (0) DT<>DT DT<>I/E DT<>ST DT<>MT 15 (0) (0) (0) (0) 16-19 Reserved Reserved 14 Reserved 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 elemen
Chapter 2 Media Changer Commands Mode Sense (6) / (10) Command (1Ah/ 5Ah) Extended Device Capabilities Page 2 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.
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. A 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.
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.
Chapter 2 Media Changer Commands Mode 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.
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.
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.
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 REQUEST and the additional sense code Medium Destination Element Full.
Chapter 2 Media Changer Commands Persistent Reserve In Command (5Eh) Persistent Reserve In Command (5Eh) 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.
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.
Chapter 2 Media Changer Commands Persistent Reserve In Command (5Eh) Field Name Description Allocation Length This field indicates how much space has been reserved for the returned 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.
Chapter 2 Media Changer Commands Persistent Reserve In Command (5Eh) Bit Byte 7 6 5 4 3 2 1 0 (MSB) n–7 to n Last Reservation Key (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.
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) Generation 0-3 (LSB) (MSB) Additional Length (n – 7) 4-7 (LSB) (MSB) Reservation Descriptors 8-n (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-emp
Chapter 2 Media Changer Commands Persistent Reserve In Command (5Eh) Field Name Description Additional Length This field contains the count of the number of bytes of Reservation descriptors (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.
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 Address Used to indicate the element that is the reservation affects when a reservation is for an element rather than a logical unit.
Chapter 2 Media Changer Commands Persistent Reserve In Command (5Eh) Table 37 Persistent Reservation Type Codes Code Name 0h Obsolete 1h WRITE Exclusive Description READS: Shared; any application client on any initiator may execute commands that perform transfers from the target to the initiator.
Chapter 2 Media Changer Commands Persistent Reserve In Command (5Eh) Code Name Description 5h WRITE Exclusive, READS: Shared; any application client on any initiator may execute Registrants Only WRITES: Exclusive; any command from an initiator that has not previously performed a Register service action with the device commands that perform transfers from the target to the initiator.
Chapter 2 Media Changer Commands Persistent Reserve Out Command (5Fh) 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.
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 Operation Code (5Fh) 0 Reserved 1 Service Action Scope 2 Type Reserved 3-6 (MSB) Parameter List Length (18h) 7–8 (LSB) 9 Unused Reserved Flag Link Figure 50 Persistent Reserve Out Command Field Name Description Service Action Service actions that require information about persistent reservation and registrations may require enabling of nonvo
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-empt and Clear Pre-empt persistent reservations from another initiator and clear the task set for the pre-empted initiator 06h Register and Ignore Existing Key Register a reservation key with the device server. Existing reservation key is ignored.
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.
Chapter 2 Media Changer Commands Persistent Reserve Out Command (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.
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.
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 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.
Chapter 2 Media Changer Commands Persistent Reserve Out Command (5Fh) Code Name Description 04h (cont) Pre-empt 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.
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 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.
Chapter 2 Media Changer Commands Persistent Reserve Out Command (5Fh) Code Name Description 06h Register and Ignore Keys This service action functions the same as the Register (00h) action except the reservation key in the parameter list is ignored and treated as if it matched the current registration, if one exists for the initiator.
Chapter 2 Media Changer Commands Persistent Reserve Out Command (5Fh) Code Name Description 5h WRITE Exclusive, READS: Shared; any application client on any initiator may execute Registrants Only commands that perform transfers from the storage medium to the initiator. 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.
Chapter 2 Media Changer Commands Persistent Reserve Out Command (5Fh) Bit Byte 7 6 5 4 3 2 1 0 (MSB) Service Action Reservation Key 8-15 (LSB) (MSB) Scope-Specific Address 16-19 (LSB) Reserved 20 21 Reserved 22-23 Obsolete APTPL Table 40 Persistent Reserve Out Parameter List Field Name Description Reservation Key This field contains an 8-byte token that is provided by the application client to the device server to identify which initiator is the source of the PERSISTENT RESERVE OUT c
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.
Chapter 2 Media Changer Commands Persistent Reserve Out Command (5Fh) Table 41 Device Server Interpretation of Service and Scope Value Parameters Service Action Allowed Scope Type Service Action 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 and Clear LU Valid Valid Valid Register and Ignore Existing Key Ignored
Chapter 2 Media Changer Commands Position to Element Command (2Bh) 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.
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.
Chapter 2 Media Changer Commands Prevent/Allow Medium Removal (1Eh) Prevent/Allow Medium Removal (1Eh) 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.
Chapter 2 Media Changer Commands Read Buffer Command (3Ch) Read Buffer Command (3Ch) The READ BUFFER command is used in conjunction with WRITE BUFFER as a diagnostic function for testing the device’s data buffer for possible diagnostic data and for checking the integrity of the SCSI bus.
Chapter 2 Media Changer Commands Read Buffer Command (3Ch) Table 44 Read Buffer Command Descriptor Block Field Name Description Mode The SuperLoader 3 supports the following values within this field.
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.
Chapter 2 Media Changer Commands Read Buffer Command (3Ch) Figure 56 Read Buffer Descriptor Bit Byte 7 6 5 4 3 2 1 0 Offset Boundaries (0h) 0 (MSB) Buffer Capacity 1-3 (LSB) Read Data from Echo Buffer (1010b) 2 In this mode the device transfers data to the application client from the 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.
Chapter 2 Media Changer Commands Read Buffer Command (3Ch) Figure 57 Echo Buffer Descriptor Bit Byte 7 6 5 4 1 0 EBOS Reserved 1 Reserved Buffer Capacity Buffer Capacity 3 Table 46 Echo Buffer Descriptor 2 Reserved 0 2 3 Field Name Description EBOS Echo Buffer Overwritten Supported. Set to 1 to indicate the drive will return the ECHO BUFFER OVERWRITTEN additional sense code if the data being read from the Echo Buffer is not the data previously written by the same initiator.
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.
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.
Chapter 2 Media Changer Commands Read Element Status Command (B8h) Element Status Data 2 The data returned by the READ ELEMENT STATUS command is defined in figure 59 and Element Status Page through Data Transfer Element Descriptor. Element status data consists of an eight-byte header, followed by zero or more element status pages.
Chapter 2 Media Changer Commands Read Element Status Command (B8h) Element Status Page Field Name Description Number Of Elements Available Indicates the number of elements meeting the request in the command descriptor block. The status for these elements is returned if sufficient Allocation Length was specified. Byte Count Of Report Available Indicates the number of bytes of element status page data available for all elements meeting the request in the command descriptor block.
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) Figure 61 Data Field Name Description Element Type Code Indicates the element type (see table 47) reported by 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.
Chapter 2 Media Changer Commands Read Element Status Command (B8h) Medium Transport Element Descriptor Figure 62 defines the medium transport element descriptor.
Chapter 2 Media Changer Commands Read Element Status Command (B8h) Table 49 Medium Transport Element Descriptor Field 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.
Chapter 2 Media Changer Commands Read Element Status Command (B8h) Figure 63 defines the storage element descriptor.
Chapter 2 Media Changer Commands Read Element Status Command (B8h) Table 50 Storage Element Descriptor 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.
Chapter 2 Media Changer Commands Read Element Status Command (B8h) Bit Byte 7 6 5 4 2 1 0 Reserved 6-8 9 3 SVALID 10-11 Invert Reserved Source Storage Element Address ••• Primary Volume Tag Information (filed omitted if PVOLTAG=0) (36 bytes) ••• (1 byte) Reserved Code Set (1 byte) Reserved Identifier Type (1 byte) Reserved (1 byte) Identifier Length Table 51 Import / Export Element Descriptor Field Name Description INENAB This field is sent as 1 to indicate that the import/ ex
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.
Chapter 2 Media Changer Commands Read Element Status Command (B8h) Bit Byte 7 10-11 6 5 4 3 2 1 0 Source Storage Element Address ••• (36 bytes) Primary Volume Tag Information (field omitted if PVOLTAG=0) ••• (1 byte) Reserved Code Set (1 byte) Reserved Identifier Type (1 byte) Reserved (1 byte) Identifier Length ••• (16 bytes) Table 52 Data Transfer Element Descriptor Drive Serial Number (field omitted if Identifier Length = 0) Field Name Description Access When set to 1 it ind
Chapter 2 Media Changer Commands Read Element Status Command (B8h) Field Name Description Logical Unit Number If it is valid, it provides the logical unit number within the SCSI bus device of the primary device served by the media changer at this element address. This field is always 0. SCSI BUS Address If valid, it provides the SCSI address of the primary device served by the media changer at this element address.
Chapter 2 Media Changer Commands Release Element (10) Command (57h) 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 not currently valid.
Chapter 2 Media Changer Commands Release Element (10) Command (57h) Table 53 Release (10) Command 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.
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.
Chapter 2 Media Changer Commands Release Unit (6) Command (17h) Release Unit (6) Command (17h) 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.
Chapter 2 Media Changer Commands Report Device Identifier Command (A3h) Report Device Identifier Command (A3h) The REPORT DEVICE IDENTIFIER command requests that the device server send device identification information to the applicable client.
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.
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.
Chapter 2 Media Changer Commands Report LUNS Command (A0h) Report LUNS Command (A0h) 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.
Chapter 2 Media Changer Commands Report LUNS Command (A0h) Figure 72 LUN Reporting Parameter List Bit Byte 7 6 5 4 3 2 1 0 (MSB) LUN List Length (n – 7) 0-3 (LSB) Reserved 4-7 (MSB) LUN (first LUN) 8 - 15 (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.
Chapter 2 Media Changer Commands Request Sense Command (03h) Request Sense Command (03h) The REQUEST SENSE command causes the media changer to transfer detailed sense data to the initiator.
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.
Chapter 2 Media Changer Commands Request Sense Command (03h) Table 57 Request Sense Data Field Description Valid When set to 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.
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.
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. The following table provides the additional sense codes (ASCs) and additional sense code qualifiers (ASCQs) that may be reported. Additional information, explanations, or suggestions for action are included in some of the descriptions.
Chapter 2 Media Changer Commands Request Sense Command (03h) Sense Key 04h HARDWARE ERROR 05h ILLEGAL REQUEST ASC ASCQ Description 04 07 Unit Not Ready, Operation in Progress 44 00 Internal Target Failure 08 00 LUN Communication Failure 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 1A 00 Parameter List Le
Chapter 2 Media Changer Commands Request Sense Command (03h) Sense Key 06h UNIT ATTENTION 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 0E Media Source Element Empty 3B 11 Magazine Not Accessible 3B 12 Magazine Removed 53 02 Media
Chapter 2 Media Changer Commands Request Sense Command (03h) Sense Key 0Bh COMMAND ABORTED ASC ASCQ Description 2A 05 Registrations Preempted 3B 12 Magazine Removed 3B 13 Magazine Inserted 3F 01 Microcode has been Changed 3F 05 Device Identifier Changed 08 00 Command Aborted - LUN Communication Failure 08 01 Command Aborted - LUN Communication Time-out 3F 00 Operating Conditions have Changed 3F 0F Echo Buffer Overwritten 43 00 Message Error 44 80 Unexpected Selection In
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) 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.
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.
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) 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.
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.
Chapter 2 Media Changer Commands Send Diagnostic Command (1Dh) Send Diagnostic Command (1Dh) The SEND DIAGNOSTIC command directs the media changer to perform its self-diagnostic tests. Figure 79 Send Diagnostic Descriptor Bit Byte 7 6 5 3 2 1 0 Selftst DevOfl UnitOfl Operation Code (1Dh) 0 1 4 Logical Unit Number PF (0) Reserved Reserved 2 (MSB) Parameter List Length 3-4 (LSB) 5 Unused Table 61 Send Diagnostic Command Data Reserved Flag Link Field Description PF Page Format.
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 List Length Not supported; must be 0.
Chapter 2 Media Changer Commands Set Device Identifier Command (A4h) 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 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.
Chapter 2 Media Changer Commands Set Device Identifier Command (A4h) Table 62 Set Device Identifier Command Descriptor Block Field Description Service Action Must be 06h. Any other value will return Check Condition, Illegal Request. Parameter List Length Specifies the length in bytes of the Identifier that shall be transferred from the application client to the device server. The maximum value for this field shall be 64 bytes.
Chapter 2 Media Changer Commands Test Unit Ready Command (00h) Test Unit Ready Command (00h) 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.
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).
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 supported. If the Buffer ID field is a value other than 0, the command is rejected.
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: Download Microcode and Save Mode (0101b) 2 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 subsystem may become unusable and the unit must be replaced.
Index Log Sense command A Request Sense 122 Reserve Element 130, 133 media changer 23 Send Diagnostic 135 ASC/ASCQ codes Request Sense (media changer) 126 Test Unit Ready 139 Write Buffer 140 M Mode Select command media changer 41 Media changer commands Initialize Element Status 10 C Mode Sense command media changer 48 Inquiry 11 Commands media changer 7 Log Sense 23 Move Medium command 67 Mode Select 41 Mode Sense 48 Move Medium 67 P overview 7 I Persistent Reserve In 69 Persistent Re
Index media changer 139 R Read Buffer command 95 Read Element Status command 100 Release Element command 113 Release Unit command media changer 116 W Write Buffer command 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 Sens
