Page 1 10kdev_.book Page i Friday, March 12, 1999 9:44 AM Spectra 10000 Developer’s Guide Copyright © 1999 Spectra Logic Corporation P/N 92844008, Revision A February 1999 U.S. Patents: 5,555,143 5,621,586 and 5,682,276...
Page 2 In no event shall Spectra Logic Corporation be liable for any loss of profits, loss of business, loss of use or data, interruption of business, or for indirect, special, incidental, or...
Page 3: Barcode Reader
CAUTION: The UCM board in the library contains a lithium battery. The battery is not serviceable by the user. Return the UCM board to Spectra Logic for proper service. Improper disposal could result in an explosion. WARNING...
Page 4 10kdev_.book Page iv Friday, March 12, 1999 9:44 AM CAUTION: These issues must be addressed when rack mounting the Spectra 10000. 1. Make sure the power requirements of the library plus the cumulative power draw of the other equipment in the rack does not overload the supply circuit and/or wiring of the rack.
Page 5 10kdev_.book Page v Friday, March 12, 1999 9:44 AM VORSICHT: Nur Bandkassetten verwenden, die für die Ihrer Spectra 10000 Library installierten Laufwerke anerkannt sind. Ungeeignete Bandkassetten beschädigen Laufwerke, Library und Bandkassetten. VORSICHT: Anwendung von Kontrollen, Einstellungen oder Benutzung von anderen als hierin angegebenen Prozeduren kann Gefährdung durch schädliches...
Page 6: Safety Standards
10kdev_.book Page vi Friday, March 12, 1999 9:44 AM REGULATORY AND SAFETY STANDARDS The Spectra 10000 tape library complies with the following regulatory and safety standards and is authorized to bear the mark of the corresponding agencies. UL-1950 C-UL (Tested to CSA 950 Standards) VDE-0805/05.90 + A1/11.91...
Page 7 ACHTUNG! BMPT Vfg 243/1991 We hereby certify that the Spectra Logic Spectra 10000 8mm Tape Library, is in compliance with the requirements of BMPT Vfg 243/1991 RFI suppressed. The marketing and sale of the equipment was reported to the Federal Office for Telecommunication Permits (BZT).
Page 8 10kdev_.book Page viii Friday, March 12, 1999 9:44 AM EC Declaration of Conformity Spectra Logic Corporation, 1700 North 55th Street, Boulder, Colorado 80301 declare under sole responsibility that Spectra Logic’s “SPECTRA” Automated Tape Library Product Family to which this declaration relates, meets the essential health and safety requirements and is in...
Page 9: Table Of Contents
10kdev_.book Page ix Friday, March 12, 1999 9:44 AM Contents Chapter 1 Serial SCSI Command Language Conventions Used in This Manual ..Connecting to the Library ....SSCL Interface Commands .
Page 10 10kdev_.book Page x Friday, March 12, 1999 9:44 AM T Set Wall Clock ..... . V, v Issue 10-byte SCSI Command..Y Move Cleaning Cartridge .
Page 11 Field Definitions ......Storage Element Descriptor Format..Contents...
Page 12 10kdev_.book Page xii Friday, March 12, 1999 9:44 AM Field Definitions ......Import/Export Element Descriptor Format ..Field Definitions .
Page 13: Serial Scsi Command Language
(SSCL) and Small Computer Systems Interface (SCSI) commands that are supported by the Spectra 10000 library. It is meant to be used by systems integrators and developers as a reference guide to the systems-level control of the library. Information on installing, configuring and using the Spectra 10000 library can be found in the Spectra 10000 User’s...
Page 14: Conventions Used In This Manual
10kdev_.book Page 2 Friday, March 12, 1999 9:44 AM Conventions Used in This Manual This manual uses the following symbols, abbreviations, typeface changes and numbering conventions: Read Notes for additional information or suggestions about the topic or proce- Note: dure being discussed. Read the information in Tips to help you successfully complete a procedure or Tip: avoid additional steps.
Page 15: Connecting To The Library
10kdev_.book Page 3 Friday, March 12, 1999 9:44 AM Numbering All numbers in this manual are assumed to be decimal, unless specifically indicated as hexadecimal. Hexadecimal numbers in this manual are indicated one of two ways: • A number followed by an h is a hexadecimal number, 11h and Bh are hex numbers. •...
Page 16: Sscl Command Phases
10kdev_.book Page 4 Friday, March 12, 1999 9:44 AM SSCL Command Phases The SSCL architecture defines five phases or operating modes, described in the following table. Each phase is distinct and mutually exclusive. Phase Phase Code Idle phase Command phase Expecting a command Issue phase Data phase Initialization phase Power up, self-test initialization, limited number of...
Page 17 10kdev_.book Page 5 Friday, March 12, 1999 9:44 AM Command Sequence The previous table shows the SSCL phases and command sequence. • The command sequence is identical whether the library is interfacing with a host system running backup software or a terminal connected to the RS-232 port. •...
Page 18: Command Summary
10kdev_.book Page 6 Friday, March 12, 1999 9:44 AM Data Phase The library enters the if it needs to return data to the host or Data Phase terminal When the library finishes returning the requested data, it returns an returns to the Idle Phase.
Page 19 10kdev_.book Page 7 Friday, March 12, 1999 9:44 AM The ASCII commands in the following table are not case-sensitive. Note: ASCII Name Control Code Enquiry Acknowledge Horizontal Tab 09h Acknowledge Synchronous Idle Escape Carriage <cr> Return SSCL Command Code Summary The SSCL commands in the following table are case-sensitive.
Page 20 10kdev_.book Page 8 Friday, March 12, 1999 9:44 AM Function 6-byte SCSI Command Robotics diagnostic mode none Request Sense Beeper On/Off Help Inquire Return Drive ECC Read/Write Confidence Test Move Media Get SCSI Status & Sense SCSI ID Library Mode Sense Library Mode Select Read Element Status Initialize Element Status none...
Page 21 10kdev_.book Page 9 Friday, March 12, 1999 9:44 AM Function Set Wall Clock 10-byte SCSI Command SCSI cmds Return Robot Diagnostic Dump Move Cleaning Cartridge source, Library Diagnostic Mode Test Unit Ready * These commands execute immediately upon being received by the library. Note: The other commands are queued up until the library finishes a command from another command stream.
Page 22 10kdev_.book Page 10 Friday, March 12, 1999 9:44 AM Chapter 1...
Page 23: Sscl Command Descriptions
10kdev_.book Page 11 Friday, March 12, 1999 9:44 AM Chapter 2 SSCL Command Descriptions The commands supported by the library are similar to the SCSI-2 command set for media changer devices and the returned error status information is identical to SCSI-2 specifications.
Page 24: (Dsp Dump) Dsp Dump Ctl+B
10kdev_.book Page 12 Friday, March 12, 1999 9:44 AM Conventions Used SSCL commands are case-sensitive. Note: • Command parameters are in a list separated by commas. Each item in the list is a two- character, ASCII-encoded hexadecimal value. Optional data parameters use the same format.
Page 25: (Enq) Check Phase Ctl+E
10kdev_.book Page 13 Friday, March 12, 1999 9:44 AM (ENQ) Check Phase ctl+e can be issued at any time. and should be used in the form of a SCSI test Check Phase unit ready command. The library returns the phases n1, n2, n3, n4, representing four operating parameters: •...
Page 26: B, B 12-Byte Scsi Command
The host can issue retrieve the status byte and all sense data available for the device. See Appendix B of the Spectra 10000 User’s Guide for a list of sense codes and their meanings. Chapter 2 to the host. Following a...
Page 27: C, C 6-Byte Scsi Command
10kdev_.book Page 15 Friday, March 12, 1999 9:44 AM C, c 6-byte SCSI Command This command issues a 6-byte command to the specified SCSI device. It is only recommended when an operating system device driver does not support a desired command.
Page 28: D Robotics Diagnostic Mode
• Unit Code, s4 See Appendix B of the Spectra 10000 User’s Guide for a list of the sense codes, ASCs, ASCQs, definitions and possible error causes. The fourth field in the string, the Unit Code, indicates the device to which the sense data...
Page 29: G Beeper On/Off
10kdev_.book Page 17 Friday, March 12, 1999 9:44 AM • 0: Library • 1: Drive 1 • 2: Drive 2 • 3: Drive 3 • 4: Drive 4 Errors: Request Sense Request Sense issuing a Request Sense G Beeper On/Off The Beeper On/Off command turns the library beeper on or off.
Page 30: Inquire
ASCII data. The content and format for each page is listed below. Example: To return data for page 0 for a library: • Page 0: vendor, product identification, number of storage elements, number of tape drives, firmware version, product revision, barcode flag, library SCSI ID, total pages available. SPCTRA,X000,43,1,2,00,00,1,0,6,3"...
Page 31: J Return Drive Ecc Rate
10kdev_.book Page 19 Friday, March 12, 1999 9:44 AM J Return Drive ECC Rate command returns the state of the clean request bit, the read ECC rate, the write ECC rate, and the number of times the tape has been loaded. Format J drive <CR>...
Page 32: Move Media
M 3, 80: Move cartridge from storage location 3 into tape drive #1. M 3, 0: Move cartridge from storage location 3 to entry/exit port (eject from library). M 3, 79: Move cartridge from storage location 3 to gripper arm.
Page 33: N Get Scsi Status And Sense
O Library Mode Sense Library Mode Sense Appendix B of the Spectra 10000 User’s Guide for a detailed list of sense code information. command is issued to the library with the tape drive as the to indicate an error condition. Following...
Page 34: O Library Mode Sense
10kdev_.book Page 22 Friday, March 12, 1999 9:44 AM Format O PAGE, [PAGE_CONTROL] <CR> Page corresponds to a page of data described in the format of the return information is a character string with each field separated by a comma and the string ends with a carriage return. See command page for information available from a is an optional field that selects which values are displayed.
Page 35 Number of data transfer elements First data transfer element address First medium transport element address Number of storage elements First storage element address Value Changeable Explanation The element address of the entry/ exit door (normally 0) The number of tape drives...
Page 36 10kdev_.book Page 24 Friday, March 12, 1999 9:44 AM Page Parameters Automatic Barcode reads Barcode Reader Label Checksum Read Volume Tags (barcode labels) of unread labels during cartridge movement Serial Port Hardware Handshake Enable/Disable Queued Unloads Lock Screen The range of acceptable values for Note: Assigning Element Addresses These fields are used to assign address values to the library elements and to specify the...
Page 37: R Read Element Status
10kdev_.book Page 25 Friday, March 12, 1999 9:44 AM Element addresses are set according to the following rules. Element addresses must be unique. If two drives are used, the address entered for the drives and the next address are both reserved. If two drives are used, the address entered for the arms and the next address are both reserved.
Page 38: S Initialize Element Status
10kdev_.book Page 26 Friday, March 12, 1999 9:44 AM and barcode reader is installed and enabled: The return information includes a list page =1 of barcode label data separated by commas; each barcode label found on the tape is enclosed with quotation marks to differentiate its contents from single ASCII If a tape is not present in the slot, ASCII Example: "120590-1",0,"120590-2"...
Page 39: S Initialize Element Status
10kdev_.book Page 27 Friday, March 12, 1999 9:44 AM Format S <CR> This command may be executed before a executed. This ensures that the information returned is accurate. In most instances this command is not necessary, as the library keeps track of any tape manipulations. In particular, the command may be needed if the user inserts cartridges into the library other than through the entry/exit port.
Page 40: T Set Wall Clock
Errors: The library indicates an error condition by returning a the library sense code will be valid. The host should issue a command to receive the sense data. Appendix B of the Spectra 10000 User’s Guide Sense Chapter 2 command only returns an error if there is an error in the format with a SCSI ID of 2.
Page 41: Y Move Cleaning Cartridge
Format Y SOURCE,DESTINATION <CR> The source element may be either a medium storage element (carousel slot) or the entry/ exit port. The destination element must be a data transfer element. The command cannot determine whether or not the source element is a cleaning cartridge; you must determine this.
Page 42 10kdev_.book Page 30 Friday, March 12, 1999 9:44 AM Chapter 2...
Page 43 10kdev_.book Page 31 Friday, March 12, 1999 9:44 AM Chapter 3 SCSI-2 Command Interface This section provides descriptions of the library’s SCSI-2 messaging system, including message sequences, general error and message processing, as well as information about SCSI-2 command formats, command status, and errors. This chapter describes: SCSI-2 Device Interface Model ...
Page 44: Scsi-2 Device Interface Model
The Spectra Logic family of tape libraries follows this model. Each library location that can hold a tape cartridge (media), is called an element. Each element in the library must have a unique address.
Page 45: Scsi-2 Message System
10kdev_.book Page 33 Friday, March 12, 1999 9:44 AM While all of the elements are areas where tape cartridges may be located, two locations are not typically considered elements: • The Medium Transport Element (gripper arm) is not normally used as a destination for tape cartridges.
Page 46: Scsi-2 Message Definitions
10kdev_.book Page 34 Friday, March 12, 1999 9:44 AM SCSI-2 Message Definitions Command Complete Message (00h) The Command Complete message is sent from the library to an initiator, indicating that the execution of an I/O process has been completed and that a valid status has been sent to the initiator. After successfully sending this message, the command process is finished and the library goes to the Bus Free phase.
Page 47: Scsi-2 Message Sequence
10kdev_.book Page 35 Friday, March 12, 1999 9:44 AM Identify Message Format Field Definitions Value Identify Identify - (Bit 7) The Identify bit is set to 1 to specify that this is an Identify message. DiscPriv - (Bit 6) The Disconnect Privilege bit (DiscPriv) set to 1 specifies that the initiator has granted the library the privilege of disconnection.
Page 48: General Error Message Processing
10kdev_.book Page 36 Friday, March 12, 1999 9:44 AM • Following the Re-Selection phase, the library sends an Identify message followed by a status byte and a Command Complete message to the initiator. • Finally, the library goes to the Bus Free phase, awaiting subsequent initiator selection. For a more detailed explanation of SCSI bus phases, refer to the ANSI Small Computer System Interface-2 (SCSI-2) specification.
Page 49: General Command Format
10kdev_.book Page 37 Friday, March 12, 1999 9:44 AM When the library detects a SCSI bus parity error, Check Condition (02h) status is returned to the initiator and the following settings are made: When the initiator detects a SCSI bus parity error, the command must be reissued. If the command was Request Sense (03h), valid Sense Data is returned.
Page 50: Ten-Byte Command Format
10kdev_.book Page 38 Friday, March 12, 1999 9:44 AM Ten-byte Command Format Byte Twelve-byte Command Format Byte Operation Code Logical Unit Number (MSB) CDB Parameters (LSB) Transfer Length or Parameter List Length or Allocation Length or CDB Parameters Reserved Control Byte Chapter 3 Operation Code Logical Unit...
Page 51: Scsi-2 Command Field Definitions
10kdev_.book Page 39 Friday, March 12, 1999 9:44 AM SCSI-2 Command Field Definitions Operation Code - (Byte 00, bits 7-0) The Operation Code of the command descriptor block is a Group Code field and a Command Code field. Byte The three-bit Group Code field provides for eight groups of command codes. The Operation Group Codes supported by the library are defined below: Group Code 01h-02h...
Page 52: Scsi Command Status
10kdev_.book Page 40 Friday, March 12, 1999 9:44 AM Transfer Length, Parameter List Length or Allocation Length (Varies, See Specific Command) The transfer length specifies the amount of data to be transferred by the command. The parameter list length is used to specify the number of bytes sent during the Data Out phase.
Page 53: Status Byte Code Descriptions
10kdev_.book Page 41 Friday, March 12, 1999 9:44 AM Status Byte Code Descriptions Status Byte Format Byte RSVD Status Byte Field Descriptions RSVD The reserved fields are set aside for future standardization. Status Byte Code (Bits 5-1) The Status Byte Codes are defined in the following table: Hex Value Individual Bits Good (00h) Good status indicates that the operation specified by the command has completed correctly.
Page 54 10kdev_.book Page 42 Friday, March 12, 1999 9:44 AM Check Condition status is reported upon receipt of a command in the following cases: • There is a SCSI error (bus parity error or format check) in the CDB. • The command is the first received by the library after a unit attention condition has been generated (i.e.
Page 55: Sense Key Descriptions
Vendor Unique (09h) The library returns a sense key of Vendor Unique to the initiator when the library detects robotics command errors or initiator SCSI command errors. For more details, see Appendix B of the Spectra 10000 User’s Guide. This is only used by the SSCL interface.
Page 56: Library Scsi-2 Command Set
10kdev_.book Page 44 Friday, March 12, 1999 9:44 AM Library SCSI-2 Command Set The table below lists the SCSI-2 commands supported by the library. The following chapters provide detailed information about these SCSI-2 commands, and the command formats and field definitions used by the library. Supported SCSI-2 Command Set Command INITIALIZE ELEMENT STATUS (6-byte)
Page 57: Chapter 4 Scsi-2 Commands: Initialize Element Status
The Initialize Element Status command instructs the library to perform an inventory check on all Library Storage Elements for the presence of cartridges, and if a barcode reader is installed and enabled, also causes barcode labels on cartridges located in Media Storage Elements (carousel slots) to be scanned.
Page 58: Initialize Element Status Format (07H, 6-Byte Cmd)
10kdev_.book Page 46 Friday, March 12, 1999 9:44 AM Initialize Element Status Format (07h, 6-byte Cmd) Byte Initialize Element Status Format (E7h, 10-byte Cmd) Byte Chapter 4 Logical Unit Number Reserved Reserved Reserved Reserved Reserved Logical Unit Number Reserved (MSB) Element Address (LSB) Reserved...
Page 59: Field Definitions
10kdev_.book Page 47 Friday, March 12, 1999 9:44 AM The 10-byte command is included to provide compatibility with Exabyte™ Note: tape libraries. When this command is issued, the Element Address and Number of Elements fields are ignored and a complete library initialization occurs. Field Definitions Logical Unit Number (Byte 01, bits 7-5) The library does not support Logical Unit Numbers, so this field must be 00h.
Page 60 10kdev_.book Page 48 Friday, March 12, 1999 9:44 AM Chapter 4...
Page 61: Chapter 5 Scsi-2 Commands: Inquiry
10kdev_.book Page 49 Friday, March 12, 1999 9:44 AM Chapter 5 SCSI-2 Commands: Inquiry The Inquiry command requests that the library send information regarding its parameters to the initiator. Inquiry Format (12h) Byte Logical Unit Number Page Code Reserved Allocation Length Reserved Reserved EVPD...
Page 62: Field Definitions
10kdev_.book Page 50 Friday, March 12, 1999 9:44 AM Field Definitions Logical Unit Number (Byte 01, bits 7-5) The library does not support Logical Unit Numbers, so this field must be 00h. EVPD (Byte 01, bit 0-1) When the Enable Vital Product Data (EVPD) bit is 0, the library returns only the Standard Inquiry Data Page.
Page 63: Standard Inquiry Data Format
10kdev_.book Page 51 Friday, March 12, 1999 9:44 AM Standard Inquiry Data Format The library returns 56 bytes of Standard Inquiry Data: Byte Peripheral Qualifier Device Type Qualifier ISO Version AENC TRMIOP Additional Length Reserved Reserved RelAdr WBus32 (MSB) Vendor Identification (LSB) (MSB) Product Identification...
Page 64: Field Definitions
10kdev_.book Page 52 Friday, March 12, 1999 9:44 AM Field Definitions Peripheral Qualifier (Byte 00, bits 7-5) The value returned for this field is 00h, indicating that the library is a single LUN device. If an initiator sends a LUN other than 00h in the Inquiry command, the value returned for this field is 03h.
Page 65 10kdev_.book Page 53 Friday, March 12, 1999 9:44 AM Additional Length (Byte 04, bits 7-0) The value returned for this field is 21h, indicating that there are 33 additional bytes of Additional Inquiry Data available to be returned to the initiator. These bytes are defined in the remainder of this section.
Page 66 Bytes 36 - 37 contain the current patch level. The Vendor Identification, Product Identification, Product Revision Level, and Note: Patch Level data fields may have unused bytes being filled with space characters (20h). * Other emulations are provided. See the Spectra 10000 Release Notes. Chapter 5...
Page 67: Chapter 6 Scsi-2 Commands: Mode Select
10kdev_.book Page 55 Friday, March 12, 1999 9:44 AM Chapter 6 SCSI-2 Commands: Mode Select The Mode Select command allows the initiator to specify medium, logical unit or device parameters for the library. An initiator uses these parameters to configure the library after power-up or a Bus Device Reset message.
Page 68: Field Definitions
10kdev_.book Page 56 Friday, March 12, 1999 9:44 AM Field Definitions Logical Unit Number (Byte 01, bits 7-5) The library does not support Logical Unit Numbers, so this field must be 00h. PF (Byte 01, bit 4) The library supports the page format specified by SCSI-2. This value must be 1. SP (Byte 01, bit 0) The library supports the Saved Page function.
Page 69: Field Definitions
10kdev_.book Page 57 Friday, March 12, 1999 9:44 AM Field Definitions Mode Data Length (Byte 00, bits 7-0) The Mode Data Length specifies the length of mode data, in bytes, that is available to be transferred. LCD Mode: Byte Parameter List Length Door Unlock Reserved...
Page 70: Element Address Assignment Parameter List Format
10kdev_.book Page 58 Friday, March 12, 1999 9:44 AM 0 - Front Panel Access is allowed 1 - Front Panel Access is disallowed Host will be displayed until Host removes it or a user touches the front panel. Display Line 1 - Bytes 04 - 23 This field specifies the text that the library displays on Line 1 of the LCD when the Write Line 1 field is set to 1.
Page 71: Field Definitions
Field Definitions Page Code (Byte 00, bits 5-0) The Page Code must identify the Element Address Assignment Parameter List. The value of this field must be 1Dh. (LSB) (MSB) First Storage Element Address (LSB) (MSB) Number of Storage Elements (LSB) (MSB)
Page 72 The default starting address is 01h. See the table on page 62 for more information. Number of Storage Elements - (Bytes 08 - 09) The Number of Storage Elements field identifies the number of carousel slots within the library. This field varies depending on the configuration of the library. See the table on page 62 for more information.
Page 73 10kdev_.book Page 61 Friday, March 12, 1999 9:44 AM First Data Transfer Element Address (Bytes 14 - 15) The First Data Transfer Element Address field identifies the address of the first location for the installed drives. The library can have between 1 and 4 Data Transfer Elements (tape drives) installed.
Page 74 Element addresses must not overlap. • Element groups (i.e. carousel slots, gripper arm, drives) must be assigned contiguous addresses. • Element addresses must be between 0 and 65,535. Chapter 6 Import/ Media Storage Media Export Element Transport Element Element First Last...
Page 75: Vendor-Unique Parameter List Format (00H)
10kdev_.book Page 63 Friday, March 12, 1999 9:44 AM Vendor-unique Parameter List Format (00h) Byte Parameter List Length Reserved Queued Unload Lock Touch Screen Reserved Reserved Reserved Reserved Reserved Field Definitions PS (Byte 00, bit 7) The Save Page field identifies whether or not this page can be saved to FPROM. 0 = not savable, 1 = savable.
Page 76 10kdev_.book Page 64 Friday, March 12, 1999 9:44 AM Auto (Byte 02, bit 2) This bit controls the Automatic Reading of barcode labels if a barcode reader is installed. Cartridges are automatically scanned. If this bit is 0 the barcode is not automatically read. For a detailed description, see on page 45.
Page 77: Chapter 7 Scsi-2 Commands: Mode Sense
10kdev_.book Page 65 Friday, March 12, 1999 9:44 AM Chapter 7 SCSI-2 Commands: Mode Sense The Mode Sense command enables the library to report its operating mode parameters to the initiator. The library returns 57 bytes of Mode Sense data to the initiator. These bytes are structured as follows: •...
Page 78: Field Definitions
10kdev_.book Page 66 Friday, March 12, 1999 9:44 AM Field Definitions Logical Unit Number (Byte 01, bits 7-5) The library does not support Logical Unit Numbers so this field must be 00h. DBD (Byte 01, bit 3) The library does not use block descriptors. The value for the Disable Block Descriptors field should be 1.
Page 79: Parameter List Header Format
10kdev_.book Page 67 Friday, March 12, 1999 9:44 AM 4 = Page Code (Byte 02, bits 5-0) This field specifies which pages are to be returned by the library. A value of 3Fh for this field returns all pages of mode data in the following order, 1Dh (Element Address Assignment Page), 1Eh (Transport Geometry Page), 1Fh (Device Capabilities Page), 00h (Vendor Unique Page).
Page 80: Transport Geometry Parameter List Header Format
10kdev_.book Page 68 Friday, March 12, 1999 9:44 AM Transport Geometry Parameter List Header Format Byte Parameter Length Field Definitions PS (byte 00, bit 7) The Save Page field identifies whether or not this page can be saved to FPROM: 0 = not savable, 1 = savable.
Page 81: Field Definitions
These values are not directly modifiable via the Mode Select command. Note: Element Address Assignment Fields Format (1Dh) Byte RSVD Page Code Parameter List Length (MSB) Medium Transport Element Address (LSB) (MSB) Number of Medium Transport Elements (LSB) (MSB) First Storage Element Address (LSB) (MSB) Number of Storage Elements (LSB)
Page 82: Field Definitions
10kdev_.book Page 70 Friday, March 12, 1999 9:44 AM Byte Field Definitions PS (Byte 00, bit 7) The Save Page field identifies whether or not this page can be saved to FPROM. 0 = not savable, 1 = savable. The value for this page is 1, i.e. these values cannot be modified. Page Code (Byte 00, bits 5-0) The Page Code identifies the Element Address Assignment Parameter List.
Page 83 Transport Elements within the library. This field varies depending on the configuration of the library. See the table in on page 62 for more information. First Storage Element Address (Bytes 06 - 07) This field identifies the starting address of the carousel slots. Number of Storage Elements (Bytes 08 - 09) This field identifies the number of carousel slots within the library, and thus varies depending on the configuration of the library.
Page 84: Device Capabilities Fields Format (1Fh)
10kdev_.book Page 72 Friday, March 12, 1999 9:44 AM Number of Data Transfer Elements (Byte 16 - 17) The Number of Data Transfer Elements field identifies the total number of CTSs installed in the library. The library can have 1 to 4 CTSs installed. This field varies depending on the configuration of the library.
Page 85: Field Definitions
StorDT (Byte 02, bit 3) This field identifies the ability of the data transfer element (tape drive) to perform the function of storage. The value returned for this field is 1. MT<>DT MT<>IE MT<>ST ST<>DT...
Page 86 The value returned for this field is 1. StorST (Byte 02, bit 1) This field identifies the ability of the storage element (carousel slots) to perform the function of storage. The value returned for this field is 1.
Page 87 10kdev_.book Page 75 Friday, March 12, 1999 9:44 AM ST->DT (Byte 05, bit 3) This field identifies the support for the Move Medium (A5h) command from a storage element (carousel slot) to a data transfer element (tape drive). The value returned for this field is 1.
Page 88 DT->ST (Byte 07, bit 1) This field identifies the support for the Move Medium (A5h) command from a data transfer element (tape drive) to a storage element (carousel slot). The value returned for this field is 1. DT->MT (Byte 07, bit 0) This field identifies the support for the Move Medium (A5h) command from a data transfer element (tape drive) to the medium transport element (gripper arm).
Page 89: Vendor-Unique Parameter List Format (00H)
10kdev_.book Page 77 Friday, March 12, 1999 9:44 AM Vendor-unique Parameter List Format (00h) Byte Parameter List Length Reserved Queued Unload Reserved Reserved Reserved Reserved Reserved Reserved Field Definitions PS (Byte 00, bit 7) The Save Page field identifies whether or not this page can be saved to FPROM. 0 = not savable, 1 = savable.
Page 90 10kdev_.book Page 78 Friday, March 12, 1999 9:44 AM Auto (Byte 02, bit 2) This bit controls the Automatic Reading of barcode labels if a barcode reader is installed. Cartridges are automatically scanned. If this bit is 0, the barcode is not automatically read.
Page 91: Chapter 8 Scsi-2 Commands: Move Medium
10kdev_.book Page 79 Friday, March 12, 1999 9:44 AM Chapter 8 SCSI-2 Commands: Move Medium The Move Medium command requests that the library move media from a specific element location (address) to another specific element location (address). The Mode Sense data contains a matrix with the valid source element-destination combinations for the Move Medium command.
Page 92: Field Definitions
Source Address (Bytes 04 - 05) This is the element location (address) from where the data cartridge is to be taken. This may be a storage location, the Entry/Exit Port or a CTS. Destination Address (Bytes 06 - 07) This is the element location (address) where the data cartridge is to be placed. This may be a storage location, the entry/exit port or a CTS.
Page 93: Chapter 9 Scsi-2 Commands: Position To Element
10kdev_.book Page 81 Friday, March 12, 1999 9:44 AM Chapter 9 SCSI-2 Commands: Position To Element The Position to Element command requests that the Gripper Arm be positioned to a specific element location (address). No movement occurs for a Move Medium (A5h) command. Note that for the library this command does not significantly reduce the access time for loading or unloading of a tape drive.
Page 94: Field Definitions
The library does not support Logical Unit Numbers, so this field must be 00h. Transport Element Address (Bytes 02 - 03) This field is the address of the storage element in front of which the gripper arm is to be positioned.
Page 95: Chapter 10 Scsi-2 Commands: Prevent/Allow Medium Removal
SCSI-2 Commands: Prevent/Allow Medium Removal The Prevent/Allow Medium Removal command requests that the library enable or disable the removal of the data cartridges from the library data cartridge storage area; for example, cartridges can be prevented from being moved to the Import/Export Element (rotary door).
Page 96: Field Definitions
10kdev_.book Page 84 Friday, March 12, 1999 9:44 AM Field Definitions Logical Unit Number (Byte 01, bits 7-5) The library does not support Logical Unit Numbers, so this field must be 00h. Prevent (Byte 04, bit 0) The valid values for this field are as follows: 0 - Allow removal of data cartridges 1 - Prevent removal of data cartridges Upon receipt of the Prevent/Allow Medium Removal command with the Prevent bit set...
Page 97: Chapter 11 Scsi-2 Commands: Read Element Status
10kdev_.book Page 85 Friday, March 12, 1999 9:44 AM Chapter 11 SCSI-2 Commands: Read Element Status The Read Element Status command requests that the library return the status of the elements in the library. This command returns the data created when the Initialize Element Status (E7h) command executes.
Page 98: Field Definitions
The element type codes are defined below: 00h All Element Types reported 01h Medium Transport Element (Gripper Arm Mechanism) 02h Storage Element (Data Cartridge Slots) 03h Import/Export Element (Entry/Exit Port) 04h Data Transfer Element (Cartridge Tape Subsystems) Starting Element Address (Bytes 02 - 03) The Starting Element Address specifies the minimum element address to report.
Page 99 10kdev_.book Page 87 Friday, March 12, 1999 9:44 AM Allocation Length (Bytes 07 - 09) This field specifies the length (in bytes) of the space allocated by the initiator for the transfer of element descriptors. Only complete element descriptors are transferred. Element descriptors are transferred until one of the following conditions is met: •...
Page 100: Element Descriptors Format
10kdev_.book Page 88 Friday, March 12, 1999 9:44 AM Element Descriptors Format The returned data is in the form shown below: Element Status 8-Byte Header + Element Status Element Status 8-Byte Header + Element Element Element Element Status 8-Byte Header + Element Element Element Element Descriptors Format...
Page 101: Read Element Status Data Format
10kdev_.book Page 89 Friday, March 12, 1999 9:44 AM Read Element Status Data Format Byte (MSB) First Element Address Reported (LSB) (MSB) Number of Elements Reported (LSB) Reserved (MSB) Byte Count of Report Available (LSB) Element Status Page(s) Field Definitions First Element Address Reported (Bytes 00 - 01) This field indicates the smallest element address found that meets the CDB requirements.
Page 102: Element Status Page Format
10kdev_.book Page 90 Friday, March 12, 1999 9:44 AM Byte Count of Report Available (Bytes 05 - 07) This field indicates the total number of element status data available that meet the CDB requirements. This value is not adjusted to match the allocation length available. Element Status Page Format This header is sent once for each group of element descriptors of the same type.
Page 103 10kdev_.book Page 91 Friday, March 12, 1999 9:44 AM 02h Storage Element (Data Cartridge Slots) 03h Import/Export Element (Entry/Exit Port) 04h Data Transfer Element (Cartridge Tape Subsystems) PVolTag (Byte 01, bit 7) The Primary Volume Tag (PVolTag) bit of one indicates that the primary volume tag information field is present in each of the following element descriptor blocks.
Page 104: Medium Transport Element Descriptor Format
Reserved Reserved Additional Sense Code Additional Sense Code Qualifier Reserved SValid (MSB) Source Storage Element Address (LSB) Primary Volume Tag Information (Field omitted if PVolTag=0) Reserved (Field moved up if Primary Volume Tag Information field is omitted) Chapter 11 Except...
Page 105: Field Definitions
4 to drive 1, then from the drive back to slot 4. The Svalid bit for this tape is now set and the Source Storage Element Address entry is 1, the number of the last drive in which the tape was located.
Page 106 The library uses single-sided media and does not support inverted media. The information reported for this field is 0. Source Storage Element Address (Bytes 10 - 11) The library only tracks previous locations of data cartridges for tapes in drives. For a tape whose SValid bit is set, the information reported for this field is the number of the drive in which this tape was last located.
Page 107: Storage Element Descriptor Format
10kdev_.book Page 95 Friday, March 12, 1999 9:44 AM Storage Element Descriptor Format Each of the slots within the carousel is a storage element. Byte (MSB) Storage Element Address (LSB) Reserved Reserved Additional Sense Code Additional Sense Code Qualifier Reserved...
Page 108: Field Definitions
10kdev_.book Page 96 Friday, March 12, 1999 9:44 AM Field Definitions Element Address (Bytes 00 - 01) The element address field gives the address for the storage element whose status is reported by this element descriptor block. Access (Byte 02, bit 3) This field indicates that access to the entry/exit port by the Gripper Arm Mechanism is allowed.
Page 109 4 to drive 1, then from the drive back to slot 4. The Svalid bit for this tape is now set and the Source Storage Element Address entry is 1, the number of the last drive in which the tape was located.
Page 110: Import/Export Element Descriptor Format
Reserved Reserved Additional Sense Code Additional Sense Code Qualifier Reserved SValid (MSB) Source Storage Element Address (LSB) Primary Volume Tag Information (Field omitted if PVolTag=0) Reserved (Field moved up if Primary Volume Tag Information field is omitted) Chapter 11 InEnab...
Page 111: Field Definitions
10kdev_.book Page 99 Friday, March 12, 1999 9:44 AM Field Definitions Element Address (Bytes 00 - 01) The Element Address field gives the address for the import/export element whose status is reported by this element descriptor block. InEnab (Byte 02, bit 5) An import enable (InEnab) bit of one indicates that the import /export element supports movement of media into the library.
Page 112 4 to drive 1, then from the drive back to slot 4. The SValid bit for this tape is now set and the Source Storage Element Address entry is 1, the number of the last drive in which the tape was located.
Page 113: Data Transfer Element Descriptor Format
Additional Sense Code Qualifier Not Bus RSVD SCSI Bus Address Reserved SValid (MSB) Source Storage Element Address (LSB) Primary Volume Tag Information (Field omitted if PVolTag=0) Reserved (Field moved up if Primary Volume Tag Information field is omitted) Access Except RSVD...
Page 114: Field Definitions
10kdev_.book Page 102 Friday, March 12, 1999 9:44 AM Field Definitions Element Address (Byte 00 - 01) The Element Address field gives the address for the Data Transfer Element whose status is reported by this element descriptor block. Access (Byte 02, bit 3) This field indicates that access to the Data Transfer Element by the Gripper Arm is allowed.
Page 115 4 to drive 1, then from the drive back to slot 4. The SValid bit for this tape is now set and the Source Storage Element Address entry is 1, the number of the last drive in which the tape was located.
Page 116 10kdev_.book Page 104 Friday, March 12, 1999 9:44 AM Source Storage Element Address (Bytes 10 - 11) The library only tracks previous locations of data cartridges for tapes in drives. For a tape whose SValid bit is set, the information reported for this field is the number of the drive in which this tape was last located.
Page 117: Chapter 12 Scsi-2 Commands: Release
10kdev_.book Page 105 Friday, March 12, 1999 9:44 AM Chapter 12 SCSI-2 Commands: Release The Release command enables the initiator to release reservations of the library or elements of the library as set by the Reserve (16h) command. See page 115, for more information. The release of an unreserved library or of unreserved elements of the library is not considered an error.
Page 118: Field Definitions
10kdev_.book Page 106 Friday, March 12, 1999 9:44 AM Field Definitions Logical Unit Number (Byte 01, bits 7-5) The library does not support Logical Unit Numbers, so this field must be 0. 3rdPty (Byte 01, bit 4) The Third-Party Release option of the Release command allows an initiator to release a unit (or elements within a unit) previously reserved using a third-party reservation.
Page 119: Chapter 13 Scsi-2 Commands: Request Sense
10kdev_.book Page 109 Friday, March 12, 1999 9:44 AM Chapter 13 SCSI-2 Commands: Request Sense The Request Sense command requests that the library transfer sense data to the initiator. Request Sense Format (03h) Byte Logical Unit Number Reserved Reserved Reserved Number of Bytes Allocated Reserved...
Page 120 Sense data is cleared upon the reception of any subsequent command that is not a Request Sense, or an Inquiry (12h) command, from the initiator which is receiving the Check Condition status. Refer to Appendix B of the Spectra 10000 User’s Guide for a list and description of sense codes.
Page 121: Request Sense Format (03H)
10kdev_.book Page 111 Friday, March 12, 1999 9:44 AM Extended Sense Data (70h) For Error Code 70h, the format of the standard extended sense bytes is defined as follows: Byte RSVD Extended Sense Data Reserved (MSB) Information Bytes (LSB) Additional Sense Length (MSB) Command Specific Information (LSB)
Page 122: Field Definitions
10kdev_.book Page 112 Friday, March 12, 1999 9:44 AM Field Definitions Extended Sense Data (Byte 01, bits 7-0) The value for this field is 0. Sense Key (Byte 02, bits 3-0) The values contained in the Sense Key field are defined below. This table includes only those sense key values supported by the library.
Page 123 Additional Sense Code Qualifier (Byte 13, bits 7-0) This field indicates detailed information related to the ASC. For a list of ASCQ values and their meanings, refer to Appendix B of the Spectra 10000 User’s Guide. Field Replaceable Unit Code (Byte 14, bits 7-0) A non-zero value in this field defines a device-specific mechanism or a unit that has failed.
Page 124 10kdev_.book Page 114 Friday, March 12, 1999 9:44 AM Chapter 13...
Page 125: Chapter 14 Scsi-2 Commands: Reserve
10kdev_.book Page 115 Friday, March 12, 1999 9:44 AM Chapter 14 SCSI-2 Commands: Reserve The Reserve command allows the initiator to reserve the library or its elements. The elements reserved are released as a result of a Release (17h) command from the same initiator, a Bus Device Reset condition, a SCSI bus reset or a power-on cycle of the library.
Page 126 10kdev_.book Page 116 Friday, March 12, 1999 9:44 AM 3rdPty (Byte 01, bit 4) The third-party reserve option of the Reserve command allows an initiator to reserve a unit or elements within a unit: • If the third-party (3rdPty) bit is zero, the third-party reserve option is not requested. •...
Page 127: Field Definitions
10kdev_.book Page 117 Friday, March 12, 1999 9:44 AM Element List Descriptor Format Byte Field Definitions Number of Elements (Bytes 02 - 03) This is the Number of Elements to be reserved. If the value of this field is 0, all elements starting at Element Address (Bytes 04 and 05) through the last address, which follows the starting address, are reserved.
Page 128 10kdev_.book Page 118 Friday, March 12, 1999 9:44 AM Chapter 14...
Page 129: Chapter 15 Scsi-2 Commands: Send Diagnostic
10kdev_.book Page 119 Friday, March 12, 1999 9:44 AM Chapter 15 SCSI-2 Commands: Send Diagnostic The Send Diagnostic command requests that the library perform diagnostic tests on itself. The library disconnects from the SCSI bus during the performance of its diagnostic tests.
Page 130: Field Definitions
10kdev_.book Page 120 Friday, March 12, 1999 9:44 AM Field Definitions Logical Unit Number (Byte 01, bits 7-5) The library does not support Logical Unit Numbers, so this field must be 0. PF (Byte 01, bit 4) The Page Format field indicates that the parameters for the diagnostic tests are vendor- specific.
Page 131: Chapter 16 Scsi-2 Commands: Test Unit Ready
10kdev_.book Page 121 Friday, March 12, 1999 9:44 AM Chapter 16 SCSI-2 Commands: Test Unit Ready The Test Unit Ready command allows the initiator to determine if the library is powered- on and ready to accept a robotics motion command. This is not a request for a library self-test, which occurs during power-on.
Page 132: Field Definition
10kdev_.book Page 122 Friday, March 12, 1999 9:44 AM Field Definition Logical Unit Number (Byte 01, bits 7-5) The library does not support Logical Unit Numbers, so this field must be 0. Chapter 16...
Page 133 10kdev_.book Page 123 Friday, March 12, 1999 9:44 AM Index Symbols ? command, SSCL Numerics 6-byte command format, SCSI 6-byte SCSI command 10-byte command format, SCSI 12-byte command format, SCSI 12-byte SCSI command A,a command, SSCL abnormal element states, providing information on Abort message, effect of SCSI Abort message, SCSI...
Page 134 Exabyte tape setting number of reserved storage with other media Enable Vital Product Data (EVPD) bit ENQ command, SSCL entry/exit port, identifying address of ESC command, SSCL Exabyte tape libraries, compatibility...
Page 135 10kdev_.book Page 125 Friday, March 12, 1999 9:44 AM moving media from moving to door positioning H command, SSCL Hardware Error sense key Help command, SSCL I command, SSCL Identify message, SCSI identifying failed library components peripheral device type specific reservation requests idle phase, SSCL Illegal Request sense key import/export element...
Page 136 10kdev_.book Page 126 Friday, March 12, 1999 9:44 AM Move Cleaning Cartridge command, SSCL Move Media command, SSCL Move Medium command, SCSI moving gripper arm moving media cleaning cartridges from a specific adress to another specific address from gripper arm to carousel slot from gripper arm to library door from gripper arm to tape drive into the library...
Page 137 10kdev_.book Page 127 Friday, March 12, 1999 9:44 AM reserved elements, setting number of reserving elements resets, soft Return Drive ECC Rate command, SSCL robotic gripper arm, identifying address Robotics Diagnostic Mode command, SSCL robotics motion command, testing readiness for S command, SSCL safety standards, library compliance with...
Page 138 Busy Check Condition Good Reservation Conflict status byte 7, ??–29 status of elements, returning storage element storage, identifying elements which can be used for supported summarized synchronous data transfer T command, SSCL tagged command queuing tape drives cleaning first location of...

Spectra Logic Spectra 10000 User Manual

Chapter 1 Serial SCSI Command Language

Chapter 2 SSCL Command Descriptions

Chapter 3 SCSI-2 Command Interface

Chapter 4 SCSI-2 Commands: Initialize Element Status

Chapter 5 SCSI-2 Commands: Inquiry

Chapter 6 SCSI-2 Commands: Mode Select

Chapter 7 SCSI-2 Commands: Mode Sense

Chapter 8 SCSI-2 Commands: Move Medium

Chapter 9 SCSI-2 Commands: Position to Element

Chapter 10 SCSI-2 Commands: Prevent/Allow Medium Removal

Chapter 11 SCSI-2 Commands: Read Element Status

Chapter 12 SCSI-2 Commands: Release

Chapter 13 SCSI-2 Commands: Request Sense

Chapter 14 SCSI-2 Commands: Reserve

Chapter 15 SCSI-2 Commands: Send Diagnostic

Chapter 16 SCSI-2 Commands: Test Unit Ready

Quick Links

Related Manuals for Spectra Logic Spectra 10000

Summary of Contents for Spectra Logic Spectra 10000

Table of Contents