Tandberg Data SLR AUTOLOADER PROGRAMMER, SLR AUTOLOADER User Manual

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.

+ 43 hidden pages

Tandberg Data SLR AUTOLOADER PROGRAMMER, SLR AUTOLOADER User Manual

Specifications and Main Features

Frequently Asked Questions

User Manual