Quantum superloader 3 User's Guide

Download

Quantum SuperLoader

81-81300-03 A01

Quantum SuperLoader

SuperLoader

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.

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)

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

2-4

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

Logical Unit Number Reserved CmdDt EVPD

Operation Code (12h)

Page Code

(MSB)

3 - 4

Allocation Length

(LSB)

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

8-15

16-31

32-35

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

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

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.

Vendor Identification

Identification of vendor.

(QUANTUM)

Product Identification

Identification of the product

(UHDL)

Product Revision Level (xxxx)

This field contains 4 bytes of ASCII hex data that provides the media changer’s firmware revision level.

Language This field indicates the language used for the front panel and

On-board Remote Management.

Image Type This field indicates the type of firmware image required when

downloading a new image. SuperLoader 3 reports a 2.

Firmware Personality Numeric indicator of firmware personality. Note that when

set to 4, this indicates OEM family.

Firmware

Set to 2, indicating standard SCSI device firmware.

Subpersonality

Vendor-Specific

Identification of product.

Subtype

* The BQue and CmdQue bits are set on HP drives, even though these options are not supported. It is necessary to set these bits for Adaptec® HBAs to support Ultra 320. These values will vary depending on the drive type in the autoloader.

Vital Product Data Page 2

Quantum SuperLoader 3 Software Interface Guide 15

The following sections describe the Vital Product Data Pages for the system.

Chapter 2 Media Changer Commands

Inquiry Command (12h)

Supported Vital Product Data Page 2

The Supported Vital Product Data Pages page provides a directory of the

Vital Product Data Pages that are supported by the SuperLoader 3.

Figure 5 Supported Vital Product Data

Bit Byte76543210

Figure 6 Unit Serial Number Page (80h)

Peripheral Qualifier Peripheral Device Type

Page Code (00h)

Reserved

Page Length (03h)

00h - (this page)

80h - Unit Serial Number Page

83h – Device Identification Page

Bit Byte76543210

Peripheral Qualifier Peripheral Device Type

Quantum SuperLoader 3 Software Interface Guide 16

Page Code (80h)

Reserved

Page Length (0Eh)

Chapter 2 Media Changer Commands

Inquiry Command (12h)

Bit Byte76543210

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.

Figure 7 Device Identification Page (83h)

Bit Byte76543210

Peripheral Qualifier Peripheral Device Type

Page Code (83h)

Reserved

Page Length

4 - n

Quantum SuperLoader 3 Software Interface Guide 17

Identification Descriptors

Chapter 2 Media Changer Commands

Inquiry Command (12h)

There are three different Identification Descriptors returned, in numerical order of the

Identifier Type. Each Identification Descriptor takes the

following form:

Figure 8 Identifier Descriptor

Bit Byte76543210

Reserved Association Identifier Type

4 - n

Table 4 Identifier Descriptor Field Descriptions

Reserved Code Set

Reserved

Identifier Length (n-3)

Identifier

Field Name Field Description

Code Set Indicates the type of data to be found in the

Identifier field. A value of 1 indicates binary data. A value of 2 indicates ASCII data.

Association Indicates whether the

Identifier is associated with

the logical unit or the port. Always contains a 0, indicating the

Identifier is associated with the logical

unit.

Identifier Type Type of identifier.

Value Description

1 Concatenation of the Vendor Name,

Product ID, and unit serial number

2 Canonical form of the IEEE Extended

Unique Identifier, 64 bit (EIU-64)

3 FC-PH Name_Identifier

Quantum SuperLoader 3 Software Interface Guide 18

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 Data2

Figure 9 Command Support Data Page

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).

2 1 8 8 bytes of binary data indicating the

EUI-64 assigned to the drive.

3 1 8 8 bytes of binary data indicating the

64-bit, type 3, FC-PH Name_Identifier assigned to the drive.

An application client can request command support data by setting the

CmdDt bit of the INQUIRY command to 1, and specifying the SCSI

operation code of the

CDB for which it wants information.

The format of the command support data and definitions of the fields follow.

Bit Byte76543210

Quantum SuperLoader 3 Software Interface Guide 19

Peripheral Qualifier Peripheral Device Type

Reserved Support

Chapter 2 Media Changer Commands

Inquiry Command (12h)

Bit Byte76543210

ISO Version ECMA Version ANSI - Approved Version

3 - 4

6 - n

Table 6 Command Support

Data Page

Field Name Description

Support The value of the

tape drive provides for

Value Description

000b Data about the requested SCSI operation code is not

currently available. In this case, all data after Byte 1 is undefined.

001b The device does not support the SCSI operation code

requested. In this case, all data after Byte 1 is undefined.

Reserved

CDB Size (m - 5)

CDB Usage Data

Support field describes the type of support that the

Command Support Data.

010b Reserved

011b The device supports the SCSI operation code in

conformance with the SCSI standard.

100b Vendor-Specific

101b The device supports the SCSI operation code, but in a

vendor-specific manner.

110b Vendor-Specific

111b Reserved

ISO-Version Must be 0.

Quantum SuperLoader 3 Software Interface Guide 20

Field Name Description

ECMA-Version Must be 0.

Chapter 2 Media Changer Commands

Inquiry Command (12h)

ANSI-Approved

Version

CDB Size This field contains the number of bytes in the

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

being queried. Note that the first byte of the the

OpCode for the operation specified. All of the other bytes of the

CDB Usage Data contain a map for bits in the CDB of the OpCode

CDB for the Operation

CDB for the Operation Code

CDB Usage Data contains

specified.

NOTE: The bits in the map have a 1-to-1 correspondence to the

CDB for the OpCode being

queried. That is, if the device senses a bit as the entire field or as part of the field of the operation, the map in device ignores a bit or declares a bit as “reserved” in the

CDB Usage Data contains a 1 in the corresponding bit position. If the

CDB for the OpCode being queried, the

map has a 0 in that corresponding bit position.

Quantum SuperLoader 3 Software Interface Guide 21

Chapter 2 Media Changer Commands

Load Unload Command (1Bh)

The LOAD UNLOAD command tells the target to eject all magazines. If no magazines are present, an

ILLEGAL REQUEST sense key.

This command will eject the magazine(s) regardless of the setting via the

PREVENT/ALLOW MEDIUM REMOVAL command.

Figure 10 Load Unload Command Descriptor Block

Bit Byte76543210

UNLOAD returns a CHECK CONDITION status with

Logical Unit Number Reserved Immed

2 - 4

Table 7 Unload Command Descriptor Block

Unused Reserved Flag Link

Operation Code (1Bh)

Reserved

Field Name Description

Immed

Immediate. If this bit is set to 1, status is returned as

soon as the operation is started. If set to 0, status is returned after the operation has completed.

Quantum SuperLoader 3 Software Interface Guide 22

Chapter 2 Media Changer Commands

Log Sense Command (4Dh)

The LOG SENSE command allows the host to retrieve statistical information maintained by the media changer about its own hardware parameters.

Figure 11 LOG SENSE Command Descriptor Block

Bit Byte76543210

3 - 4

5 - 6

7 - 8

Operation Code (4Dh)

Logical Unit Number Reserved PPC (0) SP(0)

PC Page Code

Reserved

(MSB)

Parameter Pointer

(LSB)

(MSB)

Allocation Length

(LSB)

Unused Reserved Flag Link

Quantum SuperLoader 3 Software Interface Guide 23

Table 8 Log Sense Command Descriptor Block

Field Name Description

Chapter 2 Media Changer Commands

Log Sense Command (4Dh)

PPC

Parameter Pointer Control. A PPC of 0 indicates that the parameter data

requested from the device starts with the parameter code specified in the

Parameter Pointer field (Bytes 5 - 6) and returns the number of bytes specified

in the

Allocation Length field (Bytes 7 - 8) in ascending order of parameter

codes from the specified log page. Request for changed parameters is not supported. This field must be 0.

Save Parameters. Not supported, must be set to 0. If for some reason the Save Parameters

with a sense key of

Page Control. This field defines the type of parameter values to be returned:

bit is set, the command terminates with a CHECK CONDITION status

ILLEGAL REQUEST and an ASC of INVALID FIELD IN CDB.

PC Type of Parameter Values

00b Threshold Values

01b Cumulative Values

10b Default Threshold Values

11b Default Cumulative Values

The

Default Threshold Values are the maximum values that each parameter can

attain.

The

Current Cumulative Values are the values computed since the last reset of

the device (either via power-cycle,

BUS DEVICE RESET, or SCSI RESET.)

The

Default Cumulative Values are the values to which each parameter is

initialized at a reset condition. Default values are 0.

By default,

Page Code The

Page Code field identifies which log page is being requested by the

Current Threshold Values = Default Threshold Values.

initiator. If the page is not supported, then the command terminates with a

CHECK CONDITION status, sense key set to ILLEGAL REQUEST, and additional

sense code of

INVALID FIELD IN CDB. Supported pages are:

Page Code Page Definition

00h Supported Pages Log Page (

Quantum SuperLoader 3 Software Interface Guide 24

00h)

Field Name Description

07h Last n Error Events Page (07h)

2Eh “TapeAlert Page (2Eh)” on page 29

Chapter 2 Media Changer Commands

Log Sense Command (4Dh)

Parameter Pointer

Allocation Length

30h “

31h “

33h “

3Eh “

The

Parameter Pointer field allows the host to specify at which parameter

Move Statistics Page (30h)” on page 31

Hard/Soft Error Statistics Page (31h)” on page 32

Device Wellness Page (33h)” on page 34

Device Status Page (3Eh)” on page 37

within a log page the requested data should begin. For example, if a page supports parameters 0 through 5, and the

Parameter Pointer contains 3, then

only parameters 3, 4, and 5 are returned to the initiator. Similarly, if a page supports parameters 1, 3, and 6, and the

Parameter Pointer contains 2, then only

parameters 3 and 6 are returned to the initiator.

If the

Parameter Pointer is larger than the highest numbered parameter on the

page, then the target terminates the command with sense key set to

FIELD IN CDB

ILLEGAL REQUEST, and additional sense code set to INVALID

CHECK CONDITION status,

Note that parameters within a page are always returned in ascending order according to parameter code.

If the target does not support a parameter code within this page, then it does not return any data associated with this parameter.

This field specifies the maximum number of bytes that the initiator has allocated for returning data. The host uses this field to limit the size of data transfers to its own internal buffer size.

Quantum SuperLoader 3 Software Interface Guide 25

Chapter 2 Media Changer Commands

Log Sense Command (4Dh)

Supported Pages Log Page (00h) 2

Figure 12 Supported Pages Page

When page 00h is requested, the 4-byte page header is returned, followed by the pages supported in ascending order, one byte for each.

Bit Byte76543210

Reserved Page Code (00h)

Reserved

(MSB)

2 – 3

Page Length (7h)

(LSB)

00h

07h

2Eh

Quantum SuperLoader 3 Software Interface Guide 26

30h

31h

33h

3Eh

Chapter 2 Media Changer Commands

Log Sense Command (4Dh)

Last n Error Events Page (07h) 2

Figure 13 Last n Error Events Log Sense Header

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

Error Log

EEROM Hard

Bit Byte76543210

Reserved Page Code (07h)

Reserved

(MSB)

2 - 3

Page Length (n)

(LSB)

Table 9 Last n Error Events Log Sense Header

Field Name Description

Page Code The

Page Code echoes the page code that was

specified in the

LOG SENSE command descriptor

block.

Page Length The

Page Length field specifies the total number of

bytes contained in this log page, not including the four bytes that make up the header.

Quantum SuperLoader 3 Software Interface Guide 27

Chapter 2 Media Changer Commands

Log Sense Command (4Dh)

Figure 14 Format for Last n Error Events Log Sense

Bit Byte76543210

(MSB)

0 -1

DU DS TSD ETC TMC Rsv’d LP

(MSB)

4 - n

Table 10 Parameters Last n Error Events Log Sense

Parameter Code

Parameter Length

ASCII String for Event n

Field Name Description

Parameter Code The

Parameter Code value represents the relative

time at which the error occurred. It identifies the log parameter being transferred for that log page. The most recent 10 events will be reported.

Disable Update not supported, always 0. Save not supported, always 1.

(LSB)

TSD

ETC

Target Save Disable not supported, always 1. Enable Threshold Comparison not supported,

always 0.

TMC

Parameter Length

Quantum SuperLoader 3 Software Interface Guide 28

Threshold Met Criteria not supported, always 0. List Parameter. This bit is set to 1.

The length in bytes of the following parameter value.

Field Name Description

Chapter 2 Media Changer Commands

Log Sense Command (4Dh)

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.

TapeAlert Page (2Eh) 2

The TapeAlert Log page defines error and informational flags for detailed device diagnostics. The control bits in the

TapeAlert data is event-based and the page

LOG SENSE command are not applicable and are

ignored.

The SuperLoader 3 supports the definition of the flags for media changer devices as defined in SMC-2.

Figure 15 T apeAlert Log Sense Header Format

Bit Byte76543210

Page Code (2Eh)

Reserved

(MSB)

2 - 3

Page Length

(LSB)

Table 11 TapeAlert Log Sense Header Field Descriptions

Field Name Description

Page Code The

Page Code echoes the page code that was

specified in the

LOG SENSE command descriptor

block.

Page Length The

Page Length field specifies the total number of

bytes contained in this log page, not including the four bytes that make up the header.

Quantum SuperLoader 3 Software Interface Guide 29

Chapter 2 Media Changer Commands

Log Sense Command (4Dh)

Figure 16 TapeAlert Page Log Parameters Format

Bit Byte76543210

5n – 1

MSB

to 5n

5n + 1

DU DS TSD ETC TMC Rsv’d LP

5n + 2

5n + 3

Table 12 TapeAlert Page Log Parameters

Value of TapeAlert Flag (Flag is set when Bit 0 = 1; Bits 1 - 7 are Reserved)

Parameter Code (n)

Parameter Length

Field Name Description

Parameter

This field contains the Flag code.

Code

Disable Update

DS Save not supported, always 1

TSD

ETC

Target Save Disable not supported, always 0. Enable Threshold Comparison

(LSB)

TMC Threshold Met Criteria LP List Parameter

Parameter

This field is set to 1.

Length

Value of TapeAlert Flag

If Bit 0 is set to 1, indicates that TapeAlert has sensed a problem. If Bit 0 is 0, the Flag is not set and no problem has been sensed.

Quantum SuperLoader 3 Software Interface Guide 30

Chapter 2 Media Changer Commands

Log Sense Command (4Dh)

Move Statistic s 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.

Figure 17 Move Statistics Format

Bit Byte76543210

Reserved Page Code (30h)

Reserved

(MSB)

2 - 3

Page Length (18h)

(LSB)

(MSB)

4-7

Total Moves

(LSB)

(MSB)

8-11

Drive Loads

(LSB)

(MSB)

12-15

Mail Slot Imports

(LSB)

(MSB)

16-19

Mail Slot Exports

(LSB)

Quantum SuperLoader 3 Software Interface Guide 31

Chapter 2 Media Changer Commands

Log Sense Command (4Dh)

Bit Byte76543210

(MSB)

20-23

(MSB)

24-27

Table 13 Move Statistics

Magazine Moves

(LSB)

Magazine Loads

(LSB)

Field Name Description

Page Code The page code is 30h.

Page Length The page length is 18h bytes.

Total Moves Total number of SuperLoader 3 moves.

Drive Loads Number loads to the drive from magazines and

mail slot.

Mail Slot Imports Number times a cartridge was importing into the

system.

Mail Slot Exports Number of times a cartridge was exported from

the system.

Magazine Moves Number of moves between storage slots.

Magazine Loads Number of times a cartridge was moved from a

storage slot to the drive.

Hard/Soft Error Statistics Page (31h) 2

This page consists of the Log Page Header followed by a count of recovery actions performed. The entries in this log page are cumulative throughout the life of the unit and cannot be reset via SCSI or power cycle. Log Parameters are not supported for this page. These numbers, in relation to the total number of moves performed, can provide an indication as to the health of the servo system.

Quantum SuperLoader 3 Software Interface Guide 32

Chapter 2 Media Changer Commands

Log Sense Command (4Dh)

Figure 18 Hard/Soft Move Error Statistics Format

Bit Byte76543210

2 - 3

4-5

6-9

10-13

14-17

Reserved Page Code (31h)

Reserved

(MSB)

Page Length (22h)

(LSB)

(MSB)

Servo Hard Errors

(LSB)

(MSB)

Drive Soft Error

(LSB)

(MSB)

Left Magazine Soft Error

(LSB)

(MSB)

Right Magazine Soft Error

(LSB)

(MSB)

18-21

Mail Slot Soft Error

(LSB)

(MSB)

22-25

Rotation Recovery Actions

(LSB)

Quantum SuperLoader 3 Software Interface Guide 33

Chapter 2 Media Changer Commands

Log Sense Command (4Dh)

Bit Byte76543210

(MSB)

26-29

(MSB)

30-33

(MSB)

34-37

Table 14 Hard/Soft Error

Translation Recovery Actions

(LSB)

Left Magazine Recovery Actions

(LSB)

Right Magazine Recovery Actions

(LSB)

Field Name Description

Page Code The page code is 31h.

Page Length The page length is 22h bytes.

Servo Hard Errors The number of unrecoverable errors.

Soft Errors Each field is a count of the number of times

high-level recoverable error was reported for that component.

Recovery Actions Each field is a count of the number of times

recovery actions were required in that axis to perform an operation.

Device Wellness Page (33h) 2

The Device Wellness Page returns information about any check conditions related to Sense Keys 4 and 9 logged by the media changer. Up to 16 entries (parameter code 0000h to 000Fh) can be contained in the page. Each entry records a hardware error (Sense Key = 4) or a code update event (Sense Key = 9). Note that parameter code 000h contains the oldest log information while parameter 000Fh contains the most recent.

Quantum SuperLoader 3 Software Interface Guide 34

Chapter 2 Media Changer Commands

Log Sense Command (4Dh)

This page begins with a 4-byte header followed by the log parameter blocks.

Figure 19 Device Wellness Log Sense Header

Bit Byte76543210

Reserved Page Code (33h)

(MSB)

2 - 3

Table 15 Device Wellness Log Sense Header

Figure 20 Device Wellness Log Sense (0000h-000Fh)

Reserved

Page Length

(LSB)

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.

Bit Byte76543210

(MSB)

0-1

Parameter Code

(LSB)

Quantum SuperLoader 3 Software Interface Guide 35

Chapter 2 Media Changer Commands

Log Sense Command (4Dh)

Bit Byte76543210

4-7

8 - 9

10 - 11

DU DS TSD ETC TMC Rsv’d LP

Parameter Length (0Ch)

(MSB)

Time Stamp

(LSB)

(MSB)

Source Element

(LSB)

(MSB)

Destination Element

(LSB)

Sense Key

Additional Sense Code

Additional Sense Code Qualifier

Additional Error Information

Figure 21 Log Parameters for Device Wellness Log Sense

Field Name Description

Parameter Code

Quantum SuperLoader 3 Software Interface Guide 36

Parameter Codes 0000h through 000Fh are supported. This provides 16 log

entries for error information capture.

Disable Update. Always 0. Save not supported, always 1.

Field Name Description

TSD Target Save Disable not supported, always 1.

Chapter 2 Media Changer Commands

Log Sense Command (4Dh)

ETC

Enable Threshold Comparison. Threshold checking is not supported on this

page. Always set to 0.

TMC

Parameter

Threshold Met Criteria. Always 0. List Parameter. Always set to 0.

The number of bytes to follow (0Ch).

Length

Time Stamp The Time Stamp is represented as number of power cycles and total power

on hours.

Source Element/

These fields report the element addresses that were involved in the failure.

These fields will be zero (0) if the failure did not involve a move command. Destination Element

Device Status Page (3Eh)2

Figure 22 Device Status Log Sense Header

The Device Status Page describes the current status of the media changer.

Bit Byte76543210

Reserved Page Code (3Eh)

Reserved

(MSB)

2 - 3

Page Length

(LSB)

Quantum SuperLoader 3 Software Interface Guide 37

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.

Figure 23 Parameters for Device Status Log Sense Page

Bit Byte76543210

0 - 1

DU DS TSD ETC TMC Rsv’d LP

Parameter Code

Parameter Length (04h)

(MSB)

4 - 7

Parameter Value

(LSB)

Quantum SuperLoader 3 Software Interface Guide 38

Chapter 2 Media Changer Commands

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.

Log Sense Command (4Dh)

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

TSD

ETC

Disable Update. Always 0. Save not supported, always 1. Target Save Disable not supported, always 1. Enable Threshold Comparison. Threshold checking is not supported on

this page. Always set to 0.

TMC

Threshold Met Criteria. Always 0. List Parameter. Always set to 0 (parameter codes treated as data

counter).

Figure 24 Device Status Log Sense Page (0001h)

Bit Byte76543210

Reserved Temperature Status

2 - 3

Quantum SuperLoader 3 Software Interface Guide 39

Reserved

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:

Bit 3 Bit 2 Description

0 0 Not supported

01OK

1 0 Warning: Safe temperature exceeded.

1 1 Maximum temperature exceeded.

Status These two bits indicate the overall condition of the device. The status of the

device follows the following format:

Bit 1 Bit 0 Description

0 0 Not supported

01OK

10Degraded

1 1 Failed

Quantum SuperLoader 3 Software Interface Guide 40

Chapter 2 Media Changer Commands

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

SELECT

the media changer. Before configuring the media changer, the host should issue a report of the current configuration and determine what parameters are configurable. The host interprets this information and then may issue

MODE SELECT to set the media changer to the host’s preferred

configuration. The is passed from the initiator to the media changer during the command’s

DATA OUT phase. The media changer device does not allow the host to

save any values on any page.

Information for the media changer is carried on a number of pages, each of which serves to set the media changer’s operating parameters. The

MODE SELECT pages supported, and the page within this manual that

details each, are:

and MODE SENSE requires “handshaking” between the host and

MODE SENSE command to the media changer to obtain a

Mode Parameter List described in Mode Parameter List

MODE

Page Code Description

1Ch “

1Dh “

1Eh “

1Fh “

Figure 25 Mode Select (6) Command Descriptor

TapeAlert Page (1Ch)” on page 53

Element Address Assignment Page” on page 56

Transport Geometry Parameters Page” on page 58

Device Capabilities Page” on page 60

Bit Byte76543210

Quantum SuperLoader 3 Software Interface Guide 41

Logical Unit Number PF Reserved SP (0)

Operation Code (15h)

Chapter 2 Media Changer Commands

Mode Select (6) / (10) Command (15h / 55h)

Bit Byte76543210

2 – 3

Figure 26 Mode Select (10) Command Descriptor

Unused (00) Reserved Flag Link

Reserved

Parameter List Length

Bit Byte76543210

2 – 6

7 - 8

Logical Unit Number PF Reserved SP (0)

Unused (00) Reserved Flag Link

Operation Code (55h)

Reserved

Parameter List Length

Table 19 Mode Select (6)/(10) Command Descriptor

Field Name Description

Page Format. The Page Format bit indicates that the

data sent by the host after the

MODE SELECT header

and block descriptors complies with the definition of pages in the SCSI-2 specification. The SCSI-1 format will not be implemented so this bit must be set to 1. It is an

ILLEGAL REQUEST to have page parameters

while the PF bit is 0.

Save Parameters. Must be 0. If set, this bit instructs the

SuperLoader 3 to save all savable pages, and this is not supported.

Quantum SuperLoader 3 Software Interface Guide 42

Chapter 2 Media Changer Commands

Mode Select (6) / (10) Command (15h / 55h)

Mode Parameter List 2

Figure 27 Mode Select (6) 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

OUT

phase.

Bit Byte 76543210

0 - 3

4 - 11

4 – 11 or

Mode Parameter Block Descriptor (Optional)

Mode Parameter Header

Page(s) (Optional)

12 - n

Figure 28 Mode Select (10) Mode Parameter List

Bit Byte 76543210

DATA

0 - 7

8 - 15

8 - n

Mode Parameter Block Descriptor (Optional)

Mode Parameter Header

Page(s) (Optional)

or 16 - n

Table 20 Mode Select Parameter List

Field Name Description

Mode Parameter Header

4 or 8 bytes in length, contains information about the remainder of the

Parameter List and is always

present.

Quantum SuperLoader 3 Software Interface Guide 43

Field Name Description

Chapter 2 Media Changer Commands

Mode Select (6) / (10) Command (15h / 55h)

Mode Parameter Block Descriptor

Page(s) The

8 bytes in length; not applicable to a media changer device.

Page Code(s) of the pages that are a part of this

MODE SELECT command.

Mode Parameter Header 2

The figures and table that follow provide an illustration and description of the fields that make up the

MODE SELECT command’s Mode Parameter

header.

Figure 29 Mode Select (6) Parameter Header

Bit Byte76543210

Reserved

Figure 30 Mode Select (10) Parameter Header

Block Descriptor Length

Reserved

Bit Byte76543210

0 - 1

Quantum SuperLoader 3 Software Interface Guide 44

Reserved

Chapter 2 Media Changer Commands

Mode Select (6) / (10) Command (15h / 55h)

Bit Byte76543210

4 - 5

6 - 7

Table 21 Mode Select Parameter Header

Reserved

Block Descriptor Length

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. A value of 0 indicates no block description is included; a value of 8 indicates a block descriptor is present and precedes the mode page data. Any other value other than 0 or 8 causes a sense key of

ILLEGAL REQUEST to be returned.

CHECK CONDITION status with

Mode Parameter Block Descriptor 2

The figure and table that follow provide an illustration and description of the fields that make up the

Block Descriptor

MODE SELECT command’s Mode Parameter

Quantum SuperLoader 3 Software Interface Guide 45

Chapter 2 Media Changer Commands

Mode Select (6) / (10) Command (15h / 55h)

Figure 31 Mode Select Parameter

Bit Byte76543210

(MSB)

1 - 3

(MSB)

5 - 7

Table 22 Mode Select Parameter Block

Reserved

Number of Blocks

(LSB)

Reserved

Block Length

(LSB)

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.

Mode Page Descriptors 2

Following the MODE SELECT command’s Mode Parameter Block

Descriptor

are the MODE SELECT pages, each of which sets a different

device parameter. Each mode page has a 2-byte header that identifies the page code and indicates the number of bytes in that page.

Quantum SuperLoader 3 Software Interface Guide 46

Chapter 2 Media Changer Commands

Mode Select (6) / (10) Command (15h / 55h)

Figure 32 Mode Select Page Descriptor

Bit Byte76543210

PS (0) 0 Page Code

2 - n

Table 23 Mode Select Page Descriptor

Additional Page Length

Page-Defined or Vendor Specific Parameter List

Field Name Description

Parameters Savable. For the MODE SELECT (6) (10)

commands, this field is reserved (0).

Additional Page Length

Page-Defined or Vendor Specific Parameter List

Indicates number of bytes in that page (not including bytes 0 and 1).

Information in this field depends on the mode page. Refer to “

Element Address Assignment Page” on page 56 to “Device Capabilities Page”

on page 60.

Quantum SuperLoader 3 Software Interface Guide 47

Chapter 2 Media Changer Commands

Mode Sense (6) / (10) Command (1Ah/ 5Ah)

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.

Figure 33 Mode Sense (6) Command Descriptor Block

Bit Byte76543210

Logical Unit Number Rsv’d DBD Reserved

PC Page Code

Unused Reserved Flag Link

Operation Code (1Ah)

SubPage

Allocation Length

The MODE SENSE (10) command returns descriptor data in a different format than

Quantum SuperLoader 3 Software Interface Guide 48

MODE SENSE (6).

Chapter 2 Media Changer Commands

Mode Sense (6) / (10) Command (1Ah/ 5Ah)

Figure 34 Mode Sense (10) Command Descriptor Block

Bit Byte7654321 0

Logical Unit Number Rsv’d DBD Reserved

PC Page Code

4 – 6

(MSB)

7 - 8

Table 24 Mode Sense Command Descriptor Block

Unused Reserved Flag Link

Field Name Description

DBD

Disable Block Descriptors. This field is ignored. This device does not return

a block descriptor regardless of this field.

Operation Code (5Ah)

SubPage

Reserved

Allocation Length

(LSB)

Page Control. The Page Control field indicates the type of page parameter

values to be returned to the host:

PC Type of Parameter Values

00 Report Current Values

01 Report Changeable Values

10 Report Default Values

Quantum SuperLoader 3 Software Interface Guide 49

Chapter 2 Media Changer Commands

Mode Sense (6) / (10) Command (1Ah/ 5Ah)

Field Name Description

11 Report Saved Values

Note that the media changer device does not support saved values.

Page Code This field allows the host to select any specific page or all of the pages

supported by the media changer.

Page Code Description

1Ch “

1Dh “

1Eh “

1Fh “

TapeAlert Page (1Ch)” on page 53

Element Address Assignment Page” on page 56

Transport Geometry Parameters Page” on page 58

Device Capabilities Page” on page 60

3Fh Return all pages

SubPage This field can have three values:

41h Extended Device Capabilities SubPage FFh All SubPages 00h No SubPage format

Allocation Length

This field specifies the number of bytes that the host has allocated for returned media changer will return no error, and

MODE SENSE data. An allocation length of zero indicates that the

MODE SENSE data. This is not considered an

GOOD status is returned.

MODE SENSE SENSE (6)

may be either MODE SENSE (6) or MODE SENSE (10). MODE

data contains a 4-byte header followed by one 8-byte block descriptor, followed by zero or more variable length pages, depending on the

Page Code and Allocation Length.

Mode Sense Data Headers 2

Quantum SuperLoader 3 Software Interface Guide 50

The MODE SENSE (6) and MODE SENSE (10) headers are illustrated in the following figures.

Chapter 2 Media Changer Commands

Mode Sense (6) / (10) Command (1Ah/ 5Ah)

Figure 35 Mode Sense (6) Data Header

Bit Byte76543210

Figure 36 Mode Sense (10) Data Header

Mode Sense Data Length

Reserved

Block Descriptor Length (0)

Bit Byte76543210

(MSB)

0 - 1

Mode Sense Data Length

(LSB)

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

Figure 37 Mode Sense Page Descriptor

Field Name Description

Mode Sense Data Length

Block Descriptor Length

This field specifies the length (in bytes) of the

SENSE

data that is available to be transferred during

the

DATA IN phase. Note that the Mode Sense Data

Length

does not include itself.

This field specifies the length (in bytes) of all of the block descriptors. This value will be 0, indicating no

Block Descriptors were sent.

The following figure depicts the variable length page descriptor.

MODE

Bit Byte76543210

PS 0 Page Code

Additional Page Length

Page Defined or Vendor Specific Parameter Bytes

Descriptions of the MODE SENSE page descriptor fields are provided in

Table 26 Mode Sense Page Descriptor

the following table. Detailed descriptions of each of the

Pages

follow.

Field Name Description

Parameters Savable. When 0, the supported

MODE SENSE

parameters cannot be saved (savable pages are not supported). When set to 1, it indicates that the page can be saved in nonvolatile memory by the media changer.

Quantum SuperLoader 3 Software Interface Guide 52

Field Name Description

Chapter 2 Media Changer Commands

Mode Sense (6) / (10) Command (1Ah/ 5Ah)

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

TapeAlert Page (1Ch) 2

Figure 38 TapeAlert Page Format Descriptor

performing

The SuperLoader 3 supports the T apeAlert Page that is used to set/change the supported

TapeAlert configuration options. Use the MODE SENSE

command to read the settings of the

MODE SELECT.

TapeAlert page.

Bit Byte76543210

PS (0) 0 Page Code (1Ch)

Additional Page Length (0Ah)

Perf Reserved DExcpt Test Rsvd LogErr

Reserved MRIE

(MSB)

Interval Timer

4 - 7

(LSB)

MSB)

Report Count/Test Flag Number

8 - 11

Quantum SuperLoader 3 Software Interface Guide 53

(LSB)

Table 27 TapeAlert Page Format Descriptor

Field Name Description

Chapter 2 Media Changer Commands

Mode Sense (6) / (10) Command (1Ah/ 5Ah)

Additional Page Length

Perf

DExcpt

Test

Parameters Savable. Not supported, this bit must be 0.

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 and must subsequently be set to the same value when performing

SELECT CHECK CONDITION status is returned, sense key set to ILLEGAL REQUEST

The device returns a

ILLEGAL REQUEST if it receives an unsupported Page Code or a Page

. If the page length does not match that expected by the drive, a

CHECK CONDITION status with sense key set to

MODE SENSE

MODE

field with values not supported or changeable. In such cases, no parameters are changed as a result of the command.

Performance bit. Performance Impacting Exceptions are acceptable. This

bit is ignored.

Disable Information Exception Operations. If = 0, the reporting method

specified by the contents of

MRIE is selected. When this bit is set to 1, all

information exception conditions are disabled regardless of the contents for the

MRIE field. To enable CHECK CONDITION mode, DExcpt

should = 0. Default setting = 1.

Test bit. Used to generate false TapeAlert conditions to test the response

to failure conditions. See the for more information. If both return

CHECK CONDITION status, with a send key ILLEGAL REQUEST,

and additional sense data of

Report Count/Test Flag Number description

Test and DExcpt are set to 1, the drive will

INVALID FIELD IN PARAMETER LIST.

LogErr

MRIE

Error Log. Not supported. Method for Reporting Information Exceptions. The tape drive uses the

contents of this field to report information about exception conditions.

Value Method

00h No reporting of Informational Exception Conditions.

The device server does not report information exception conditions.

Quantum SuperLoader 3 Software Interface Guide 54

Field Name Description

03h Conditionally Generate Recovered Error. The device

Chapter 2 Media Changer Commands

Mode Sense (6) / (10) Command (1Ah/ 5Ah)

server reports information exception conditions, if such reports of recovered errors is allowed, by returning

CHECK CONDITION status on the next SCSI command

(except following detection of the condition. The set to code of with

INQUIRY and REQUEST SENSE commands)

Sense Key is

RECOVERED ERROR with an additional sense

5D 00 (TapeAlert Event). The SCSI command

CHECK CONDITION completes without error prior

to the report of any exception condition, and does not need to be repeated.

04h

06h

Interval Timer Not supported.

Unconditionally Generate Recovered Error. The drive

reports information exception conditions by returning

CHECK CONDITION status on the next SCSI command

(except

INQUIRY and REQUEST SENSE commands)

following detection of the condition. The Sense Key is set to

RECOVERED ERROR with an additional sense

code of with

5D 00 (TapeAlert Event). The SCSI command

CHECK CONDITION completes without error prior

to the report of any exception condition, and does not need to be repeated.

Only Report Informational Exception Condition on Request

. The device server preserves informational exception data. To access the data, a poll can be taken by issuing an unsolicited

Sense Key is set to NO SENSE with an additional sense

code of

5D 00 (TapeAlert Event).

The additional sense code of and

06h signals that a TapeAlert event has occurred.

Information about the event is stored in the

Log Page

. The setting of MRIE does not impact logging

of events in the

REQUEST SENSE command. The

5D 00 for values 03h, 04h,

TapeAlert

TapeAlert Log Page.

Report Count/Test Flag Number

Report Count or Test Flag Number. This field must be set to 0 unless the Test bit is set. When the Test bit is set, this field indicates that a test

condition to be generated as follows:

Quantum SuperLoader 3 Software Interface Guide 55

Field Name Description

Value Result

Chapter 2 Media Changer Commands

Mode Sense (6) / (10) Command (1Ah/ 5Ah)

0 Change no

condition based on the setting of the

1 to 64 Set the

generate an exception condition based on the

TapeAlert Flag but report an exception

MRIE field.

TapeAlert Flag indicated in the value and

MRIE

field.

-1 to -64 Clear the

TapeAlert Flag in an equivalent manner to

taking corrective action as indicated by the absolute number of the value.

32767 Set all

Element Address Assignment Page 2

The element address assignment page is used to report element address assignments to the host. This page also defines the number of each type of

TapeAlert Flags and generate and exception

condition based on the setting of the

MRIE field.

element present. None of the fields in this page are changeable.

Figure 39 Element Address Assignment Page

Bit Byte 7 6 5 4 3 2 1 0

PS (0) RSVD Page Code (1Dh)

Parameter List Length (12h)

(MSB)

2-3

First Medium Transport Element Address

(LSB)

Quantum SuperLoader 3 Software Interface Guide 56

Chapter 2 Media Changer Commands

Mode Sense (6) / (10) Command (1Ah/ 5Ah)

Bit Byte 7 6 5 4 3 2 1 0

(MSB)

4-5

6-7

8-9

10-11

12-13

14-15

Number of Medium Transport Elements

(LSB)

(MSB)

First Storage Element Address

(LSB)

(MSB)

Number of Storage Elements

(LSB)

(MSB)

First Import/Export Element Address

(LSB)

(MSB)

Number of Import/Export Address

(LSB)

(MSB)

First Data Transfer Element Address

(LSB)

(MSB)

16-17

Number of Data Transfer Elements

(LSB)

18-19

Quantum SuperLoader 3 Software Interface Guide 57

Reserved

Table 28 Element Address Assignment Page

Field Name Description

Chapter 2 Media Changer Commands

Mode Sense (6) / (10) Command (1Ah/ 5Ah)

First Medium Transport Element Address

Number of Medium Transport Elements

First Storage Element Address

Number of Storage Elements

First Import/Export Element Address

Number of Import/Export Elements

First Data Transfer Element Address

Number of Data Transfer Elements

Identifies the address of the first medium transport element contained in the media changer. The SuperLoader 3 uses the default address of 0.

Defines the total number of medium transport elements contained in the media changer. The SuperLoader 3 contains 1.

Identifies the address of the first medium storage element contained in the media changer.

Defines the total number of storage elements contained in the media changer. There are 16 total, although since the magazines are removable, eight of them may be “inaccessible” at times.

Identifies the address of the first import/export element that is accessible both by the medium transport device and also by an operator from outside the media changer.

Defines the total number of import/export elements contained in the media changer.

Identifies the address of the first data transfer element contained in the media changer. The first element is

0020h.

Defines the total number of data transport elements contained in the media changer. The SuperLoader 3 contains 1.

Transport Geometry Parameters Page 2

The transport geometry parameters page defines whether each medium transport element of a media changer is a member of a set of elements that share a common robotics subsystem and whether the element is capable of media rotation. One transport geometry descriptor is transferred for each medium transport element, beginning with the first medium transport element. None of the fields in the page are changeable.

Quantum SuperLoader 3 Software Interface Guide 58

Chapter 2 Media Changer Commands

Mode Sense (6) / (10) Command (1Ah/ 5Ah)

Figure 40 Transport Geometry Parameters Page

Bit Byte 7 6 5 4 3 2 1 0

2-n

PS (0) RSVD Page Code (1Eh)

Parameter Length (02h)

Transport Geometry Descriptor(s)

The geometry of each medium transport element is defined using a twobyte field as defined in figure 41

Figure 41 Transport Geometry Descriptor

Bit Byte 7 6 5 4 3 2 1 0

0 Reserved Rotate

1 Member Number In Transport Element Set

Table 29 Transport Geometry Parameters Page

Field Name Description

Parameter length

Specifies the number of bytes of transport geometry descriptors to follow. This field has a value of 2.

Rotate This bit is sent as 0. Rotation of the medium

transport element is not supported.

Member Number in

This field is sent as 0. There is only one medium

transport element and robotic subsystem. Transport Element Set

Quantum SuperLoader 3 Software Interface Guide 59

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.

Figure 42 Device Capabilities Page

Bit Byte 7 6 5 4 3 2 1 0

PS (0) SPF (0) Page Code (1Fh)

Parameter Length (12h)

Reserved STORDT

(1)

STORI/E

(0)

Reserved

Reserved MT->DT

(1)

MT->I/E

(0)

STORST

(1)

MT->ST

(1)

STORMT

MT->MT

(1)

Reserved ST->DT

(1)

Reserved I/E->DT

(0)

Reserved DT->DT

8-11

(1)

Reserved

Reserved MT<>DT

(0)

Reserved ST<>DT

Quantum SuperLoader 3 Software Interface Guide 60

(0)

ST->I/E

(0)

I/E->I/E

(0)

DT->I/E

(0)

MT<>I/E

(0)

ST<>I/E

(0)

ST->ST

(1)

I/E->ST

(0)

DT->ST

(1)

MT<>ST

(0)

ST<>ST

(0)

ST->MT

(1)

I/E->MT

(0)

DT->MT

(1)

MT<>MT

(0)

ST<>MT

(0)

Chapter 2 Media Changer Commands

Mode Sense (6) / (10) Command (1Ah/ 5Ah)

Bit Byte 7 6 5 4 3 2 1 0

Reserved I/E<>DT

Reserved DT<>DT

16-19

Table 30 Device Capabilities Page

(0)

I/E<>I/E

(0)

DT<>I/E

(0)

I/E<>ST

(0)

DT<>ST

(0)

I/E<>MT

(0)

DT<>MT

(0)

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 element type abbreviations.

Field Name Description

Parameters Savable. This bit is reserved for MODE SELECT

supported and must be 0 for

and must be 0. Saved parameters are not

MODE SENSE.

SPF A SubPage Format bit set to zero indicates that the

subpage format is not used for this page.

STORXX These bits are sent as 1 for all element types to indicate

that each element type provides storage for a unit of media.

XX->YY These bits are sent as 1 for all element types to indicate

that the media changer supports all

MOVE MEDIUM

commands between all types of elements.

XX<>YY These bits are sent as 0 to indicate that the media

changer does not support the

EXCHANGE MEDIUM

command for any combination of element types.

Quantum SuperLoader 3 Software Interface Guide 61

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.

Figure 43 Extended Device Capabilities Page

Bit

Byte76543210

PS (0) SPF (1) Page Code (1Fh)

SubPage Code (41h)

(MSB)

2-3

Page Length (10h)

(LSB)

Reserved

Reserved DTEDA RSSEA

MVPRV

MVCL MVOP USRCL USROP IEST

MVTRY

IEMGZ SMGZ

9-19

Quantum SuperLoader 3 Software Interface Guide 62

Reserved TREXC LCKIE LCKD

Reserved SPMER

DPMER

PEPOS

Reserved UCST

Reserved

Table 31 Extended Device Capabilities Page

Field Name Description

Chapter 2 Media Changer Commands

Mode Sense (6) / (10) Command (1Ah/ 5Ah)

PS The parameters savable (

command. This bit is reserved with the

PS) bit is only used with the MODE SENSE

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.

SPF A SubPage Format (

SPF) bit set to one indicates that the subpage mode

page format is being used.

MVPRV A move prevented to import/export element (MVPRV) bit set to one

indicates that the media changer prevents moves with the import/export element as destination element address when medium removal is prevented with the

PREVENT ALLOW MEDIUM REMOVAL command. An

MVPRV bit set to zero indicates that the media changer does not prevent moves with the import/export element as destination element address when medium removal is prevented with the

REMOVAL

command.

PREVENT ALLOW MEDIUM

MVCL A move closes import/export element (MVCL) bit set to one indicates

that the media changer will closes the import/export element whenever a command is issued to move media from an open import/export element. An MVCL bit set to zero indicates that the media changer does not close the import/export element whenever a command is issued to move media from an open import/export element.

MVOP A move opens import/export element (MVOP) bit set to one indicates

that the media changer opens the import/export element for operator access whenever a command is issued to move media with an import/ export element as a destination element address. An MVOP bit set to zero indicates that the media changer does not open the import export element for operator access whenever a command is issued to move media with an import/export element as a destination element address.

USRCL A user control import/export element close (USRCL) bit set to one

indicates that the media changer requires the operator to manually close an open import/export element. An USRCL bit set to zero indicates that the media changer does not require the operator to manually close an open import/export element.

Quantum SuperLoader 3 Software Interface Guide 63

Chapter 2 Media Changer Commands

Mode Sense (6) / (10) Command (1Ah/ 5Ah)

Field Name Description

USROP A user control import/export element open (USROP) bit set to one

indicates that the media changer requires the operator to manually open a closed import/export element. An USROP bit set to zero indicates that the media changer does not require the operator to manually open a closed import/export element.

IEST An import/export element state (IEST) bit set to one indicates that the

media changer is able to detect medium presence in all import/export elements. An IEST bit set to zero indicates that the media changer is not able to detect medium presence in all import/export elements.

DTEDA A data transfer element empty on door access (DTEDA) bit set to one

indicates that the media changer requires all data transfer elements not contain media before access via the door is possible. A DTEDA bit set to zero indicates that the door may be opened while data transfer elements contain media.

RSSEA A return to source storage element address (RSSEA) bit set to one

indicates that the media changer requires the application client to return the medium to the element address specified in the SOURCE STORAGE ELEMENT ADDRESS field. An RSSEA bit set to zero indicates that the application client does not need to return the medium to the element address specified in the SOURCE STORAGE ELEMENT ADDRESS field.

MVTRY A move tray (MVTRY) bit set to one indicates that the media changer

uses removable trays in its elements, which requires the medium to be placed in a tray and the tray moved to the desired position. An MVTRY bit set to zero indicates that the media changer does not use trays in its elements.

IEMGZ An import/export magazine (IEMGZ) bit set to one indicates that the

media changer uses medium magazines for some import/export elements. An IEMGZ bit set to zero indicates that the media changer does not use medium magazines for any import/export element.

SMGZ A storage magazine (SMGZ) bit set to one indicates that the media

changer uses medium magazines for some storage elements. A SMGZ bit set to zero indicates that the media changer does not use medium magazines for any storage element.

Quantum SuperLoader 3 Software Interface Guide 64

Chapter 2 Media Changer Commands

Mode Sense (6) / (10) Command (1Ah/ 5Ah)

Field Name Description

TREXC A true exchange capable (TREXC) bit set to one indicates that the media

changer allows an

EXCHANGE MEDIUM command that has the second

destination element address equal to the source element address. A TREXC bit set to zero indicates that the media changer does not allow an

EXCHANGE MEDIUM command that has the second destination element

address equal to the source element address.

LCKIE A lock import/export element (LCKIE) bit set to one indicates that the

PREVENT ALLOW MEDIUM REMOV AL command with the PREVENT field

set to 01b secures the media changer import/export element(s). An LCKIE bit set to zero indicates that the

REMOVAL

command with the PREVENT field set to 01b does not secure

PREVENT ALLOW MEDIUM

the media changer import/export element(s).

LCKD A lock door (LCKD) bit set to one indicates that the

MEDIUM REMOVA L

command with the PREVENT field set to 01b secures

PREVENT ALLOW

the media changer door(s). An LCKD bit set to zero indicates that the

PREVENT ALLOW MEDIUM REMOV AL command with the PREVENT field

set to 01b does not secure the media changer door(s).

SPMER A source pre-move eject required (SPMER) bit set to one indicates that

the media changer requires the application client to send an explicit command to the data transfer element to eject the medium before the media changer is able to move the medium from the data transfer element. A SPMER bit set to zero indicates that the application client does not need to send an explicit command to the data transfer element to eject the medium before the media changer is able to move the medium from a data transfer element.

DPMER A destination pre-move eject required (DPMER) bit set to one indicates

that the media changer requires the application client to send an explicit command to the data transfer element to extend the drive mechanism before the media changer is able to move the medium to the data transfer element. (e.g. a CD-ROM changer that requires the tray to be presented before the

MOVE MEDIUM operation starts). A DPMER bit set to zero

indicates that the application client does not need to send an explicit command to the data transfer element before the media changer is able to move the medium to the data transfer element.

Quantum SuperLoader 3 Software Interface Guide 65

Chapter 2 Media Changer Commands

Mode Sense (6) / (10) Command (1Ah/ 5Ah)

Field Name Description

PEPOS An pre-eject position (PEPOS) bit set to one indicates that the media

changer requires a

POSITION TO ELEMENT command to position the

medium transport element to a data transfer element before an eject (see SSC-3). An PEPOS bit set to zero indicates that the media changer does not require a

POSITION TO ELEMENT command to position the medium

transport element to a data transfer element before an eject.

UCST An unassigned cleaning storage (UCST) bit set to one indicates that the

device server does not assign element addresses to the physical entities that contain cleaning media. These unassigned physical entities are not reported in the

READ ELEMENT STATUS data. A UCST bit set to zero

indicates that the device server assigns element addresses to physical entities that contain cleaning media.

Quantum SuperLoader 3 Software Interface Guide 66

Chapter 2 Media Changer Commands

Move Medium Command (A5h)

The MOVE MEDIUM command requests that the SuperLoader 3 move a volume from a source element to a destination element.

Figure 44 Move Medium Descriptor Block

Bit Byte7654321 0

2-3

4-5

6-7

8-9

Operation Code (A5h)

Logical Unit Number Reserved

(MSB)

Medium Transport Address

(LSB)

(MSB)

Source Address

(LSB)

(MSB)

Destination Address

(LSB)

Reserved

Reserved INV

Unused Reserved Flag Link

Quantum SuperLoader 3 Software Interface Guide 67

Chapter 2 Media Changer Commands

Move Medium Command (A5h)

If the Source Address element is empty, the target shall return CHECK

CONDITION

additional sense code

Address

the target shall return

ILLEGAL REQUEST and the additional sense code Medium Destination Element Full

status. The sense key shall be ILLEGAL REQUEST and the

Medium Source Element Empty. If the Destination

element is full, and different from the Source Address element,

CHECK CONDITION status. The sense key shall be

Table 32 Move Medium Command

Field Name Description

Medium Transport Address

Source Address Destination Address

Must be set to 0. Specifies the medium transport element that is to be used in executing this command.

These fields can be any valid element address. If it is not valid, the media changer shall return

CHECK CONDITION status. The sense key shall be ILLEGAL REQUEST and the additional sense code INVALID ELEMENT ADDRESS.

INV Must be set to 0. Inverting and rotating are not

supported.

The device capabilities MODE SENSE page provides a matrix with the supported source element or destination element combinations for the

MOVE MEDIUM command.

Quantum SuperLoader 3 Software Interface Guide 68

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)

The following figure illustrates the format of the

command; the table that follows explains the data fields of the

command.

Figure 45 Persistent Reserve In Descriptor Block

Bit Byte765 43210

2 - 6

7 – 8

Reserved Service Action

(MSB)

Unused Reserved Flag Link

Operation Code (5Eh)

Reserved

Allocation Length

PERSISTENT RESERVE

(LSB)

Quantum SuperLoader 3 Software Interface Guide 69

T ab le 33 Persistent Reserve

In Command

Field Name Description

Chapter 2 Media Changer Commands Persistent Reserve In Command (5Eh)

Note: The original SCSI specification allowed users to specify the

LUN (Logical Unit Number) in bits 7 - 5 in byte 1. Systems still set the LUN on the initial

INQUIRY when talking to a newer

than SCSI-2 device. There are systems/drivers in the field that set the legacy LUN field in all CDBs. HP drives ignore the legacy LUN field in all CDBs that identify bits 7 - 5 in byte 1 as reserved. These values will vary depending on the drive type.

Service Action

Service actions that require information about persistent reservation and registrations may require enabling of nonvolatile memory within the logical unit.

Service action codes available are:

Code Name Description

00h Read Keys Reads all registered reservation keys

01h Read Reservations Reads all current persistent reservations

02-1Fh Reserved Reserved

Read Keys service action requests that the device server return a parameter

list that includes a header and a complete list of all of the reservation keys currently registered with the device server. If multiple initiators have registered with the same key, then the key is listed multiple times, once for each registration. Refer to figure 46

and table 34 for information about Read Keys

parameter data.

Read Reservation service action requests that the device server return a

parameter list that contains a header and a complete list of all persistent reservations that are presently active in the device server. Refer to figure 47 page 73 and table 35

on page 73 for information about Read Reservations

parameter data.

Quantum SuperLoader 3 Software Interface Guide 70

Field Name Description

Chapter 2 Media Changer Commands Persistent Reserve In Command (5Eh)

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. If it is determined that the remainder of the list is required, the client should send a new

RESERVE IN

command with an Allocation Length field large enough to contain

PERSISTENT

the entire list of parameters.

The figure and table below illustrate and describe the data fields of Read

Key

data parameters.

Figure 46 Read Keys Parameters

Bit Byte76543210

(MSB)

0 - 3

Generation

(LSB)

(MSB)

4 - 7

Additional Length (n – 7)

(LSB)

(Reservation Key List Follows in Bytes 8 – n)

(MSB)

8 - 15

First Reservation Key

(LSB)

•••

Quantum SuperLoader 3 Software Interface Guide 71

Chapter 2 Media Changer Commands Persistent Reserve In Command (5Eh)

Bit Byte76543210

(MSB)

n – 7 to n

Table 34 Read Keys

Last Reservation Key

(LSB)

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

Register, Clear, Pre-empt, or Pre-empt and Clear operation. Note that PERSISTENT RESERVE IN commands do not increment the counter, nor do PERSISTENT RESERVE OUT commands that perform a Reserve or Release

PERSISTENT RESERVE OUT command requests a

service action, or by a PERSISTENT RESERVE OUT command that is not done due to an error or a reservation conflict. The value in the

Generation field is set

to 0 as part of the power on or reset processes.

The value in the

Generation field allows the application client that examines

the value to verify that the configuration of the initiators attached to a logical unit has not been modified by another application client without any notification of the application client doing the examination.

Additional Length

Reservation Keys

This field contains the count of the number of bytes that are in the

Key

list (bytes 8 – n). Note that this field contains the number of bytes in the reservation key list regardless of the value prescribed by the field in the command’s

Each of the

Reservation Keys appear as items in a list as bytes 8 through n.

CDB.

Reservation

Allocation Length

Each entry reflects an 8-byte reservation key registered with the device server via the

Key

PERSISTENT RESERVE OUT, Register or Register and Ignore Existing

service actions. Each key can be examined by the application client for correlation with a set of initiators and SCSI ports.

The following figure and table illustrate and describe the data fields of

Read Reservations data parameters.

Quantum SuperLoader 3 Software Interface Guide 72

Chapter 2 Media Changer Commands Persistent Reserve In Command (5Eh)

Figure 47 Read Reservations Parameters

Bit Byte76543210

(MSB)

0 - 3

Generation

(MSB)

4 - 7

Additional Length (n – 7)

(MSB)

8 - n

T able 35 Read Reservations

Reservation Descriptors

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

service action, or by a due to an error or a reservation conflict. The value in the

PERSISTENT RESERVE OUT command requests a

PERSISTENT RESERVE OUT command that is not done

Generation field is set

to 0 as part of the power on or reset processes.

(LSB)

The value in the

Generation field allows the application client that examines

Quantum SuperLoader 3 Software Interface Guide 73

Field Name Description

Chapter 2 Media Changer Commands Persistent Reserve In Command (5Eh)

Additional Length

Reservations Descriptors

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

One

Reservation descriptor is reported for each unique persistent reservation

on the logical unit when the a

Read Reservations action. Figure 48 and table 36 detail the contents of each

Reservation Descriptors field.

Allocation Length field in the command’s CDB.

PERSISTENT RESERVE IN command has indicated

The figure and table below illustrate and describe the data fields of each

Read Reservations descriptor’s data fields.

Figure 48 Persistent Reserve In Read Reservations

Bit Byte76543210

(MSB)

0 - 7

Reservation Key

(LSB)

(MSB)

8 - 11

Scope-Specific Address

(LSB)

Scope Type

14 - 15

Quantum SuperLoader 3 Software Interface Guide 74

Reserved

Obsolete

T able 36 Persistent Reserve In Read Reservations Descriptor

Field Name Description

Chapter 2 Media Changer Commands Persistent Reserve In Command (5Eh)

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. The SuperLoader 3 does not support reservations of elements, so this field is always 0.

Scope The value in this field indicates whether a persistent reservation applies

to an entire logical unit, to a part of the logical unit (defined as an extent), or to an element.

The values for the Scope field are:

Code Name Description

0h LU Logical Unit. Persistent reservation applies to the

full logical unit. The LU scope is therefore implemented by all device servers that implement

PERSISTENT RESERVE OUT.

1h Obsolete

2h Element Persistent reservation applies to an element.

Reservations of elements. Is not supported.

3h - Fh Reserved Reserved

Type The value of the Type field specifies the characteristics of the persistent

reservation being established for all data blocks within the extent or within the logical unit. Refer to table 39

on page 87 for the applicable

Type codes and their meanings.

The following table describes the available “Type” values from the Type field of the

Each of the codes provides handling instructions for

WRITE operations, and for subsequent attempts to establish persistent

reservations, referred to as “

Quantum SuperLoader 3 Software Interface Guide 75

PERSISTENT RESERVE IN Read Reservations parameters.

READ operations, for

Additional Reservations Allowed” in the table.

Table 37 Persistent Reservation Type Codes

Code Name Description

0h Obsolete

Chapter 2 Media Changer Commands Persistent Reserve In Command (5Eh)

1h WRITE

Exclusive

2h Obsolete

3h Exclusive

Access

READS: Shared; any application client on any initiator may execute

commands that perform transfers from the target to the initiator.

WRITES: Exclusive; any command from any initiator other than the

initiator that holds the persistent reservation that attempts a transfer to the target results in a reservation conflict

ADDITIONAL RESERVATIONS: Allowed; any initiator may reserve

the logical unit, extents, or elements as long as the persistent reservations do not conflict with any reservations already known to the device server.

READS: Exclusive; any command from any initiator other than the

initiator holding the persistent reservation that attempts a transfer from the target results in a reservation conflict.

WRITES: Exclusive; any command from any initiator other than the

initiator holding the persistent reservation that attempts a transfer to the target results in a reservation conflict.

ADDITIONAL RESERVATIONS: Restricted; any PERSISTENT RESERVE OUT

command with the Reserve service action from any initiator other than the initiator holding the persistent reservation results in a reservation conflict. The initiator that holds the persistent reservation can reserve the logical unit, extents, or elements as long as the persistent reservations do not conflict with any reservations already known to the device server.

4h Obsolete

Quantum SuperLoader 3 Software Interface Guide 76

Code Name Description

Chapter 2 Media Changer Commands Persistent Reserve In Command (5Eh)

5h WRITE

Exclusive,

Registrants Only

6h Exclusive

Access,

Registrants Only

READS: Shared; any application client on any initiator may execute

commands that perform transfers from the target to the initiator.

WRITES: Exclusive; any command from an initiator that has not

previously performed a

server that attempts a transfer to the target results in a reservation conflict

ADDITIONAL RESERVATIONS: Allowed; any initiator may reserve

the logical unit, extents, or elements as long as the persistent reservations to not conflict with any reservations already known to the device server.

READS: Exclusive; any command from an initiator that has not

previously performed a Register service action with the device server that attempts a transfer from the target results in a reservation conflict.

WRITES: Exclusive; any command from an initiator that has not

previously performed a Register service action with the device server that attempts a transfer to the target results in a reservation conflict

ADDITIONAL RESERVATIONS: Allowed; any initiator may reserve

the logical unit, extents, or elements as long as the persistent reservations to not conflict with any reservations already known to the device server.

7h-Fh Reserved Not applicable

Quantum SuperLoader 3 Software Interface Guide 77

Chapter 2 Media Changer Commands

Persistent Reserve Out Command (5Fh)

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 command; it is not used with the

RESERVE and RELEASE commands.

PERSISTENT RESERVE IN

Persistent reservations conflict with reservations made via the command. Initiators that perform

PERSISTENT RESERVE OUT actions are

RESERVE

identified by a reservation key assigned by the application client. The client may use the

PERSISTENT RESERVE IN command to identify which

other initiators within a system hold conflicting or invalid persistent reservations and use the

PERSISTENT RESERVE OUT command to

preempt those reservations if necessary.

Note that since persistent reservations are not reset by the

T ARGET RESET

task management function or other global actions, they can be used to enact device sharing among multiple initiators. The

RESERVE OUT

and PERSISTENT RESERVE IN commands provide the

PERSISTENT

means for resolving contentions in multiple-initiator systems with multiple port target. By using the reservation key to identify persistent reservations, it is possible to determine which ports hold conflicting persistent reservations and to take over such reservations from failing or “greedy” initiators.

Note: Support for Persistent Reserve is drive type dependent. See

individual drive documentation for complete details.

The following figure illustrates the format of the

OUT

command; the table that follows explains the data fields of the

PERSISTENT RESERVE

command.

Quantum SuperLoader 3 Software Interface Guide 78

Chapter 2 Media Changer Commands

Persistent Reserve Out Command (5Fh)

Figure 49 Persistent Reserve Out Descriptor

Bit Byte765 43210

3 - 6

Reserved Service Action

Scope Type

Operation Code (5Fh)

Reserved

(MSB)

7 – 8

Figure 50 Persistent Reserve Out Command

Unused Reserved Flag Link

Parameter List Length (18h)

Field Name Description

Service Action Service actions that require information about persistent reservation and

registrations may require enabling of nonvolatile memory within the logical unit.

(LSB)

Service action codes available are:

Code Name Description

00h Register Register a reservation key with the device server

01h Reserve Create a persistent reservation using a

reservation key

02h Release Release a persistent reservation

03h Clear Clear all reservation keys and all persistent

reservations

Quantum SuperLoader 3 Software Interface Guide 79

Field Name Description

04h Pre-empt Pre-empt persistent reservations from another

Chapter 2 Media Changer Commands

Persistent Reserve Out Command (5Fh)

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

07-1Fh Reserved Reserved

(HP drives support Service Action 07h - Register and Move)

Refer to table 40

on page 89 for detailed descriptions of each of the service

action codes.

Scope The value in this field indicates whether a persistent reservation applies to

an entire logical unit or to an element.

The values for the Scope field are:

Code Name Description

0h LU

Logical Unit. Persistent reservation applies to the

full logical unit. The LU scope is therefore implemented by all device servers that implement

PERSISTENT RESERVE OUT.

1h Obsolete

2h Element Persistent reservation applies to the specified

element. When Element is the scope, it indicates that the persistent reservation applies to the element of the logical unit defined by the ScopeSpecific Address field in the

RESERVE OUT

parameter list. Element

PERSISTENT

reservations are not supported.

3h–3F Reserved Reserved

Quantum SuperLoader 3 Software Interface Guide 80

Field Name Description

Chapter 2 Media Changer Commands

Persistent Reserve Out Command (5Fh)

Type The value of the

reservation being established for all data blocks within the extent or within the logical unit. Refer to table 37 and their meanings. (HP drives only support

Parameter List Length

Fields contained in the the reservation keys and extent information required to perform a persistent reservation service action.

The parameter list is 24 bytes in length; the contains 24 (18h) bytes.

The following table provides detailed descriptions of each of the

PERSISTENT RESERVE OUT command’s seven possible service actions. Service Action Codes appear in bits 0–4 of Byte 1.

Type field specifies the characteristics of the persistent

on page 76 for the applicable Type codes

Type codes 3h, 6h, and 8h.)

PERSISTENT RESERVE OUT parameter list specify

Parameter List Length field

Quantum SuperLoader 3 Software Interface Guide 81

Table 38 Persistent Reserve Out Command Service Action

Code Name Description

Chapter 2 Media Changer Commands

Persistent Reserve Out Command (5Fh)

00h Register When the command executes a

reservation key with a device server without generating a reservation. The device server holds these reservation keys from each initiator that performs a

PERSISTENT RESERVE OUT command with a Register service

action until the key is changed by a new command with Register service action from the same initiator, or until the initiator registration is removed by:

Powering down the logical unit, if the last

Loss

(APTPL; see figure 51 on page 88 and table 40 on page 89) received

by the device server was 0;

Performing a

Clear service action; Pre-empt service action; Pre-empt and Clear service action; or Register service action from the same initiator with the

value of the service action reservation key set to 0.

When a reservation key has not yet been established or when the reservation key has been removed, a reservation key of 0 is used when the initiator performs a

PERSISTENT RESERVE OUT with the Register service

action. When the reservation has been removed, no information is reported for the initiator in the

PERSISTENT RESERVE IN command.

PERSISTENT RESERVE OUT

Activate Persist Through Power

Read Keys service action of the resulting

01h Reserve A

PERSISTENT RESERVE OUT command with Reserve service action

creates a persistent reservation with a specified

Scope and Type.

Persistent reservations are not superseded by a new persistent reservation from any initiator except by the execution of a command that specifies a

Release, Clear, Pre-empt, or Pre-empt and Clear

PERSISTENT RESERVE OUT

service action.

Quantum SuperLoader 3 Software Interface Guide 82

Chapter 2 Media Changer Commands

Persistent Reserve Out Command (5Fh)

Code Name Description

02h Release A PERSISTENT RESERVE OUT command with Release service action

removes a persistent reservation held by the same initiator.

The fields associated with a active persistent reservation. Sending of a command that specifies a

Release service action match fields of the

PERSISTENT RESERVE OUT

Release service action when no persistent

reservation exists from that initiator does not result in an error. Instead, the device server returns a reservation: the reservation key is not changed by the

GOOD message without altering any other

Release service

action.

The device server returns a

PERSISTENT RESERVE OUT command that specifies the release of a

CHECK CONDITION status for any

persistent reservation held by the requesting initiator that does not match the

Scope and Type. The sense key is set to ILLEGAL REQUEST and

additional sense data is set to

RESERVATION

of the

Scope, Type, Reservation Key, and extent values match an existing

. Attempts to release persistent reservations in which none

INVALID RELEASE OF ACTIVE PERSISTENT

persistent reservation held by the initiator making the request are not errors.

An active persistent reservation may also be released by:

Powering off. When the most recent APTPL value received by the device

server is 0, a power-off performs a hard reset, clears all persistent reservations, and removes all registered reservation keys; or

Executing a with a persistent reserve service action of

Clear.

Note that a

PERSISTENT RESERVE OUT command from another initiator

Clear, Pre-empt, or Pre-empt and

Release service action should not be performed if any

operations interlocked by the persistent reservation have not yet completed.

Powering off. When the most recent APTPL value received by the device

server is 0, a power-off performs a hard reset, clears all persistent reservations, and removes all registered reservation keys; or

Executing a with a persistent reserve service action of

Clear.

Note that a

PERSISTENT RESERVE OUT command from another initiator

Clear, Pre-empt, or Pre-empt and

Release service action should not be performed if any

operations interlocked by the persistent reservation have not yet completed.

Quantum SuperLoader 3 Software Interface Guide 83

Chapter 2 Media Changer Commands

Persistent Reserve Out Command (5Fh)

Code Name Description

03h Clear A PERSISTENT RESERVE OUT command with a successful Clear service

action removes all persistent reservations for 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.

UNIT A TTENTION condition is established for all registered initiators for

the logical unit. The sense key is set to sense data is set to

RESERVATIONS PREEMPTED.

UNIT ATTENTION; the additional

Note that applications should not use the during recoveries associated with initiator or system reconfiguration, since data integrity may be compromised.

04h Pre-empt A

service action removes all persistent reservations for all initiators that have been registered with the Service action Reservation key specified in the reservation is also established for the pre-empting initiator. Any commands from any initiator that have been accepted by the device server as non-conflicting continue their normal executions. If a

RESERVE OUT

and no persistent reservation exists for the initiator identified by the

Service action Reservation key, it is not an error condition.

A The sense key is set to

RESERVATIONS PREEMPTED. Commands that follow are subject to the

persistent reservation restrictions set by the pre-empting initiator.

Clear action service except

PERSISTENT RESERVE OUT command with a successful Pre-empt

PERSISTENT RESERVE OUT command’s parameter list. A persistent

PERSISTENT

command is sent that specifies a Pre-empt service action

UNIT A TTENTION condition is established for the pre-empted initiators.

UNIT ATTENTION; the additional sense data is set to

Quantum SuperLoader 3 Software Interface Guide 84

Quantum superloader 3 User's Guide

Specifications and Main Features

Frequently Asked Questions

User Manual

Preface

1Theory of Operation

SuperLoader 3

Medium Changer Elements

Events

Medium Transport Element 1

Data Transfer Element 1

Storage Elements 1

Power Cycle 1

SuperLoader 3 Offline 1

Magazine Insertion/ Removal 1

Maximum Temperature Exceeded 1

Automatic Drive Cleaning

Element Status Information 1

Automatic Cleaning Operation 1

2Media Changer Commands

Overview of Command and Status Processing

Media Changer Command Descriptions

Initialize Element Status Command (07h)

Inquiry Command (12h)

Standard Inquiry Data Page 2

Vital Product Data Page 2

Supported Vital Product Data Page 2

Command Support Data2

Load Unload Command (1Bh)

Log Sense Command (4Dh)

Supported Pages Log Page (00h) 2

Last n Error Events Page (07h) 2

TapeAlert Page (2Eh) 2

Move Statistic s Page (30h) 2

Hard/Soft Error Statistics Page (31h) 2

Device Wellness Page (33h) 2

Device Status Page (3Eh)2

Mode Select (6) / (10) Command (15h / 55h)

Mode Parameter List 2

Mode Parameter Header 2

Mode Parameter Block Descriptor 2

Mode Page Descriptors 2

Mode Sense (6) / (10) Command (1Ah/ 5Ah)

Mode Sense Data Headers 2

Mode Sense Mode Pages2

TapeAlert Page (1Ch) 2

Element Address Assignment Page 2

Transport Geometry Parameters Page 2

Device Capabilities Page 2

Extended Device Capabilities Page 2

Move Medium Command (A5h)

Persistent Reserve In Command (5Eh)

Persistent Reserve Out Command (5Fh)