Dell™ PowerVault™ TL2000/TL4000 Tape Library SCSI Reference
Second Edition (March 2007) | Information in this document is subject to change without notice. | ©2007 Dell Inc. All rights reserved. | | | | Reproduction in any manner whatsoever without the written permission of Dell Inc. is strictly forbidden. Trademarks used in this text: 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.
Contents Chapter 1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-1 Chapter 2. Library Features . . . . . . . . . Cleaning Cartridge Detection . . . . . . . . . Auto Clean Mode . . . . . . . . . . . . . User Commanded Cleaning . . . . . . . . . Control Modes . . . . . . . . . . . . . . About the Not Ready Condition . . . . . . . . Commands Allowed in the Presence of Reservations RMU Features . . . . . . . . . . . . . . Operator Control Panel Features . . . . . . .
Element Address Assignment page (1Dh) . . . . . . . . . . Transport Geometry Parameters page (1Eh) . . . . . . . . . Device Capabilities page (1Fh) . . . . . . . . . . . . . . Vendor Specific Event Filter page (20h) . . . . . . . . . . MODE SENSE 10 (5Ah) . . . . . . . . . . . . . . . . . Mode Parameter List . . . . . . . . . . . . . . . . . Mode Parameter Header . . . . . . . . . . . . . . . . MOVE MEDIUM (A5h) . . . . . . . . . . . . . . . . . . PERSISTENT RESERVE IN (5Eh) . . . . . . . . . . . . .
Disconnect . . . . Initiator Detected Error Abort . . . . . . . Message Reject . . . No Operation . . . . Message Parity Error . Bus Device Reset . . Identify . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
vi TL2000 and TL4000 SCSI Reference
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. The tape drive will pass the received SCSI commands for LUN 1 over to the attached library controller by means of serial communication.
1-2 TL2000 and TL4000 SCSI Reference
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.
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. When the media changer is in OCP Control mode the OCP has control of the media changer.
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. Next table shows all commands allowed in the presence of reservations.
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. RMU Features The library is equipped with a Remote Management Unit.
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.
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) Table 2-4.
Chapter 3.
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. The library shall not return GOOD status until checking of all the elements is complete.
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.
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. Each Vital Product Data page requires a separate INQUIRY command from the initiator.
Bit 7 6 5 4 3 2 1 0 5 SCCS ACC 6 BQue EncServ Reserved MultiP MChngr Obsolete Obsolete Addr16 7 Obsolete Obsolete WBus16 Sync Linked Obsolete CmdQue Reserved Byte TPGS 3PC Reserved 815 Vendor Identification (8 ASCII bytes) 16 31 Product Identification (16 ASCII bytes) 32 35 Product Revision level (4 ASCII bytes) 36 37 Plant of manufacturer 38 49 Serial Number (12 ASCII bytes) 50 54 Reserved 55 Protect Reserved 56 BarC Clocking 57 Reserved 58 59 Version De
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. SCCS: The media changer does not contain an embedded storage array controller component. Set to 0.
Vendor Identification: Eight byte ASCII string. This field is set to: 0 1 2 I B M 3 4 5 6 7 Product Identification: Sixteen byte ASCII string. This field depends on the library model. This field is set to: 0 1 2 3 4 5 6 3 5 7 3 - T L 7 8 9 10 11 12 13 14 15 Product Revision Level: This field contains 4 bytes of ASCII data that provides the media changer's software revision levels.
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.
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. Peripheral Device Type: Indicates that this is a medium changer device. Set to 8.
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.
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.
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. Bit 7 6 5 4 3 2 1 0 Byte 0 Reserved Page Code 1 Reserved 2-3 Page Length Field descriptions: Page Code: The Page Code echoes the page code that was specified in the CDB.
Bit 7 6 5 4 3 2 1 0 Byte 0 Reserved Page Code (07h) 1 Reserved 2-3 Page Length 4xxxxh Events Structures 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. Event Structure: An event structure consists of a header and a variable number of event data bytes. This structure is defined in the next table.
TMC: No threshold supported, set to 0. LP: 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. Event type: This field specifies the event type. Possible event types are shown in table below. Source module ID of event: This field specifies the module ID that generated the event.
SDCI 0100h Serial Monitor 0200h TNT Monitor 0400h Debug Monitor 0800h Test 1000h MN Server 2000h Network 4000h RMU 8000h Next table describes the possible Data types of event data. Data type of event data Identifier Binary 00h ASCII 01h Tape Alert Log Page (2Eh) This page consists of the Page Header followed by 64 Tape Alert flags. Each Tape Alert flag stands for a pre-determined media changer specific error condition. Tape Alert Flags range from 1 until 64.
04d Library Hardware D C v Make sure the media changer and drives are not being used by any host, then reset the library from the front panel. v If the problem persists, contact Technical Support. 13d Library Pick Retry W There is a potential problem with the cartridge loader picking a cartridge from a drive or slot. v No action needs to be taken at this time. v If the problem persists, contact Technical Support This flag is cleared when the next move command is received.
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.
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 Bit 7 6 5 4 3 2 1 0 Byte 0 (MSB) Parameter Code (n) 1 (LSB) 2 DU(0) DS(1) TSD(0) 3 ETC(0) TMC(0) Reserved Reserved LP(0) Parameter Length (4) 4 (MSB) 5 Statistic Counter Value 6 7 (LSB) Field descriptions: Parameter Code : The Parameter Code is a 2-byte value that uniquely identifies the parameter within the log.
8 Number of Warning Entries This 4 byte unsigned counter specifies the number of Warning entries in the trace buffer. 0 0 9 Number of Configuration Change Entries This 4 byte unsigned counter specifies the number of Configuration Change entries in the trace buffer. 0 0 Error Log Page (33h) This page consists out of a Page Header followed by a FIFO containing the last 64 error events. This log data is helpful to determine the error history of the media changer.
Bit 7 6 5 4 3 2 1 0 Byte ... Error Event data (n bytes) 13 + (n-1) (13 + n (LSB) (MSB) ... Error Event description (max. 80 ASCII characters) 96 (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. DU: Disable Update is set for any parameter that the Host cannot reset. DS: Disable Save. The media changer has no support for SP bit. Set to 1.
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.
1Fh 00h Device Capabilities page No Provides a means to set the media changers capabilities. (not changeable). 20h 00h Event Filter page (Vendor Specific) Yes This page provides a means to mask certain 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.
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. The number of parity retries is by factory default set to 4. The maximum value allowed in the parity retry field is 7.
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).
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. If the Number of Medium Transport Elements is greater than the default value returned in the Mode Sense parameter data, the library shall return a Check Condition.
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.
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.
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. Every bit in this mask represents a event type. When a mask bit is set all events with the subsequent event type will be stored in the event log.
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. For documentation on the supported Mode Select pages refer to the Mode Select (6) description.
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. Bit 7 6 5 4 3 2 1 0 Byte 0 Operation Code (1Ah) 1 LUN 2 Reserved PC DBD Reserved Page Code 3 Subpage Code 4 Allocation length 5 Control Field descriptions: DBD: The Disable Block Descriptors bit specifies if the media changer may return block descriptor after the Parameter List Header.
3Fh 00h 68 All pages Returns all Mode Sense pages in incrementing order. 3Fh FFh 100 All pages including subpages Returns all Mode Sense pages including subpages in incrementing order. Note: The number bytes column does not include the Parameter List Header and the (optional) Block Descriptor. A page code of 3Fh indicates that all mode pages shall be returned to the application client. These pages will be returned in ascending order except for Mode Page 00h.
Parity page (00h) By means of the Parity page the host can enable Parity retries and select the maximum number of retries. Bit 7 6 5 PS (1) SPF (0) 4 3 2 1 0 Byte 0 Page Code (00h) 1 Additional Page Length (02h) 2 Reserved Parity 3 Reserved Maximum Parity retries Field descriptions: PS: Parameters Savable. This field is set to one. The media changer can write this page to non-volatile memory. Parity: This bit indicates whether parity retries are enabled or disabled.
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.
Bit 7 6 PS (1) SPF (0) 5 4 3 2 1 0 Byte 0 Page Code (1Dh) 1 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 11 First Import / Export Element Address 12 13 Number of Import / Export Elements 14 15 First Data Transfer Element Address 16 17 Number of Data Transfer Element 18 Reserved 19 Reserved Field descriptions: PS: Parameter Saveable.
medium transport element is capable of media rotation. Bit 7 6 5 PS (0) SPF (0) 4 3 2 1 0 Byte 0 Page Code (1Eh) 1 Additional Page Length (02h) 2 Reserved 3 Rotate (0) Member Number in Transport Element Set (0) Field descriptions: PS: Parameter Saveable. This field is set to 0. The media changer cannot save this page to non-volatile memory. Rotate: Rotation of media is not an implemented feature, so the value returned for this field bit is 0.
Bit 7 6 5 4 3 2 1 0 I/E↔DT I/E↔I/E I/E↔ST I/E↔ST (0) (0) (0) (0) DT↔DT DT↔I/E DT↔ST DT↔ST (0) (0) (0) (0) Byte I/E→WA 14 Reserved (0) DT→WA 15 Reserved (0) 16 19 Reserved Field descriptions: PS: Parameters Savable. This field is set to zero. the media changer cannot write this page to non-volatile memory. DT: Data Transfer. The value for this field is 1. Tape drives can store cartridges. I/E: Import/Export. The value for this field is 1.
Bit 7 6 PS (1) SPF (0) 5 4 3 2 1 0 Byte 0 Page Code (20h) 1 Additional Page Length (08h) 2 Reserved 3 Reserved 4 Log Mode Reserved 5 Reserved Seq Mode 6 Reserved 7 Event Type Filter 8-9 Event Module Filter Field descriptions: PS: Parameters Savable. This field is set to one. The media changer can write this page to non-volatile memory. Seq Mode: This bit indicates the operational mode of the library. When set to 1, the library is in Sequential Mode.
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.
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.
Mode Parameter Header The returned data on a Mode Sense (10) command begins with an eight byte Mode Parameter Header.
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.
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.
Bit 7 6 5 4 3 2 1 0 Byte n-7 (MSB) Last reservation key n (LSB) Field descriptions: Generation: See SPC-3 r23. Additional Length: See SPC-3 r23. Reservation Key List: See SPC-3 r23.
Bit 7 6 5 4 3 2 1 0 Byte 3 (LSB) 4 Reserved 5 6 Scope (MSB) 7 Type 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.
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.
0h Persistent reservation applies to the full logical unit 1h Obsolete 2h 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. PERSISTENT RESERVE OUT Parameter List The format for the reservation descriptor is shown below.
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.
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.
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. Also a prevent condition shall not inhibit a front panel LOAD of a cartridge when the tape drive is empty.
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. Bit 7 6 5 4 3 2 1 0 Byte 0 Operation Code (3Ch) 1 LUN Reserved 2 Mode Buffer ID 3 (MSB) 4 Buffer offset 5 (LSB) 6 (MSB) 7 Allocation Length 8 (LSB) 9 Control Field descriptions: Mode: The Mode field is used to select the mode of operation.
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. Bit 7 6 5 4 3 2 1 0 Byte 0 Reserved 1 Additional Page Length (2Ch) 2 Reserved 3 Reserved 4 (MSB) ... Current Setting Variables (42 bytes) 45 (LSB) Note: For a description of the possible Setting Variables, see the table at the WRITE BUFFER command.
Bit 7 6 5 4 3 2 1 0 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. The sense key shall be set to ILLEGAL REQUEST and the sense data shall be set to COMMAND SEQUENCE ERROR.
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.
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.
Bit 7 6 5 4 3 2 1 0 Byte 4 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: 1h Medium Transport Element 2h Storage Element 3h Import / Export Element 4h Data Transfer Element PVolTag: Primary Volume Tag.
Bit 7 6 5 4 3 2 1 0 Except Reserved Full Byte 10 Reserved 11 Reserved 12 Additional Sense Code 13 Additional Sense Code Qualifier 14 16 Reserved 17 SValid Invert Reserved ED 18 19 Source Storage Element Address 20 55 Primary Volume Tag Information Medium Type (field omitted if PVolTag = 0) 56 59 Reserved (field moved up if Primary Volume Tag Information field is omitted) Field descriptions: PVolTag: Primary Volume Tag.
ED: 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.
Bit 7 6 5 4 3 2 1 0 Byte 11 Reserved 12 Additional Sense Code 13 Additional Sense Code Qualifier 14 16 Reserved 17 SValid Invert Reserved ED 18 19 Source Storage Element Address 20 55 Primary Volume Tag Information Medium Type (field omitted if PVolTag = 0) 56 59 Reserved (field moved up if Primary Volume Tag Information field is omitted) Field descriptions: PVolTag: Primary Volume Tag. When set this flag indicates valid information in the Primary Volume Tag Information field.
ED: 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.
Bit 7 6 5 4 3 2 1 0 Except ImpExp Full Byte 10 OIR CMC InEnab ExEnab Access 11 Reserved 12 Additional Sense Code 13 Additional Sense Code Qualifier 14 16 Reserved 17 SValid Invert Reserved ED 18 19 Source Storage Element Address 20 55 Primary Volume Tag Information Medium Type (field omitted if PVolTag = 0) 56 59 Reserved (field moved up if Primary Volume Tag Information field is omitted) Field descriptions: PVolTag: Primary Volume Tag.
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.
83h 00h Element not yet scanned The media changer has not scanned this element up to now. 83h 01h 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). A Data Transfer Element contains a cartridge when the Full bit is set.
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. Access: When 1 indicates that access to the data transfer element by a medium transport element is allowed.
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. 0 1 2 3 4 5 6 7 n n n n n n t t The first six (6) characters are any combination of upper case A-Z or 0-9 (e.g.
RELEASE 6 (17h) The RELEASE command is used to release a previously reserved logical unit. Bit 7 6 5 4 3 2 1 0 Byte 0 1 Operation Code (17h) LUN Obsolete 2 Obsolete 3 Reserved 4 Reserved 5 Control Field descriptions: Chapter 3.
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.
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.
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. Each command descriptor contains information about a single supported command CDB (i.e., one operation code and service action combination, or one non-service-action operation code).
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 The device server supports the requested command in conformance with a SCSI standard. 100h Reserved 101h The device server supports the requested command in a vendor specific manner.
REPORT TIMESTAMP (A3h) The REPORT TIMESTAMP command requests that the library return the value of the logical unit s timestamp. Bit 7 6 5 4 3 2 1 0 Byte 0 Operation Code (A3) 1 LUN Service Action (0Fh) 2 Reserved 3 Reserved 4 Reserved 5 Reserved 6 (MSB) 7 Allocation Length 8 9 (LSB) 10 Reserved 11 Control Field descriptions: Allocation Length: The Allocation Length field specifies the number bytes the application client has allocated for the returned data.
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. Chapter 3.
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. Bit 7 6 5 4 3 2 1 0 SelfT (1) DOfl (0) UOfl (0) Byte 0 Operation Code (1Dh) 1 LUN 2 3 PF (1) Reserved Reserved (MSB) Parameter List Length (0) 4 (LSB) 5 Control Field descriptions: PF: Page Format.
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.
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.
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.
REQUEST SENSE (03h) The REQUEST SENSE command tells the library to transfer sense data to the initiator. Bit 7 6 5 4 3 2 1 0 Byte 0 Operation Code (03h) 1 LUN Reserved 2 Reserved 3 Reserved 4 Allocation Length 5 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.
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. It is always zero. Filemark: This bit is only used in sequential access devices. It is always set to zero.
5h 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 6h UNIT ATTENTION Indicates that the removable medium may have been changed or the target has been reset. Bh ABORTED COMMAND Indicates that the device server aborted the command. Note: A list of possible sense keys, with supported sense codes (ASC) and additional sense code qualifiers (ASCQ) is available in chapter 8.
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.
Request Volume Element Address header Bit 7 6 5 4 3 2 1 0 Byte 0 (MSB) First Element Address Reported 1 2 (LSB) (MSB) Number of Elements Reported 3 (LSB) 4 5 Reserved Send Action Code (MSB) 6 Byte Count of Report Available 7 (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.
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. Bit 7 6 5 4 3 2 1 0 Byte 0 1 Operation Code (16h) LUN Obsolete 2 Obsolete 3 Obsolete 4 5 Control Field descriptions: Chapter 3.
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. All other commands result in a Reservation Conflict status.
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.
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.
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.
3-86 TL2000 and TL4000 SCSI Reference
Chapter 4. Messages The message system allows communication between the host and the media changer logical unit for the purpose of physical path management.
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). The successful exchange of WDTR message implies an agreement to an 8-bit data transfer width.
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; it accepts this message and continues processing the current command. Message Parity Error The MESSAGE PARITY ERROR message is sent from the initiator to the target to indicate that one or more bytes in the last message received contained a parity error.
4-4 TL2000 and TL4000 SCSI Reference
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 00h This status indicates, that the media changer successfully completed the command Check condition 02h An error condition occurred during command processing. The REQUEST SENSE command responds with detailed error information Busy 08h The target is busy.
5-2 TL2000 and TL4000 SCSI Reference
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.
B6h SEND VOLUME TAG 30 seconds A4h SET TIMESTAMP 30 seconds 00h TEST UNIT READY 10 seconds 3Bh WRITE BUFFER 3 minutes 5 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. The Move Medium command assumes a move from one storage element to the data transfer element or vice versa.
Chapter 7. Sense Keys, ASC, and ASCQ Sense Key ASC ASCQ Description Recovered Error (01) 0Ah 00h Error log overflow 47h 00h SCSI parity error 00h 17h Drive cleaning requested 04h 00h Cause not reportable 04h 01h In progress becoming ready, scanning magazines, etc.
Sense Key ASC ASCQ Description Hardware Error (04) 81h 80h Cannot initialize bar code reader 81h 81h No response from bar code reader 81h 82h No response from EEPROM 81h 83h Slave robotic generic problem 81h 84h Setting of gripper pic value failed 81h 85h Setting of slider pic value failed 81h 86h Setting of elevator pic value failed 81h 87h Setting of rotation pic value failed 81h 88h Setting of sled pic value failed 81h 89h Gripper blocked 81h 8Ah Slider blocked 81h
Sense Key ASC ASCQ Description Hardware Error (04) (continued) 80h C0h Network init 80h C1h Telnet interface 80h C2h Webserver 80h C3h EEPROM parameter 80h C4h Cannot init LAN card 80h C5h Write to EEPROM failed 80h C6h Ping command did not reach target 80h C7h Cannot upgrade from USB 80h D0h ROM error 80h D1h RAM error 80h D2h NVRAM error 80h D3h CTC error 80h D4h UART error 80h D5h Display error 80h D6h Memory error 80h D7h Fatal system error 80h D8h
Sense Key ASC ASCQ Description Illegal Request (05h) 1Ah 00h Parameter length error 20h 00h Invalid command operation code 21h 01h Invalid element address 24h 00h Invalid field CDB 3Dh 00h SCSI invalid ID message 25h 00h Invalid LUN 2Ch 00h Command sequence error 26h 00h Invalid field in parameter list 26h 01h Parameter list error: parameter not supported 26h 02h Parameter value invalid 26h 90h Wrong firmware image, does not fit boot code 26h 91h Wrong personality fir
Sense Key ASC ASCQ Description Command Aborted (0Bh) 3Fh 0Fh ECHO buffer overwritten 43h 00h SCSI message error 47h 00h SCSI parity error 49h 00h SCSI invalid message 4Eh 00h Overlapped command attempt Chapter 7.
7-6 TL2000 and TL4000 SCSI Reference
Index Numerics 00h (TEST UNIT READY) 3-83 03h (REQUEST SENSE) 3-76 07h (INITIALIZE ELEMENT STATUS) 3-2 12h (INQUIRY) 3-4 16h (RESERVE) 3-81 17h (RELEASE) 3-65 1Ah (MODE SENSE) 3-30 1Bh (OPEN/CLOSE IMPORT/EXPORT ELEMENT) 3-47 1Dh (SEND DIAGNOSTIC) 3-72 1Eh (PREVENT / ALLOW MEDIA REMOVAL) 2Bh (POSITION TO ELEMENT) 3-48 37h (INITIALIZE ELEMENT STATUS WITH RANGE) 3-3 3Bh (WRITE BUFFER) 3-84 3Ch (READ BUFFER) 3-50 4Ch (LOG SELECT) 3-10 4Ch (MODE SELECT) 3-21 4Dh (LOG SENSE) 3-11 55h (MODE SELECT) 3-29 56h (RESER
P PERSISTENT RESERVE IN (5Eh) 3-42 PERSISTENT RESERVE OUT (5Fh) 3-45 POSITION TO ELEMENT (2Bh) 3-48 PREVENT / ALLOW MEDIA REMOVAL (1Eh) 3-49 R READ BUFFER (3CH) 3-50 READ ELEMENT STATUS (B8h) 3-53 RELEASE (17h) 3-65 RELEASE 10 (57H) 3-66 REPORT SUPPORTED OPERATION CODES (A3h) 3-67 REPORT TIMESTAMP (A3h) 3-70 REQUEST SENSE (03h) 3-76 REQUEST VOLUME ELEMENT ADDRESS (B5h) 3-79 RESERVE (16h) 3-81 RESERVE 10 (56H) 3-82 X-2 TL2000 and TL4000 SCSI Reference restore pointers 4-2 RMU features 2-4 S save data po
