Quantum superloader 3 User's Guide
Quantum SuperLoader
TM
3
81-81300-03 A01
Quantum SuperLoader
TM
3
SuperLoader
3
Software Interface Guide Software Interface Guide Software Interface Guide
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.
Contents
Preface xiii
Chapter 1 Theory of Operation 1
SuperLoader 3.....................................................................................................2
Medium Changer Elements..............................................................................2
Medium Transport Element ......................................................................3
Data Transfer Element................................................................................3
Storage Elements.........................................................................................3
Events...................................................................................................................3
Power Cycle .................................................................................................3
SuperLoader 3 Offline ................................................................................4
Magazine Insertion/Removal...................................................................4
Maximum Temperature Exceeded...........................................................4
Automatic Drive Cleaning................................................................................5
Element Status Information.......................................................................6
Automatic Cleaning Operation.................................................................6
Quantum SuperLoader 3 Software Interface Guide iii
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 ....................................................................12
Vital Product Data Page ...........................................................................15
Command Support Data ..........................................................................19
Load Unload Command (1Bh) .......................................................................22
Log Sense Command (4Dh) ............................................................................23
Supported Pages Log Page (00h) ............................................................26
Last n Error Events Page (07h)................................................................27
TapeAlert Page (2Eh)................................................................................29
Move Statistics Page (30h) .......................................................................31
Hard/Soft Error Statistics Page (31h).....................................................32
Device Wellness Page (33h) .....................................................................34
Device Status Page (3Eh)..........................................................................37
Mode Select (6) / (10) Command (15h / 55h)..............................................41
Mode Parameter List ................................................................................43
Mode Sense (6) / (10) Command (1Ah/ 5Ah).............................................48
Mode Sense Data Headers .......................................................................50
Mode Sense Mode Pages..........................................................................52
TapeAlert Page (1Ch) ...............................................................................53
Element Address Assignment Page .......................................................56
Transport Geometry Parameters Page...................................................58
Device Capabilities Page..........................................................................60
Extended Device Capabilities Page ........................................................62
Move Medium Command (A5h)....................................................................67
Persistent Reserve In Command (5Eh)..........................................................69
Persistent Reserve Out Command (5Fh).......................................................78
Position to Element Command (2Bh) ............................................................92
Prevent/Allow Medium Removal (1Eh) ......................................................94
Read Buffer Command (3Ch) .........................................................................95
Combined Header and Data Mode (000b) ............................................96
Data Mode (0010b) ....................................................................................97
Descriptor Mode (0011b)..........................................................................97
Read Data from Echo Buffer (1010b)......................................................98
Echo Buffer Descriptor Mode (1011b) ....................................................98
Contents
Quantum SuperLoader 3 Software Interface Guide iv
Read Element Status Command (B8h) ........................................................100
Element Status Data................................................................................102
Element Status Page................................................................................103
Medium Transport Element Descriptor...............................................105
Storage Element Descriptor...................................................................107
Import/Export Element Descriptor......................................................108
Data Transfer Element Descriptor........................................................110
Release Element (10) Command (57h) ........................................................113
Release Unit (6) Command (17h) .................................................................116
Report Device Identifier Command (A3h) .................................................117
Report LUNS Command (A0h)....................................................................120
Request Sense Command (03h)....................................................................122
Reserve Element (10) Command (56h)........................................................130
Reserve Element (6) Command (16h)..........................................................133
Send Diagnostic Command (1Dh) ...............................................................135
Set Device Identifier Command (A4h)........................................................137
Test Unit Ready Command (00h) ................................................................139
Write Buffer Command (3Bh).......................................................................140
Write Combined Header and Data Mode (0000b)..............................141
Write Data Mode (0010b) .......................................................................141
Download Microcode Mode (0100b)....................................................141
Download Microcode and Save Mode (0101b)...................................142
Write Data to Echo Buffer (1010b) ........................................................142
Contents
Quantum SuperLoader 3 Software Interface Guide v
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 ..................................................16
Figure 6 Unit Serial Number Page (80h).................................................16
Figure 7 Device Identification Page (83h)...............................................17
Figure 8 Identifier Descriptor...................................................................18
Figure 9 Command Support Data Page..................................................19
Figure 10 Load Unload Command Descriptor Block .............................22
Figure 11 LOG SENSE Command Descriptor Block...............................23
Figure 12 Supported Pages Page................................................................ 26
Figure 13 Last n Error Events Log Sense Header ....................................27
Figure 14 Format for Last n Error Events Log Sense ..............................28
Figure 15 TapeAlert Log Sense Header Format ......................................29
Figure 16 TapeAlert Page Log Parameters Format.................................30
Figure 17 Move Statistics Format...............................................................31
Figure 18 Hard/Soft Move Error Statistics Format.................................33
Quantum SuperLoader 3 Software Interface Guide vi
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).....................................39
Figure 25 Mode Select (6) Command Descriptor.....................................41
Figure 26 Mode Select (10) Command Descriptor...................................42
Figure 27 Mode Select (6) Mode Parameter List......................................43
Figure 28 Mode Select (10) Mode Parameter List....................................43
Figure 29 Mode Select (6) Parameter Header...........................................44
Figure 30 Mode Select (10) Parameter Header.........................................44
Figure 31 Mode Select Parameter...............................................................46
Figure 32 Mode Select Page Descriptor ....................................................47
Figure 33 Mode Sense (6) Command Descriptor Block..........................48
Figure 34 Mode Sense (10) Command Descriptor Block........................49
Figures
Figure 35 Mode Sense (6) Data Header.....................................................51
Figure 36 Mode Sense (10) Data Header...................................................51
Figure 37 Mode Sense Page Descriptor.....................................................52
Figure 38 TapeAlert Page Format Descriptor ..........................................53
Figure 39 Element Address Assignment Page.........................................56
Figure 40 Transport Geometry Parameters Page.....................................59
Figure 41 Transport Geometry Descriptor ...............................................59
Figure 42 Device Capabilities Page............................................................60
Figure 43 Extended Device Capabilities Page..........................................62
Figure 44 Move Medium Descriptor Block ..............................................67
Figure 45 Persistent Reserve In Descriptor Block....................................69
Figure 46 Read Keys Parameters................................................................71
Figure 47 Read Reservations Parameters..................................................73
Figure 48 Persistent Reserve In Read Reservations.................................74
Quantum SuperLoader 3 Software Interface Guide vii
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................................95
Figure 55 Read Buffer Header....................................................................97
Figure 56 Read Buffer Descriptor...............................................................98
Figure 57 Echo Buffer Descriptor...............................................................99
Figure 58 Read Element Status Descriptor .............................................100
Figure 59 Element Status Data Header ...................................................102
Figure 60 Element Status Page .................................................................103
Figure 61 Data.............................................................................................104
Figure 62 Medium Transport Element Descriptor ................................105
Figure 63 Storage Element Descriptor.....................................................107
Figures
Figure 64 Import/Export Element Descriptor .......................................108
Figure 65 Data Transfer Element Descriptor..........................................110
Figure 66 Release (10) Descriptor Block..................................................113
Figure 67 Release (10) ID Only Parameter List ......................................115
Figure 68 Release Unit (6) Descriptor Block...........................................116
Figure 69 Report Device Identifier Descriptor.......................................117
Figure 70 Report Device Identifier...........................................................118
Figure 71 Report LUNS Descriptor..........................................................120
Figure 72 LUN Reporting Parameter List...............................................121
Figure 73 Request Sense Command Descriptor Block..........................122
Figure 74 Request Sense Command Data...............................................122
Figure 75 Request Sense ............................................................................123
Figure 76 Reserve Element (10) Descriptor ............................................130
Figure 77 Reserve (10) ID Only Parameter List .....................................132
Figure 78 Reserve Element (6) Descriptor ..............................................133
Quantum SuperLoader 3 Software Interface Guide viii
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............................................................140
Figures
Quantum SuperLoader 3 Software Interface Guide ix
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..................................................20
Table 7 Unload Command Descriptor Block .......................................22
Table 8 Log Sense Command Descriptor Block...................................24
Table 9 Last n Error Events Log Sense Header ....................................27
Table 10 Parameters Last n Error Events Log Sense .............................28
Table 11 TapeAlert Log Sense Header Field Descriptions...................29
Table 12 TapeAlert Page Log Parameters...............................................30
Table 13 Move Statistics ............................................................................32
Table 14 Hard/Soft Error..........................................................................34
Table 15 Device Wellness Log Sense Header .........................................35
Table 16 Device Status Log Sense Header..............................................38
Table 17 Parameters for Device Status Log Sense Page........................ 39
Quantum SuperLoader 3 Software Interface Guide x
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 ....................................................47
Table 24 Mode Sense Command Descriptor Block................................49
Table 25 Mode Sense Data Header ..........................................................52
Table 26 Mode Sense Page Descriptor.....................................................52
Table 27 TapeAlert Page Format Descriptor ..........................................54
Table 28 Element Address Assignment Page.........................................58
Table 29 Transport Geometry Parameters Page.....................................59
Table 30 Device Capabilities Page............................................................61
Table 31 Extended Device Capabilities Page..........................................63
Tables
Table 32 Move Medium Command .........................................................68
Table 33 Persistent Reserve In Command ..............................................70
Table 34 Read Keys Parameters................................................................72
Table 35 Read Reservations Parameters..................................................73
Table 36 Persistent Reserve In Read Reservations Descriptor.............75
Table 37 Persistent Reservation Type Codes..........................................76
Table 38 Persistent Reserve Out Command Service Action.................82
Table 39 Persistent Reservation Type Codes..........................................87
Table 40 Persistent Reserve Out Parameter List ....................................89
Table 41 Device Server Interpretation of Service and Scope Value ....91
Table 42 Position to Element Command.................................................93
Table 43 Prevent/Allow Medium Removal
Command Descriptor Block....................................................94
Table 44 Read Buffer Command Descriptor Block................................96
Table 45 Read Buffer Header....................................................................97
Quantum SuperLoader 3 Software Interface Guide xi
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.....................................109
Table 52 Data Transfer Element Descriptor..........................................111
Table 53 Release (10) Command ............................................................114
Table 54 Report Device Identifier Command Descriptor Block ........117
Table 55 Report Device Identifier Parameter Data..............................118
Table 56 Report LUNS Command Descriptor Block...........................120
Table 57 Request Sense Data...................................................................124
Table 58 Supported Sense Keys for Request Sense..............................125
Table 59 Supported ASC / ASCQ (Hex) for Request Sense...............126
Tables
Table 60 Reserve Element (10) Command............................................131
Table 61 Send Diagnostic Command Data ...........................................135
Table 62 Set Device Identifier Command Descriptor Block...............138
Table 63 Set Device Identifier Parameter List ......................................138
Table 64 Write Buffer Command Data..................................................140
Quantum SuperLoader 3 Software Interface Guide xii
Intended Audience
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.
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
• System integrators that are responsible for the SCSI interface
• End users that operate and troubleshoot the SuperLoader 3
Quantum SuperLoader 3 Software Interface Guide xiii
Purpose
Organization
Preface
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
This reference manual is organized as follows:
• Chapter 1,
SuperLoader 3 models, media changer elements, events, and
automatic drive cleaning.
• Chapter 2,
features implemented in the media changer.
Theory of Operation describes differences between the
Media Changer Commands describes the SCSI protocol
Quantum SuperLoader 3 Software Interface Guide xiv
Document Conventions
This manual uses the following conventions to designate specific
elements:
Element Convention Example
Preface
Abbreviations Lowercase, except where standard usage
requires uppercase
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
Mb (megabits)
MB (megabytes)
Quantum SuperLoader 3 Software Interface Guide xv
Preface
Quantum SuperLoader 3 Software Interface Guide xvi
Chapter 1
1Theory 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. The SCSI command set supported by the media changer
device is detailed in “
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.
Media Changer Command Descriptions” on page 9.
Quantum SuperLoader 3 Software Interface Guide 1
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 “
Inquiry Data Page” on page 12) requires the drive hardware to report the
proper function.
Medium Changer 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.
Chapter 1 Theory of Operation
SuperLoader 3
Standard
• Medium transport element
• Storage elements
• Data transfer elements
You can issue the
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
Mode Sense command to determine the SuperLoader 3
Chapter 1 Theory of Operation
Events
Medium Transport Element 1
Data Transfer Element 1
Storage Elements 1
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 removable 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
“
Storage Element Descriptor” on page 107–byte 2, bit 3.
Read Element Status–
Events are system conditions created by operator actions or system
failures. These events are recorded in sense data for the SCSI host to
Power Cycle 1
retrieve via the
When the SuperLoader 3 is powered-on, it goes through an initialization
sequence during which it:
Request Sense command.
• Resets and initializes all hardware
• Responds to SCSI commands which do not require movement
• Responds to
a not ready, initialization in progress check condition (
ASCQ=02
Test Unit Ready and all movement type commands with
SK=02 ASC=29
).
When the power on initialization is complete, it:
• Generates a
Quantum SuperLoader 3 Software Interface Guide 3
Power On/Reset Occurred event (SK=6 ASC=29 ASCQ=02)
Chapter 1 Theory of Operation
• 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.
Events
SuperLoader 3 Offline 1
Magazine Insertion/ Removal 1
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 (
ASCQ=01
unit attention (
). Once the inventory is complete, the SuperLoader 3 reports a
SK=06 ASC=3B ASCQ=13).
SK=02 ASC=04
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).
Maximum Temperature Exceeded 1
The SuperLoader 3 monitors the ambient temperature within the system.
If the temperature exceeds the maximum safe temperature for the media,
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 (
ASC=0B ASCQ=01
Quantum SuperLoader 3 Software Interface Guide 4
).
SK=04
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.
When automatic drive cleaning of the drive is enabled, either the host or
the SuperLoader 3 is responsible for all cleaning functions such as:
• Detecting when a drive requires cleaning
• Tracking and selecting cleaning cartridges
• Moving a cleaning cartridge to the drive
Chapter 1 Theory of Operation
Automatic Drive Cleaning
• 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 configured 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
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.
Element Status Information 1
Automatic Cleaning Operation 1
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
Descripto
r page.
Read Element Status Storage Element
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 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 (
ASCQ=03
).
SK=–2 ASC=30
Quantum SuperLoader 3 Software Interface Guide 6
Chapter 2
2Media 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. 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 7
.
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)
“Inquiry Command (12h)” on page 11
“Load Unload Command (1Bh)” on page 22
“Log Sense Command (4Dh)” on page 23
“Mode Select (6) / (10) Command (15h / 55h)” on page 41
“Mode Sense (6) / (10) Command (1Ah/ 5Ah)” on page 48
“Move Medium Command (A5h)” on page 67
“Persistent Reserve In Command (5Eh)” on page 69 (SCSI-3)
“Persistent Reserve Out Command (5Fh)” on page 78 (SCSI-3)
“Position to Element Command (2Bh)” on page 92
“Prevent/Allow Medium Removal (1Eh)” on page 94
“Read Buffer Command (3Ch)” on page 95
“Read Element Status Command (B8h)” on page 100
“Release Element (10) Command (57h)” on page 113
“Release Unit (6) Command (17h)” on page 116
07h
12h
1Bh
4Dh
15h / 55h
1Ah / 5Ah
A5h
5Eh
5Fh
2Bh
1Eh
3Ch
B8h
57h
17h
“Report Device Identifier Command (A3h)” on page 117
“Report LUNS Command (A0h)” on page 120
“Request Sense Command (03h)” on page 122
“Reserve Element (10) Command (56h)” on page 130 (SCSI-3)
“Reserve Element (6) Command (16h)” on page 133
“Send Diagnostic Command (1Dh)” on page 135
“Set Device Identifier Command (A4h)” on page 137 (SCSI-3)
“Test Unit Ready Command (00h)” on page 139
Quantum SuperLoader 3 Software Interface Guide 8
A3h
A0h
03h
56h
16h
1Dh
A4h
00h
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.
Throughout this manual, multiple bytes containing information about
specific command parameters are portrayed as shown in the following
example of the
SELECT
Bit
Byte76543210
command:
Parameter List Length field (bytes 7 and 8) of the MODE
(Bytes 0 - 6)
(MSB)
7 - 8
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
Parameter List Length
(LSB)
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
STA TUS
failure, if a volume has been changed by an operator, or if configurations
have been changed.
Figure 1 Initialize Element
Status Command
Bit
Byte765 43210
command. It may be useful to issue this command after a power
READ ELEMENT
0
1
2-4
5
Operation Code (07h)
Logical Unit Number Reserved
Reserved
Unused Reserved Flag Link
Quantum SuperLoader 3 Software Interface Guide 10
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.
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.
Each
Vital Product Data page requires a separate INQUIRY command from
the initiator.
are supported by opcode. An
does it clear, a
Figure 2 Inquiry Command
Chapter 2 Media Changer Commands
Inquiry Command (12h)
Vital Product Data comprises several pages of additional data.
Command Support Data indicates the fields in the CDB that
INQUIRY command is not affected by, nor
Unit Attention condition.
Bit
Byte76543210
0
1
Logical Unit Number Reserved CmdDt EVPD
2
Operation Code (12h)
Page Code
(MSB)
3 - 4
Allocation Length
(LSB)
5
Quantum SuperLoader 3 Software Interface Guide 11
Unused Reserved Flag Link
Figure 3 Inquiry Command
Field Description
Chapter 2 Media Changer Commands
Inquiry Command (12h)
CmdDt
EVPD
Page Code or
Operation Code
Command Support Data. If CmdDt =0 and EVPD (see below) = 0, the
media changer returns the
EVPD = 0, the media changer returns the Command Data specified by
Page Code/ Operation. Information about Command Support Data is
provided in figure 9
Enable Vital Product Data. If EVPD=0 and CmdDt (see above) = 0, the
on page 19 and table 6 on page 20.
media changer returns the
CmdDt = 0, the media changer returns the Vital Product Data Page
specified by
Specifies the
Page Code/Operation Code.
Vital Product Data Page which is to be returned by the
media changer when
Standard Inquiry Data. If CmdDt =1 with
Standard Inquiry Data. If EVPD =1 and
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
CmdDt are set. Figure Figure 5 on page 16 shows the Page Codes for
the
Vital Product Pages supported by the media changer.
Page or Operation Code or if both EVPD and
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 2
Quantum SuperLoader 3 Software Interface Guide 12
Figure 4 shows the format of the Standard Inquiry Data page returned by
the media changer.
Chapter 2 Media Changer Commands
Inquiry Command (12h)
Figure 4 Standard Inquiry Data
Bit
Byte 7 6 5 4 3 2 1 0
0
1
2
3
4
5
6
7
8-15
16-31
32-35
36
37
Peripheral Qualifier Peripheral Device Type
RMB Reserved
Version
AERC Obsolete NormACA HiSup Response Data Format
Additional Length (n-4)
SCCS Reserved
BQue EncServ Reserved MultiP MChngr Obsolete Obsolete Add16
RelAdr Obsolete Wbus16 Sync Linked Obsolete CmdQue Reserved
Vendor Identification (QUANTUM)
Product Identification (UHDL)
Product Revision Level (xxxx)
Language
Reserved Image Type
38-40
41
42
43
Quantum SuperLoader 3 Software Interface Guide 13
Firmware Subpersonality
Vendor-Specific Subtype
Reserved
Firmware Personality
Chapter 2 Media Changer Commands
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)
Inquiry Command (12h)
Peripheral Device
8 indicates that this is a media changer device.
Type
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.
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
Format
This Standard Inquiry Data is in SCSI-2 format. Note that
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
Response Data
available.
INQUIRY
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
Loading...