1. Manuals
  2. Brands
  3. Dell Manuals
  4. Storage
  5. PowerVault TL2000
  6. Reference manual

Dell PowerVault TL2000 Reference Manual

Tape library scsi reference
Hide thumbs Also See for PowerVault TL2000:
Table of Contents

Advertisement

Quick Links

Download this manual See also: Configuration Manual, User Manual
™
™
Dell
PowerVault
TL2000/TL4000 Tape Library
SCSI Reference

Advertisement

Table of Contents
loading

Related Manuals for Dell PowerVault TL2000

Summary of Contents for Dell PowerVault TL2000

  • Page 1 ™ ™ Dell PowerVault TL2000/TL4000 Tape Library SCSI Reference...
  • Page 2 Dell, the DELL logo, and PowerVault are trademarks of Dell Inc. Other trademarks and trade names may be used in this document to refer to either the entities claiming the marks and names or their products. Dell Inc.

  • Page 3: Table Of Contents

    Contents Chapter 1. Introduction ......1-1 Chapter 2. Library Features ......2-1 Cleaning Cartridge Detection .
  • Page 4 Element Address Assignment page (1Dh) ..... . 3-33 Transport Geometry Parameters page (1Eh) ..... 3-34 Device Capabilities page (1Fh) .
  • Page 5 Disconnect ........4-2 Initiator Detected Error ......4-2 Abort .
  • Page 6 TL2000 and TL4000 SCSI Reference...

  • Page 7: Chapter 1. Introduction

    Chapter 1. Introduction ™ ™ This document describes the SCSI Media Changer Command Set for the Dell PowerVault TL2000 Tape Library and TL4000 Tape Library. The host will recognize both a tape drive and a Media Changer on the same SCSI ID. On this SCSI ID logical unit zero is reserved for the tape drive and logical unit one is used for the media changer.
  • Page 8 TL2000 and TL4000 SCSI Reference...

  • Page 9: Chapter 2. Library Features

    Chapter 2. Library Features The library includes the following components: v Operator panel with LCD display and 4 buttons which allows you to monitor the media changer operations, control robotic operation and change configuration settings v Bar code scanner, the media changer uses the bar code scanner to read the bar codes from the data cartridges and report this information as part of the cartridge inventory v Ethernet port for connecting to a 10/100Base T Ethernet network.

  • Page 10: About The Not Ready Condition

    Immediately after the user command is finished the media changer switches to on-line mode. Note the media changer is continuous off-line when it is configured into Sequential Mode. The concept of control modes is introduced to explain the owner of the media changer. If the media changer is on-line then the SCSI bus has control of the loader.

  • Page 11: Commands Allowed In The Presence Of Reservations

    Allowed commands during not ready state PREVENT/ALLOW MEDIUM REMOVAL (prevent=0) READ ELEMENT STATUS (curdata=1) READ ELEMENT STATUS (dvcid=1) RELEASE (6) RELEASE (10) REQUEST SENSE WRITE BUFFER Commands Allowed in the Presence of Reservations The details of which commands are allowed under a reservations are described in next table. The RESERVE and RELEASE commands are used to manage the reservation state of the library.

  • Page 12: Rmu Features

    RESERVE (6) conflict RESERVE (10) conflict SET TIMESTAMP conflict SEND DIAGNOSTIC conflict SEND VOLUME TAG conflict TEST UNIT READY conflict WRITE BUFFER conflict v allowed : Command received from SCSI initiators not holding the reservation should complete normally. v conflict : Commands received from SCSI initiators not holding the reservation shall terminate the command with a RESERVATION CONFLICT status.

  • Page 13: Tl2000 Tape Library Element Addressing

    TL2000 Tape Library Element Addressing Table 2-1. TL2000 Tape Library SCSI Element Types and Element Address Ranges Element Type Element Address Range Media Transport Element (MTE) 1 (0x01) I/O Station Element (IEE) 16 (0x10) Data Transfer Element (DTE) 256 (0x100) Storage Element (STE) 4096 (0x1000) - 4117 (0x1015) Table 2-2.

  • Page 14: Tl4000 Tape Library Element Addressing

    TL4000 Tape Library Element Addressing Table 2-3. TL4000 Tape Library SCSI Element Types and Element Addresses Element Type Element Address Range Media Transport Element (MTE) 1 (0x01) I/O Station Element (IEE) 16 (0x10), 17 (0x11), 18 (0x12) Data Transfer Element (DTE) 256 (0x100), 257 (0x101) Storage Element (STE) 4096 (0x1000) - 4139 (0x102B)

  • Page 15: Chapter 3. Supported Scsi Commands

    Chapter 3. Supported SCSI Commands The media changer SCSI command set supports the following commands: Command Operation Code Standard Support Status INITIALIZE ELEMENT STATUS SMC-2 supported INITIALIZE ELEMENT STATUS WITH RANGE SMC-2 supported INQUIRY SPC-3 supported LOG SELECT SPC-3 supported LOG SENSE SPC-3 supported...

  • Page 16: Initialize Element Status (07H)

    INITIALIZE ELEMENT STATUS (07h) This command directs the medium changer to check all existing elements for tape cartridges and any status relevant to that element. This command enables the initiator to get a quick response from a Read Element Status command that may follow, and is useful after a power failure, if tape medium has been changed by an operator, or if subsystem configuration has changed.

  • Page 17: Initialize Element Status With Range (37H)

    INITIALIZE ELEMENT STATUS WITH RANGE (37h) The INITIALIZE ELEMENT STATUS WITH RANGE command shall cause the media changer to check the specified elements for volume status and any other relevant status. This command enables the initiator to get a quick response from a Read Element Status command that may follow, and is useful after a power failure, if tape medium has been changed by an operator, or if subsystem configuration has changed.

  • Page 18: Inquiry (12H)

    INQUIRY (12h) The INQUIRY command requests that information regarding parameters of the medium changer be sent to the initiator. The media changer can provide two categories of data in response to an inquiry command: Standard Inquiry Data and Vital Product Data. Standard Inquiry Data contains basic data about the Medium Changer and Vital Product Data can comprise several pages of additional data.
  • Page 19 Byte SCCS TPGS Reserved Protect BQue EncServ Reserved MultiP MChngr Obsolete Obsolete Addr16 Obsolete Obsolete WBus16 Sync Linked Obsolete CmdQue Reserved Vendor Identification (8 ASCII bytes) 16 - Product Identification (16 ASCII bytes) 32 - Product Revision level (4 ASCII bytes) 36 - Plant of manufacturer 38 -...
  • Page 20 HiSup: A hierarchical support (HISUP) bit set to zero indicates the SCSI target device does not use the hierarchical addressing model to assign LUNs to logical units Response Data Format: This Standard Inquiry Data is in SCSI-2 format. Set to 2. Additional Length: The media changer uses this field to indicate the number of additional bytes of INQUIRY response data available.

  • Page 21: Supported Vital Product Data Page (00H)

    Vendor Identification: Eight byte ASCII string. This field is set to: Product Identification: Sixteen byte ASCII string. This field depends on the library model. This field is set to: Product Revision Level: This field contains 4 bytes of ASCII data that provides the media changer's software revision levels.

  • Page 22: Unit Serial Number Page (80H)

    Unit Serial Number page (80h) The Unit Serial Number VPD page contains 12 bytes of ASCII data representing a unique serial number of the media changer. Byte Peripheral Qualifier (0) Peripheral Device Type (8) Page Code (80h) Reserved Page Length (10h) Serial Number (12 ACSII bytes) 16 - Unique Logical Library Identifier...

  • Page 23: Firmware Built Information Page (C0H)

    Note: If an unsupported LUN was initially specified, the Peripheral Qualifier will return 3h and the Peripheral Device Type will return 1Fh. Field descriptions: Peripheral Qualifier: A return value of 0 indicates that the specified LUN is supported in this device. When a unsupported LUN was specified the Peripheral Qualifier will return 3h which indicates that specified LUN is not supported.

  • Page 24: Log Select (4Ch)

    LOG SELECT (4Ch) The LOG SELECT command provides a means for the host to clear the event log in the media changer. This event log is maintained in the media changer internal NVRAM and is therefore resistant to power failures. The only method to clear the event log is by means of a LOG SELECT command. Byte Operation Code (4Ch) Reserved...

  • Page 25: Log Sense (4Dh)

    LOG SENSE (4Dh) The LOG SENSE command allows the host to retrieve statistical information maintained by the media changer about its own hardware. The statistical information is divided over several pages. A LOG SENSE command will retrieve one of these pages. Byte Operation Code (4Dh) Reserved...

  • Page 26: Log Page Header Format

    Allocation Length: The Allocation Length field is used to inform the target how much space the initiator has allocated for data. The target returns the bytes specified by allocation length. Log Page Header format Each Log Sense page begins with a 4-byte header. Byte Reserved Page Code...

  • Page 27: Event Structure

    Byte Reserved Page Code (07h) Reserved 2 - 3 Page Length Events Structures xxxxh Field descriptions: Page Code: The Page Code echoes the page code that was specified in the LOG SENSE CDB. Page Length: The Page Length specifies the total number of event bytes, not including the four bytes for this header.
  • Page 28 TMC: No threshold supported, set to 0. The List Parameter field is set to zero for parameters that are counters and set to one for parameters that are not counters. Parameter Length: This field specifies the total length of the event structure, including the additional event data, but without the 4 byte header.

  • Page 29: Tape Alert Log Page (2Eh)

    SDCI 0100h Serial Monitor 0200h TNT Monitor 0400h Debug Monitor 0800h Test 1000h MN Server 2000h Network 4000h 8000h Next table describes the possible Data types of event data. Data type of event data Identifier Binary ASCII Tape Alert Log Page (2Eh) This page consists of the Page Header followed by 64 Tape Alert flags.
  • Page 30 Library v Make sure the media changer and drives are not being used by any Hardware D host, then reset the library from the front panel. v If the problem persists, contact Technical Support. Library Pick There is a potential problem with the cartridge loader picking a cartridge Retry from a drive or slot.

  • Page 31: Tape Alert Flag Structure

    v I = Informational suggestion to user v W = Warning. Remedial action is advised. Performance of data may be at risk. v C = Critical immediate remedial action is required. Tape Alert Flag structure Byte (MSB) Parameter Code (n) (LSB) DU(0) (DS(1)

  • Page 32: Statistic Counter Structure

    Page Length: The Page Length specifies the total number of bytes contained in this log page, not including the four bytes of the header. Statistic Counter structure Byte (MSB) Parameter Code (n) (LSB) DU(0) DS(1) TSD(0) ETC(0) TMC(0) Reserved Reserved LP(0) Parameter Length (4) (MSB)

  • Page 33: Error Log Page (33H)

    Number of Warning This 4 byte unsigned counter specifies the number of Entries Warning entries in the trace buffer. Number of This 4 byte unsigned counter specifies the number of Configuration Change Configuration Change entries in the trace buffer. Entries Error Log Page (33h) This page consists out of a Page Header followed by a FIFO containing the last 64 error events.
  • Page 34 Byte Error Event data (n bytes) 13 + (LSB) (n-1) (13 + (MSB) Error Event description (max. 80 ASCII characters) (LSB) Field descriptions: Parameter Code: The Parameter Code is a 2-byte value that uniquely identifies the error event structure the log. It ranges between 1 and 64.

  • Page 35: Mode Select 6 (15H)

    MODE SELECT 6 (15h) The MODE SELECT (6) command provides a means for the host to specify peripheral device parameters to the media changer. Application clients should issue MODE SENSE prior to each MODE SELECT to determine supported pages, page lengths, changeable variables and to determine is the page is savable to NVRAM.

  • Page 36: Mode Select Parameter List

    Device Capabilities Provides a means to set the media changers page capabilities. (not changeable). Event Filter page This page provides a means to mask certain (Vendor Specific) error event types from the event logging of the SCSI controller. Mode Select Parameter List The Mode Select parameter list shown below, contains a 4-byte header, followed by an optional 8 byte block descriptor after which the Mode Select pages are specified.

  • Page 37: Control Extension Page (0Ah)

    Parity: By means of this field the host can enable parity retires. Parity retries are by factory default enabled by the media changer. When cleared parity retries are disabled. Maximum Parity retries: This field indicates the maximum number of retries performed on a parity error during data out, data in, and message out phase.

  • Page 38: Element Address Assignment Page (1Dh)

    Field descriptions: Perf: When this bit is set to 0, this indicates that informational exception operations that can cause delays are acceptable. This bit should be set to zero. Dexcpt: When this bit is set to zero the reporting method indicated by the MRIE field is used. When this bit is set to one this indicates that the media changer shall disable all information exception operations, ignoring the MRIE field (In this mode the initiator must the poll the Tape Alert log page).

  • Page 39: Transport Geometry Parameters Page (1Eh)

    Field descriptions: First Medium Transport Element Address: By means of this field the host can specify the address of the accessor cartridge handler. Number of Medium Transport Elements: By means of this field the host can specify the number of robotic cartridge handlers within the library.

  • Page 40: Device Capabilities Page (1Fh)

    Device Capabilities page (1Fh) The Device Capabilities Page defines the characteristics of the element types used by this medium changer. The initiator cannot change this information. Byte Reserved SPF (0) Page Code (1Fh) Additional Page Length (12h) Reserved Reserved VTRP MT→RA Reserved MT→DT...

  • Page 41: Vendor Specific Event Filter Page (20H)

    XX→YY: (Where XX is a valid source and YY is a valid destination address) If one of these bits is set to 1, it indicates that the medium changer device supports all Move Medium commands for which the source is element type XX and the destination is element type YY on the condition that the element addresses are valid.
  • Page 42 Sequential or Random mode. This mode cannot be changed by means of this page, it can only be changed by means of the OCP. Therefore the value set for this bit is ignored. Event Type Filter: The Event Type Filter field determines which event types will be stored in the event log. This field is a 8 bit mask.

  • Page 43: Mode Select 10 (55H)

    MODE SELECT 10 (55h) The MODE SELECT (10) command provides a means for the host to specify peripheral device parameters to the media changer. Application clients should issue MODE SENSE prior to each MODE SELECT to determine supported pages, page lengths, changeable variables and to determine is the page is savable to NVRAM.

  • Page 44: Mode Sense 6 (1Ah)

    MODE SENSE 6 (1Ah) The MODE SENSE (6) command provides a means for a device server to report parameters to an application client. It is a complementary command to the MODE SELECT (6) command. Byte Operation Code (1Ah) Reserved Reserved Page Code Subpage Code Allocation length...

  • Page 45: Mode Parameter List

    All pages Returns all Mode Sense pages in incrementing order. All pages including Returns all Mode Sense pages including subpages subpages in incrementing order. Note: The number bytes column does not include the Parameter List Header and the (optional) Block Descriptor.

  • Page 46: Parity Page (00H)

    Parity page (00h) By means of the Parity page the host can enable Parity retries and select the maximum number of retries. Byte PS (1) SPF (0) Page Code (00h) Additional Page Length (02h) Reserved Parity Reserved Maximum Parity retries Field descriptions: Parameters Savable.

  • Page 47: Tape Alert Page (1Ch)

    IALUAE: An implicit asymmetric logical unit access enabled (IALUAE) bit set to zero. The media changer does not allow implicit asymmetric logical unit access state changes. Tape Alert page (1Ch) By means of this page the host can retrieve the tape alerts logging method. Byte PS (0) SPF (1)

  • Page 48: Transport Geometry Parameters Page (1Eh)

    Byte PS (1) SPF (0) Page Code (1Dh) Additional Page Length (12h) 2 - 3 First Medium Transport Element Address 4 - 5 Number of Medium Transport Elements 6 - 7 First Storage Element Address 8 - 9 Number of Storage Elements 10 - First Import / Export Element Address 12 -...

  • Page 49: Device Capabilities Page (1Fh)

    medium transport element is capable of media rotation. Byte PS (0) SPF (0) Page Code (1Eh) Additional Page Length (02h) Reserved Rotate (0) Member Number in Transport Element Set (0) Field descriptions: Parameter Saveable. This field is set to 0. The media changer cannot save this page to non-volatile memory.

  • Page 50: Vendor Specific Event Filter Page (20H)

    Byte I/E→WA Reserved I/E↔DT I/E↔I/E I/E↔ST I/E↔ST DT→WA Reserved DT↔DT DT↔I/E DT↔ST DT↔ST 16 - Reserved Field descriptions: Parameters Savable. This field is set to zero. the media changer cannot write this page to non-volatile memory. Data Transfer. The value for this field is 1. Tape drives can store cartridges. I/E: Import/Export.
  • Page 51 Byte PS (1) SPF (0) Page Code (20h) Additional Page Length (08h) Reserved Reserved Log Mode Reserved Reserved Seq Mode Reserved Event Type Filter 8 - 9 Event Module Filter Field descriptions: Parameters Savable. This field is set to one. The media changer can write this page to non-volatile memory.
  • Page 52 Event Module Filter: The Trace Module Filter field determines which firmware module is allowed to store events. This field is a 16 bit mask. Every bit in this mask represents a firmware module. When a mask bit is set the subsequent module is allowed to store its event data in the event log. When a mask bit is cleared the event data of the subsequent firmware module will be discarded.

  • Page 53: Mode Sense 10 (5Ah)

    MODE SENSE 10 (5Ah) The MODE SENSE (10) command provides a means for a device server to report parameters to an application client. It is a complementary command to the MODE SELECT command. For documentation on the supported Mode Pages refer to the Mode Sense (6) command. Byte Operation Code (5Ah) Reserved...

  • Page 54: Mode Parameter Header

    Mode Parameter Header The returned data on a Mode Sense (10) command begins with an eight byte Mode Parameter Header. This header has the following structure: Byte (MSB) Mode Data Length (LSB) Reserved Reserved Reserved Reserved (MSB) Block Descriptor Length (LSB) Field descriptions: Mode Data Length:...

  • Page 55: Move Medium (A5H)

    MOVE MEDIUM (A5h) The Move Medium command is used to move tape cartridges from one element address to another specific element address. The library can transfer cartridges between Storage Elements, Import/Export Elements, and Data Transfer Elements. Byte Operation Code (A5h) Reserved (MSB) Medium Transport Address...

  • Page 56: Persistent Reserve In (5Eh)

    PERSISTENT RESERVE IN (5Eh) The PERSISTENT RESERVE IN command is used to obtain information about persistent reservation keys that are active within a library. This command is used in conjunction with the PERSISTENT RESERVE OUT command. Byte Operation Code (5Eh) Service Action Reserved Reserved...

  • Page 57: Persistent Reserve In Parameter Data For Read Reservation

    Byte n - 7 (MSB) Last reservation key (LSB) Field descriptions: Generation: See SPC-3 r23. Additional Length: See SPC-3 r23. Reservation Key List: See SPC-3 r23. PERSISTENT RESERVE IN Parameter Data for Read Reservation The format for the parameter data provided in response to a PERSISTENT RESERVE IN command with the Read Reservation service action is shown below: Byte (MSB)
  • Page 58 Byte (LSB) Reserved Scope Type (MSB) Obsolete (LSB) Field descriptions: Reservation Key: See SPC-3 r23. Scope-Specific Address: See SPC-3 r23. Scope: See SPC-3 r23. Type: See SPC-3 r23. 3-44 TL2000 and TL4000 SCSI Reference...

  • Page 59: Persistent Reserve Out (5Fh)

    PERSISTENT RESERVE OUT (5Fh) The PERSISTENT RESERVE OUT command is used to request service actions that reserve the whole library or certain elements for the exclusive or shared use of a particular initiator. The command uses other service actions to manage and remove such reservations. The command shall be used in conjunction with the PERSISTENT RESERVE IN command and shall not be used with the RESERVE and RELEASE commands.

  • Page 60: Persistent Reserve Out Parameter List

    Persistent reservation applies to the full logical unit Obsolete Persistent reservation applies to the specified element 3h - Fh Reserved Parameter List Length: The Parameter List Length shall be set to the length of the Persistent Reserve Out Parameter List structure.

  • Page 61: Open/Close Import/Export Element (1Bh)

    OPEN/CLOSE IMPORT/EXPORT ELEMENT (1Bh) The OPEN/CLOSE IMPORT/EXPORT ELEMENT command allows an application client to open the Import/Export element, also referred to as I/O Station. When the action code is set to Open Import/Export Element, the library will open the import/export element. The library will not return a Check Condition status when the import/export element was already open.

  • Page 62: Position To Element (2Bh)

    POSITION TO ELEMENT (2Bh) The POSITION TO ELEMENT allows the initiator to position the Medium Transport Element to a specific element address position. This destination address can be a Storage Element, Import/Export Element or a Data Transfer Element address. Byte Operation Code (2Bh) Reserved (MSB)

  • Page 63: Prevent / Allow Media Removal (1Eh)

    PREVENT / ALLOW MEDIA REMOVAL (1Eh) The PREVENT / ALLOW MEDIA REMOVAL commands enable or disable removing cartridges from the media changer. A prevent condition inhibits the media changer to remove magazines and open the Import/Export element. A prevent condition of the media changer shall not affect an UNLOAD command issued to the tape drive.

  • Page 64: Read Buffer (3Ch)

    READ BUFFER (3Ch) The READ BUFFER command is used in conjunction with Write Buffer as a diagnostic function for testing the media changer’s data buffer and the SCSI bus integrity. It is also used to read out Vendor Specific settings. Byte Operation Code (3Ch) Reserved...

  • Page 65: Descriptor Mode

    The following structure specifies the Variables Setting page. A WRITE BUFFER command to this page is used to update the setting variables in NV-RAM. Byte Reserved Additional Page Length (2Ch) Reserved Reserved (MSB) Current Setting Variables (42 bytes) (LSB) Note: For a description of the possible Setting Variables, see the table at the WRITE BUFFER command. Descriptor Mode In this mode, the media changer returns the Buffer Capacity of the specified Buffer ID in Data Mode.

  • Page 66: Echo Mode

    Byte 0 - n (data defined by previous Data Mode WRITE BUFFER command) Echo Mode In this mode, the library returns the same number of bytes of data as received in the prior Echo Mode WRITE BUFFER command from the same host. If a prior Echo Mode WRITE BUFFER command did not complete successfully the Echo Mode READ BUFFER command shall return Check Condition status.

  • Page 67: Read Element Status (B8H)

    READ ELEMENT STATUS (B8h) The READ ELEMENT STATUS command is sent to a target from the initiator requesting that the target report the status of its internal elements. Byte Operation Code (B8h) VolTag Element Type Code (MSB) Starting Element Address (LSB) (MSB) Number of Elements...

  • Page 68: Element Status Data

    DVCID: If the DVCID bit is set the media changer will return device identifiers for the Data Transfer element. A DVCID bit of zero specifies that the device shall not return device identifiers. Allocation Length: This field specifies the number of bytes that the initiator has allocated for returned data. Note that the Read Element Status command can be issued with an Allocation Length specified as 8 bytes (the length of the status page header) to determine the Allocation Length required to transfer all of the element status data that become available as a result of the command.

  • Page 69: Medium Transport Element Status Page (01H)

    Byte Reserved 5 - 7 Byte Count of Descriptor Data Available Field descriptions: Element Type Code: This field specifies the element type of the next element descriptor(s). The supported element type descriptors are: Medium Transport Element Storage Element Import / Export Element Data Transfer Element PVolTag: Primary Volume Tag.
  • Page 70 Byte Reserved Except Reserved Full Reserved Additional Sense Code Additional Sense Code Qualifier 14 - Reserved SValid Invert Reserved Medium Type 18 - Source Storage Element Address 20 - Primary Volume Tag Information (field omitted if PVolTag = 0) 56 - Reserved (field moved up if Primary Volume Tag Information field is omitted) Field descriptions:...

  • Page 71: Storage Element Status Page (02H)

    An ED bit of one indicates the element is disabled. An ED bit value of zero indicates the element is enabled. Medium Type: The Medium Type field provides the type of medium currently present in the Media Transfer Element. The next table describes the values for the Medium Types. Unspecified Data Medium Cleaning Medium...
  • Page 72 Byte Reserved Additional Sense Code Additional Sense Code Qualifier 14 - Reserved SValid Invert Reserved Medium Type 18 - Source Storage Element Address 20 - Primary Volume Tag Information (field omitted if PVolTag = 0) 56 - Reserved (field moved up if Primary Volume Tag Information field is omitted) Field descriptions: PVolTag: Primary Volume Tag.

  • Page 73: Import/Export Element Status Page (03H)

    An ED bit of one indicates the element is disabled (for example, a magazine is not installed or has been logical disabled). An ED bit value of zero indicates the element is enabled. Medium Type: The Medium Type field provides the type of medium currently present in the Storage Element. The next table describes the values for the Medium Types.
  • Page 74 Byte InEnab ExEnab Access Except ImpExp Full Reserved Additional Sense Code Additional Sense Code Qualifier 14 - Reserved SValid Invert Reserved Medium Type 18 - Source Storage Element Address 20 - Primary Volume Tag Information (field omitted if PVolTag = 0) 56 - Reserved (field moved up if Primary Volume Tag Information field is omitted)
  • Page 75 Enable bit of one indicates that the import/export element supports movement of media out of the scope of the media changer device. An InEnab bit of zero indicates that this element does not support export actions. CMC: Connected Media Changer bit of one indicates that exports are to a connected media changer. A CMC bit of zero indicates that exports are to the operator and imports are from the operator.

  • Page 76: Data Transfer Element Status Page (04H)

    Element not yet scanned The media changer has not scanned this element up to now. No bar code label The element contains a cartridge without a readable bar code label. Data Transfer Element Status Page (04h) The Data Transfer Element is the device that stores user data on the cartridges in the library (aka Tape Drive).
  • Page 77 AVolTag: Alternate Volume Tag. The library does not support dual sided media. Therefore the Alternate Volume Tag label is always set to zero even when the VolTag bit is set in the CDB. Data Transfer Element Address: This field provides the address of the data transfer element of this changer device whose status is reported by this element descriptor block.
  • Page 78 Source Storage Element Address: This field provides the address of the last storage element from which the tape cartridge was moved (valid only if the SValid bit is 1). Primary Volume Tag Information: When VolTag in CDB was set the media changer will return a 36 byte PVolTag Identifier. This identifier will contain the bar code label of the cartridge mounted in the tape drive.

  • Page 79: Release 6 (17H)

    RELEASE 6 (17h) The RELEASE command is used to release a previously reserved logical unit. Byte Operation Code (17h) Obsolete Obsolete Reserved Reserved Control Field descriptions: 3-65 Chapter 3. Supported SCSI Commands...

  • Page 80: Release 10 (57H)

    RELEASE 10 (57h) The RELEASE 10 command is used to release a previously reserved logical unit. This library supports Third-Party reservation. Third-Party release allows an application client to release a logical unit that was previously reserved using third party reservation. Byte Operation Code (57h) 3rdPty...

  • Page 81: Report Supported Operation Codes (A3H)

    REPORT SUPPORTED OPERATION CODES (A3h) The REPORT SUPPORTED OPERATION CODES command requests information on commands the addressed logical unit supports. An application client may request a list of all operation codes and service actions supported by the media changer. Byte Operation Code (A3) Service Action (0Ch) Reserved...
  • Page 82 Allocation Length: The Allocation length field specifies the length in bytes that the initiator has allocated for returned data. The REPORT SUPPORTED OPERATION CODES all_commands parameter data format begins with a four-byte header that contains the length in bytes of the parameter data followed by a list of supported commands.
  • Page 83 Support Description 000b Data about the requested SCSI command is not currently available. All data after byte 1 is not valid. A subsequent request for command support data may be successful. 001b The device server does not support the requested command. All data after byte 1 is undefined. 010b Reserved 011b...

  • Page 84: Report Timestamp (A3H)

    REPORT TIMESTAMP (A3h) The REPORT TIMESTAMP command requests that the library return the value of the logical unit s timestamp. Byte Operation Code (A3) Service Action (0Fh) Reserved Reserved Reserved Reserved (MSB) Allocation Length (LSB) Reserved Control Field descriptions: Allocation Length: The Allocation Length field specifies the number bytes the application client has allocated for the returned data.
  • Page 85 000b Timestamp initialized to zero at power-on or as the result of a hard reset 001b Reserved 010b Timestamp initialized by the SET TIMESTAMP command 011b Timestamp initialized by methods outside the scope of this standard TimeStamp : The Timestamp field contains the current value of the timestamp. The Time Stamp field returns the number of milliseconds that have elapsed since midnight, 1 January 1970 UT.

  • Page 86: Send Diagnostic (1Dh)

    SEND DIAGNOSTIC (1Dh) By means of this command the media changer can be requested to perform a self-test operation on itself. During this self-test the serial communication to the tape drive and robotics is tested. Also any pending Hardware Error condition is reported on this command. Byte Operation Code (1Dh) PF (1)

  • Page 87: Send Volume Tag (B6H)

    SEND VOLUME TAG (B6h) The SEND VOLUME TAG command transfers a volume tag template to be used for a search of existing volume tag information or new volume tag information for one media changer element address. The function of the command is conveyed by the Send Action Code field value. The REQUEST VOLUME ELEMENT ADDRESS command may be used to transfer the results of a translate search operation.

  • Page 88: Send Volume Tag Parameter Structure

    Parameter List Length: The Parameter List Length field shall be zero when the Send Action Code is an undefine function. The Parameter List Length shall be set to the length of the Send Volume Tag Parameter structure. Send Volume Tag Parameter structure Byte (MSB) Volume Identification Template...

  • Page 89: Set Timestamp (A4H)

    SET TIMESTAMP (A4h) The SET TIMESTAMP command requests the device server to initialize the timestamp in the media changer, if the SCSIP bit is set to one or the TCMOS bit is set to one in the Control Extension mode page. If the SCSIP bit is set to zero, the SET TIMESTAMP command shall be terminated with CHECK CONDITION status, with the sense key set to ILLEGAL REQUEST, and the additional sense code set to INVALID FIELD IN CDB.

  • Page 90: Request Sense (03H)

    REQUEST SENSE (03h) The REQUEST SENSE command tells the library to transfer sense data to the initiator. Byte Operation Code (03h) Reserved Reserved Reserved Allocation Length Control Field descriptions: Allocation length: This field specifies the maximum sense data length the hosts wants to receive. The sense data is valid for a check condition status returned on the previous command.

  • Page 91: Possible Sense Keys

    Response Code: A value of 70h indicates a current error the report is associated with the most recently received command. Response code value 71h (deferred errors) not implemented. No other values are returned. Segment Number: This byte contains the number of the current segment descriptor if the Request Sense command is the response to a Copy, Compare or Copy and Verify command.
  • Page 92 ILLEGAL REQUEST Indicates that there was an illegal parameter in the command descriptor block or in the additional parameters supplied as data for some commands UNIT ATTENTION Indicates that the removable medium may have been changed or the target has been reset. ABORTED COMMAND Indicates that the device server aborted the command.

  • Page 93: Request Volume Element Address (B5H)

    REQUEST VOLUME ELEMENT ADDRESS (B5h) The REQUEST VOLUME ELEMENT ADDRESS command is used to transfer the results of the SEND VOLUME TAG command. Multiple REQUEST VOLUME ELEMENT ADDRESS commands may be used to retrieve the results of a single SEND VOLUME TAG command with the translate option. Byte Operation Code (B5h) VolTag...

  • Page 94: Request Volume Element Address Header

    Request Volume Element Address header Byte (MSB) First Element Address Reported (LSB) (MSB) Number of Elements Reported (LSB) Reserved Send Action Code (MSB) Byte Count of Report Available (LSB) Field descriptions: First Element Address Reported: This field indicates the element address of the element with the smallest element address found to meet the Send Volume Tag command s request.

  • Page 95: Reserve 6 (16H)

    RESERVE 6 (16h) The RESERVE command allows the initiator to reserve the library. After reserving the library, only the INQUIRY, LOG SENSE, RELEASE, REQUEST SENSE, REPORT LUNS, READ ELEMENT STATUS with CurData set and ALLOW MEDIUM REMOVAL commands are accepted from other initiators. All other commands result in a Reservation Conflict status.

  • Page 96: Reserve 10 (56H)

    RESERVE 10 (56h) The RESERVE and RELEASE commands provide the mechanism for contention resolution in multiple initiator systems. The third-party reservation allows logical units to be reserved for another specified SCSI device. When a initiator reserves the library, only INQUIRY, LOG SENSE, RELEASE, REQUEST SENSE, REPORT LUNS, READ ELEMENT STATUS with CurData set and ALLOW MEDIUM REMOVAL commands are accepted from other initiators.

  • Page 97: Test Unit Ready (00H)

    TEST UNIT READY (00h) TEST UNIT READY checks if the media changer is ready for commands involving cartridge movement. If the media changer has completed initialization and the magazines are inserted, the command returns Good Status. Otherwise, Check Condition is reported. Due to power cycle, code update, etc., it is possible to get multiple check conditions on TEST UNIT READY commands.

  • Page 98: Write Buffer (3Bh)

    WRITE BUFFER (3Bh) Write Buffer is used with Read Buffer as a diagnostic function for testing the device data buffer, DMA engine, SCSI bus interface hardware, and SCSI bus integrity. Additional modes are provided for downloading and saving micro code and updating Vendor Unique settings. Byte Operation Code (3Bh) Reserved...

  • Page 99: Download Microcode And Download Microcode And Save Mode

    Download microcode and Download microcode and save Mode In these modes, vendor-specific micro code shall be transferred to the media changer and, if the WRITE BUFFER command is completed successfully, also shall be saved in a non-volatile memory. The downloaded code shall then be effective after each power-cycle. The firmware image can be sent in variable length blocks, the buffer offset should be the incremental of the previously send code.
  • Page 100 3-86 TL2000 and TL4000 SCSI Reference...

  • Page 101: Chapter 4. Messages

    Chapter 4. Messages The message system allows communication between the host and the media changer logical unit for the purpose of physical path management. Description Code Direction COMMAND COMPLETE EXTENDED MESSAGES In / Out SAVE DATA POINTERS RESTORE POINTERS DISCONNECT INITIATOR DETECTED ERROR ABORT MESSAGE REJECT...

  • Page 102: Save Data Pointers

    The Wide Data Transfer Request message is used to negotiate the width of the data path for the data transfers between the media changer and the initiator. The width applies to data phases only. The media changer does not support wide data transfers. When it receives a WDTR message from the initiator, it returns a WDTR message with a transfer width exponent of 0 (8-bit transfer width).

  • Page 103: No Operation

    No Operation The NO-OP message is sent from an initiator to inform the target that no message is valid in response to the target request for a message. The media changer does not take any action in response to the No Operation message;...
  • Page 104 TL2000 and TL4000 SCSI Reference...

  • Page 105: Chapter 5. Command Status Byte

    Chapter 5. Command Status Byte The media changer enters the status phase once per command and returns the following status bytes. Status Value Description Good This status indicates, that the media changer successfully completed the command Check condition An error condition occurred during command processing. The REQUEST SENSE command responds with detailed error information Busy...
  • Page 106 TL2000 and TL4000 SCSI Reference...

  • Page 107: Chapter 6. Command Timeouts

    Chapter 6. Command Timeouts Next table will list the library media changer commands with the recommended maximum time-out values. Note: If the library is working in a multi host environment, the time-out values should be adjusted for the worst case time-out value from a pending motion command from another host. Op Code SCSI Command Command Timeout...
  • Page 108 SEND VOLUME TAG 30 seconds SET TIMESTAMP 30 seconds TEST UNIT READY 10 seconds WRITE BUFFER 3 minutes Notes: 1. The Initialize Element Status time-out assumes a fully populated unit. 2. The Initialize Element Status With Range time-out assumes a fully populated unit. 3.

  • Page 109: Chapter 7. Sense Keys, Asc, And Ascq

    Chapter 7. Sense Keys, ASC, and ASCQ Sense Key ASCQ Description Recovered Error (01) Error log overflow SCSI parity error Not Ready (02) Drive cleaning requested Cause not reportable In progress becoming ready, scanning magazines, etc. Initializing command required Manual intervention required Operation in progress Offline Door open...
  • Page 110 Sense Key ASCQ Description Hardware Error (04) Cannot initialize bar code reader No response from bar code reader No response from EEPROM Slave robotic generic problem Setting of gripper pic value failed Setting of slider pic value failed Setting of elevator pic value failed Setting of rotation pic value failed Setting of sled pic value failed Gripper blocked...
  • Page 111 Sense Key ASCQ Description Hardware Error (04) Network init (continued) Telnet interface Webserver EEPROM parameter Cannot init LAN card Write to EEPROM failed Ping command did not reach target Cannot upgrade from USB ROM error RAM error NVRAM error CTC error UART error Display error Memory error...
  • Page 112 Sense Key ASCQ Description Illegal Request (05h) Parameter length error Invalid command operation code Invalid element address Invalid field CDB SCSI invalid ID message Invalid LUN Command sequence error Invalid field in parameter list Parameter list error: parameter not supported Parameter value invalid Wrong firmware image, does not fit boot code Wrong personality firmware image...
  • Page 113 Sense Key ASCQ Description Command Aborted (0Bh) ECHO buffer overwritten SCSI message error SCSI parity error SCSI invalid message Overlapped command attempt Chapter 7. Sense Keys, ASC, and ASCQ...
  • Page 114 TL2000 and TL4000 SCSI Reference...

  • Page 115: Index

    Index Numerics console features 2-4 00h (TEST UNIT READY) 3-83 control modes 2-1 03h (REQUEST SENSE) 3-76 07h (INITIALIZE ELEMENT STATUS) 3-2 12h (INQUIRY) 3-4 16h (RESERVE) 3-81 disconnect 4-2 17h (RELEASE) 3-65 drive 1Ah (MODE SENSE) 3-30 auto clean mode 2-1 1Bh (OPEN/CLOSE IMPORT/EXPORT user commanded cleaning 2-1 ELEMENT) 3-47...
  • Page 116 restore pointers 4-2 PERSISTENT RESERVE IN (5Eh) 3-42 features 2-4 PERSISTENT RESERVE OUT (5Fh) 3-45 POSITION TO ELEMENT (2Bh) 3-48 PREVENT / ALLOW MEDIA REMOVAL (1Eh) 3-49 save data pointers 4-2 SEND DIAGNOSTIC (1Dh) 3-72 SEND VOLUME TAG (B6h) 3-73 READ BUFFER (3CH) 3-50 Sense keys 7-1 READ ELEMENT STATUS (B8h) 3-53...

This manual is also suitable for:

Powervault tl4000

Table of Contents