Quantum ACL 4/52 Manual

ACL 4/52 Automated Tape Library
for DLT Cartridges
Software Interface Guide
6211225-03
Version 3.0

6211225-03, Version 3.0, October 25, 1996, Made in USA.
©Copyright 1996, ATL Products, Inc. All rights reserved.
Your right to copy this manual is limited by copyright law. Making copies or adaptations without prior written authorization of
ATL Products, Inc. is prohibited by law and constitutes a punishable violation of the law.
ATL Products, Inc. provides this publication “as is” without warranty of any kind, either express or implied, including but not
limited to the implied warranties of merchantability or fitness for a particular purpose. ATL Products, Inc. may revise this
publication from time to time without notice.
FCC STATEMENT
This equipment has been tested and found to comply with the limits for a Class A digital device, pursuant to Part 15 of the FCC
Rules. These limits are designed to provide reasonable protection against harmful interference when the equipment is operated
in a commercial environment. This equipment generates, uses, and can radiate radio frequency energy and, if not installed and
used in accordance with the instruction manual, may cause harmful interference to radio communications.
Any changes or modifications made to this equipment may void the user's authority to operate this equipment.
Operation of this equipment in a residential area may cause interference in which case the user at his own expense will be
required to take whatever measures may be required to correct the interference.
This device complies with Part 15 of the FCC Rules. Operation is subject to the following conditions: (1) this device may not
cause harmful interference, and (2) this device must accept any interference received, including interference that may cause
undesired operation.
CISPR-22 WARNING!
This is a Class A product. In a domestic environment this product may cause radio interference in which case the user may be
required to take adequate measures.
ACHTUNG!
Dieses ist ein Gerät der Funkstörgrenzwertklasse A. In Wohnbereichen können bei Betrieb dieses Gerätes Rundfunkstörungen
auftreten, in welchen Fällen der Benutzer für entsprechende Gegenmassnahmen verantwortlich ist.
ATTENTION!
Ceci est un produit de classe A. Dans un environment domestique, ce produit peat causer des interférences radio lectriques. Il
appartienl alors a l'utilisateur de prendre les mesures appropriées.
NOTICE FOR USA AND CANADA ONLY
If shipped to USA, use the UL LISTED power cord specified below for 100-120 V operation. If shipped to CANADA, use the
CSA CERTIFIED power cord specified below for 100-120V operation.
Plug Cap Parallel blade with ground pin (NEMA 5-15P Configuration)
Cord Type: SJT, three 16 or 18 AWG wires
Length Maximum 15 feet
Rating Minimum 10 A, 125 V
ATTENTION
LIRE LA REMARQUE DANS LE MODE D'EMPLOI

REMARQUE
CETTE REMARQUE NE CONCERNE QUE LES ÉTATS-UNIS ET LE CANADA.
En cas d'envoi aux États-Unis, utiliser le cordon d'alimentation certifié UL et convenant pour 100-120 V.
En cas d'envoi au CANADA, utiliser le cordon d'alimentation CERTIFIÉ CSA et convenant pour 100-120 V.
Fiche Broches paralléus avec une broche de mise à la terre (configuration NEMA 5-15P)
Cordon Type: SJT, trifilaire 16 ou 18 AWG
Longeur Maximum 15 pieds
Capacité Minimum 10 A, 125 V
ZU IHRER SICHERHEIT
Vorsicht
Um Feuergefahr und die Gefahr eines elektrischen Schlages zu vermeiden. darf das Gerät weder Regen noch Feuchtigkeit
ausgesetzt werden.
Um einen elektrischen Schlag zu vormeiden, darf das Gehäuse nicht geöffnet werden. Überlassen Sie Wartungsarbeiten stets
nur einem Fachmann.
Achtung
Da der interne Laserstrahl in lhre Augen eindringen und Verletzungen verursachen kann, darf das Gehäuse nicht selbst geöffnet
werden. Überlassen Sie Wartungearbeiten stets nur einem Fachmann.
Die Verwendung von Brillen, Kontaktlinsen usw.vergrössert die Gefahr.
Zur besonderen Beachtung
Zur Sicherheit
Sollte ein fester Gegenstand oder Flüssigkeit in das Geräteinnere gelangen, trennen Sie das Gerät von der Wandsteckdose ab und
lassen Sie es von einem Fachmann überprufen, bevor Sie es weiter verwenden.
Zum Abziehen des Kabels fassen Sie stets am Stecker und niemals am Kabel selbst an.
Zur Aufstellung
Stellen Sie das Gerät weder auf einer weichen Unterlage (z. B. Decke, Teppich) noch in der Nahe von Vorhangen, Tapeten usw,
auf, da hierdurch die Ventilationsöffnungen blockiert werden können.
Zur Reiningung
Verwenden Sie zur Reiningung des Gehäuses, des Bedienungspultes und der Bedienungselemente ein trockenes, weiches Tuch
oder ein weiches, leicht mit mildem Haushaltsreiniger angefeuchtetes Tuch. Lösemittel wie Alkohol oder Benzin dürfen nicht
verwendet werden, da diese die Gehäuseoberfläche ungreifen.

Table of Contents
ACL 4/52 Software Interface Guide
Document 6211225-03
Version 3.0
Table of Contents v
Introduction
Purpose.......................................................................................................................1-3
Conventions Used in this Guide ................................................................................1-3
Related Documentation..............................................................................................1-4
ATL Products Technical Publications.................................................................1-5
ATL Products BBS..............................................................................................1-5
ATL Products Internet Web Site.........................................................................1-5
Theory of Operation
Chapter Overview......................................................................................................2-3
Library Description....................................................................................................2-3
SCSI Implementation Philosophy..............................................................................2-4
Medium Changer Elements........................................................................................2-4
Medium Transport Element.................................................................................2-5
Storage Elements.................................................................................................2-5
Import/Export (Load Port) Elements...................................................................2-5
Data Transfer Elements.......................................................................................2-5
Events.........................................................................................................................2-6
Power Cycle ........................................................................................................2-7
Library Unit Off-line/Standby.............................................................................2-7
Library Unit On-line Initialization Failure..........................................................2-7
Library Unit Door Opened..................................................................................2-7
Library Unit Stopped...........................................................................................2-7
Accessed Load Port.............................................................................................2-7
Maximum Temperature Exceeded ......................................................................2-7
Operational Sequences........................................................................................2-8
Power-On Sequence......................................................................................2-8
Door Opened Sequence ................................................................................2-8
System Stopped Sequence............................................................................2-9
On-line Initialization Sequence ....................................................................2-9
Library Unit Inventory Sequence ...............................................................2-10
Off-line Sequence.......................................................................................2-11
Automatic Drive Cleaning Sequence..........................................................2-11
Configuration Procedures ........................................................................................2-12
“DIAG” Interface..............................................................................................2-12

ACL 4/52 Software Interface Guide
Document 6211225-03
Version 3.0
vi Table of Contents
Control Panel Menu Mode ............................................................................... 2-13
Error Recovery Procedures..................................................................................... 2-14
Internal Error Recovery.................................................................................... 2-14
Operator Recovery............................................................................................ 2-14
System Performance ............................................................................................... 2-15
Key Performance Items.................................................................................... 2-15
Typical Application Enhancements.................................................................. 2-15
System Diagnostic Support..................................................................................... 2-16
Host Interface Diagnostic Error Codes............................................................. 2-16
Off-line Diagnostics via the “DIAG” Port ....................................................... 2-16
Software Interfaces
Chapter Overview ..................................................................................................... 3-3
SCSI Interface........................................................................................................... 3-3
Reset Sequence................................................................................................... 3-4
Supported Messages........................................................................................... 3-4
Abort ............................................................................................................ 3-5
Bus Device Reset......................................................................................... 3-5
Command Complete .................................................................................... 3-5
Disconnect (from Target to Initiator)........................................................... 3-5
Identify (Initiator to Target)......................................................................... 3-6
Identify (Target to Initiator)......................................................................... 3-6
Save Data Pointer......................................................................................... 3-6
Supported Operational Commands..................................................................... 3-7
Initialize Element Status (07h)..................................................................... 3-9
Initialize Element Status with Range (E7h)............................................... 3-10
Inquiry (12h).............................................................................................. 3-12
Log Sense Command (4Dh)....................................................................... 3-15
Mode Select Command (15h).................................................................... 3-19
Mode Sense (1Ah) ..................................................................................... 3-25
Move Medium (A5h)................................................................................. 3-35
Position To Element (2Bh) ........................................................................ 3-37
Prevent/Allow Medium Removal (1Eh).................................................... 3-38
Read Element Status (B8h)........................................................................ 3-40
Ready Inport (DEh).................................................................................... 3-53
Release (17h) ............................................................................................. 3-54
Reserve (16h)............................................................................................. 3-55
Request Sense (03h)................................................................................... 3-58
Request Volume Element Address (B5h).................................................. 3-61
Rezero Unit (01h) ...................................................................................... 3-75
Send Diagnostic (1Dh)............................................................................... 3-76

ACL 4/52 Software Interface Guide
Document 6211225-03
Version 3.0
Table of Contents vii
Send Volume Tag (B6h)............................................................................ 3-78
Test Unit Ready (00h)................................................................................ 3-80
Sense Data Values
Introduction...............................................................................................................A-1
Control Panel Messages
Introduction...............................................................................................................B-1
System States ............................................................................................................B-2
Operator Messages....................................................................................................B-4
Menu Mode Messages ..............................................................................................B-5
Automatic Drive Cleaning Discussion
Purpose and Scope ....................................................................................................C-3
Drive Cleaning Modes ..............................................................................................C-3
Host Initiated Cleaning Mode ............................................................................C-3
Fully Automatic Cleaning Mode........................................................................C-3
Selection of Cleaning Mode......................................................................................C-4
Diagnostic Software ...........................................................................................C-4
Control Panel......................................................................................................C-4
Mode Select Command (Host Initiated).............................................................C-4
Reporting of Cleaning Mode.....................................................................................C-5
Diagnostic Software ...........................................................................................C-5
Mode Sense Command (Host Initiated) .............................................................C-5
Cleaning Cartridges...................................................................................................C-5
Capacity..............................................................................................................C-5
Identification.......................................................................................................C-6
Storage and Tracking..........................................................................................C-6
Monitoring Usage...............................................................................................C-7
Element Status Information................................................................................C-7
Monitoring Drives.....................................................................................................C-8
Drive Interface....................................................................................................C-8
Drive Monitoring................................................................................................C-8
Initiating Drive Cleaning Operations........................................................................C-8
Selection of Cleaning Cartridges ..............................................................................C-9
Media Movement to the Drive..................................................................................C-9
Supervising the Drive Cleaning Operation.............................................................C-10
Media Movement from the Drive ...........................................................................C-10
Unloading Cleaning Cartridges...............................................................................C-11

ACL 4/52 Software Interface Guide
Document 6211225-03
Version 3.0
viii Table of Contents
Exabyte EXB-120 Emulation Discussion
Purpose and Scope ....................................................................................................D-3
Host Interface Modes................................................................................................D-3
Standard Interface Mode ....................................................................................D-3
Exabyte EXB-120 Interface Mode.....................................................................D-3
Selection of Host Interface Mode .............................................................................D-4
Diagnostic Software ...........................................................................................D-4
Control Panel......................................................................................................D-4
Mode Select Command (Host Initiated).............................................................D-4
Reporting of Host Interface Mode ............................................................................D-5
Diagnostic Software ...........................................................................................D-5
Mode Sense Command (Host Initiated) .............................................................D-5
SCSI Command Differences.....................................................................................D-6
Inquiry (12h).......................................................................................................D-6
Move Medium (A5h)..........................................................................................D-6
Read Element Status (B8h) ................................................................................D-6
Receive Diagnostic Results (1Ch)......................................................................D-7
Request Sense (03h) ...........................................................................................D-7
Send Diagnostic (1Dh) .......................................................................................D-7
Write Firmware (C1h)........................................................................................D-7
Unsolicited Message Differences.......................................................................D-7
Exabyte Emulation Design Philosophy.....................................................................D-8
Glossary
Index

List of Figures
ACL 4/52 Software Interface Guide
Document 6211225-03
Version 3.0
List of Figures ix
Figure 1: Control Panel .........................................................................................2-6
Figure 2: Read Element Status Data General Structure ......................................3-42
Figure 3: Request Volume Element Address Data General Structure ................3-63

x

List of Tables
ACL 4/52 Software Interface Guide
Document 6211225-03
Version 3.0
List of Tables xi
Table 1: Related Documentation .......................................................................... 1-4
Table 2: Supported Operational Commands......................................................... 3-8
Table 3: Initialize Element Status Cmd................................................................ 3-9
Table 4: Initialize Element Status with Range Command.................................. 3-10
Table 5: Inquiry Command................................................................................. 3-12
Table 6: Standard Inquiry Data........................................................................... 3-13
Table 7: Log Sense Command............................................................................ 3-15
Table 8: Supported Log Pages............................................................................ 3-16
Table 9: Medium Changer Statistics Page.......................................................... 3-17
Table 10: Log Parameter....................................................................................... 3-17
Table 11: Supported Log Parameter Codes.......................................................... 3-18
Table 12: Mode Select Command ........................................................................ 3-19
Table 13: Mode Select Data - Vendor Unique Page 20h...................................... 3-20
Table 14: Mode Select Data - Vendor Unique Page 00h...................................... 3-21
Table 15: Mode Select Data - Element Address Assignment Page...................... 3-23
Table 16: Mode Sense Command......................................................................... 3-25
Table 17: Mode Sense Data Header ..................................................................... 3-27
Table 18: Mode Sense Data - Vendor Unique Page 00h...................................... 3-28
Table 19: Mode Sense Data - Element Address Assignment Page ...................... 3-30
Table 20: Mode Sense Data - Transport Geometry Parameters Page................... 3-32
Table 21: Mode Sense Data - Device Capabilities Data....................................... 3-33
Table 22: Mode Sense Data - Vendor Unique Page 20h...................................... 3-34
Table 23: Move Medium Command..................................................................... 3-36
Table 24: Position To Element Command............................................................ 3-37
Table 25: Prevent/Allow Medium Removal Command....................................... 3-39
Table 26: Read Element Status Command........................................................... 3-40
Table 27: Element Status Data.............................................................................. 3-43
Table 28: Element Status Page ............................................................................. 3-44
Table 29: Medium Transport Element Descriptor................................................ 3-45
Table 30: Primary Volume Tag Information........................................................ 3-46
Table 31: Storage Element Descriptor.................................................................. 3-47
Table 32: Import/Export Element Descriptor....................................................... 3-49
Table 33: Data Transfer Element Descriptor........................................................ 3-51

ACL 4/52 Software Interface Guide
Document 6211225-03
Version 3.0
xii List of Tables
Table 34: Ready Inport Command....................................................................... 3-53
Table 35: Release Command ............................................................................... 3-54
Table 36: Reserve Command............................................................................... 3-56
Table 37: Element List Descriptor....................................................................... 3-57
Table 38: Request Sense Command .................................................................... 3-58
Table 39: Request Sense Data.............................................................................. 3-59
Table 40: Request Volume Element Address Command .................................... 3-61
Table 41: Volume Element Address Header ....................................................... 3-64
Table 42: Element Status Page ............................................................................ 3-65
Table 43: Medium Transport Element Descriptor............................................... 3-66
Table 44: Primary Volume Tag Information ....................................................... 3-68
Table 45: Storage Element Descriptor................................................................. 3-68
Table 46: Import/Export Element Descriptor ...................................................... 3-71
Table 47: Data Transfer Element Descriptor....................................................... 3-73
Table 48: Rezero Unit Command ........................................................................ 3-75
Table 49: Send Diagnostic Command ................................................................. 3-76
Table 50: Selftest Bit Definitions ........................................................................ 3-77
Table 51: Send Volume Tag Command............................................................... 3-78
Table 52: Send Volume Tag Parameters ............................................................. 3-79
Table 53: Test Unit Ready Command ................................................................. 3-80
Table A-1: Sense Data Values (Hexadecimal)......................................................... A-2
Table B-1: System States......................................................................................... B-2
Table B-2: Operator Messages................................................................................. B-4

ACL 4/52 Software Interface Guide
Document 6211225-03
Version 3.0
1-1
Introduction 1
Purpose...................................................................................................................... 1-3
Conventions Used in this Guide................................................................................ 1-3
Related Documentation............................................................................................. 1-4
ATL Products Technical Publications................................................................ 1-5
ATL Products BBS............................................................................................. 1-5
ATL Products Internet Web Site........................................................................ 1-5

1-2

ACL 4/52 Software Interface Guide
Document 6211225-03
Version 3.0
Purpose 1-3
Purpose
This guide was written for software engineers developing the
application and hierarchical mass storage software that accesses the
ACL 4/52 Automated Tape Library (library). The manual describes the
SCSI-2 software interfaces, discusses performance issues as well as
error handling. The document is divided into the following sections:
•Section 1, “Introduction,” describes the purpose of this manual,
provides a list of its contents and a list of related documentation.
•Section 2, “Theory of Operation,” contains detailed discussions of
the Medium Changer Elements, Events, Operational Sequences,
Configuration and Error Recovery Procedures as well as System
Performance and Diagnostic Support issues.
•Section 3, “Software Interfaces,” describes the specific terminology
of the Small Computer Systems Interface (SCSI-2).
Conventions Used in this Guide
The following conventions are used in this guide:
All binary numbers are succeeded by “b”.
All hexadecimal numbers are succeeded by “h”.
Error or attention conditions are represented in parenthesis that
translate as follows:
(SK=S ASC=AA ASCQ=QQ)
where:
S= hexadecimal sense key value
AA = hexadecimal additional sense code
QQ = hexadecimal additional sense code qualifier
Definitions of these values are located in Appendix A.

ACL 4/52 Software Interface Guide
Document 6211225-03
Version 3.0
1-4 Related Documentation
Related Documentation
Table 1 is a list of all manuals associated with the ACL 4/52
Automated Tape Library. To obtain further information and/or copies
of documentation on this product, contact:
ATL Products, Inc.
1515 South Manchester Avenue
Anaheim, California 92802-2907
[phone]
The part number of each document will be required at the time of
order.
Table 1: Related
Documentation
Document
Number Document Title Document Description
6211221 ACL 4/52 Facilities
Planning and
Installation Guide
This guide describes facility preparation and
provides the procedures for first-time installation of
the library.
6211222 ACL 4/52 Operator’s
Guide This guide describes the operator accessible components of the library and provides both
operating and troubleshooting procedures.
6211223 ACL 4/52 Field Service
Manual This document contains periodic maintenance, fault isolation and removal/replacement procedures.
6211224 ACL 4/52 Diagnostic
Software User’s
Manual
This manual provides procedures for installing and
using the ACL 4/52 Diagnostic Software.
EK-TH4XX-1M DLT™2000 Series
Cartridge Tape
Subsystem Owner’s
Manual
This document describes the DLT™2000 Tape
Drive and provides operating instructions and
troubleshooting procedures.
81-108336-01 DLT™4000 Cartridge
Tape Drive Product
Manual
This document describes the DLT™4000 Tape
Drive and provides operating instructions and
troubleshooting procedures.
81-60000-01 DLT™7000 Tape
Drive Product Manual This document describes the DLT™7000 Tape Drive and provides operating instructions and
troubleshooting procedures.

ACL 4/52 Software Interface Guide
Document 6211225-03
Version 3.0
Related Documentation 1-5
ATL Products Technical Publications
Comments or questions regarding this or any ATL Products’
documentation can be directed to the address listed on page 1-4 or by
sending email directly to the ATL Products, Inc. technical publications
group. Send all documentation related email comments and questions
to:
[email protected]
ATL Products BBS
The ATL Products, Inc. Bulletin Board Service (BBS) provides a
customer service conference, product support conference,
documentation conference and public-domain software conference.
product manuals, utility software, firmware updates, and other
product information may be obtained in soft copy. BBS. The BBS is
available 24 hours a day, 7 days a week at 714-780-7736.
Modem settings for the ATL BBS are:
• 8 bits, 1 stop bit, no parity.
• support for up to 28.8 Kbps.
• modems that are also capable of V.34, V.FCTM, V.32 terboTM, and
V.32 bisTM.
ATL Products Internet Web Site
If you are on the Internet, you may prefer to access our home page.
Documents, utility software, firmware updates, and product
information may be obtained in soft copy. You will also find Sales &
Marketing contacts along with e-mail address for customer
information and feedback. ATL Products, Inc. can be reached 24 hours
a day, 7 days a week on the internet at:
http://www.atlp.com/

1-6

ACL 4/52 Software Interface Guide
Document 6211225-03
Version 3.0
2-1
2
Chapter Overview.................................................................................................. 2-3
Library Description ................................................................................................2-3
SCSI Implementation Philosophy ........................................................................2-4
Medium Changer Elements...................................................................................2-4
Medium Transport Element............................................................................2-5
Storage Elements .............................................................................................2-5
Import/Export (Load Port) Elements ...........................................................2-5
Data Transfer Elements ..................................................................................2-5
Events........................................................................................................................2-6
Power Cycle ......................................................................................................2-7
Library Unit Off-line/Standby.......................................................................2-7
Library Unit On-line Initialization Failure ...................................................2-7
Library Unit Door Opened .............................................................................2-7
Library Unit Stopped.......................................................................................2-7
Accessed Load Port..........................................................................................2-7
Maximum Temperature Exceeded.................................................................2-7
Operational Sequences ....................................................................................2-8
Power-On Sequence...................................................................................2-8
Door Opened Sequence.............................................................................2-8
System Stopped Sequence ........................................................................2-9
On-line Initialization Sequence................................................................2-9
Library Unit Inventory Sequence..........................................................2-10
Off-line Sequence ....................................................................................2-11
Automatic Drive Cleaning Sequence....................................................2-11
Configuration Procedures....................................................................................2-12
“DIAG” Interface............................................................................................2-12
Theory of Operation

ACL 4/52 Software Interface Guide
Document 6211225-03
Version 3.0
2-2
Control Panel Menu Mode........................................................................... 2-13
Error Recovery Procedures................................................................................. 2-14
Internal Error Recovery ................................................................................ 2-14
Operator Recovery ........................................................................................ 2-14
System Performance ............................................................................................ 2-15
Key Performance Items................................................................................. 2-15
Typical Application Enhancements............................................................ 2-15
System Diagnostic Support................................................................................. 2-16
Host Interface Diagnostic Error Codes....................................................... 2-16
Off-line Diagnostics via the “DIAG” Port.................................................. 2-16