Quantum ATL SuperLoader ATL User Manual Download

Page: 16 / 196

Preface
Purpose

xvi

Quantum ATL SuperLoader Software Interface Guide

Purpose

This interface guide describes the procedures and issues involved

in the development of software applications and utilities to

communicate with the Quantum ATL SuperLoader.
• SCSI interfaces
• SCSI Messages
• Media Changer Commands

Organization

This reference manual is organized as follows:
•

Chapter 1, Theory of Operation

describes differences between

the SuperLoader models, media changer elements, events, and

automatic drive cleaning.

•

Chapter 2, Messages

describes the SCSI messages supported by

the SuperLoader.

•

Chapter 3, Media Changer Commands

describes the SCSI

protocol features implemented in the media changer.

Summary of Contents for ATL SuperLoader ATL

Page 1: ...ATL SuperLoader DLT and ATL SuperLoader LTO Software Interface Guide 81 60220 01 A02...

Page 2: ...se this publication from time to time without notice COPYRIGHT STATEMENT 2003 Quantum Corporation All rights reserved Your right to copy this manual is limited by copyright law Making copies or adapta...

Page 3: ...Theory of Operation 1 SuperLoader DLT 2 SuperLoader LTO 2 Medium Changer Elements 2 Medium Transport Element 3 Data Transfer Element 3 Storage Elements 3 Events 3 Power Cycle 4 SuperLoader Offline 4...

Page 4: ...Data Pointer 02h 20 Synchronous Data Transfer Request 01h 21 Wide Data Transfer Request Extended Message 03h 23 Chapter 3 Media Changer Commands 27 Overview of Command and Status Processing 27 Media...

Page 5: ...Combined Header and Data Mode 000b 122 Data Mode 0010b 123 Descriptor Mode 0011b 123 Read Data from Echo Buffer 1010b 123 Echo Buffer Descriptor Mode 1011b 124 Read Element Status Command B8h 126 Elem...

Page 6: ...re Interface Guide Write Buffer Command 3Bh 171 Write Combined Header and Data Mode 0000b 172 Write Data Mode 0010b 172 Download Microcode Mode 0100b 173 Download Microcode and Save Mode 0101b 173 Wri...

Page 7: ...est Message 24 Figure 6 Initialize Element Status Command 31 Figure 7 Inquiry Command 32 Figure 8 Inquiry Command 33 Figure 9 Standard Inquiry Data LTO 34 Figure 10 Standard Inquiry Data DLT 35 Figure...

Page 8: ...Device Wellness Log Sense 61 Figure 28 Device Status Log Sense Header 62 Figure 29 Parameters for Device Status Log Sense Page 63 Figure 30 Device Status Log Sense Page 0001h 64 Figure 31 Mode Select...

Page 9: ...Persistent Reserve Out Descriptor 102 Figure 55 Persistent Reserve Out Command 102 Figure 56 Persistent Reserve Out Parameter List 112 Figure 57 Position to Element Descriptor 116 Figure 58 Prevent Al...

Page 10: ...igure 78 LUN Reporting Parameter List 149 Figure 79 Request Sense Command Descriptor Block 151 Figure 80 Request Sense Command Data 151 Figure 81 Request Sense 152 Figure 82 Reserve Element 10 Descrip...

Page 11: ...e 17 Table 7 Response to Initiator Detected Error 18 Table 8 Transfer Rates 23 Table 9 Supported Media Changer Commands 28 Table 10 Standard Inquiry Data LTO and DLT 36 Table 11 Unit Serial Number Pag...

Page 12: ...Mode Select 6 10 Command Descriptor 68 Table 28 Mode Select Parameter List 69 Table 29 Mode Select Parameter Header 71 Table 30 Mode Select Parameter Block 72 Table 31 Mode Select Page Descriptor 73...

Page 13: ...53 Echo Buffer Descriptor 125 Table 54 Read Element Status Command Descriptor Block 127 Table 55 Element Status Data 129 Table 56 Medium Transport Element Descriptor 133 Table 57 Storage Element Desc...

Page 14: ...iv Quantum ATL SuperLoader Software Interface Guide Table 69 Set Device Identifier Command Descriptor Block 169 Table 70 Set Device Identifier Parameter List 169 Table 71 Write Buffer Command Data 172...

Page 15: ...about the intended audience purpose organization and document conventions Intended Audience 0 This interface guide is a written for the following audiences Original Equipment Manufacturers OEMs that...

Page 16: ...rLoader SCSI interfaces SCSI Messages Media Changer Commands Organization 0 This reference manual is organized as follows Chapter 1 Theory of Operation describes differences between the SuperLoader mo...

Page 17: ...wercase except where standard usage requires uppercase Mb megabits MB megabytes Acronyms Uppercase SCSI Binary Notation Number followed by lowercase b 101b Commands Uppercase unless case sensitive FOR...

Page 18: ...Preface Document Conventions xviii Quantum ATL SuperLoader Software Interface Guide...

Page 19: ...lity 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 de...

Page 20: ...r each reside on a unique ID The media changer device supports narrow and wide asynchronous data transfers only The tape drive device supports narrow and wide synchronous and asynchronous data transfe...

Page 21: ...SuperLoader Data Transfer Element 1 The SuperLoader is configured with a single tape drive Storage Elements1 All of the storage elements within the SuperLoader are contained within removable magazine...

Page 22: ...he front panel or On board Remote Management in such a way that would cause conflict with a SCSI command the SuperLoader is put into an offline state If a SCSI command is received while in this offlin...

Page 23: ...perLoader will disable all movement until the temperature decreases below a safe threshold While the temperature remains excessive SCSI commands that require movement will fail SK 04 ASC 0B ASCQ 01 Au...

Page 24: ...ing cartridge and will attempt to use it as such The SuperLoader 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 expi...

Page 25: ...he SCSI host If an unrecoverable error occrus when moving a cleaning cartridge that prevents a subsequent host initiated command from completing a check condition will be set in the returned status by...

Page 26: ...Chapter 1 Theory of Operation Automatic Drive Cleaning 8 Quantum ATL SuperLoader Software Interface Guide...

Page 27: ...be one or more bytes in length One or more messages can be sent during a single MESSAGE phase but a message cannot be split over MESSAGE phases The initiator is required to end the MESSAGE OUT phase...

Page 28: ...table 1 determines the format of the message Table 1 Message Format The SuperLoader supports the messages listed in table 2 The message code and the direction of the message flow is also included in t...

Page 29: ...extended message The minimum number of bytes sent for an extended message is three The extended message format is shown in figure 1 and the data fields are described in table 3 EXTENDED MESSAGE Synch...

Page 30: ...ield Description Extended Message Length This field specifies the length in bytes of the Extended Message Code plus the Extended Message Arguments that follow Therefore the total length of the message...

Page 31: ...r If no unit has been selected the target goes to BUS FREE phase and no commands data or status on the target are affected If a command that causes movement of the media changer has started the moveme...

Page 32: ...T and enters its STATUS phase reporting CHECK CONDITION with the sense key set to COMMAND ABORTED Disconnect 04h 2 The DISCONNECT message is sent from the SuperLoader to inform the initiator that the...

Page 33: ...US FREE COMMAND The SuperLoader discards the DISCONNECT message and goes to BUS FREE The ATTENTION request is ignored while the Command Descriptor Block is fetched The SuperLoader does not switch to M...

Page 34: ...cription Identify The Identify bit must be set to 1 This identifies the message as an IDENTIFY message DiscPriv Disconnect Privilege The DiscPriv can be 0 provided that no other I O process is current...

Page 35: ...The source of the error may either be related to previous activities on the SCSI bus or may be only SuperLoader related When received the SuperLoader attempts to re transfer the last command data or s...

Page 36: ...etched from the initiator sets the Sense Key to ABORTED COMMAND sets the Additional Sense Code to INITIATOR DETECTED ERROR MESSAGE RECEIVED It sends the CHECK CONDITION status and the COMMAND COMPLETE...

Page 37: ...ch message has the parity error If the target receives this message under any other condition it proceeds directly to the BUS FREE state by releasing the BSY signal signifying a catastrophic error The...

Page 38: ...orresponding current pointers The command and status pointers are restored to the beginning of the present command and status areas The data pointer is restored to the value at the beginning of the da...

Page 39: ...st Message A SYNCHRONOUS DATA TRANSFER REQUEST message exchange is initiated by a SCSI device whenever a previously arranged transfer width agreement may have become invalid The agreement becomes inva...

Page 40: ...ransfer agreement If a synchronous data transfer agreement is in effect then after accepting a WIDE DATA TRANSFER REQUEST message it resets the synchronous agreement to asynchronous mode If the Transf...

Page 41: ...than 62 will cause the device to return a request for 62 The SuperLoader DLT1 Transfer REQ ACK offset may be any value between 0 and 15 A value of 0 indicates asynchronous transfers A request with a v...

Page 42: ...reement between two SCSI devices on the width of the data path to be used for DATA phase transfer between them This agreement applies to DATA IN and DATA OUT phases only All other information transfer...

Page 43: ...erface Guide 25 The transfer width is expressed as 2n where n is the transfer width in bytes The transfer width that is established applies to all logical units Valid transfer widths for the SuperLoad...

Page 44: ...Chapter 2 Messages Supported SCSI Messages 26 Quantum ATL SuperLoader Software Interface Guide...

Page 45: ...ns 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 Overview of Command and Status P...

Page 46: ...een implemented Please see individual command descriptions for the SCSI 3 features that have been implemented The SuperLoader device supports the Media Changer commands listed in table 9 Table 9 Suppo...

Page 47: ...in the example of the Parameter List Length field bytes 7 and 8 of the MODE SELECT command shown as follows Read Element Status Command B8h on page 126 B8h Release Element 10 Command 57h on page 140...

Page 48: ...ns 30 Quantum ATL SuperLoader Software Interface Guide 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 Bit...

Page 49: ...any other status relevant to that element address The intent of this command is to enable the Initiator to get a quick response from a subsequent READ ELEMENT STATUS command It may be useful to issue...

Page 50: ...ta in response to an INQUIRY command Standard Inquiry Data Vital Product Data and Command Support Data Standard Inquiry Data contains basic data about the device Vital Product Data comprises several p...

Page 51: ...e Standard Inquiry Data If EVPD 1 and CmdDt 0 the media changer returns the Vital Product Data Page specified by Page Code Operation Code Page Code or Operation Code Specifies the Vital Product Data P...

Page 52: ...MB Reserved 2 Version 3 AERC Obsolete NormACA HiSup Response Data Format 4 Additional Length n 4 5 SCCS Reserved 6 BQue EncServ Reserved MultiP MChngr Obsolete Obsolete Add16 7 RelAdr Obsolete Wbus16...

Page 53: ...0 0 Peripheral Qualifier Peripheral Device Type 1 RMB Device Type Modifier 2 ISO Version ECMA Version ANSI Version 3 AENC TrmlOP Reserved Response Data Format 4 Additional Length 27h 5 Reserved 6 Rsv...

Page 54: ...zero if initiator selects an invalid logical unit see below Peripheral Device Type 8 8 indicates that this is a media changer device RMB 1 Removable Medium Bit Set to 1 Device Type Modifier DLT 0 This...

Page 55: ...ueueing is not supported EncServ LTO 0 This device does not contain an embedded enclosure services component MultiP LTO 0 This device does not implement multi port requirements MChangr LTO 0 This devi...

Page 56: ...Identification of the product Product Revision Level hhss This field contains 4 bytes of ASCII data that provides the media changer s firmware revision level Language LTO This field indicates the lang...

Page 57: ...l Product Data Pages that are supported by the SuperLoader Figure 11 Supported Vital Product Data Figure 12 Unit Serial Number Page 80h Bit Byte 7 6 5 4 3 2 1 0 0 Peripheral Qualifier Peripheral Devic...

Page 58: ...Page 83h 2 Reserved 3 Page Length 0Eh 4 17 Serial Number Field Name Description Serial Number The serial number given is the serial number of the media changer typically starting with PM indicating th...

Page 59: ...eld Descriptions Bit Byte 7 6 5 4 3 2 1 0 0 Reserved Code Set 1 Reserved Association Identifier Type 2 Reserved 3 Identifier Length n 3 4 n Identifier Field Name Field Description Code Set Indicates t...

Page 60: ...e format of the command support data and definitions of the fields follow Value Description 1 Concatenation of the Vendor Name Product ID and unit serial number 2 Canonical form of the IEEE Extended U...

Page 61: ...Size m 5 6 n CDB Usage Data Field Name Description Support The value of the Support field describes the type of support that the tape drive provides for Command Support Data Value Description 000b Da...

Page 62: ...This field contains information about the CDB for the Operation Code being queried Note that the first byte of the CDB Usage Data contains the OpCode for the operation specified All of the other bytes...

Page 63: ...is command will eject the magazine s regardless of the setting via the PREVENT ALLOW MEDIUM REMOVAL command Figure 16 Load Unload Command Descriptor Block Table 15 Unload Command Descriptor Block Bit...

Page 64: ...the host to retrieve statistical information maintained by the media changer about its own hardware parameters Figure 17 LOG SENSE Command Descriptor Block Bit Byte 7 6 5 4 3 2 1 0 0 Operation Code 4D...

Page 65: ...AL REQUEST and an ASC of INVALID FIELD IN CDB PC Page Control This field defines the type of parameter values to be returned PC Type of Parameter Values 00b Threshold Values 01b Cumulative Values 10b...

Page 66: ...hen 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 init...

Page 67: ...ages Log Page Page 00h 3 When page 00h is requested the 4 byte page header is returned followed by the pages supported in ascending order one byte for each Figure 18 Supported Pages Page Bit Byte 7 6...

Page 68: ...sts of the ASCII text for the EEROM Hard Error Log Figure 19 Last n Error Events Log Sense Header Table 17 Last n Error Events Log Sense Header Bit Byte 7 6 5 4 3 2 1 0 0 Reserved Page Code 07h 1 Rese...

Page 69: ...vent n LSB 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 O...

Page 70: ...the flags for media changer devices as defined in SMC 2 The SuperLoader DLT only supports the reporting of the TapeAlert Log page on logical unit 0 It supports the combined drive and media changer fl...

Page 71: ...2 3 MSB 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...

Page 72: ...nnot be reset via SCSI or power cycle Log Parameters are not supported for this page Figure 23 Move Statistics Format 5n 2 Parameter Length 5n 3 Value of TapeAlert Flag Flag is set when Bit 0 1 Bits 1...

Page 73: ...L SuperLoader Software Interface Guide 55 2 3 MSB Page Length 18h LSB 4 7 MSB Total Moves LSB 8 11 MSB Drive Loads LSB 12 15 MSB Mail Slot Imports LSB 16 19 MSB Mail Slot Exports LSB 20 23 MSB Magazin...

Page 74: ...ge These numbers in relation to the total number of moves performed can provide an indication as to the health of the servo system Field Name Description Page Code The page code is 30h Page Length The...

Page 75: ...gure 24 Hard Soft Move Error Statistics Format Bit Byte 7 6 5 4 3 2 1 0 0 Reserved Page Code 31h 1 Reserved 2 3 MSB Page Length 22h LSB 4 5 MSB Servo Hard Errors LSB 6 9 MSB Drive Soft Error LSB 10 13...

Page 76: ...37 MSB 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 Erro...

Page 77: ...ense Key 9 Note that parameter code 000h contains the oldest log information while parameter 000Fh contains the most recent This page begins with a 4 byte header followed by the log parameter blocks F...

Page 78: ...26 Device Wellness Log Sense 0000h 000Fh Bit Byte 7 6 5 4 3 2 1 0 0 1 MSB Parameter Code LSB 2 DU DS TSD ETC TMC Rsv d LP 3 Parameter Length 0Ch 4 7 MSB Time Stamp LSB 8 9 LTO only MSB Source Element...

Page 79: ...Enable Threshold Comparison Threshold checking is not supported on this page Always set to 0 TMC Threshold Met Criteria Always 0 LP List Parameter Always set to 0 Parameter Length The number of bytes...

Page 80: ...ernal media identifier being used when check condition occurred 0 no media or unknown media when event occurred Note that this is not an applicable means of tracing media Source Element Destination El...

Page 81: ...e 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 de...

Page 82: ...eserved for media changer device and shall contain 0 0004h Vendor specific DU Disable Update Always 0 DS Disable Save Not supported This bit always set to 1 TSD Target Save Disable Not supported This...

Page 83: ...s indicate the temperature of the device This field follows the following format Bit 3 Bit 2 Description 0 0 Not supported 0 1 OK 1 0 Warning Safe temperature exceeded 1 1 Maximum temperature exceeded...

Page 84: ...rprets this information and then may issue MODE SELECT to set the media changer to the host s preferred configuration The Mode Parameter List described in Mode Parameter List on page 68 is passed from...

Page 85: ...ptor Figure 32 Mode Select 10 Command Descriptor Bit Byte 7 6 5 4 3 2 1 0 0 Operation Code 15h 1 Logical Unit Number PF Reserved SP 0 2 3 Reserved 4 Parameter List Length 5 Unused 00 Reserved Flag Lin...

Page 86: ...escription PF Page Format The Page Format bit indicates that the data sent by the host after the MODE SELECT header and block descriptors complies with the definition of pages in the SCSI 2 specificat...

Page 87: ...s that make up the MODE SELECT command s Mode Parameter header Bit Byte 7 6 5 4 3 2 1 0 0 7 Mode Parameter Header 8 15 Mode Parameter Block Descriptor Optional 8 n or 16 n Page s Optional Field Name D...

Page 88: ...Software Interface Guide Figure 35 Mode Select 6 Parameter Header Figure 36 Mode Select 10 Parameter Header Bit Byte 7 6 5 4 3 2 1 0 0 Reserved 1 Reserved 2 Reserved 3 Block Descriptor Length Bit Byte...

Page 89: ...arameter 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...

Page 90: ...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 Figure 38 Mode Select Page Descriptor Field Name Descriptio...

Page 91: ...cription PS Parameters Savable For the MODE SELECT 6 10 commands this field is reserved 0 Additional Page Length Indicates number of bytes in that page not including bytes 0 and 1 Page Defined or Vend...

Page 92: ...mand to MODE SELECT The command descriptor block for the 6 byte MODE SENSE 1Ah is shown below An illustration of the command descriptor block for the 10 byte MODE SENSE 5Ah follows on the next page Fi...

Page 93: ...gical Unit Number Rsv d DBD Reserved 2 PC Page Code 3 6 Reserved 7 8 MSB Allocation Length LSB 9 Unused Reserved Flag Link Field Name Description DBD Disable Block Descriptors This field is ignored Th...

Page 94: ...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 De...

Page 95: ...ide 77 Figure 41 Mode Sense 6 Data Header Figure 42 Mode Sense 10 Data Header Bit Byte 7 6 5 4 3 2 1 0 0 Mode Sense Data Length 1 Reserved 2 Reserved 3 Block Descriptor Length 0 Bit Byte 7 6 5 4 3 2 1...

Page 96: ...ailed descriptions of each of the MODE SENSE Pages follow Field Name Description Mode Sense Data Length This field specifies the length in bytes of the MODE SENSE data that is available to be transfer...

Page 97: ...scriptor Field Name Description PS Parameters Savable When 0 the supported parameters cannot be saved savable pages are not supported When set to 1 it indicates that the page can be saved in nonvolati...

Page 98: ...t match that expected by the drive a CHECK CONDITION status is returned sense key set to ILLEGAL REQUEST The device returns a CHECK CONDITION status with sense key set to ILLEGAL REQUEST if it receive...

Page 99: ...te Recovered Error The device server reports information exception conditions if such reports of recovered errors is allowed by returning CHECK CONDITION status on the next SCSI command except INQUIRY...

Page 100: ...nals that a TapeAlert event has occurred Information about the event is stored in the TapeAlert Log Page The setting of MRIE does not impact logging of events in the TapeAlert Log Page Interval Timer...

Page 101: ...e Bit Byte 7 6 5 4 3 2 1 0 0 PS 0 RSVD Page Code 1Dh 1 Parameter List Length 12h 2 3 MSB First Medium Transport Element Address LSB 4 5 MSB Number of Medium Transport Elements LSB 6 7 MSB First Storag...

Page 102: ...ansport elements contained in the media changer The SuperLoader contains 1 First Storage Element Address Identifies the address of the first medium storage element contained in the media changer Numbe...

Page 103: ...inning with the first medium transport element None of the fields in the page are changeable Figure 46 Transport Geometry Parameters Page The geometry of each medium transport element is defined using...

Page 104: ...e initiator to determine functions permitted by the MOVE MEDIUM command None of the fields in the page are changeable Bit Byte 7 6 5 4 3 2 1 0 0 Reserved Rotate 1 Member Number In Transport Element Se...

Page 105: ...meter Length 12h 2 Reserved STORDT 1 STORI E 0 STORST 1 STORMT 1 3 Reserved 4 Reserved MT DT 1 MT I E 0 MT ST 1 MT MT 1 5 Reserved ST DT 1 ST I E 0 ST ST 1 ST MT 1 6 Reserved I E DT 0 I E I E 0 I E ST...

Page 106: ...DT ST 0 DT MT 0 16 19 Reserved Field Name Description PS Parameters Savable This bit is reserved for MODE SELECT and must be 0 Saved parameters are not supported and must be 0 for MODE SENSE STORXX T...

Page 107: ...equests that the SuperLoader move a volume from a source element to a destination element Figure 49 Move Medium Descriptor Block Bit Byte 7 6 5 4 3 2 1 0 0 Operation Code A5h 1 Logical Unit Number Res...

Page 108: ...sense code Medium Destination Element Full Table 39 Move Medium Command The device capabilities MODE SENSE page provides a matrix with the supported source element or destination element combinations...

Page 109: ...ons and registrations that are active within a device server It is used in conjunction with the PERSISTENT RESERVE OUT command The following figure illustrates the format of the PERSISTENT RESERVE IN...

Page 110: ...once for each registration Refer to figure 51 on page 93 and table 41 on page 94 for information about Read Keys parameter data A Read Reservation service action requests that the device server retur...

Page 111: ...e figure and table below illustrate and describe the data fields of Read Key data parameters Figure 51 Read Keys Parameters Bit Byte 7 6 5 4 3 2 1 0 0 3 MSB Generation LSB 4 7 MSB Additional Length n...

Page 112: ...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 logi...

Page 113: ...stent Reserve In Command 5Eh Quantum ATL SuperLoader Software Interface Guide 95 Figure 52 Read Reservations Parameters Bit Byte 7 6 5 4 3 2 1 0 0 3 MSB Generation LSB 4 7 MSB Additional Length n 7 LS...

Page 114: ...ation 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 verif...

Page 115: ...8 11 MSB Scope Specific Address LSB 12 Reserved 13 Scope Type 14 15 Obsolete Field Name Description Reservation Key The Reservation key field contains an 8 byte value that identifies the reservation k...

Page 116: ...pplies 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...

Page 117: ...ny reservations already known to the device server 2h Obsolete 3h Exclusive Access READS Exclusive any command from any initiator other than the initiator holding the persistent reservation that attem...

Page 118: ...persistent reservations to not conflict with any reservations already known to the device server 6h Exclusive Access Registrants Only READS Exclusive any command from an initiator that has not previou...

Page 119: ...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 persist...

Page 120: ...n Code 5Fh 1 Reserved Service Action 2 Scope Type 3 6 Reserved 7 8 MSB Parameter List Length 18h LSB 9 Unused Reserved Flag Link Field Name Description Service Action Service actions that require info...

Page 121: ...k set for the pre empted initiator 06h Register and Ignore Existing Key Register a reservation key with the device server Existing reservation key is ignored 07 1Fh Reserved Reserved Refer to table 47...

Page 122: ...e Specific Address field in the PERSISTENT RESERVE OUT parameter list Element reservations are not supported 3h 3F Reserved Reserved Type The value of the Type field specifies the characteristics of t...

Page 123: ...e device server was 0 Performing a Clear service action Performing a Pre empt service action Performing a Pre empt and Clear service action or Performing a Register service action from the same initia...

Page 124: ...e persistent reservations in which none of the Scope Type Reservation Key and extent values match an existing persistent reservation held by the initiator making the request are not errors An active p...

Page 125: ...04h Pre empt A PERSISTENT RESERVE OUT command with a successful Pre empt service action removes all persistent reservations for all initiators that have been registered with the Service action Reserva...

Page 126: ...ce action the reservation key for an initiator that has performed a Pre empt service action with its own Reservation key specified in the Service action Reservation key remains unchanged although all...

Page 127: ...ONS PREEMPTED Commands that follow and retries of commands that timed out because there were cleared are subject to the persistent reservation restrictions set by the pre empting initiator The persist...

Page 128: ...and treated as if it matched the current registration if one exists for the initiator Code Name Description 0h Obsolete 1h WRITE Exclusive READS Shared any application client on any initiator may exe...

Page 129: ...transfers from the storage medium to the initiator WRITES Exclusive any command from an initiator that has not previously performed a Register service action with the device server that attempts a tr...

Page 130: ...antum ATL SuperLoader Software Interface Guide Figure 56 Persistent Reserve Out Parameter List Bit Byte 7 6 5 4 3 2 1 0 0 7 MSB Reservation Key LSB 8 15 MSB Service Action Reservation Key LSB 16 19 MS...

Page 131: ...eturns a RESERVATION CONFLICT status The Reservation Key of the initiator is valid for all Service action and Scope values Service Action Reservation Key This field contains information needed for 3 s...

Page 132: ...and Ignore Existing Key service actions it is ignored for all other types of service actions If the last valid APTPL bit value received by the device server is 0 the loss of power in the target releas...

Page 133: ...nd Scope Value Parameters Service Action Allowed Scope Type Service Action Reservation Key Reservation Key Register Ignored Ignored Valid Valid Reserve LU Valid Ignored Valid Release LU Valid Ignored...

Page 134: ...further motion of the Medium Transport Address element is unnecessary to execute an appropriate MOVE MEDIUM command between the Medium Transport Address element and the Destination Address element Fi...

Page 135: ...mmand Field Name Description Medium Transport Address Address of the medium transport element to position Must be set to 0 Destination Address Address of the element in which to position the medium tr...

Page 136: ...es the removal of the magazines as well as removal of tape cartridges through the mail slot via front panel and On board Remote Management control It does not prevent removal via the SCSI Load Unload...

Page 137: ...OVE MEDIUM command with a destination address equal to the mail slot would return a CHECK CONDITION status The sense key shall be ILLEGAL REQUEST with the additional sense code MEDIA REMOVAL PREVENTED...

Page 138: ...with WRITE BUFFER as a diagnostic function for testing the device s data buffer for possible diagnostic data and for checking the integrity of the SCSI bus Figure 59 Read Buffer Command Descriptor Bl...

Page 139: ...ues within this field If any non supported value is set the drive terminates the command with a CHECK CONDITION status ILLEGAL REQUEST sense key set Mode Description 0000b Combined Header and Data Mod...

Page 140: ...ed by data bytes from the target data buffer The figure below illustrates the format of the header The buffer ID must be set to 0 The buffer offset must be less than the size of the buffer Figure 60 R...

Page 141: ...ptor information for the buffer specified by the Buffer ID In this mode the device does not reject the invalid Buffer IDs with a CHECK CONDITION status but returns all zeros in the READ BUFFER descrip...

Page 142: ...Echo Buffer has been overwritten by another initiator the drive will terminate the command with a CHECK CONDITION status the sense key will be set to ABORTED COMMAND and the additional sense code to...

Page 143: ...ptor Field Name Description EBOS Echo Buffer Overwritten Supported Set to 1 to indicate the drive will return the ECHO BUFFER OVERWRITTEN additional sense code if the data being read from the Echo Buf...

Page 144: ...requests that the target report the status of its internal elements to the initiator Figure 63 Read Element Status Descriptor Bit Byte 7 6 5 4 3 2 1 0 0 Operation Code B8h 1 Logical Unit Number VOLTA...

Page 145: ...eported valid in CDB only 1h Medium transport element 2h Storage element 3h Import export element 4h Data transfer element 5h Fh Reserved Starting Element Address Specifies the minimum element address...

Page 146: ...followed by zero or more element status pages Figure 64 Element Status Data Header DVCID Must be set to 0 Reporting of device identifiers is not supported Allocation Length Specifies the number of by...

Page 147: ...and Field Name Description First Element Address Reported Indicates the element address of the element with the smallest element address found to meet the CDB request Number Of Elements Available Indi...

Page 148: ...or more element descriptor blocks The header includes the element type code the length of each descriptor block and the number of bytes of element descriptor information that follow the header for th...

Page 149: ...nt Type Code Indicates the element type see table 54 on page 127 reported by this page PVOLTAG When set to 1 indicates that the Primary Volume Tag Information field is present in each of the following...

Page 150: ...6 5 4 3 2 1 0 0 1 Element Address 2 Reserved Except RSVD Full 3 Reserved 4 Additional Sense Code 5 Additional Sense Code Qualifier 6 8 Reserved 9 SVALID Invert 0 Reserved 10 11 Source Storage Element...

Page 151: ...f REQUEST SENSE command response data This field is valid only if the Except bit is one Additional Sense Code Qualifier Provides more detailed information on an abnormal element state The values in th...

Page 152: ...dentifier Length This field contains the length in byes of the Identifier field Reporting of device identifiers is not supported This field is always 0 Bit Byte 7 6 5 4 3 2 1 0 0 1 Element Address 2 R...

Page 153: ...cess to the element by the medium transport element is denied When a magazine is removed from the SuperLoader the corresponding storage elements shall have an Access bit of 0 Access will also be denie...

Page 154: ...0 1 Element Address 2 Reserved INENAB 1 EXENAB 1 Access Except IMPEXP Full 3 Reserved 4 Additional Sense Code 5 Additional Sense Code Qualifier 6 8 Reserved 9 SVALID Invert Reserved 10 11 Source Stor...

Page 155: ...t element supports movement of media out of the scope of the media changer Access When set to 1 it indicates that access to the element by a medium transport is allowed When set to 0 it indicates that...

Page 156: ...ment Address 2 Reserved Access Except RSVD Full 3 Reserved 4 Additional Sense Code 5 Additional Sense Code Qualifier 6 Not BUS 0 RSVD ID Valid LU Valid RSVD Logical Unit Number 7 SCSI BUS Address 8 Re...

Page 157: ...he data transfer element is on the same bus as the media changer device ID Valid When set to 1 it indicates that the SCSI BUS address field contains valid information LU Valid When set to 1 it indicat...

Page 158: ...The RELEASE 10 command is used to release a previously reserved logical unit The media changer will not return an error if the initiator attempts to release a reservation that is not currently valid F...

Page 159: ...ytes of the parameter list carry the device ID of the third party device the contents of the Third Party Device ID in the CDB byte 3 are ignored Element The SuperLoader supports reservations only on e...

Page 160: ...ter List Parameter List Length The contents of this field specify the length in bytes of the parameter list that will be transferred from the initiator to the target NOTE Assuming that the RELEASE Com...

Page 161: ...itiator If the media changer is reserved by another initiator however it is not released the media changer is only released from the initiator that issued the RELEASE command Element reservations are...

Page 162: ...mand 17h 144 Quantum ATL SuperLoader Software Interface Guide Figure 74 Release Unit 6 Descriptor Block DLT Bit Byte 7 6 5 4 3 2 1 0 0 Operation Code 17h 1 Logical Unit Number 3rdPty Third Party Devic...

Page 163: ...mmand A3h 3 The REPORT DEVICE IDENTIFIER command requests that the device server send device identification information to the applicable client Figure 75 Report Device Identifier Descriptor Bit Byte...

Page 164: ...05h Any other value will return Check Condition Illegal request Allocation Length If the Allocation Length is not sufficient to contain all the parameter data the first portion of the data shall be re...

Page 165: ...field in the CDB is too small to transfer all of the identifier the length is not adjusted to reflect the truncation The identifier length is initially equal to zero and is changed only by a successf...

Page 166: ...at the peripheral device logical unit numbers of known logical units in the target be sent to the applications client The command only returns information about the logical units to which commands may...

Page 167: ...th If the Allocation Length is not sufficient to contain the logical unit number values for all configured logical units the device server still reports as many logical number values as will fit in th...

Page 168: ...the length in bytes of the LUN list that can be transferred The LUN list length equals the number of logical unit numbers reported multiplied by eight If the allocation length in the CDB is too small...

Page 169: ...Descriptor Block Figure 80 Request Sense Command Data Bit Byte 7 6 5 4 3 2 1 0 0 Operation Code 03h 1 Logical Unit Number Reserved 2 3 Reserved 4 Allocation Length 5 Unused Reserved Flag Link Field D...

Page 170: ...nitiator though some commands such as INQUIRY do not change sense data If the media changer receives an unsolicited REQUEST SENSE it returns sense data with the appropriate values in the Sense Key Add...

Page 171: ...th the most recently received command A value of 71h indicates a deferred error the report is associated with a previous command and not as a result of the current command No other values are returned...

Page 172: ...ld for Additional Sense Code provides additional information about the Sense Key and cause of a CHECK CONDITION status Additional Sense Code Qualifiers are discussed in detail later in this chapter Su...

Page 173: ...ny unrecovered errors for a long period of time however 2h NOT READY The media changer is not ready for move operation commands Initialization or calibration may be in progress or may have failed 4h H...

Page 174: ...D 00 Failure Predictive Threshold Exceeded 5D FF Failure Predictive Threshold Exceeded False 02h NOT READY 04 01 Unit Not Ready Calibration Initialization in Process 04 03 Unit Not Ready Manual Interv...

Page 175: ...alid Offset 24 87 Invalid Size 24 89 Image Data Over Limit 24 8B Image Personality is Bad 24 8C Not Immediate Command during Code Update 24 91 Bad Autoloader Image EDC 25 00 Illegal LUN 26 00 Paramete...

Page 176: ...28 01 Import Export Element Accessed 29 00 Reset Occurred 29 01 Power On Occurred 29 02 SCSI BUS Reset Occurred 29 03 BUS Device Reset Function Occurred 29 04 Device Internal Reset 29 05 Transceiver...

Page 177: ...ction Interrupt 44 82 Command Complete Sequence Failure 44 83 SCSI Chip Gross Error Illegal Command Status 44 84 Unexpected Unexplained Residue Count in Transfer Register 44 87 Disconnect SDP Sequence...

Page 178: ...systems The RESERVE command is used to reserve a logical unit The RESERVE 10 Command Descriptor Block is shown in figure 82 and the data fields are described in table 67 on page 161 Figure 82 Reserve...

Page 179: ...and used only when the 3rdPty bit is set in which case this field specifies the SCSI ID of the initiator to be granted the reservation of the logical unit The drive preserves the reservation until on...

Page 180: ...Media Changer Commands Reserve Element 10 Command 56h 162 Quantum ATL SuperLoader Software Interface Guide Figure 83 Reserve 10 ID Only Parameter List Bit Byte 7 6 5 4 3 2 1 0 0 7 MSB Third Party Devi...

Page 181: ...he requesting initiator or for another specified SCSI device Element reservations are not supported The SuperLoader LTO implements this command as specified in SMC 2 Third party reservations are not s...

Page 182: ...of the last two conditions is indicated by the media changer returning a CHECK CONDITION status sense key of UNIT ATTENTION on the next command following the condition It is not an error to issue a RE...

Page 183: ...dia Changer Commands Reserve Element 6 Command 16h Quantum ATL SuperLoader Software Interface Guide 165 RESERVATION CONFLICT status That logical unit ignores a RELEASE ELEMENT command issued by anothe...

Page 184: ...t Byte 7 6 5 4 3 2 1 0 0 Operation Code 1Dh 1 Logical Unit Number PF 0 Reserved Selftst DevOfl UnitOfl 2 Reserved 3 4 MSB Parameter List Length LSB 5 Unused Reserved Flag Link Field Description PF Pag...

Page 185: ...Quantum ATL SuperLoader Software Interface Guide 167 UnitOfl Unit Offline This bit is used in conjunction with Selftst and DevOfl to specify the type of testing to be done This bit must be set to 0 Pa...

Page 186: ...ful completion of a SET DEVICE IDENTIFIER command a unit attention shall be generated for all initiators except the one that issued the service action When reporting the unit attention condition the a...

Page 187: ...h in bytes of the Identifier that shall be transferred from the application client to the device server The maximum value for this field shall be 64 bytes A parameter list length of zero indicates tha...

Page 188: ...and the unit is not in an error state the command returns a GOOD status Otherwise CHECK CONDITION is reported Some conditions that would cause a CHECK CONDITION include overtemperature no magazines in...

Page 189: ...The WRITE BUFFER command is used with READ BUFFER as a diagnostic function and for downloading and updating microcode firmware Figure 90 Write Buffer Descriptor Bit Byte 7 6 5 4 3 2 1 0 0 Operation C...

Page 190: ...the following values within the field If any other value is set the media changer terminates the command with CHECK CONDITION status and an ILLEGAL REQUEST sense key set Mode Description 0000b Write...

Page 191: ...de mode without the Save This mode of the WRITE BUFFER command causes the image data to be verified and the Flash EEPROM firmware area to be updated During the reprogramming front panel displays progr...

Page 192: ...Chapter 3 Media Changer Commands Write Buffer Command 3Bh 174 Quantum ATL SuperLoader Software Interface Guide...

Page 193: ...Reset message 13 C Command Complete message 14 Commands media changer 27 D Disconnect message 14 I Identify message 15 Ignore Wide Residue message 16 Initialize Element Status command 31 Initiator Det...

Page 194: ...170 Write Buffer 171 Message Parity Error message 19 Message Reject message 19 Messages Abort 13 Command Complete 14 Disconnect 14 Identify 15 Ignore Wide Residue 16 Initiator Detected Error 17 Linked...

Page 195: ...media changer 151 sense keys media changer 155 supported ASC ASCQ codes media changer 156 Reserve Element command 160 media changer 163 Restore Pointers message 20 S Send Diagnostic command media cha...

Page 196: ...Index 178 Quantum ATL SuperLoader Software Interface Guide...

Search results

Summary of Contents for ATL SuperLoader ATL

Reviews:

Related manuals for ATL SuperLoader ATL

Brands by name

Popular brands

Quantum ATL SuperLoader ATL, User Manual

Search results

Summary of Contents for ATL SuperLoader ATL

Reviews:

Related manuals for ATL SuperLoader ATL

Brands by name

Popular brands