Tandberg Data SLR AUTOLOADER PROGRAMMER, SLR AUTOLOADER User Manual

Download

TANDBERG SLR

AUTOLOADER

SCSI INTERFACE

FUNCTIONAL SPECIFICATIONS

TANDBERG DATA ASA

P.O. Box 134 Kjelsås N-0411 OSLO, NORWAY Phone + 47 22 18 90 90 Telefax + 47 22 18 95 50

Part No. 43 20 73-03 December 2003

Related publications available from our Marketing Department:

Part No. Title

43 21 77 - 03

Tandberg SLR Autoloader Installation and User Manual

43 20 72 - 03

Tandberg SLR Autoloader Service and Repair Manual

43 20 74 - 01

Tandberg SLR Autoloader Product Verification Reports

43 04 44 - 11

Tandberg SLR7 – SLR140 Reference Manual

43 07 43 - 13

Tandberg SLR7 – SLR140 SCSI Interface Functional Specification

This publication may describe designs f or which patents are granted or pending. By publishing this information, Tandberg Data ASA conveys no license under any patent or any other rights.

Every effort has been made to avoid errors in text and diagrams. However, Tandberg Data ASA assumes no respons ibility for any errors which m ay appear in this publication.

It is the policy of Tandberg Data ASA to improve produc ts as new techniques and components become available. Tandber g Data ASA therefore reserves the right to change specifications at any time.

We would appreciate any comments on this publication.

Table of Contents

1 Overview 1-1 2 SCSI Commands 2-1

2.1 INITIALIZE ELEMENT STATUS 07h 2-2

2.2 INITIALIZE ELEMENT STATUS WITH RANGE E7h 2-3

2.3 INQUIRY 12h 2-4

2.3.1 Standard Inquiry Response 2-5

2.3.2 Supported Vital Product Data Page 00h 2-8

2.3.3 Unit Serial Number Page 80h 2-8

2.4 LOG SENSE 4Dh 2-9

2.4.1 LOG SENSE Page Format 2-10

2.4.2 LOG SENSE Page Header Format 2-10

2.4.3 LOG SENSE Page 00h Format 2-11

2.4.4 LOG SENSE Page 2Eh Format 2-11

2.4.5 LOG SENSE Page 30h, 31h, 32h Format 2-13

2.5 MODE SELECT 15h 2-14

2.5.1 MODE SELECT Parameter List 2-14

2.5.2 MODE SELECT Page Format 2-15

2.5.3 Element Address Assignment Page 1Dh 2-16

2.5.4 Library Mode Page 23h 2-17

2.6 MODE SENSE 1Ah 2-18

2.6.1 MODE SENSE Parameter List 2-19

2.6.2 MODE SENSE Page Format 2-19

2.6.3 Element Address Assignment Page 1Dh 2-20

2.6.4 Default, Changeable and Saved Values for Page 1Dh 2-21

2.6.5 Transport Geometry Parameters Page 1Eh 2-22

2.6.6 Device Capabilities Page 1Fh 2-23

2.6.7 Library Mode Page 23h 2-25

2.6.8 Library Configuration Page 24h 2-26

2.7 MOVE MEDIUM A5h 2-27

2.8 POSITION TO ELEMENT 2Bh 2-28

2.9 PREVENT ALLOW MEDIUM REMOVAL 1Eh 2-28

2.10 READ ELEMENT STATUS B8h 2-29

2.10.1 Element Status Data Header 2-30

2.10.2 Medium Transport Element Status Page 2-31

2.10.3 Storage Element Status Page 2-33

2.10.4 Import Export Element Status Page 2-35

2.10.5 Data Transfer Element Status Page 2-37

2.11 RELEASE 17h 2-39

2.12 REQUEST SENSE 03h 2-40

2.12.1 Sense Information Format 2-41

2.13 REQUEST VOLUME ELEMENT ADDRESS B5h 2-45

2.13.1 Volume Element Address Header 2-46

2.14 RESERVE 16h 2-47

2.14.1 Element List Descriptor 2-48

2.15 SEND DIAGNOSTIC 1Dh 2-49

2.16 SEND VOLUME TAG B6h 2-50

2.16.1 Send Volume Tag Parameter List 2-51

2.17 TEST UNIT READY 00h 2-52

2.18 WRITE BUFFER 3Bh 2-53

3 SCSI Status and Messages 3-1

3.1 Supported SCSI Status Codes 3-1

3.2 Supported SCSI Message Codes 3-1

This Page Intentionally Left Blank

______________________________________________________________________

Tandberg SLR Autoloader SCSI Functional Specifications 1-1

1 Overview

The purpose of this specification is to provide a definition of the SCSI implementation for the Tandberg Data SLR Loader medium changer device. For SCSI implementation informatio n regarding the SLR tape driv es (Data transfer element), refer to the SLR7-140 Programers Manual: SCSI-2 Interface Functional Specifications Tandberg Data P/N 430743.

The SLR Loader consists of one medium changer device, one SLR tape drive, one eight-cartridge removable magazine, and an integrated bar code reader.

The medium changer and the tape drive are single LUN SCSI devices, each occupying a unique SCSI address. The individual SCSI address of the autoloader and the internal drive are programble from the front pannel of the unit. The SLR Autoload er supports both Single-end ed and LVDS SCSI interfaces as standard. The dual SCSI connectors on the back of the unit are the standard SCSI-3 68-pin high-density connectors. Refer to the SLR Autoloader Installation Manual (Tandberg Data P/N 432177 (SLR60-140)) for details on SCSI addressing, interconnect, termination, and cabling considerations.

All SLR Loader configurations utilize three o f the me dium chan ger eleme nt types defined in the SCSI Standard - one data transfer element (the tape drive), one medium transport element (the cartridge picker/elevator), and the storage elements (one for each magazine slot).

The SLR Loader operates in either sequential or random access mode, depending on the configuration stored in its non-volatile memory. In random access mode, cartridges are moved to and from the tape drive by issuing the SCSI MOVE MEDIUM command to the medium changer device. In sequential mode, cartridge s are sequentially moved by issuing the SCSI UNLOAD command to the tape drive (after manually loading the first tape).

Tandberg Data Overview

______________________________________________________________________

1-2 Tandberg SLR Autoloader SCSI Functional Specifications

This Page Intentionally Left Blank

______________________________________________________________________

Tandberg SLR Autoloader SCSI Functional Specifications 2-1

2 SCSI Commands

The following table summarizes the command set for the SLR Loader medium changer:

OPCODE COMMAND

07 INITIALIZE ELEMENT STATUS E7 INITIALIZE ELEMENT STATUS W/RANGE 12 INQUIRY

4D LOG SENSE

15 MODE SELECT 1A MODE SENSE A5 MOVE MEDIUM 2B POSITION TO ELEMENT 1E PREVENT ALLOW MEDIUM REMOVAL B8 READ ELEMENT STATUS

17 RELEASE

03 REQUEST SENSE B5 REQUEST VOLUME ELEMENT ADDRESS

16 RESERVE 1D SEND DIAGNOSTIC B6 SEND VOLUME TAG

00 TEST UNIT READY 3B WRITE BUFFER

Tandberg Data SCSI Commands

______________________________________________________________________

2-2 Tandberg SLR Autoloader SCSI Functional Specifications

2.1 INITIALIZE ELEMENT STATUS 07h

Bit

Byte

76543210

0 Operation Code (07h) 1 Logical Unit Number Reserved 2 Reserved 3 Reserved 4 Reserved 5 Mode Reserved Flag Link

The INITIALIZE ELEMENT STATUS command will cause the medium changer to check any relevant element status. A subsequent READ ELEMENT STATUS command may be used to retrieve element status information. Since the medium changer always maintains the current element status information, the default operation of this command only determines if the changer is ready.

Mode

The setting of the Mode field defines whether or not an inventory is performed by this command:

Mode Description

00b Do not re-inventory elements or bar codes, use current valid element status 01b Re-inventory bar codes only, if bar code reader is enabled 10b Do not re-inventory elements or bar codes, use current valid element status 11b Re-inventory all elements and bar codes, if bar code reader is enabled

Tandberg Data SCSI Commands

______________________________________________________________________

Tandberg SLR Autoloader SCSI Functional Specifications 2-3

2.2 INITIALIZE ELEMENT STATUS WITH RANGE E7h

Bit

Byte

76543210

0 Operation Code (E7h) 1 Logical Unit Number Reserved Range 2 Element Address (MSB) 3 Element Address (LSB) 4 Reserved 5 Reserved 6 Number of Elements (MSB) 7 Number of Elements (LSB) 8 Reserved 9 Mode Reserved Flag Link

The INITIALIZE ELEMENT STATUS WITH RANGE command will cause the medium changer to check the status of the requested range of elements. A subsequent READ ELEMENT STATUS command may be used to retrieve element status information. Since the medium changer always maintains the current element status information, the default operation of this command only determines if the changer is ready.

Range

A Range bit of zero indicates th at all eleme nts are to be initialized . A Range bit of one indicates that the range of elements specified by the Element Address and the Number of Elements fields are to be initialized.

Element Address

This field specifies the address of the element or the starting address of the range of elements to be checked. This field is ignored when the Range bit is zero.

Number of Elements

This field specifies the maximum number of elements to be checked. This field is ignored when the Range bit is zero.

Mode

The setting of the Mode field defines whether or not an inventory is performed by this command:

Mode Description

Tandberg Data SCSI Commands

______________________________________________________________________

2-4 Tandberg SLR Autoloader SCSI Functional Specifications

2.3 INQUIRY 12h

Bit

Byte

76543210

0 Operation Code (12h) 1 Logical Unit Number Reserved EVPD 2 Page Code 3 Reserved 4 Allocation Length 5 Vendor Unique Reserved Flag Link

The INQUIRY command requests that information regarding parameters of the medium changer be sent to the initiator.

EVPD

An enable vital product data (EVPD) bit of zero specifies that the target shall return the standard INQUIRY data. An EVPD bit of one specifies that the device shall return the vital product data based on the Page Code field.

Page Code

The page code field is used to specify which page of vital product data to return if the EVPD bit is set to one.

Page Code Page Description

00h List of supported VPD pages 80h Unit Serial Number page

Allocation Length

This specifies the maximum number of byte s that the initiato r has allocated for returned Inquiry data. An Allocation Length of zero indicates that no Inquiry data is transferred. This cond ition is not considered an error. The device will terminate the D ATA IN ph ase whe n allocatio n leng th byte s hav e been transferred, or when all available Inqu iry data has bee n transferred to the initiator, whichever is less.

Tandberg Data SCSI Commands

______________________________________________________________________

Tandberg SLR Autoloader SCSI Functional Specifications 2-5

2.3.1 Standard Inquiry Response

The following information is returned in respo nse to an INQUIRY co mmand with the EVPD bit set to zero:

Bit

Byte

76543210

0 Peripheral Qualifier Peripheral Device Type 1 RMB Device-Type Modifier 2 ISO Version ECMA Version ANSI-Approved Version 3 AENC TrmIOP Reserved Response Data Format 4 Additional Length 5 Reserved 6 Reserved 7 RelAdr Wbus32 WBus16 Sync Linked Reserved CmdQue SftRe 8 Vendor ID “T” or “O” or “X”

9 “A” or “V” or “X” 10 “N” or “E” or “X” 11 “D” or “R” or “X” 12 “B” or “L” or “X” 13 “E” or “A” or “X” 14 “R” or “N” or “X” 15 “G” or “D” or “X” 16 Product ID “S” or “L” or “X” 17 “L” or “X” or “X” 18 “R” or “B” or “X” 19 “ “ or “ ” or “X” 20 “A” or “ “ or “X” 21 “U” or “ “ or “X” 22 “T” or “ “ or “X” 23 “O” or “ “ or “X” 24 “L” or “ “ or “X” 25 “O” or “ “ or “X” 26 “A” or “ “ or “X” 27 “D” or “ “ or “X” 28 “E” or “ “ or “X” 29 “R” or “ “ or “X” 30 “ ” or “ “ or “X” 31 “ ” or “ “ or “X”

32-35 Firmware Revision Level 36-46 Firmware Creation Date 47-51 Vendor Unique

52 Boot Code Revision Level 53 Firmware Download Size 54 Product Class 55 Vendor Unique BarCode

Peripheral Qualifier & Peripheral Device Type

These fields identify the physical device currently connected to the logical unit. If the logical unit number is zero, this byte will be set to 08h, indicating the medium changer device. If the logical unit is not zero, this byte will be set to 7Fh, indicating that no dev ice is attached to this logical unit.

Tandberg Data SCSI Commands

______________________________________________________________________

2-6 Tandberg SLR Autoloader SCSI Functional Specifications

RMB

A removable medium (RMB) bit of one indicates that the medium is removable.

Device Type Modifier

The device type modifier field is a seven bit device-specific code. This field is set to zero.

ISO Version

This field indicates the level of compliance with ISO. A value of 01b indicates compliance with the ISO version of SCSI (I SO IS 9316). This field is always set to 01b.

ECMA Version

This field indicates the level of compliance with ECMA. A value of 001b indicates compliance with the ECMA version of SCSI (ECMA-111). This field is always set to 001b.

ANSI-Approved Version

This field indicates the level of compliance with ANSI. A value of 010b indicates compliance with the SCSI-2 standard X3.131-1994. This field is always set to 010b.

AENC

An AENC bit of zero indicates that the device does not support asynchronous event notification. This bit shall always be set to zero.

TrmIOP

A terminate I/O process (TrmIOP) bit of zero indicates that the device does not support the TERMINATE I/O PROCESS message. This bit shall always be set to zero.

Response Data Format

This field is always set to 2h, indicating compliance with SCSI-2.

Additional Length

The additional length field specifies the length in bytes of the parameters. If the allocation length of the CDB is too small to transfer all of the available parameters, the additional length field is not adjusted to reflect the truncation.

RelAdr

A relative address (RelAdr) bit of zero indicates that the device does not support relative addressing.

WBus32

A wide bus 32 (WBus32) bit of zero indicates that the device does not support 32-bit wide data transfers.

WBus16

A wide bus 16 (WBus16) bit of zero indicates that the device does not support 16-bit wide data transfers. A WBu s16 bit of one indicates that the device supports 16-bit wide data transfers.

Tandberg Data SCSI Commands

______________________________________________________________________

Tandberg SLR Autoloader SCSI Functional Specifications 2-7

Sync

A synchronous transfer (Sync) bit of one indicates that the device supports synchronous data transfer.

Linked

A linked bit of zero indicates that the device does not support linked commands.

CmdQue

A command queuing (CmdQue) bit of zero indicates that the device does not support command queuing.

SftRe

A soft reset (SftRe) bit of zero indicates that the device responds to the RESET condition with the hard RESET alternative.

Vendor Identification

The vendor identification field contains ASCII data, left Justified, padded to the right with ASCII space characters (20h). The returned parameter data from the vendor identification string is user programmable from the SLR Autoloader operator control panel SETUP, SCSI, Vendor ID menu. The vendor identification can be either “TANDBERG” or “OVERLAND” or “XXXXXXXX” where “X” is unique user programmed ASCII data. The default vendor ID string is “TANDBERG”.

Product Identification

The product identification field contains ASCII data, left justified, padded to the right with ASCII space characters (20h). The returned parameter data from the product identification string is user programmable from the SLR Autoloader operator control panel SETUP, SCSI, Product ID menu. The product identification can be either “SLR AUTOLADER “ or “LXB “ or “XXXXXXXXXXXXXXXX” where “X” is unique user programmed ASCII data. The default product ID string is “SLR AUTOLOADER”.

Firmware Revision Level

This field contains the revision level of the control firmware (ASCII data ).

Firmware Creation Date

This field contains the creation date of the control firmware (ASCII data)

Boot Code Revision Level

This field contains the revision level of the boot code.

Firmware Download Size

This field specifies the size of the firmware image file required for a firmware download operation. A value of 02h indicates a 1MB file size.

Product Class

This field is set to 02h to indicate an SLR Library product.

BarCode

This field is set to 01h (LSBof Byte 55 set) if the bar code scanner is enabled in the library.

Tandberg Data SCSI Commands

______________________________________________________________________

2-8 Tandberg SLR Autoloader SCSI Functional Specifications

2.3.2 Supported Vital Product Data Page 00h

The supported v ital pro duct d ata page (Page Code 0) re turn s the list of vital product data pages implemented by the target

Bit

Byte

76543210

0 Peripheral Qualifier Peripheral Device Type 1 Page Code (00h) 2 Reserved 3 Page Length 4 Page 0 (00h) 5 Page 80 (80h)

2.3.3 Unit Serial Number Page 80h

The unit serial number page (Page Code 8h0) returns the medium changer device serial number.

Bit

Byte

76543210

0 Peripheral Qualifier Peripheral Device Type 1 Page Code (80h) 2 Reserved 3 Page Length 4 Unit Serial Number “2” 5“B” or “U” 6“Y” 7“W” 8“W”

9“X” 10 “X” 11 “X” 12 “X” 13 “X”

Peripheral Qualifier & Peripheral Device Type

Unit Serial Number

The value returned for this field is the serial number (ASCII data) for the library, as set from the operator panel.

Byte 5: Plant of manufacture B = San Diego, U = UK Byte 6: WhereY equals last digit of the year of manufacture Byte 7: Where W equals the firs t numeric digit of the week of manufact u re Byte 8: Where W equals the second numeric digit of the week of

manufacture

Tandberg Data SCSI Commands

______________________________________________________________________

Tandberg SLR Autoloader SCSI Functional Specifications 2-9

2.4 LOG SENSE 4Dh

Bit

Byte

76543210

0 Operation Code (4Dh) 1 Logical Unit Number Reserved PPC SP 2 PC Page Code 3 Reserved 4 Reserved 5 Parameter Pointer (MSB) 6 Parameter Pointer (LSB) 7 Allocation Length (MSB) 8 Allocation Length (LSB) 9 Vendor Unique Reserved Flag Link

The LOG SENSE command provides a means for the initiator to retrieve statistical information maintained by the device.

PPC

The parameter pointer control (PPC) bit controls the type of parameters requested from the target. A PPC bit of zero indicates that the log parameter requested shall begin with the parameter code specified in the parameter pointer field and shall return the number of bytes specified in the allocation length field in ascending order of parameter codes from the specified log page. This bit should always be set to zero.

A save parameters (SP) bit of zero indicates that parameters shall not be saved. This bit should always be set to zero.

The page control (PC) field specifies the type of parameter values to be selected:

PC Parameter Value

01b Cumulative values

All other PC values are not supported.

PAGE CODE

The page code field identifies which log page is being requested by the initiator. Valid values are:

Page Code Page Description

00h List of supported pages 2Eh TapeAlert Log Page 30h System Trace Page 31h System Log Page 32h System Configuration Page

Tandberg Data SCSI Commands

______________________________________________________________________

2-10 Tandberg SLR Autoloader SCSI Functional Specifications

PARAMETER POINTER

The parameter pointer fie ld allows the initiator to request paramete r data bytes beginning fro m a specific parameter code to the maximum allocation length or maximum parameter code supported by the device, whichever is less. Log parameters within the specified page shall be transferred in ascending order according to parameter code. This field should always be set to zero.

ALLOCATION LENGTH

The allocation length field specifies how much space the initiator has allocated for returned data.

2.4.1 LOG SENSE Page Format

Log sense data is organized in pages. The data for only one page can be transferred with any one LOG SENSE command. The Log Sense page consists of a 4-byte page header followed by zero or more log parameters. Each log parameter is made up of a 4-byte parameter header followed by one or more associated parameter data bytes.

2.4.2 LOG SENSE Page Header Format

Each log page begins with a four-byte page header followed by zero or more variable length log parameters defined for that page.

Bit

Byte

76543210

0 Reserved Page Code

1 Reserved

2 Page Length (MSB)

3 Page Length (LSB)

4-n Page-specific log parameter(s)

PAGE CODE

The page code field identifies which log page is being transferred.

PAGE LENGTH

The page length field specifies the length in bytes of the following log parameters. If the initiator sends a page length that results in the truncation of any parameter, the target shall terminate the command with CHECK CONDITION status. The sense key shall be set to ILLEGAL REQUEST with the additional sense code set to INVALID FIELD IN PARAMETER LIST.

Tandberg Data SCSI Commands

______________________________________________________________________

Tandberg SLR Autoloader SCSI Functional Specifications 2-11

2.4.3 LOG SENSE Page 00h Format

The supported log page (Page Code 0) returns the list of log pages implemented by the target

Bit

Byte

76543210

0 Reserved Page Code (00h) 1 Reserved 2 Page Length(MSB) 3 Page Length (LSB) 4 Page 0 (00h) 5 Page 2Eh 6 Page 30h 7 Page 31h 8 Page 32h

2.4.4 LOG SENSE Page 2Eh Format

Bit

Byte

76543210

0 Reserved Page Code (2Eh) 1 Reserved 2 Page Length (MSB) 3 Page Length (LSB)

TapeAlert Flag Format

5n-1 Parameter Code (MSB)

5n Parameter Code [n] (LSB) 5n+1 DU (0) DS (1) TSD (0) ETC (0) TMC (0) Reserved LP (0) 5n+2 Parameter Length (1) 5n+3 Flag Value

Log Sense Page 2Eh returns the TapeAlert log page information for the device. Log Sense Page 2Eh will return the 64 TapeAlert flag s as defined in the TapeAlert Specification V2.0. The device implements the following TapeAlert flags:

NUMBER FLAG NAME TYPE FLAG DESCRIPTION

1 Library Hardware A Critical Drive Communications Error 2 Library Hardware B Warning Library Mechanism Error

4 Library Hardware D Critical Library Hardware Fault 13 Library Pick Retry Warning Library Pick Retries have occurred 14 Library Place Retry Warning Library Place Retries have occurred 15 Library Load Retry Warning Library Load Retries have occurred 16 Library Door Critical Library Door is Open 18 Library Magazine Critical Library Magazine not Present 23 Library Scan Retry Warning Library Barcode Scan Retries have occurred

Tandberg Data SCSI Commands

______________________________________________________________________

2-12 Tandberg SLR Autoloader SCSI Functional Specifications

The value for any flag that is not implemented will always be set to zero.

• Each flag will be cleared to zero in the following circumstances:

• At device power on

• When the TapeAlert log page 2Eh is read

• When the specified corrective action has been taken

• On a SCSI bus reset or Bus Device Reset message

Parameter Code

The parameter code field specifies the TapeAlert flag number.

A Disable Update (DU) bit of zero indicates that th e target shall up date the log parameter value to reflect all events that should be noted by that parameter

A Disable Save (DS) bit of one indicates that the target does not support saving the log parameter value in response to a LOG SENSE command with the SP bit set to one.

TSD

A Target Save Disable (TSD) bit of zero indicates that the target provides a target-defined method for saving the log parameter

ETC

An Enable Threshold Comparison (ETC) bit of zero indicates that a threshold comparison is not performed.

TMC

The Threshold Met Criteria field is not valid when the ETC bit is zero.

A List Parameter bit of zero indicates that the parameter code is a data counter.

Parameter Length

The parameter length fie ld defines the length of the param eter data. This field is always set to 01h for the TapeAlert flags.

Flag Value

A Flag Value of 00h indicates that the specific TapeAlert flag is cleared. A flag value of 01h ind icates th at the sp e cif ic Tape Ale rt f lag is set. Flag values 02h-FFh are reserved.

Tandberg Data SCSI Commands

______________________________________________________________________

Tandberg SLR Autoloader SCSI Functional Specifications 2-13

2.4.5 LOG SENSE Page 30h, 31h, 32h Format

Bit

Byte

76543210

0 Reserved Page Code 1 Reserved 2 Page Length (MSB) 3 Page Length (LSB)

4-n Page-specific log parameter(s)

Log Sense Page 30h returns a device specific listing of the Library System Trace information. Log Sense Page 31h returns a device spec ific listing of the Library System Log information. Log Sense Page 32h returns a device specific listing of the Library System Co nfiguratio n information . The format of this data is not defined by this document and is intended for use by factory personnel.

Tandberg Data SCSI Commands

______________________________________________________________________

2-14 Tandberg SLR Autoloader SCSI Functional Specifications

2.5 MODE SELECT 15h

Bit

Byte

76543210

0 Operation Code (15h) 1 Logical Unit Number PF Reserved SP 2 Reserved 3 Reserved 4 Parameter List Length 5 Vendor Unique Reserved Flag Link

The MODE SELECT command provides a means for the initiator to specify medium, logical unit, or peripheral device parameters to the target.

The Page Format bit, when set to one, indicates that the data sent by the host after the MODE SELECT header and block descriptors complies with the definition of pages in the SCSI-2 specification. If the PF bit is set to zero, only the header is defined for the MODE SELECT data.

A save pages (SP) bit of zero indicates the target shall perform the specified MODE SELECT operation, and shall not save any pages. An SP bit of one indicates that the current configuration values specified by this command are saved in nonvolatile memory and used for sub sequent operat ions.

PARAMETER LIST LENGTH

This specifies the length in bytes of the MODE SELECT parameter list that is transferred during the DATA OUT phase. A zero parameter list length indicates that no data is to be transferred.

2.5.1 MODE SELECT Parameter List

The MODE SELECT parameter list contains a 4-byte header followed by zero or more variable length pages.

MODE SELECT Header

Bit

Byte

76543210

0 Reserved 1 Reserved 2 Reserved 3 Reserved

All fields in the parameter list header are reserved and must be set to zero.

Tandberg Data SCSI Commands

______________________________________________________________________

Tandberg SLR Autoloader SCSI Functional Specifications 2-15

2.5.2 MODE SELECT Page Format

Following the header are MODE SELECT pages. Each mode page contains a page code, a page length, and a set of mode parameters. The mode page format is as follows:

Bit

Byte

76543210

0 Reserved Page Code 1 Page Length

2-n Mode Page Parameters

Page Code

The page code field identifies the format and parameters defined for that mode page.

Page Length

The page length field specifies the length in bytes of the mode parameters that follow.

The following page codes are supported for the MODE SELECT command:

Page Code Description

1Dh Element Address Assignment Page 1Ch Tape Alert Configuration Page

23h Library Mode Page

Implementors Note: For compatibility with some software, page code 1Eh, 1Fh, and 24h may be sent during MODE SELECT if no values are changed from the MODE SENSE defau lts.

Tandberg Data SCSI Commands

______________________________________________________________________

2-16 Tandberg SLR Autoloader SCSI Functional Specifications

2.5.3 Element Address Assignment Page 1Dh

The element address assignment page (1Dh) is defined as follows:

Bit Byte

76543210

0 Reserved Page Code (1Dh) 1 Additional Page Length (12h) 2 1st Medium Transport Element Address (MSB) 3 1st Medium Transport Element Address (LSB) 4 Number of Medium Transport Elements (MSB) 5 Number of Medium Transport Elements (LSB) 6 1st Storage Element Address (MSB) 7 1st Storage Element Address (LSB) 8 Number of Storage Elements (MSB)

9 Number of Storage Elements (LSB) 10 1st Import Export Element Address (MSB) 11 1st Import Export Element Address (LSB) 12 Number of Import Export Elements (MSB) 13 Number of Import Export Elements (LSB) 14 1st Data Transfer Element Address (MSB) 15 1st Data Transfer Element Address (LSB) 16 Number of Data Transfer Elements (MSB) 17 Number of Data Transfer Elements (LSB) 18 Reserved 19 Reserved

1st Medium Transport Element Address

The first medium transport element address field identifies the first medium transport element contained in the medium changer. The default medium transport element address is zero.

Number of Medium Transport Elements

The number of medium transport elements field defines the total number of medium transport elements contained in the medium changer. This field must be set to one.

1st Storage Element Address

The first storage element address field identifies the first storage element contained in the medium changer. The default starting address is one.

Number of Storage Elements

The number of storage elements field defines the total number of storage elements contained in the medium changer. This field must match the value returned on MODE SENSE.

1st Import Export Element Address

The first import export element address field identifies the first import export element contained in the medium changer.

Number of Import Export Elements

The number of import export elements field defines the total number of import export elements contained in the medium changer, which is always zero. This field must match the value returned on MODE SENSE.

Tandberg Data SCSI Commands

______________________________________________________________________

Tandberg SLR Autoloader SCSI Functional Specifications 2-17

1st Data Transfer Element Address

The first data tra n sfer element address field identifies the first data transfer element contained in the medium changer. The default starting address is F0h.

Number of Data Transfer Elements

The number of data transfer elements field defines the total number of data transfer elements contained in the medium changer. This field should match the value returned on MODE SENSE .

2.5.4 Library Mode Page 23h

The library mode page (23h) is defined as follows:

Bit

Byte

76543210

0 Reserved Page Code (23h) 1 Additional Page Length (2h) 2 TapeAlrt Reserved Recirc UnldMd Library Mode 3 Reserved

TapeAlrt

A TapeAlert (TapeAlrt) bit of zero indicates that TapeAlert reporting is disabled. A TapeAlert bit of one indicates that TapeAlert reporting is enabled.

UnldMd

An Unload Mode (UnldMd) bit of zero selects the operating mode of the library as Implicit Unload. An UnldMd bit of one selects the o peratin g mo de of the library as Explicit Unload. If the library is set to Explicit Unload mode, the specified tape drive must be in the unloaded state before attempting to issue a MOVE MED IUM comm and with th e tape drive as the source element address. If the library is set to Implicit Unload mode, it is not necessary for the specified tape drive to be in the unloaded state before issuing the MOVE MEDIUM command.

Recirc

A Recirc bit of zero indicates that the library does not recirculate if set to sequential mode (Library Mode 001b, 010b, or 011b). In sequential nonrecirculate mode, the library will stop autoloading cartridges after unloading the last cartridge in the stack. A Recirc bit of one indicates that the library will recirculate if set to a sequential operating mode. In sequential recirculate mode, the library will loop back to au toload the first cartridge in the stack after unloading the last cartridge. The Recirc bit has no effect when operating in random mode (Library Mode 000b).

Library Mode

The library mode field indicates the current operating mode of the library.

Library Mode Description

000b Random 001b Sequential 010b-111b Reserved

Tandberg Data SCSI Commands

______________________________________________________________________

2-18 Tandberg SLR Autoloader SCSI Functional Specifications

2.6 MODE SENSE 1Ah

Bit

Byte

76543210

0 Operation Code (1Ah)

1 Logical Unit Number Reserved DBD Reserved

2 PC Page Code

3 Reserved

4 Allocation Length

5 Vendor Unique Reserved Flag Link

MODE SENSE allows the library to report its configuration parameters to the host.

DBD

A disable block descriptor (DBD) bit of zero indicates that the block descriptor (if any) should be returned in the MODE SENSE data. A DBD bit of one indicates that the block descriptor (if any) should not be returned. This bit is ignored since the device never sends a block descriptor.

The Page Control field indicates the type of page parameter values to be returned to the host.

PC Type of Parameter

00b Current Values 01b Changeable Values 10b Default Values 11b Saved Values

Page Code

This allows the host to select any specific p ag e, o r all th e pag e s sup p orte d by the device. The required page codes are shown in the following table:

Page Code Description

1Dh Element Address Assignment Page

1Eh Transport Geometry Parameters Page 1Fh Device Capabilities Page 23h Library Mode Page 24h Library Configuration Page 3Fh Return All Pages

If page code 3Fh is selected, then the mode pages are returned in ascending order.

Allocation Length

The Allocation Length field specifies the number of bytes that the host has allocated for returned MODE SENSE data. An Allocation Length of zero means that the device will return no MODE SENSE data. This is not considered an error and GOOD status is returned.

Tandberg Data SCSI Commands

______________________________________________________________________

Tandberg SLR Autoloader SCSI Functional Specifications 2-19

2.6.1 MODE SENSE Parameter List

The MODE SENSE data contains a 4-byte he ader, followe d by zero or more variable length pages, depending on the Page Code and the Allocation Length:

MODE SENSE Header

Bit

Byte

76543210

0 Data Length 1 Reserved 2 Reserved 3 Block Descriptor Length (0)

Data Length

The sense data length specifies the length in bytes of the following MODE SENSE data that is available to be transferred during DATA IN phase. The sense data length does not include itself.

Block-Descriptor Length

This field specifies the length, in bytes, of all the block descriptors. A blockdescriptor length of zero indicates no block descriptors are included in the parameter list.

2.6.2 MODE SENSE Page Format

Following the header are the MODE SENSE pages, which report the device parameters. Each page has a 2-byte header that iden tifie s the pag e cod e and indicates the number of bytes in that page.

The format of the MODE SENSE Page Header follows:

Bit

Byte

76543210

0 PS Reserved Page Code 1 Additional Page Length 2 Page Defined Parameter Bytes

PS Bit

A Parameters Savable (PS) bit of zero indicates that the supported parameters cannot be saved. A PS bit of one indicates that the device can save this page to nonvolatile memory.

Additional Page Length

This indicates the number of bytes in that page. However, the value does not include bytes 0 and 1.

Tandberg Data SCSI Commands

______________________________________________________________________

2-20 Tandberg SLR Autoloader SCSI Functional Specifications

2.6.3 Element Address Assignment Page 1Dh

The Element Address Assignment page is used to report the address assignments of the elements of the medium changer. This page also defines the number of each type of element present. The Element Address Assignment page has the following format:

Bit

Byte

76543210

0 PS Reserved Page Code (1Dh)

1 Additional Page Length (12h)

2 1st Medium Transport Element Address (MSB)

3 1st Medium Transport Element Address (LSB)

4 Number of Medium Transport Elements (MSB)

5 Number of Medium Transport Elements (LSB)

6 1st Storage Element Address (MSB)

7 1st Storage Element Address (LSB)

8 Number of Storage Elements (MSB)

PS Bit

A Parameters Savable (PS) bit of one indicates that the supported parameters can be saved.

1st Medium Transport Element Address

The first medium transport element address field identifies the first medium transport element contained in the medium changer.

Number of Medium Transport Elements

The number of medium transport elements field defines the total number of medium transport elements contained in the medium changer.

1st Storage Element Address

The first storage element address field identifies the first storage element contained in the medium changer.

Number of Storage Elements

The number of storage elements field defines the total number of storage elements contained in the medium changer.

Tandberg Data SCSI Commands

______________________________________________________________________

Tandberg SLR Autoloader SCSI Functional Specifications 2-21

1st Import Export Element Address

The first import export element address field identifies the first import export element contained in the medium changer.

Number of Import Export Elements

The number of import export elements field defines the total number of import export elements contained in the medium changer. This field is always zero.

1st Data Transfer Element Address

The first data tra n sfer element address field identifies the first data transfer element contained in the medium changer.

Number of Data Transfer Elements

The number of data transfer elements field defines the total number of data transfer elements contained in the medium changer.

The default Medium Changer Element Address Assignment is as follows:

Address Element

0000h Medium Transport Element 0001h 1st Medium Storage Slot 1 00F0h 1st Data Transfer Element

2.6.4 Default, Changeable and Saved Values for Page 1Dh

The following table describes the default, changeable, and saved values reported for the Element Address Assignment page:

Field Description Default Changeable Saved

1st Medium Transport Element Address 0000 FFFF NOVRAM Number of Medium Transport Elements 0001 0000 0001 1st Storage Element Address 0001 FFFF NOVRAM Number of Storage Elements * 0000 * 1st Data Transfer Element Address 00F0 FFFF NOVRAM Number of Data Transfer Elements * 0000 *

NOTES : * : The default and saved value of these fields will depend on the configuration as determined by the de vice firmware at power up.

NOVRAM: The value returned is the current val u e stored in non-volatile mem ory.

Tandberg Data SCSI Commands

______________________________________________________________________

2-22 Tandberg SLR Autoloader SCSI Functional Specifications

2.6.5 Transport Geometry Parameters Page 1Eh

The Transport Geometry Parameters page reports how the medium transport element is physically attached to the system and whether the medium changer is capable of media rotation. The Transport Geometry Parameters page has the following format:

Bit

Byte

76543210

0 PS Reserved Page Code (1Eh)

1 Additional Page Length (02h)

2 Reserved Rotate

3 Member Number in Transport Element Set

PS Bit

A Parameters Savable (PS) bit of zero indicates that the supported parameters cannot be saved.

Rotate

A rotate bit of one indicates that the medium transport element supports media rotation for handling double-sided media. A rotate bit of zero indicates that the medium transport element does not support media rotation. This bit shall be set to zero indicating no media rotation support.

Member Number in Transport Element Set

The member number in transport element set indicates the position of this element in a set of medium transport elements. There is only one medium transport element, so there is only one set with one member. This field shall be set to zero, indicating the first element in the set.

Tandberg Data SCSI Commands

______________________________________________________________________

Tandberg SLR Autoloader SCSI Functional Specifications 2-23

2.6.6 Device Capabilities Page 1Fh

The Device Capabilities page defines the characteristics of the element types on the medium changer. The Device Capabilities page has the following format:

Bit

Byte

76543210

0 PS Reserved Page Code (1Fh) 1 Additional Page Length (0Eh) 2 Reserved StorDT StorI/E StorST StorMT 3 Reserved 4 Reserved MTàDT MTàI/E MTàST MTàMT 5 Reserved STàDT STàI/E STàST STàMT 6 Reserved I/EàDT I/EàI/E I/EàST I/EàMT 7 Reserved DTàDT DTàI/E DTàST DTàMT 8 Reserved

9 Reserved 10 Reserved 11 Reserved 12 Reserved

MT↔DT MT↔I/E MT↔ST MT↔MT

13 Reserved

ST↔DT ST↔I/E ST↔ST ST↔MT

14 Reserved

I/E↔DT I/E↔I/E I/E↔ST I/E↔MT

15 Reserved

DT↔DT DT↔I/E DT↔ST DT↔MT

PS Bit

A Parameters Savable (PS) bit of zero indicates that the supported parameters cannot be saved.

In the field names on this page, the following element type abbreviations are used:

MT Medium Transport Element (picker/elevator assembly) ST Storage Element (magazine slots) I/E Import/Export Element (optionally configured mail slots) DT Data Transfer Element (tape drive)

In the descriptions that follow, XX and YY are any of the element type abbreviations.

A StorXX bit value of one indicates that the defined elements provide independent storage of media. A value of zero indicates that the elements do not provide independent storage of media. StorDT and StorST are both set to a value of one. If mail slots are configured, StorI/E is set to one. StorMT is always set to a value of zero.

An XXàYY bit value of one indicates that the Medium Changer device supports all MOVE MEDIUM commands where the source is element type XX, the destination is element type YY, and the element addresses are otherwise valid. An XXàYY bit value of zero indicates that the Medium Changer device does not support MOVE MEDIUM commands where the source is element type XX, the destination is element type YY, and the element addresses are otherwise valid.

Tandberg Data SCSI Commands

______________________________________________________________________

2-24 Tandberg SLR Autoloader SCSI Functional Specifications

An XX↔YY bit value of one indicates that the Medium Changer device supports all EXCHANGE MEDIUM commands where the source is element type XX, the destination is element type YY, and the element addresses are otherwise valid. An XX↔YY bit value of zero indicates that the Medium Changer device may or may not support EXCHANGE MEDIUM commands depending on the particular elements requested.

Implementors Note: For compatibility with some software, it is possible to configure the library to report four additional reserved bytes at the end of the Device Capabilities Page (1Fh). This feature is enabled by setting the menu option for Mode Page 1Fh to Long. The default setting of Short returns the Device Capabilities Page as shown above.

Tandberg Data SCSI Commands

______________________________________________________________________

Tandberg SLR Autoloader SCSI Functional Specifications 2-25

2.6.7 Library Mode Page 23h

The library mode page (23h) is defined as follows:

Bit

Byte

76543210

0 PS Reserved Page Code (23h)

1 Additional Page Length (2h)

2 TapeAlrt Reserved Recirc UnldMd Library Mode

3 Reserved

PS Bit

A Parameters Savable (PS) bit of one indicates that the supported parameters can be saved.

TapeAlrt

A TapeAlert (TapeAlrt) bit of zero indicates that TapeAlert reporting is disabled. A TapeAlert bit of one indicates that TapeAlert reporting is enabled.

Recirc

A Recirc bit of zero indicates that the library does not recirculate if set to sequential mode (Library Mode 001b) . In sequential non-recirculate mode, the library will stop autoloading cartridges after unloading the last cartridge in the stack. A Recirc bit of one indicates that the library will recirculate if set to a sequential operating mode. In sequential recirculate mode, the library will loop back to autoload the first cartridge in the stack after unloading the last cartridge.

UnldMd

An Unload Mode (UnldMd) bit of zero indicates that the operating mode of the library is Implicit Unload. An UnldMd bit of one indicates that the operating mode of the library is Explicit Unload. If the library is set to Explicit Unload mode, the specified tape dr ive mu st be in the un lo ade d state before attempting to issue a MOVE MED IUM comm and with th e tape drive as the source element add ress. If the library is se t to Implicit Unload mode, it is not necessary for the specified tape drive to be in the unloaded state before issuing the MOVE MEDIUM command.

Library Mode

The library mode field indicates the current operating mode of the library.

Library Mode Description

000b Random 001b Sequential Drive 1 010b-111b Reserved

Tandberg Data SCSI Commands

______________________________________________________________________

2-26 Tandberg SLR Autoloader SCSI Functional Specifications

2.6.8 Library Configuration Page 24h

The library configuration page (24h) is defined as follows:

Bit

Byte

76543210

0 PS Reserved Page Code (24h) 1 Additional Page Length (03h) 2 Module 0 Configuration 3 Reserved

A Parameters Savable (PS) bit of zero indicates that the supported parameters cannot be saved.

Module Configuration

The module configuration byte defines the hardware configuration. The format of the module configuration field is as follows:

Bit76543210

Byte n Mail Drives Slots

Mail

A mail bit of zero indicates that this mod ule is not con figured as a mail slo t (Import/Export) element. This bit is always set to zero.

Drives

The drives field specifies the number of drive (data transfer) elements contained in this module. A v alue of 00b specifies n o drives. A valu e of 01b specifies one drive.

Slots

The slots field specifies the number of storage elements configured in this module.

Tandberg Data SCSI Commands

______________________________________________________________________

Tandberg SLR Autoloader SCSI Functional Specifications 2-27

2.7 MOVE MEDI UM A5h

Bit

Byte

76543210

0 Operation Code (A5h)

1 Logical Unit Number Reserved

2 Transport Element Address (MSB)

3 Transport Element Address (LSB)

4 Source Address (MSB)

5 Source Address (LSB)

6 Destination Address (MSB)

7 Destination Address (LSB)

8 Reserved

9 Reserved 10 Reserved Invert 11 Vendor Unique Reserved Flag Link

The MOVE MEDIUM command re quests that the target move a tap e from the source address to the destination address.

Transport Element Address

The transport element address specifies the address of the medium transport element used in executing the command. A value of zero specifies the default transport element.

Source Address

The source address specifies the location that the medium is taken from.

Destination Address

The destination address specifies the location that the medium is moved to.

Invert

The invert bit should be set to zero specifying that the media shall not be inverted.

NOTE: If the Unload Mode in the library menu is set to Explicit Unload and a MOVE MEDIUM command is attemp ted with a data transfe r element (tape drive) as the Source Address, the medium in the tape drive must be in the unloaded state (using a SCSI UNLOAD command) prior to executing the MOVE MEDIUM command. If the MOVE MEDIUM comm and is attempted when the da ta transfer element is not in the unloaded state, the command will be rejected and the sense data will report ILLEGAL REQUEST, ELEMENT NOT ACCESSIBLE (Sense Key 5h, ASC/ASCQ 3Bh/90h).

Tandberg Data SCSI Commands

______________________________________________________________________

2-28 Tandberg SLR Autoloader SCSI Functional Specifications

2.8 POSITION TO ELEMENT 2Bh

Bit

Byte

76543210

0 Operation Code (2Bh) 1 Logical Unit Number Reserved 2 Transport Element Address (MSB) 3 Transport Element Address (LSB) 4 Destination Element Address (MSB) 5 Destination Element Address (LSB) 6 Reserved 7 Reserved 8 Reserved 9 Vendor Unique Reserved Flag Link

The POSITION TO ELEMENT command requests that the transport element be positioned in front of the specified destination element. This command is supported for compatibility with system software, but no physical motion occurs.

2.9 PREVENT ALLOW MEDIUM REMOVAL 1Eh

Bit

Byte

76543210

0 Operation Code (1Eh) 1 Logical Unit Number Reserved 2 Reserved 3 Reserved 4 Reserved Prevent 5 Vendor Unique Reserved Flag Link

The PREVENT ALLOW MEDIUM REMOVAL command requests that the library enable or disable access to the cartridge magazine.

Prevent

A Prevent bit of zero requests that the library enable operator access to the cartridge magazine. A Prevent bit of one requests that the library disable operator access to the cartridge magazine(s).

Tandberg Data SCSI Commands

______________________________________________________________________

Tandberg SLR Autoloader SCSI Functional Specifications 2-29

2.10 READ ELEMENT STATUS B8h

Bit

Byte

76543210

0 Operation Code (B8h)

1 Logical Unit Number VolTag Element Type Code

2 Starting Element Address (MSB)

3 Starting Element Address (LSB)

4 Number of Elements (MSB)

5 Number of Elements (LSB)

6 Reserved

7 (MSB)

8 Allocation Length

9 (LSB) 10 Reserved 11 Vendor Unique Reserved Flag Link

The READ ELEMENT STATUS command requests the target report the status of its internal elements to the initiator.

VolTag

A volume tag (VolTag) bit of zero indicates that volume tag (bar code) information shall not be reported. A VolTag bit of one indicates that volume tag information shall be reported.

Element Type Code

The element type code field specifies the element type(s) selected for reporting. The element type codes are defined as follows:

Code Description

0h All element types reported 1h Medium Transport Element 2h Storage Element 3h Import Export Element 4h Data Transfer Element

5h-Fh Reserved

Starting Element Address

The starting element address specifies the minimum address to report. Only elements with an element type code permitted by the element type code specification and an element address greater than or equal to the starting element address shall be reported. Element descriptor blocks are not generated for undefined element addresses.

Number of Elements

The number of elements specifies the maximum number of element descriptors to be created by the target for this command. If the allocation length is not sufficient to transfer all the element descriptors, the target shall transfer all those descripto rs that can be completely transferred and this shall not be considered an error.

Tandberg Data SCSI Commands

______________________________________________________________________

2-30 Tandberg SLR Autoloader SCSI Functional Specifications

2.10.1 Element Status Data Header

The element status data consists of an eight-byte header followed by one or more element status pages (one for each element type). Each element status page includes an eight-byte header followed by one or more element descriptors (one for each element address). The data shown for the Element Status pages assumes that the com mand was specified in such a w ay that all descriptors for a given element type would be returned.

The format of the Element Status Data Header follows:

Bit

Byte

76543210

0 First Element Address Reported (MSB) 1 First Element Address Reported (LSB) 2 Number of Elements Available (MSB) 3 Number of Elements Available (LSB) 4 Reserved 5 (MSB) 6 Byte Count of Report Available 7 (LSB)

First Element Address Reported

The first element address reported field indicates the element address of the element with the smallest element address found to meet the request in the command descriptor block.

Number of Elements Available

The number of elements available field indicates the number of elements meeting the request in the command descriptor block. The status for these elements is returned if sufficient allocation length was specified.

Byte Count of Report Available

The byte count of report available field indicates the number of bytes of element status page data available for all elements meeting the request in the command descriptor block. This value shall not be adjusted to match the allocation length available.

Tandberg Data SCSI Commands

______________________________________________________________________

Tandberg SLR Autoloader SCSI Functional Specifications 2-31

2.10.2 Medium Transport Element Status Page

The Medium Transport Element Status page includes an eight-byte header followed by one element descriptor.

The format of the Medium Transport Element Header follows:

Bit

Byte

76543210

0 Element Type Code (1 = Medium Transport Element)

1 PVolTag AVolTag Reserved

2 Medium Transport Element Descriptor Length (MSB)

3 Medium Transport Element Descriptor Length (LSB)

4 Reserved

5 (MSB)

6 Byte Count of Descriptor Data Available

7 (LSB)

The format of the Medium Transport Element Descriptor follows:

8 Element Address (MSB)

9 Element Address (LSB) 10 Reserved Except Reserved Full 11 Reserved 12 Additional Sense Code 13 Additional Sense Code Qualifier 14 Reserved 15 Reserved 16 Reserved 17 SValid Invert Reserved 18 Source Storage Element Address (MSB) 19 Source Storage Element Address (LSB) 20 Reserved 21 Reserved 22 Reserved 23 Reserved

PVolTag

The primary volume tag (PVolTag) bit o f one ind icates that the pr imary tag information field is present in the following element descriptor. A value of zero indicates that these bytes are omitted from the element descriptor.

AVolTag

The alternate volume tag (AVolTag ) bit of one indicates that the alternate tag information field is present in the following element descriptor. A value of zero indicates that these bytes are omitted from the element descriptor.

Element Descriptor Length

The element descriptor length field indicates the number of bytes in each element descriptor.

Tandberg Data SCSI Commands

______________________________________________________________________

2-32 Tandberg SLR Autoloader SCSI Functional Specifications

Byte Count of Descriptor Data Available

The byte count of descriptor data available field indicates the number of bytes of element descriptor data available for elements of this element type meeting the request of the CDB. The value shall not be adjusted to match the allocation length available.

Element Address

The element address field gives the address of the medium changer element.

Except

An exception (Except) bit of one indicates the element is in an abnormal state. An Except bit of zero indicates the element is in a normal state. If this bit is one, information on the abnormal state may be available in the additional sense code and additional sense code qualifier bytes.

Full

A full bit of one indicates that the element contains a unit of media. A value of zero indicates that the element does not contain a unit of media.

Additional Sense Code

The additional sense code field provides specific information on an abnormal element state. The values in this field are as defined for the additional sense code of the REQUEST SENSE data.

Additional Sense C ode Qualifier

The additional sense code qu alifier field p rovides more detailed information on an abnormal element state. The values in this field are as defined for the additional sense code qualifier of the REQUEST SENSE data.

SValid

A source valid (SValid) bit value of one indicates that the source storage element address field and the invert bit information is valid. A value of zero indicates that the values in these fields are not valid.

Invert

An invert bit value of one indicates that the unit of media in this element was inverted. A value of zero indicates that no inversion occurred. This bit shall always be set to zero.

Source Storage Element Address

The source storage element address field provides the address of the last storage element this unit of media was moved from. This field is valid only if the SValid bit is one.

Tandberg Data SCSI Commands

______________________________________________________________________

Tandberg SLR Autoloader SCSI Functional Specifications 2-33

2.10.3 Storage Element Status Page

The Storage Element Status page includes an eight-byte header followed by one or more storage element descriptors.

The format of the Storage Element Header follows:

Bit

Byte

76543210

0 Element Type Code (2 = Storage Element)

1 PVolTag AVolTag Reserved

2 Storage Element Descriptor Length (MSB)

3 Storage Element Descriptor Length (LSB)

4 Reserved

5 (MSB)

6 Byte Count of Descriptor Data Available

7 (LSB)

The format of the Storage Element Descriptor follows:

8 Element Address (MSB)

9 Element Address (LSB) 10 Reserved Access Except Reserved Full 11 Reserved 12 Additional Sense Code 13 Additional Sense Code Qualifier 14 Reserved 15 Reserved 16 Reserved 17 SValid Invert Reserved 18 Source Storage Element Address (MSB) 19 Source Storage Element Address (LSB)

20-55 Primary Volume Tag Information (field omitted if PVolTag = 0) 56-59 Reserved (field moved up if PVolTag = 0) 60 - n Descriptors for other Storage Elements Reported

There is one storage element descriptor corresponding to each configured magazine slot. For fields not defined in this section, refer to 2.10.2.

Element Address

The element address field gives the address of the storage element.

Access

An access bit value of one indicates access to the element by a medium transport element is allowed (the magazine is installed). An access bit of zero indicates access to the element by the medium transport element is denied.

Except

Tandberg Data SCSI Commands

______________________________________________________________________

2-34 Tandberg SLR Autoloader SCSI Functional Specifications

Full

A full bit of one indicates that the element contains a unit of media. A value of zero indicates that the element does not contain a unit of media.

Source Storage Element Address

The source storage element address field provides the address of the last storage element this unit of media was moved from. This field is valid only if the SValid bit is one.

Primary Volume Tag Information

When the PVolTag bit in the element status page header is set to one, this field contains the volume tag (bar code) information of the element being reported.

Tandberg Data SCSI Commands

______________________________________________________________________

Tandberg SLR Autoloader SCSI Functional Specifications 2-35

2.10.4 Import Export Element Status Page

The Import Export Element Status page includes an eight-byte header followed by one or more storage element descriptors.

The format of the Import Export Element Header follows:

Bit

Byte

76543210

0 Element Type Code (3 = Import Export Element)

1 PVolTag AVolTag Reserved

2 Import Export Element Descriptor Length (MSB)

3 Import Export Element Descriptor Length (LSB)

4 Reserved

5 (MSB)

6 Byte Count of Descriptor Data Available

7 (LSB)

The format of the Import Export Element Descriptor follows:

8 Element Address (MSB)

9 Element Address (LSB) 10 Reserved InEnab ExEnab Access Except ImpExp Full 11 Reserved 12 Additional Sense Code 13 Additional Sense Code Qualifier 14 Reserved 15 Reserved 16 Reserved 17 SValid Invert Reserved 18 Source Storage Element Address (MSB) 19 Source Storage Element Address (LSB)

20-55 Primary Volume Tag Information (field omitted if PVolTag = 0) 56-59 Reserved (field moved up if PVolTag = 0) 60 - n Descriptors for other Import Export Elements Reported

There is one Import Export element descriptor corresponding to each configured magazine slot. For fields not defined in this section, refer to

2.10.2.

Element Address

The element address field gives the address of the import export element.

InEnab

An import enable (InEnab) bit of one indicates that the import export element supports movement of media into the medium changer. An InEnab bit of zero indicates that this element does not support import actions.

ExEnab

An export enable (ExEnab) bit of one indicates that the import export element supports movement of media out of the medium changer. An ExEnab bit of zero indicates that this element does not support export actions.

Tandberg Data SCSI Commands

______________________________________________________________________

2-36 Tandberg SLR Autoloader SCSI Functional Specifications

Access

Except

ImpExp

An import export (ImpExp) bit of one indicates that the media in the import export element was placed there by an operator. An ImpExp bit of zero indicates that the media in the import export element was placed there by the medium transport element.

Full

A full bit of one indicates that the element contains a unit of media. A value of zero indicates that the element does not contain a unit of media.

Source Storage Element Address

The source storage element address field provides the address of the last storage element this unit of media was moved from. This field is valid only if the SValid bit is one.

Primary Volume Tag Information

When the PVolTag bit in the element status page header is set to one, this field contains the volume tag (bar code) information of the element being reported.

Tandberg Data SCSI Commands

______________________________________________________________________

Tandberg SLR Autoloader SCSI Functional Specifications 2-37

2.10.5 Data Transfer Element Status Page

The Data Transfer Element Status page includes an eight-byte header followed by one or more data transfer element descriptors.

The format of the Data Transfer Element Header follows:

Bit

Byte

76543210

0 Element Type Code (4 = Data Transfer Element)

1 PVolTag AVolTag Reserved

2 Data Transfer Element Descriptor Length (MSB)

3 Data Transfer Element Descriptor Length (LSB)

4 Reserved

5 (MSB)

6 Byte Count of Descriptor Data Available

7 (LSB)

The format of the Data Transfer Element Descriptor follows:

8 Data Transfer Element Address (MSB)

9 Data Transfer Element Address (LSB) 10 Reserved Access Except Reserved Full 11 Reserved 12 Additional Sense Code 13 Additional Sense Code Qualifier 14 Not Bus Reserved ID Valid LU Valid Reserved Logical Unit Number 15 SCSI Bus Address 16 Reserved 17 SValid Invert Reserved 18 Source Storage Element Address (MSB) 19 Source Storage Element Address (LSB)

20-55 Primary Volume Tag Information (field omitted if PVolTag = 0) 56-59 Reserved (field moved up if PVolTag = 0)

60-n Descriptors for other Data Transfer Elements Reported

Element Address

The element address field gives the address of the data transfer element.

Access

An access bit value of one indicates access to the element by a medium transport element is allowed (the tape drive is installed). An access bit of zero indicates access to the element by the medium transport element is denied.

NOTE: This bit will be set to zero when the data transfer element is full if the Explicit Unload option is selected in the library menu and the tape has not been unloaded using the SCSI UNLOAD command.

Tandberg Data SCSI Commands

______________________________________________________________________

2-38 Tandberg SLR Autoloader SCSI Functional Specifications

Except

Full

A full bit of one indicates that the element contains a unit of media. A value of zero indicates that the element does not contain a unit of media.

Not Bus

A not this bus (Not Bus) bit value of one in di cate s that th e SCSI bu s add re ss and the logical unit number are not v alid fo r the SCSI bus use d to se lect the medium changer device. A Not Bus bit value of zero indicates that the SCSI address and logical unit values, if valid, are on the same bus as the me dium changer device. This bit is not supported by the library and is always set to zero, indicating that the library cannot determine the bus configuration.

ID Valid

An ID Valid bit value of one indicates that the SCSI bus address field contains valid information.

LU Valid

An LU Valid bit of one indi cates that the logical u nit number field contain s valid information.

SCSI Bus Address

The SCSI bus address field contains the SCSI address of the primary device served by the medium changer device at this element address.

Logical Unit Number

The logical unit number field contains the logical unit number within the SCSI bus device of the primary device served by the medium changer device at this element address.

Primary Volume Tag Information

When the PVolTag bit in the element status page header is set to one, this field contains the volume tag (bar code) information of the element being reported.

For fields not defined in this section, refer to 2.10.2.

Tandberg Data SCSI Commands

______________________________________________________________________

Tandberg SLR Autoloader SCSI Functional Specifications 2-39

2.11 RELEASE 17h

Bit

Byte

76543210

0 Operation Code (17h)

1 Logical Unit Number 3rdPty Third Party Device ID Element

2 Reservation Identification

3 Reserved

4 Reserved

5 Vendor Unique Reserved Flag Link

The RELEASE command releases the library if it is currently reserved by the requesting initiator. It is not an error to attempt to release the library if it is not currently reserved by the requesting initiator. However, if it reserved by another initiator, the library is not released.

3rdPty

The third-party release option allows an initiator to release a logical unit that was previously reserved using the third-party reservation option. If the third-party (3rdPty) bit is zero, then the third-party release option is not requested. The library does not support third party reservation, so the value for this field must be zero.

Third Party Device ID

The Third Party Device ID field contains the SCSI ID of the third party device if the 3rdPty bit is one. Since the library does not support third party reservation, this field should be set to zero.

Element

If the element bit is zero, the target shall release the library or any reserved elements from reserved status. If the element bit is one, the target shall release any reserved elements associated with the Reservation Identification from reserved status.

Reservation Identification

This field specifies a v alue established by the initiator to identify a specific reservation request if the element bit is set to one.

Tandberg Data SCSI Commands

______________________________________________________________________

2-40 Tandberg SLR Autoloader SCSI Functional Specifications

2.12 REQUEST SENSE 03h

Bit

Byte

76543210

0 Operation Code (03h) 1 Logical Unit Number Reserved 2 Reserved 3 Reserved 4 Allocation Length 5 Vendor Unique Reserved Flag Link

REQUEST SENSE tells the target to transfer sense data to the initiator.

The sense data is valid for a CHECK CONDITION status returned on the previous command. The sense data bytes are preserved by the target until retrieved by the REQUEST SENSE command, or until the receipt of any other command from the same initiator.

Implementors Note: For compatibility with some software, it is possible to configure the library to restrict the reporting of Unit Attention conditions. This feature is enabled by setting the menu77 option for Unit Attention Reporti ng to One. When set to One, only the highest priority Unit Attention condition is reported. By default, all (stacked) Unit Attention conditions are reported.

Allocation Length

The allocation length specifies the maximum number of sense bytes to be returned. The device terminates the transfer when allocation length bytes have been transferred or when all available sense data has been transferred to the host, whichever is less.

Tandberg Data SCSI Commands

______________________________________________________________________

Tandberg SLR Autoloader SCSI Functional Specifications 2-41

2.12.1 Sense Information Format

Bit

Byte

76543210

0 Valid Error Code

1 Segment Number

2 Reserved Sense Key

3 (MSB)

4 Information

5Bytes

6 (LSB)

7 Additional Sense Length

8 (MSB)

9 Command Specific 10 Information Bytes 11 (LSB) 12 Additional Sense Code 13 Additional Sense Code Qualifier 14 FRU Code 15 SKSV C/D Reserved BPV Bit Pointer 16 Field Pointer (MSB) 17 Field Pointer (LSB) 18 FSC (MSB) 19 FSC (LSB)

Valid

A valid bit of one indicates that the information bytes contain valid information as defined in the SCSI-2 specification.

Error-Code

A value of 70h indicates a current error- the report is associated with the most recently received command. A value of 71h indicates a deferred error- the report is associated with a previous command and not as a result of the current command. No other values will be returned.

Segment Number

This byte is always zero.

Tandberg Data SCSI Commands

______________________________________________________________________

2-42 Tandberg SLR Autoloader SCSI Functional Specifications

Sense Key

This field provides the top level reason for the error or exception condition.

SENSE KEY DESCRIPTION

0h NO SENSE. Indicates no specific sense key information is available. 1h RECOVERED ERROR. Indicates that the last command completed successfully with

some recovery action performed by the target. This code is not used for the Library.

2h NOT READY. Indicates that the logical unit addressed cannot be accessed. Operator

intervention may be required to correct this condition.

3h MEDIUM ERROR. Indicates that the command terminated with a non-recovered error

condition that was probably caused by a flaw in the medium or an error in the recorded data. This sense key may also be returned if the target is unable to distinguish between a flaw in the medium and a specific hardware failure (sense key 4h).

4h HARDWARE ERROR. Indicates that the target detected a non-recoverable hardware

failure (for example, controller failure, device failure, parity error, etc.) while performing the command or during a self-test.

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. If the target detects an invalid parameter in the command descriptor block, then it shall terminate the command without altering the medium. If the target detects an invalid parameter in the additional parameters supplied as data, then the target may have already altered the medium. This sense key may also indicate that an invalid IDENTIFY message was received.

6h UNIT ATTENTION. Indicates that the removable medium may have been changed or

the target has been reset.

7h DATA PROTECT. Indicates that a command that writes the medium was attempted on

a tape block that is protected from this operation. This code is not used for the Library.

8h BLANK CHECK. Indicates that the device encountered blank medium or format-

defined end-of-data indication while reading. This code is not used for the Library.

Bh ABORTED COMMAND. Indicates that the target aborted the command. The initiator

may be able to recover by trying the command again.

Dh VOLUME OVERFLOW. Indicates that a buffered peripheral device has reached the

end-of-partition and data may remain in the buffer that has not been written to the medium. This code is not used for the Library.

Information Bytes

This field is always set to zero.

Additional Sense Length

This specifies the number of additional sense bytes to follow. If the allocation length of the command descriptor block is too small to transfer all of the additional sense bytes, the additional sense length is not adjusted to reflect the truncation.

Command Specific Information Bytes

Command Specific Bytes are hand le d as d ev ice sp e cific an d can be log ge d by the operating system on error conditions. This field is not used for any implemented commands.

Tandberg Data SCSI Commands

______________________________________________________________________

Tandberg SLR Autoloader SCSI Functional Specifications 2-43

Additional Sense Code (ASC) and ASC Qualifier (ASCQ)

These two bytes provide additional information about the Sense Key and cause of the CHECK CONDITION st atus. (See Table)

ASC ASCQ Description

00h 00h NO ADDITIONAL SENSE INFORMATION 04h 00h LOGICAL UNIT NOT READY, CAUSE NOT REPORTABLE 04h 01h LOGICAL UNIT IS IN PROCESS OF BECOMING READY 04h 03h LOGICAL UNIT NOT READY, MANUAL INTERVENTION REQUIRED 04h 83h LOGICAL UNIT NOT READY, MAGAZINE DOOR OPEN 04h 8Dh LOGICAL UNIT NOT READY, FRONT PANEL MODE 04h 8Eh LOGICAL UNIT NOT READY, SEQUENTIAL MODE 0Ah 00h ERROR LOG OVERFLOW 15h 01h MECHANICAL POSITIONING ERROR 1Ah 00h PARAMETER LIST LENGTH ERROR 20h 00h INVALID COMMAND OPERATION CODE 21h 00h LOGICAL ADDRESS OUT OF RANGE 21h 01h INVALID ELEMENT ADDRESS 24h 00h INVALID FIELD IN CDB 25h 00h LOGICAL UNIT NOT SUPPORTED 26h 00h INVALID FIELD IN PARAMETER LIST 26h 01h PARAMETER NOT SUPPORTED 26h 02h PARAMETER VALUE INVALID 26h 04h INVALID RELEASE OF ACTIVE PERSISTENT RESERVATION 28h 00h NOT READY TO READY TRANSITION, MEDIUM MAY HAVE CHANGED 28h 01h IMPORT OR EXPORT ELEMENT ACCESSED 28h 8Ch NOT READY TO READY TRANSITION, MAGAZINE DOOR CLOSED 28h 8Dh NOT READY TO READY TRANSITION, EXITED MENU MODE 28h 8Eh NOT READY TO READY TRANSITION, EXITED SEQUENTIAL MODE 28h 8Fh NOT READY TO READY TRANSITION, MAGAZINE DOOR OPENED 29h 00h POWER ON, RESET, OR BUS DEVICE RESET OCCURRED 29h 01h POWER ON OCCURRED 29h 02h SCSI BUS RESET OCCURRED 29h 03h BUS DEVICE RESET FUNCTION OCCURRED 29h 04h DEVICE INTERNAL RESET 2Ah 01h MODE PARAMETERS CHANGED 2Ah 02h LOG PARAMETERS CHANGED 2Ah 03h RESERVATIONS PREEMPTED

2Ch 00h COMMAND SEQUENCE ERROR

30h 00h INCOMPATIBLE MEDIUM INSTALLED 3Ah 00h MEDIUM NOT PRESENT 3Bh 0Dh MEDIUM DESTINATION ELEMENT FULL 3Bh 0Eh MEDIUM SOURCE ELEMENT EMPTY 3Bh 80h ILLEGAL MOVE COMMAND 3Bh 87h CANNOT MOVE, ELEMENT IN ERROR 3Bh 90h ELEMENT NOT ACCESSIBLE 3Bh 91h CANNOT MOVE, ELEMENT NOT INSTALLED 3Dh 00h INVALID BITS IN IDENTIFY MESSAGE 3Eh 00h LOGICAL UNIT HAS NOT SELF-CONFIGURED YET 3Fh 01h MICROCODE HAS BEEN CHANGED

Tandberg Data SCSI Commands

______________________________________________________________________

2-44 Tandberg SLR Autoloader SCSI Functional Specifications

ASC ASCQ Description

3Fh 80h FLASH UPDATE ERASE ERROR 3Fh 82h FLASH UPDATE DOW NL OAD ERROR 3Fh 84h FLASH UPDATE PROGRAM ERROR 3Fh 86h FLASH UPDATE CRC ERROR 3Fh 88h CANNOT EXECUTE FLASH UPDATE 40h 80h DIAGNOSTIC FAILURE 43h 00h MESSAGE ERROR 44h 00h INTERNAL TARGET FAILURE 45h 00h SELECT OR RESELECT FAILURE 47h 00h SCSI PARITY ERROR 48h 00h INITIATOR DETECTED ERROR 4Eh 00h OVERLAPPED COMMANDS ATTEMPTED 53h 00h MEDIA LOAD OR EJECT FAILED 53h 02h MEDIUM REMOVAL PREVENTED 80h 03h MEDIUM SOURCE ELEMENT NOT INSTALLED 80h 04h MEDIUM DESTINATION ELEMENT NOT INSTALLED 83h 01h ERROR READING BARCODE LABEL 83h 02h CARTRIDGE MAGAZINE IS NOT INSTALLED 83h 04h TAPE DRIVE IS NOT INSTALLED 83h 09h NO BARCODE LABEL DETECTED 83h 10h ELEMENT IS IN ERROR

FRU Code

The Field Replaceable Unit (FRU) Code field is not used and shall always return a value of zero.

SKSV

The Sense Key Specific Valid bit, when set to zero, specifies that bytes 15-17 are not defined. If the sense key is ILLEGAL REQUEST and the SKSV bit is set to one, bytes 15-17 describe the parameter in error.

C/D

When set, indicates that the illegal parameter is in the CDB. A C/D of zero indicates that the illegal parameter is in the parameter list from the initiator.

BPV

When the Bit Pointer Valid bit is set, it indicates that the bit pointer field is valid and designates which bit of the byte designated by the field pointer is in error. For a multibit field, it points to the most significant bit of the field.

Field Pointer

Indicates which byte of the CDB or parameter list was in error. For a multi byte field, the most significant byte is indicated.

FSC

The fault symptom code (FSC) field contains the two-byte fault symptom code reported by the device.

Tandberg Data SCSI Commands

______________________________________________________________________

Tandberg SLR Autoloader SCSI Functional Specifications 2-45

2.13 REQUEST VOLUME ELEMENT ADDRESS B5h

Bit

Byte

76543210

0 Operation Code (B5h) 1 Logical Unit Number VolTag Element Type Code 2 Starting Element Address (MSB) 3 Starting Element Address (LSB) 4 Number of Elements (MSB) 5 Number of Elements (LSB) 6 Reserved 7 (MSB) 8 Allocation Length

9 (LSB) 10 Reserved 11 Vendor Unique Reserved Flag Link

The REQUEST VOLUME ELEMENT ADDRESS command is used to transfer the results o f a SEND VOLUME TAG co mmand. Data is re turned in element address order.

VolTag

A volume tag (VolTag ) bit of one indicates that the library shall report the volume tag information searched for by the SEND VOLUME TAG command. A VolTag bit of zero indicates that the library shall not report volume tag information.

Element Type Code

The element type code field specifies the element type(s) selected for reporting by this command. The element type codes are defined as follows:

Code Description

0h All element types reported 1h Medium Transport Element 2h Storage Element 3h Import Export Element 4h Data Transfer Element

5h-Fh Reserved

For an element type code of 0h, the element types are reported in element address order, beginning with the starting element address. If an element type code of 1h is selected, only element status information is returned, since the medium transport element does not retain a cartridge.

Starting Element Address

Tandberg Data SCSI Commands

______________________________________________________________________

2-46 Tandberg SLR Autoloader SCSI Functional Specifications

Number of Elements

2.13.1 Volume Element Address Header

The volume element address data consists of an eight-byte header followed by one or more element status pages (one for each element type). The element status pages returned by this command are in the same format as defined by the READ ELEMENT STATUS command (see 2.10.2 - 2.10.5)

The format of the Volume Element Address Header follows:

Bit

Byte

76543210

0 First Element Address Reported (MSB) 1 First Element Address Reported (LSB) 2 Number of Elements Available (MSB) 3 Number of Elements Available (LSB) 4 Reserved Send Action Code 5 (MSB) 6 Byte Count of Report Available 7 (LSB)

8 - n Element status page(s)

First Element Address Reported

The first element address reported field indicates the element address of the first element that has a volume tag (bar code) that matches the template sent by the SEND VOLUME TAG command.

Number of Elements Available

Send Action Code

The send action code field contains the action code performed by the last SEND VOLUME TAG command. The library supports a send action code of 5h.

Byte Count of Report Available

Tandberg Data SCSI Commands

______________________________________________________________________

Tandberg SLR Autoloader SCSI Functional Specifications 2-47

2.14 RESERVE 16h

Bit

Byte

76543210

0 Operation Code (16h)

1 Logical Unit Number 3rdPty Third Party Device ID Element

2 Reservation Identification

3 Element List Length (MSB)

4 Element List Length (LSB)

5 Vendor Unique Reserved Flag Link

The RESERVE command reserves the library or elements for exclusive use by the requesting initiator. The reservation remains in effect until one of the following conditions is met:

• The initiator that made the reservation sends another RESERVE command.

• The device is released by RELEASE from the same initiator.

• A BUS DEVICE RESET message is received from any initiator.

• A hard reset occurs.

The occurrence of the last two conditions is indicated by the device returning a CHECK CONDITION status with a sense key of UNIT ATTENTION on the next command following the condition. It is not an error to issue RESERVE to a device that is currently reserved to the requesting initiator.

If the logical unit has previously been reserved by another initiator, the target returns a RESERVATION CONFLICT status.

If, after honoring the reservation, any other initiator attempts to perform any command except INQUIRY, REQUEST SENSE, or RELEASE, the command is rejected with a RESERVATION CONFLICT status. A RELEASE command issued by another initiator is ignored by that reserved logical unit.

3rdPty

The third-party reservation option for RESERVE UNIT allows an initiator to reserve a logical unit for another SCSI device. If the third-party (3rdPty) bit is zero, then the third -party reservation option is not requested. Since the device does not supp ort third party reservation, th is bit must be set to zero.

Third Party Device ID

The Third Party Device ID field contains the SCSI ID of the third party device if the 3rdPty bit is set to one. Since th e device does no t support thir d party reservation, this field should be set to zero.

Element

If the element bit is zero, the entire unit is reserved for the requesting initiator. If the element bit is one, a series of elements is reserved, as identified by the reservation identification field and specified by the element list descriptor.

Tandberg Data SCSI Commands

______________________________________________________________________

2-48 Tandberg SLR Autoloader SCSI Functional Specifications

Reservation Identification

The reservation identification field is used to assign an identification number to a reservation request that reserves a set of elements. Using this number with a subsequent RELEASE command shall release the reservation for the same set of elements.

Element List Length

The element list length field specifies the total length in bytes of the element list descriptors sent for this command. Each element list descriptor is six bytes, so valid values for this field are 0, 6, and increments of 6.

2.14.1 Element List Descriptor

If the element bit is set to one in the RESERVE command, zero or more element list descriptors are sent to reserve specific el ements.

The format of the element list descriptor follows:

Bit

Byte

76543210

0 Reserved 1 Reserved 2 Number of Elements (MSB) 3 Number of Elements (LSB) 4 Element Address (MSB) 5 Element Address (LSB)

Number of Elements

This field specifies the number of elements to reserve. If the number of elements is zero, the element list shall begin at the specified element address and continue through the last element address on the unit.

Element Address

This field specifies the element address or starting element address of a series of elements to be reserved.

Tandberg Data SCSI Commands

______________________________________________________________________

Tandberg SLR Autoloader SCSI Functional Specifications 2-49

2.15 SEND DIAGNOSTIC 1Dh

Bit

Byte

76543210

0 Operation Code (1Dh)

1 Logical Unit Number PF Reserved SelfTest DevOfl UnitOfl

2 Reserved

3 Parameter List Length (MSB)

4 Parameter List Length (LSB)

5 Vendor Unique Reserved Flag Link

The SEND DIAGNOSTIC command requests the target to perform diagnostic operations on itself, on the logical unit, or on both. The only mandatory implementation of this command is the self-test feature with the parameter list length of zero.

If the specified test passes, a GOOD STATUS is returned. Otherwise, a CHECK CONDITION is generated, and the sense data will contain information about the failure.

The page format (PF) bit is not supported and must be set to zero.

SelfTest

The self-test (SelfTest) bit of one directs the target to perform its default self test. T he parameter list length must be set to zero if the SelfTest bit is set to one. A SelfTest bit of zero is not supported.

DevOfl, UnitOfl

The device offline (DevOfl) and unit offline (UnitOfl) bits may be set in conjunction with the SelfTest bit of one, if the parameter list length is zero. Any other combinations with these bits are not supported.

Parameter List Length

The parameter list length must be set to zero.

Tandberg Data SCSI Commands

______________________________________________________________________

2-50 Tandberg SLR Autoloader SCSI Functional Specifications

2.16 SEND VOLUME TAG B6h

Bit

Byte

76543210

0 Operation Code (B6h) 1 Logical Unit Number Reserved Element Type Code 2 Element Address (MSB) 3 Element Address (LSB) 4 Reserved 5 Reserved Send Action Code 6 Reserved 7 Reserved 8 Parameter List Length (MSB)

9 Parameter List Length (LSB) 10 Reserved 11 Vendor Unique Reserved Flag Link

The SEND VOLUME TAG command tran sfers a volume tag te mplate to be searched and compared to the volume tag (bar code) information available to the library. The results of the scan can be obtained by a subsequent REQUEST VOLUME ELEMENT ADDRESS command.

Element Type Code

The element type code field specifies the element type(s) to be scanned for this command. The element type codes are defined as follows:

Code Description

0h All element types reported 1h Medium Transport Element 2h Storage Element 3h Import Export Element 4h Data Transfer Element

5h-Fh Reserved

Element Address

The element address field specifies the minimum element address at which to start the search for volume tag information.

Send Action Code

This field specifies the function to be performed by this command. The library only supports a Send Action Code of 5h (translate - search all primary tags - ignore sequence numbers).

Parameter List Length

This field specifies the length of the SEND VOLUME TAG parameter list. The value for this field may not be less than 32 bytes or more than 40 bytes.

Tandberg Data SCSI Commands

______________________________________________________________________

Tandberg SLR Autoloader SCSI Functional Specifications 2-51

2.16.1 Send Volume Tag Parameter List

The format of the volume tag information used for the SEND VOLUME TAG translate function follows:

Bit

Byte

76543210

0 - 31 Volume Identification Template Field

32 - 39 Reserved

Volume Identification Template Field

The volume identification template field specifies a search template for translate functions. For the library, only the first 8 bytes of this 32-byte field are valid and any addition al bytes mu st be set to 00h ( null). The temp late is considered terminated after the first null byte (00h) is received.

As a search template, the field may contain the wildcard characters '*' (3Fh) and '?' (2Ah). The '*' character will match any string of characters and whe n it appears in a template, the remainder of the te mplate is not used . The '?' character will match any single character.

Tandberg Data SCSI Commands

______________________________________________________________________

2-52 Tandberg SLR Autoloader SCSI Functional Specifications

2.17 TEST UNIT READY 00h

Bit

Byte

76543210

0 Operation Code (00h)

1 Logical Unit Number Reserved

2 Reserved

3 Reserved

4 Reserved

5 Vendor Unique Reserved Flag Link

TEST UNIT READY checks if the logical unit is ready for commands involving medium access. If the logical unit is ready, the command returns a GOOD status. The library will report CHECK CONDITION status with the sense key set to NOT READY for the following conditions: during the power-on initialization process, when a magazine door is opened, or when the library is in front panel mode.

Tandberg Data SCSI Commands

______________________________________________________________________

Tandberg SLR Autoloader SCSI Functional Specifications 2-53

2.18 WRITE BUFFER 3Bh

Bit

Byte

76543210

0 Operation Code (3Bh) 1 Logical Unit Number Reserved Mode 2 Buffer ID 3 (MSB) 4 Buffer Offset 5 (LSB) 6 (MSB) 7 Transfer Length 8 (LSB) 9 Vendor Unique Reserved Flag Link

The WRITE BUFFER command is used to download firmware to the medium changer device. This command should only be used by qualified service personnel.

NOTE: Prior to issuing this command, the medium changer device must be placed in Flash Update Mode by entering the front panel Menu and selecting Flash Update. If the WRITE BUFFER command is no t received withi n thirty seco nds, the device will exit Flash Update Mode. If the device is not in Flash Update Mode when the WRITE BUFFER command is issued, the target shall terminate the command with CHECK CONDITION status. The sense key shall be set to ILLEGAL REQUEST with an additional sense code and additional sense code qualifier set to CANNOT EXECUTE FLASH UPDATE.

Mode

The library only supports the following values in the mode field. If any other value is set, the target shall return CHECK CONDITION status and a sense key of ILLEGAL REQUEST

Mode Description

101h Download Microcode and Save 111h Download Microcode with offsets and Save

Buffer ID

The Buffer ID field must be set to 00h. If any other value is set, the target shall return CHECK CONDITION status and a sense key of ILLEGAL REQUEST

Buffer Offset

The Buffer Offset fie ld mu st be se t to 000000h f or th e first WRITE BU FFER command and must progress by the transfer size for each subsequent WRITE BUFFER command.

Transfer Length

The transfer length field specifies the number of bytes to transfer. The total size of the transfer (1MB) is determined by the value reported in the INQUIRY data Firmware Download Size (byte 53). The transfer length must be a multiple of 65536 bytes (for example , 8192, 16384, 32768, etc). If an incorrect transfer length is specified, the target shall return CHECK CONDITION status and a sense key of ILLEGAL REQUEST.

Tandberg Data SCSI Commands

______________________________________________________________________

2-54 Tandberg SLR Autoloader SCSI Functional Specifications

Vendor Unique

The vendor unique field shall be set to 00b to perform the firmware download operation. Non-zero values in this field are intended for factory use only.

CAUTION! Using non-zero values in the vendor uni que field may cause unpredictable results and the medium changer device may b ec o me unusable.

NOTE: If an error occurs during the firmware do wnload proce ss after the fi rst 64K bytes of data have been transferred, the flash firmware may become unusable and it may not be possible to complete a firmware upgrade using the SCSI WRITE BUFFER command. If this occurs, the only recove ry action is to update the firmware using the serial port on the l ibrary. Refer to the I nstallation a nd User Manual for additional information on Installing Firmware Upgrades using the serial port.

______________________________________________________________________

Tandberg SLR Autoloader SCSI Functional Specifications 3-1

3 SCSI Status and Messages

3.1 Suppor ted SCSI Status Codes

The following table lists the Status codes supported by the device.

Code Description

00h GOOD 02h CHECK CONDITION 08h BUSY 18h RESERVATION CONFLICT

GOOD

This status indicates that the target has successfully completed the command.

CHECK CONDITION

This status indicates that a contingent allegiance condition has occurred.

BUSY

This status indicates that the target is busy. The recommended recovery action is to issue the command again at a later time.

RESERVATION CONFLICT

This status shall be returned whenever an initiator attempts to access a device or element that is reserved to another initiator using the RESERVE command. The recommended recovery action is to issue the command again at a later time.

3.2 Suppor ted SCSI Message Codes

The following table lists the Message codes supported by the device.

Code Description

00h Command Complete 01h Extended Message (SDTR & WDTR only) 02h Save Data Pointer 03h Restore Pointers 04h Disconnect 05h Initiator Detected Error 06h Abort 07h Message Reject 08h No Op 09h Message Parity Error

0Ch Bus Device Reset

8Xh-

CXh

Identify

Tandberg Data SCSI Status and Messages

______________________________________________________________________

3-2 Tandberg SLR Autoloader SCSI Functional Specifications

This Page Intentionally Left Blank

Tandberg Data SLR AUTOLOADER PROGRAMMER, SLR AUTOLOADER User Manual

Specifications and Main Features

Frequently Asked Questions

User Manual