1. Manuals
  2. Brands
  3. Quantum Manuals
  4. Storage
  5. ACL 4/52
  6. Supplementary manual

Quantum ACL 4/52 Supplementary Manual

Automated tape library for dlt cartridges
Hide thumbs Also See for ACL 4/52:
Table of Contents

Advertisement

Quick Links

Download this manual See also: Operator's Manual, Installation Manual
ACL 4/52 Automated Tape Library
for DLT Cartridges
Software Interface Guide
6211225-03
Version 3.0

Advertisement

Table of Contents
loading

Related Manuals for Quantum ACL 4/52

Summary of Contents for Quantum ACL 4/52

  • Page 1 ACL 4/52 Automated Tape Library for DLT Cartridges Software Interface Guide 6211225-03 Version 3.0...
  • Page 3 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.
  • Page 4 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 à...

  • Page 5: Table Of Contents

    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 Table of Contents ACL 4/52 Software Interface Guide Document 6211225-03 Version 3.0...
  • Page 6 ACL 4/52 Software Interface Guide Document 6211225-03 Version 3.0 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...
  • Page 7 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 Table of Contents ACL 4/52 Software Interface Guide Document 6211225-03 Version 3.0...
  • Page 8 ACL 4/52 Software Interface Guide Document 6211225-03 Version 3.0 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...
  • Page 9 List of Figures 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 List of Figures ACL 4/52 Software Interface Guide Document 6211225-03 Version 3.0...

  • Page 11: Document

    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 List of Tables ACL 4/52 Software Interface Guide Document 6211225-03 Version 3.0...
  • Page 12 ACL 4/52 Software Interface Guide Document 6211225-03 Version 3.0 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...
  • Page 13 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 ACL 4/52 Software Interface Guide Document 6211225-03 Version 3.0...

  • Page 15: 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,”...

  • Page 16: Related Documentation

    ACL 4/52 Software Interface Guide Document 6211225-03 Version 3.0 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.

  • Page 17: Atl Products Technical Publications

    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/ Related Documentation ACL 4/52 Software Interface Guide Document 6211225-03 Version 3.0 , V.32 terbo , and...

  • Page 19: Theory Of Operation

    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...
  • Page 20 ACL 4/52 Software Interface Guide Document 6211225-03 Version 3.0 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...

  • Page 21: Chapter Overview

    ACL 4/52. The ACL 4/52 has a minimal connection to any installed tape drives. The library knows the number of drives installed and the SCSI addresses for the tape drives. The library does not know if the drives are on the same SCSI bus or not.

  • Page 22: Scsi Implementation Philosophy

    ACL 4/52 Software Interface Guide Document 6211225-03 Version 3.0 SCSI Implementation Philosophy Using the SCSI-2 standard, the tape library has been designed so that the host can adapt to changes in the tape library configuration. Changes in the number of tape drives can be detected by the host.

  • Page 23: Medium Transport Element

    Storage Elements Each library unit contains up to 48 storage elements, which correspond to the bins in the FSA. One storage element exists per bin. Import/Export (Load Port) Elements The import/export mechanism consists of a four-bin, rotating Load Port.

  • Page 24: Events

    ACL 4/52 Software Interface Guide Document 6211225-03 Version 3.0 Events Events are system conditions created by failures or operator actions such as opening the door or pressing the STOP switch. Some of these events appear as states on the control panel. For a list of event states, see Appendix B.

  • Page 25: Power Cycle

    Exceeded” event (SK=6 ASC=88 ASCQ=00) and continues operations. If the temperature exceeds 96.8 F, the library disables all actuators until the temperature decreases and generates a “Maximum Temperature Exceeded” event (SK=4 ASC=88 ASCQ=01). Events ACL 4/52 Software Interface Guide Document 6211225-03 Version 3.0...

  • Page 26: Operational Sequences

    ACL 4/52 Software Interface Guide Document 6211225-03 Version 3.0 Operational Sequences A description of operational sequences follow. They are listed in order of precedence. For example, if the door is opened and the STOP switch was pressed, the door open sequence will override the system stop sequence until it is complete.

  • Page 27: System Stopped Sequence

    Sense, Log Sense, and Mode Sense commands. Check Condition status is set for all other commands, and the “Logical Unit in Process of Becoming Ready” condition (SK=2 ASC=04 ASCQ=01) is set in the sense data. Events ACL 4/52 Software Interface Guide Document 6211225-03 Version 3.0...

  • Page 28: Library Unit Inventory Sequence

    ACL 4/52 Software Interface Guide Document 6211225-03 Version 3.0 When the mechanisms are successfully tested and homed, the library performs an inventory of its elements. (See Library Unit Inventory Sequence). When initialization successfully completes, the control panel changes to “System On-line” and the library is fully operational.

  • Page 29: Off-Line Sequence

    The library remains off-line until one of the other operational sequences occur. Automatic Drive Cleaning Sequence The default state of automatic drive cleaning is “disabled.” For a detailed discussion of the automatic drive cleaning features, see Appendix C. Events ACL 4/52 Software Interface Guide Document 6211225-03 Version 3.0 2-11...

  • Page 30: Configuration Procedures

    Version 3.0 Configuration Procedures The library can be configured using either the EIA/TIA-574 (DIAG) interface (refer to Document 6211224, ACL 4/52 Diagnostic Software User’s Manual) or through the Control Panel Menu Mode (refer to Document 6211222, ACL 4/52 Operator’s Guide).

  • Page 31: Control Panel Menu Mode

    Enable/Disable the Auto Clean option Enable/Disable Recovery Enable/Disable the Auto Load option Select the language to be displayed in the Status Display Area (English/Francais/Deutsch/Espanol/Italiano) Operate System Test Enable/Disable temperature sensor Configuration Procedures ACL 4/52 Software Interface Guide Document 6211225-03 Version 3.0 2-13...

  • Page 32: Error Recovery Procedures

    “place” is attempted one additional time before the error is reported. (SK=B ASC=83 ASCQ=02) Operator Recovery Refer to Document 6211222, ACL 4/52 Operator’s Guide, for suggested operator recovery procedures. 2-14 Error Recovery Procedures...

  • Page 33: System Performance

    The host can increase performance by minimizing the distance of the actuator moves. It can do this by using the time when the tape drives are busy (or when no commands are being issued) to sort the storage elements to better suit the application.

  • Page 34: System Diagnostic Support

    Field Service Engineer and are intended for use with the fault isolation procedures described in Document 6211223, ACL 4/52 Field Service Manual. Use of the DSP is described in Document 6211224, ACL 4/52 Diagnostic Software User’s Manual.

  • Page 35: Software Interfaces

    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 Send Volume Tag (B6h) ...3-78 Test Unit Ready (00h)...3-80 ACL 4/52 Software Interface Guide Document 6211225-03 Version 3.0...

  • Page 37: Chapter Overview

    Storage Element is a Bin in the Fixed Storage Array. Import Export Element is a Bin in the Load Port. The ACL 4/52 is a SCSI-2 medium change device. The host computer serves as the SCSI initiator and issues commands to the library and tape drives which act as SCSI targets.

  • Page 38: Reset Sequence

    ACL 4/52 Software Interface Guide Document 6211225-03 Version 3.0 Reset Sequence The ACL 4/52 library supports the SCSI-2 soft reset option. When a SCSI bus reset occurs, the library clears the SCSI bus as described in the SCSI-2 Standard. Supported Messages This section describes the required messages and supported optional messages and their use in coordinating the host and library.

  • Page 39: Abort

    The SCSI-2 standard also allows an optional host-to-target disconnect message. The library does not support this option and responds with a Message Reject if a Disconnect message is received. SCSI Interface ACL 4/52 Software Interface Guide Document 6211225-03 Version 3.0...

  • Page 40: Identify (Initiator To Target)

    ACL 4/52 Software Interface Guide Document 6211225-03 Version 3.0 Identify (Initiator to Target) The host sends this message to the library to identify the library to which the command is being sent. This message also indicates whether the library may disconnect during the command.

  • Page 41: Supported Operational Commands

    Prevent/Allow Medium Removal (1Eh) Release (17h) Reserve (16h) Send Volume Tag (B6h) Finally, the library supports the following vendor specific commands: Initialize Element Status with Range(E7h) Ready Import (DEh) SCSI Interface ACL 4/52 Software Interface Guide Document 6211225-03 Version 3.0...

  • Page 42: Table 2: Supported Operational Commands

    ACL 4/52 Software Interface Guide Document 6211225-03 Version 3.0 Note This section describes the commands, command format and data format. For the most part, these formats are taken directly from the SCSI-2 Specification. Only the fields and values supported by the ACL 4/52 are described in this guide.

  • Page 43: Initialize Element Status (07H)

    SCSI Interface Operation Code (07h) Reserved (00h) Reserved (00h) Reserved (00h) Reserved (00h) Reserved (00h) field of 1 specifies the inventory to not scan No Bar-code Labels ACL 4/52 Software Interface Guide Document 6211225-03 Version 3.0...

  • Page 44: Initialize Element Status With Range (E7H)

    ACL 4/52 Software Interface Guide Document 6211225-03 Version 3.0 Initialize Element Status with Range (E7h) The Initialize Element Status with Range Command allows the host to request an inventory of a specified range of elements in the library. The library conducts the inventory and determines whether each element within the specified range contains a tape cartridge.
  • Page 45 A value of 0 specifies element bar code labels are to be scanned and placed in the primary volume tags. SCSI Interface ACL 4/52 Software Interface Guide Number of Elements Reserved (00h) Reserved (00h) Document 6211225-03 Version 3.0...

  • Page 46: Inquiry (12H)

    Anything greater than 36 returns the full 36 bytes of data. Page Code Vital Product Data Page Code. The ACL 4/52 returns only the Standard Inquiry Data. This field is not used and must be set to 0. The format for the Standard Inquiry Data block returned by the library to the initiator is shown in Table 6.

  • Page 47: Table 6: Standard Inquiry Data

    Peripheral Qualifier 3. ACL 4/52 Software Interface Guide Document 6211225-03 Version 3.0 (02h) CmdQue...
  • Page 48 Note “XXXX” in the represents the ATL part number of the library. Product Revision Level This field contains the ACL 4/52 library firmware revision level in the format X.XX. 3-14 A terminate I/O process value of zero indicates that the device...

  • Page 49: Log Sense Command (4Dh)

    The page control field defines the type of parameter values to be selected. Only cumulative values are supported, therefore this field must be set to one. SCSI Interface ACL 4/52 Software Interface Guide Operation Code (4Dh) Reserved (0) Page Code...

  • Page 50: Table 8: Supported Log

    ACL 4/52 Software Interface Guide Document 6211225-03 Version 3.0 Page Codes Currently, there are only 3 supported page codes: Parameter Pointer This field allows the host to request parameter data beginning from a specific parameter code to the maximum allocation length or the maximum parameter code supported by the target, whichever is less.

  • Page 51: Table 9: Medium Changer Statistics Page

    See Table 10 for Log Parameter format. Table 10: Log Parameter Bit/Byte (MSB) DU(0) DS(0) (MSB) SCSI Interface ACL 4/52 Software Interface Guide Page Code (30h) Reserved (00h) Page Length LOG PARAMETER LIST Log Parameter (First) Log Parameter...

  • Page 52: Table 11: Supported Log Parameter Codes

    ACL 4/52 Software Interface Guide Document 6211225-03 Version 3.0 Parameter Code The parameter code field identifies which log parameter is being transferred for that log page. See Table 11 for parameter codes supported. DU, DS, TSD, ETC, TMC, and LP These parameters are not supported and must be set to zero.

  • Page 53: Mode Select Command (15H)

    Mode Select Data pages being sent with the Mode Select command. Mode Select Data pages are shown in Tables 13, 14, and 15. SCSI Interface ACL 4/52 Software Interface Guide Operation Code (15h) PF (1) Reserved (0)

  • Page 54: Table 13: Mode Select Data - Vendor Unique Page 20H

    ACL 4/52 Software Interface Guide Document 6211225-03 Version 3.0 The format for Mode Select Vendor Unique Page 20h is shown in Table 13. Table 13: Mode Select Data - Vendor Unique Page 20h Bit/Byte Reserved This bit is only used with the Mode Sense command (See Table 22 PS - Parameters Savable on page 3-34).

  • Page 55: Table 14: Mode Select Data - Vendor Unique Page 00H

    On-line, bar codes are scanned and their value placed in the corresponding primary volume tag. NRDC - Not Ready Display Control Not supported. SCSI Interface ACL 4/52 Software Interface Guide Page Code (00h) Page Length (3Eh)
  • Page 56 ACL 4/52 Software Interface Guide Document 6211225-03 Version 3.0 MDC - Message Display Control Not supported. Maximum Parity Retries Not supported. Display Message Not supported. 3-22 SCSI Interface...

  • Page 57: Table 15: Mode Select Data - Element Address Assignment Page

    Number of Storage Elements First Import Export Element Address Number of Import Export Elements First Data Transport Element Address Number of Data Transport Elements Reserved (0000h) ACL 4/52 Software Interface Guide Document 6211225-03 Version 3.0 (LSB) (LSB) (LSB) (LSB) (LSB)
  • Page 58 ACL 4/52 Software Interface Guide Document 6211225-03 Version 3.0 PS - Parameters Savable This bit is only used with the Mode Sense command (See Table 19 on page 3-30). This bit is reserved for Mode Select command and should be set to zero.

  • Page 59: Mode Sense (1Ah)

    This code selects the page of parameter information to be returned by the target. The ACL 4/52 library supports the three medium changer device parameter pages defined in the SCSI-2 standard and two vendor unique pages:...
  • Page 60 ACL 4/52 Software Interface Guide Document 6211225-03 Version 3.0 The disable block descriptors (DBD) field can be one or zero. A bit of zero indicates that the target may return zero or more block descriptors in the returned Mode Sense data at the target’s discretion.

  • Page 61: Table 17: Mode Sense Data Header

    This field is reserved for medium changer devices. This field is reserved for medium changer devices. Block Descriptor Length SCSI Interface ACL 4/52 Software Interface Guide Mode Sense Data Length Medium Type (00h) Device-Specific Parameter (00h) Block Descriptor Length (00h) Document 6211225-03 Version 3.0...

  • Page 62: Table 18: Mode Sense Data - Vendor Unique Page 00H

    ACL 4/52 Software Interface Guide Document 6211225-03 Version 3.0 The format for Mode Select Vendor Unique Page 00h is shown in Table 18. Table 18: Mode Sense Data - Vendor Unique Page 00h Bit/Byte Reserved AInit UInit This bit is always set to one indicating that this page can be saved PS-Parameters Savable to nonvolatile memory.
  • Page 63 MDC - Message Display Control Not supported. Maximum Parity Retries Not supported. Display Message Not supported. SCSI Interface ACL 4/52 Software Interface Guide Document 6211225-03 Version 3.0 3-29...

  • Page 64: Table 19: Mode Sense Data - Element Address Assignment Page

    ACL 4/52 Software Interface Guide Document 6211225-03 Version 3.0 The format for the Element Address Assignment Page is shown in Table 19. Table 19: Mode Sense Data - Element Address Assignment Page Bit/Byte Reserved (MSB) (MSB) (MSB) (MSB) (MSB) (MSB)
  • Page 65 Number of Data Transport Elements This field defines the total number of data transfer elements contained within the medium changer and accessible to the medium transport elements. SCSI Interface ACL 4/52 Software Interface Guide Document 6211225-03 Version 3.0 3-31...

  • Page 66: Table 20: Mode Sense Data - Transport Geometry Parameters Page

    ACL 4/52 Software Interface Guide Document 6211225-03 Version 3.0 The format for the Transport Geometry Parameters Page is shown in Table 20. Table 20: Mode Sense Data - Transport Geometry Parameters Page Bit/Byte Reserved The parameters savable bit of zero indicates the target is not capable of saving the page in a nonvolatile vendor-specific...

  • Page 67: Table 21: Mode Sense Data - Device Capabilities Data

    Reserved (00000000h) Reserved MT<->DT (0h) Reserved ST<->DT (0h) Reserved I/E<->DT (0h) Reserved DT<->DT (0h) Reserved (00000000h) ACL 4/52 Software Interface Guide Document 6211225-03 Version 3.0 Page Code (1Fh) StorI/E StorST StorMT MT->I/E MT->ST MT->MT ST->I/E ST->ST ST->MT I/E->I/E I/E->ST I/E->MT DT->I/E...

  • Page 68: Table 22: Mode Sense Data - Vendor Unique Page 20H

    ACL 4/52 Software Interface Guide Document 6211225-03 Version 3.0 The StorDT, StorIE, StorST, and StorMT fields indicate whether an element of the indicated type (DT, IE, ST, or MT) is capable of storing a tape cartridge. The XX->YY fields indicate whether a transfer from an element of type XX is possible to an element of type YY.

  • Page 69: Move Medium (A5H)

    The library then moves the tape cartridge contained in the source element to the empty destination element. The source and destination elements can be of any type: storage, medium transport, import/export or data transport element. The valid combinations of source element type and destination element type are summarized in the Mode Sense Device Capabilities Parameter Page.

  • Page 70: Table 23: Move Medium Command

    ACL 4/52 Software Interface Guide Document 6211225-03 Version 3.0 The format for the Move Medium Command block is shown in Table 23. Table 23: Move Medium Command Bit/Byte Logical Unit Number (MSB) (MSB) (MSB) The Logical Unit Number must be set to 0. This field indicates Logical Unit Number which logical unit the command should be sent to.

  • Page 71: Position To Element (2Bh)

    The destination element can be one of the following types: storage, import/export or data transfer. If the address is in error, the library returns Check Condition status and sets the sense key to Illegal Request.

  • Page 72: Prevent/Allow Medium Removal (1Eh)

    ACL 4/52 Software Interface Guide Document 6211225-03 Version 3.0 Destination Element Address The destination address specifies the location to which the medium transport element is moved. Invert The medium changer does not support medium rotation for handling double-sided media. The invert bit must be set to zero.

  • Page 73: Table 25: Prevent/Allow Medium Removal Command

    Prevent When this bit is set to one, medium removal is (prevented) disabled. When set to zero (default), removal is (allowed) enabled. SCSI Interface ACL 4/52 Software Interface Guide Operation Code (1Eh) Reserved (00h) Reserved (00h)

  • Page 74: Read Element Status (B8H)

    ACL 4/52 Software Interface Guide Document 6211225-03 Version 3.0 Read Element Status (B8h) The host can determine the status of any of the library’s elements by issuing a Read Element Status Command. The type of element (medium transfer, storage, import/export or data transfer) can be specified in the command as well as the starting address and number...
  • Page 75 fits within the allocated space. SCSI Interface indicates all element types reported. indicates medium transport element. indicates storage element. indicates import/export element. indicates data transfer elements. ACL 4/52 Software Interface Guide Document 6211225-03 Version 3.0 3-41...

  • Page 76: Figure 2: Read Element Status Data General Structure

    ACL 4/52 Software Interface Guide Document 6211225-03 Version 3.0 The returned Read Element Status Data has the general structure as depicted in Figure 2. Figure 2: Read Element Status Data General Structure A single Read Element Status Data Header is returned along with one or more element status pages.

  • Page 77: Table 27: Element Status Data

    The page header (bytes 0-7) contains information that defines the contents of the element descriptors for the elements of that type. The format of a status page is shown in Table 28. SCSI Interface ACL 4/52 Software Interface Guide First Element Address Reported Number of Elements Reported Reserved (00h)

  • Page 78: Table 28: Element Status Page

    ACL 4/52 Software Interface Guide Document 6211225-03 Version 3.0 Table 28: Element Status Page Bit/Byte PVolTag AVolTag (MSB) (MSB) PVolTag A primary volume tag field value of one indicates that the primary volume tag information field is present in each of the following element descriptor blocks.

  • Page 79: Table 29: Medium Transport Element Descriptor

    Additional Sense Code Additional Sense Code Qualifier Reserved (000000h) Reserved (00h) Source Storage Element Address (0000h) Primary Volume Tag Information (if present) Reserved (00000000h) Vendor Unique (0000h) ACL 4/52 Software Interface Guide Document 6211225-03 Version 3.0 (LSB) Except Rsvd Full 3-45...

  • Page 80: Table 30: Primary Volume Tag Information

    ACL 4/52 Software Interface Guide Document 6211225-03 Version 3.0 Except The Exception field is set to one when that element is in an abnormal state. When the element is in a normal state, it is set to zero. Further information on the abnormal state is available in the Additional Sense Code and Additional Sense Code Qualifier fields.

  • Page 81: Table 31: Storage Element Descriptor

    Volume Sequence Number This field is reserved and set to zero. The format of an element descriptor for an element of the storage element type is shown in Table 31. Table 31: Storage Element Descriptor Bit/Byte (MSB) Reserved SValid Invert Element Address This field indicates the address of the element being reported by...
  • Page 82 Medium Removal Requested (ASC=5A ASCQ=01). SValid The SValid bit is set to one if the information in the Source Storage Element Address field is valid. If the information is unknown (due to a door open or power on condition) the SValid bit is set to zero.

  • Page 83: Table 32: Import/Export Element Descriptor

    Additional Sense Code Additional Sense Code Qualifier Reserved (000000h) Reserved (00h) Source Storage Element Address Primary Volume Tag Information (if present) Reserved (00000000h) Vendor Unique (0000h) ACL 4/52 Software Interface Guide Document 6211225-03 Version 3.0 (LSB) Except Import Full Export 3-49...
  • Page 84 Cleaning Cartridge Installed (ASC=30 ASCQ=03) and Operator Medium Removal Request (ASC=5A ASCQ=01). SValid The SValid bit is set to one if the information in the Source Storage Element Address field is valid. If the information is unknown the SValid bit is set to zero.

  • Page 85: Table 33: Data Transfer Element Descriptor

    Source Storage Element Address Primary Volume Tag Information (if present) Reserved (00000000h) Vendor Unique (0000h) An access bit value of one indicates access to the element by a ACL 4/52 Software Interface Guide Document 6211225-03 Version 3.0 (LSB) Except Rsvd Full...
  • Page 86 Element Contents Unknown condition (ASC=80 ASCQ=22), Cleaning Cartridge Installed (ASC=30 ASCQ=03) or any DLT drive error (ASC=8D or ASC=F3). The SValid bit is set to one if the information in the Source Storage SValid Element Address field is valid. If the information is unknown (due to a door open or power on condition) the SValid bit is set to zero.

  • Page 87: Ready Inport (Deh)

    The Logical Unit Number must be set to 0. This field indicates which logical unit the command should be sent to. Address of import to ready. Element Address SCSI Interface ACL 4/52 Software Interface Guide Operation Code (DEh) Reserved (00h) Element Address Reserved (00h)

  • Page 88: Release (17H)

    ACL 4/52 Software Interface Guide Document 6211225-03 Version 3.0 Release (17h) The Release Command releases the library or elements that match the specified release parameters. It is not an error to attempt to release the library if it is not currently Note reserved by the requesting initiator.

  • Page 89: Reserve (16H)

    Release to that element, the command is rejected with a Reservation Conflict status. A Release command issued by another initiator is ignored by the reserved element. SCSI Interface ACL 4/52 Software Interface Guide Document 6211225-03 Version 3.0 3-55...

  • Page 90: Table 36: Reserve Command

    ACL 4/52 Software Interface Guide Document 6211225-03 Version 3.0 Table 36: Reserve Command Bit/Byte Logical Unit Number (MSB) Unused The Logical Unit Number must always be 0. This field indicates Logical Unit Number which logical unit the command should be sent to.

  • Page 91: Table 37: Element List Descriptor

    All the specified elements must be able to be reserved or no reservations take place at all. SCSI Interface ACL 4/52 Software Interface Guide Reserved (0000h) Number of Elements Starting Element Address Document 6211225-03 Version 3.0...

  • Page 92: Request Sense (03H)

    ACL 4/52 Software Interface Guide Document 6211225-03 Version 3.0 Request Sense (03h) The Request Sense Command allows the host to receive sense data from the library. The library supports the reporting of current errors only. A current error (error code 70h) is returned when the error was generated during the execution of the command indicating the Check Condition.

  • Page 93: Table 39: Request Sense Data

    The format of the Request Sense data is shown in Table 39. Table 39: Request Sense Data Bit/Byte Valid Filemark (MSB) (MSB) SKSV SCSI Interface ACL 4/52 Software Interface Guide Error Code (70h) Segment Number (00h) Reserved Information Bytes (00000000h) Additional Sense Length (0Dh) Command Specific Information Bytes...
  • Page 94 ACL 4/52 Software Interface Guide Document 6211225-03 Version 3.0 Valid This field is set to zero indicating that the information field is not being used. Segment Number, Filemark, EOM, and ILI These fields are not supported and are set to zero.

  • Page 95: Request Volume Element Address (B5H)

    Bit/Byte Logical Unit Number (MSB) (MSB) (MSB) Logical Unit Number The Logical Unit Number is 0. SCSI Interface ACL 4/52 Software Interface Guide Operation Code (B5h) VolTag Element Type Code Starting Element Address Number of Elements Reserved (00h) Allocation Length...
  • Page 96 ACL 4/52 Software Interface Guide Document 6211225-03 Version 3.0 VolTag The Volume Tag field (VolTag) indicates whether the volume tag information associated with each tape cartridge should be returned as part of the status information. The volume tag (or bar code) is updated for each tape cartridge whenever it is moved with a Move Medium Command.

  • Page 97: Figure 3: Request Volume Element Address Data General Structure

    Allocation Length of eight to determine how much space must be allocated to transfer all of the status data requested by the command. SCSI Interface ACL 4/52 Software Interface Guide Request Volume Element Address Data Request Volume Element Address Data Header Element Status Data Page (first or only) Element Status Data Page Header Element Descriptor (first or only)

  • Page 98: Table 41: Volume Element Address Header

    ACL 4/52 Software Interface Guide Document 6211225-03 Version 3.0 The format for the Volume Element Address Header is shown in Table 41. Table 41: Volume Element Address Header Bit/Byte (MSB) (MSB) Reserved (00h) (MSB) First Element Address Reported This field indicates the element address of the element with the smallest element address found to meet the command description block request.

  • Page 99: Table 42: Element Status Page

    (minus seven) of descriptor data (excluding this header) that would be returned for the descriptors of the specified type if an adequate allocation length had been specified. SCSI Interface ACL 4/52 Software Interface Guide Element Type Code Reserved (00h)

  • Page 100: Table 43: Medium Transport Element Descriptor

    ACL 4/52 Software Interface Guide Document 6211225-03 Version 3.0 There are four different types of element descriptor blocks, one for each type of element. There are several fields which are found in more than one type of element descriptor as well as fields which are unique to an element descriptor.
  • Page 101 Primary Volume Tag Information field will be included in the element descriptor. This field contains the information read from the bar code affixed to each tape cartridge; its format is shown in Table 44. SCSI Interface ACL 4/52 Software Interface Guide Reserved (00000000h) Vendor Unique (0000h) Document 6211225-03 Version 3.0...

  • Page 102: Table 44: Primary Volume Tag Information

    20h (blanks). Volume Sequence Number This field is reserved and set to zero. The format of an element descriptor for an element of the storage element type is shown in Table 45.
  • Page 103 Medium Removal Requested (ASC=5A ASCQ=01). SValid The SValid bit is set to one if the information in the Source Storage Element Address field is valid. If the information is unknown (due to a door open or power on condition) the SValid bit is set to zero.
  • Page 104 ACL 4/52 Software Interface Guide Document 6211225-03 Version 3.0 Invert The invert field is not supported and is set to zero. Source Storage Element Address The Source Storage Element Address represents the address of the last storage element which held the cartridge. The SValid field indicates whether or not this information is valid.

  • Page 105: Table 46: Import/Export Element Descriptor

    Additional Sense Code Additional Sense Code Qualifier Reserved (000000h) Reserved (00h) Source Storage Element Address Primary Volume Tag Information (if present) Reserved (00000000h) Vendor Unique (0000h) ACL 4/52 Software Interface Guide Document 6211225-03 Version 3.0 (LSB) Except Import Full Export 3-71...
  • Page 106 Cleaning Cartridge Installed (ASC=30 ASCQ=03) and Operator Medium Removal Request (ASC=5A ASCQ=01). SValid The SValid bit is set to one if the information in the Source Storage Element Address field is valid. If the information is unknown the SValid bit is set to zero.

  • Page 107: Table 47: Data Transfer Element Descriptor

    Source Storage Element Address Primary Volume Tag Information (if present) Reserved (00000000h) Vendor Unique (0000h) An access bit value of one indicates access to the element by a ACL 4/52 Software Interface Guide Document 6211225-03 Version 3.0 (LSB) Except Rsvd Full...
  • Page 108 Element Contents Unknown condition (ASC=80 ASCQ=22), Cleaning Cartridge Installed (ASC=30 ASCQ=03) or any DLT drive error (ASC=8D or ASC=F3). The SValid bit is set to one if the information in the Source Storage SValid Element Address field is valid. If the information is unknown (due to a door open or power on condition) the SValid bit is set to zero.

  • Page 109: Rezero Unit (01H)

    Bit/Byte Logical Unit Number Logical Unit Number The Logical Unit Number is 0. This field indicates which logical unit the command is sent to. SCSI Interface ACL 4/52 Software Interface Guide Operation Code (01h) Reserved (00h) Reserved (000000h) Reserved (00h) Document 6211225-03 Version 3.0...

  • Page 110: Send Diagnostic (1Dh)

    ACL 4/52 Software Interface Guide Document 6211225-03 Version 3.0 Send Diagnostic (1Dh) The library includes a built-in self-test. This test is automatically performed when the library is turned on. It can also be performed by issuing the Send Diagnostic Command to the library. If the self-test passes, a Good status is returned.

  • Page 111: Table 50: Selftest Bit Definitions

    A parameter length of zero indicates that no data is transferred. SCSI Interface DevOfl UnitOfl Illegal Combination No-Op Illegal Combination No-Op Selftest 1 Selftest 2 Selftest 1 Selftest 2 ACL 4/52 Software Interface Guide Document 6211225-03 Version 3.0 Selftest Action 3-77...

  • Page 112: Send Volume Tag (B6H)

    ACL 4/52 Software Interface Guide Document 6211225-03 Version 3.0 Send Volume Tag (B6h) The Send Volume Tag command evaluates the element descriptors found by a Send Volume Tag command. The type of element (medium transfer, storage, import/export or data transfer) can be specified in the command as well as the starting address for evaluation.

  • Page 113: Table 52: Send Volume Tag Parameters

    Max Vol Sequence Number Sequence numbers are not supported. This must be set to zero. SCSI Interface Volume Identification Template Field Reserved (0000h) Minimum Volume Sequence Number (0000h) Reserved (0000h) Maximum Volume Sequence Number (0000h) ACL 4/52 Software Interface Guide Document 6211225-03 Version 3.0 (LSB) (LSB) (LSB) 3-79...

  • Page 114: Test Unit Ready (00H)

    ACL 4/52 Software Interface Guide Document 6211225-03 Version 3.0 Test Unit Ready (00h) The host uses the Test Unit Ready Command to determine if a library is ready. The library responds in one of the following ways, depending upon the state of the library: Returns a Good status.

  • Page 115: Sense Data Values

    SCSI (Host Computer) Diag (Diagnostic Port/Computer) Both = SCSI and Diag Note The message name and description may contain an abbreviation as follows: REQ’D Diag NVRAM ACL 4/52 Software Interface Guide Appendix Logical Unit Required Device Diagnostics Nonvolatile RAM Analog-to-Digital Document 6211225-03 Version 3.0...

  • Page 116: Table A-1: Sense Data Values (Hexadecimal

    PARAMETER LIST LENGTH ERROR Invalid parameter list length field specified by command. INVALID COMMAND OPERATION CODE Verify host command format using the ACL 4/52 Software Interface Guide. INVALID ELEMENT ADDRESS Check Mode Sense data for correct element addresses. INVALID FIELD IN COMMAND DATA BLOCK Ensure all reserve fields are set to zero.
  • Page 117 INVALID FIELD IN PARAMETER LIST Verify Mode Select page fields.Verify that fields comply with the command format described in the ACL 4/52 Software Interface Guide. PARAMETER VALUE INVALID Verify Mode Select page fields. Verify that fields comply with the command format described in the ACL 4/52 Software Interface Guide.
  • Page 118 ACL 4/52 Software Interface Guide Document 6211225-03 Version 3.0 Table is sorted by data in the ASC column Sense ASCQ -none- CLEANING CARTRIDGE INSTALLED Indicates that the element contains a cleaning cartridge that is not “used-up”. This is returned with the element status data, which has no sense key.
  • Page 119 SCSI MESSAGE ERROR Detected message error in message processing on the SCSI BUS. SELECT OR RE-SELECT FAILURE ACL 4/52 timed out trying to reselect host. Make sure host is running. SCSI PARITY ERROR SCSI Parity Error detected. Check cable connections and cable length.
  • Page 120 ACL 4/52 Software Interface Guide Document 6211225-03 Version 3.0 Table is sorted by data in the ASC column Sense ASCQ MEDIUM REMOVAL PREVENTED Prevent Medium Removal command was executed and command was received to export cartridge. Execute Allow Medium Removal command and retry move medium command.
  • Page 121 LOGICAL UNIT STANDBY BUTTON WAS PRESSED Retry command. LOAD RETRY FAILED ACL 4/52 was unable to successfully load the drive, even after retries. Check drive alignment. If problem continues, drive may need servicing. Introduction ACL 4/52 Software Interface Guide...
  • Page 122 ACL 4/52 Software Interface Guide Document 6211225-03 Version 3.0 Table is sorted by data in the ASC column Sense ASCQ NVRAM CHECKSUM FAILURE Nonvolatile RAM contents are corrupted. Ensure nonvolatile RAM ICs are seated correctly. Use the Diagnostic Software to initialize nonvolatile RAM and calibrate system.
  • Page 123 Replace Robotic Controller Board. EXTENSION TIMEOUT Extension axis did not reach desired position. Retry command. If failure repeats, use Diagnostic Software to run extension self-test. Introduction ACL 4/52 Software Interface Guide Message Name/Description Document 6211225-03 Version 3.0 Interface Both Both...
  • Page 124 ACL 4/52 Software Interface Guide Document 6211225-03 Version 3.0 Table is sorted by data in the ASC column Sense ASCQ EXTENSION CURRENT FEEDBACK FAILURE Extension axis collided with obstruction. Determine cause of obstruction. Calibrate the system. Lubricate the rail. EXTENSION MECHANICAL POSITION ERROR Extension axis was unable to move to commanded position.
  • Page 125 Check for obstacles in path. Check motor cable connection. VERTICAL CURRENT TEST FAILURE Unable to detect current feedback during self-test. Check motor cable connection. Introduction ACL 4/52 Software Interface Guide Message Name/Description Document 6211225-03 Version 3.0 Interface Both Both...
  • Page 126 ACL 4/52 Software Interface Guide Document 6211225-03 Version 3.0 Table is sorted by data in the ASC column Sense ASCQ VERTICAL POSITION OVERFLOW The position step counter overflowed. Issue a Rezero Unit command. VERTICAL HARDWARE ERROR Vertical actuator or sensor has failed.
  • Page 127 If failure repeats, run horizontal self-test. WARNING SAFE TEMPERATURE EXCEEDED This is only a warning that the temperature in the library exceeds the normal operational temperature Introduction Message Name/Description ACL 4/52 Software Interface Guide Document 6211225-03 Version 3.0 Interface Both Both...
  • Page 128 ACL 4/52 Software Interface Guide Document 6211225-03 Version 3.0 Table is sorted by data in the ASC column Sense ASCQ MAXIMUM TEMPERATURE EXCEEDED Library turns off and remains off until the temperature returns to an acceptable level (59-90 UNCALIBRATED POSITION System requires calibration.
  • Page 129 Flash is soldered onto the board. Replace the Robotic Controller. FLASH MEMORY UNABLE TO PROGRAM Flash is soldered onto the board. Replace the Robotic Controller. Introduction ACL 4/52 Software Interface Guide Message Name/Description Document 6211225-03 Version 3.0 Interface Both Both...
  • Page 130 ACL 4/52 Software Interface Guide Document 6211225-03 Version 3.0 Table is sorted by data in the ASC column Sense ASCQ LIBRARY UNIT COMMAND TIMED OUT Verify that communications to library still exists by issuing another command DLT™ DRIVE COMMUNICATION TIMEOUT The library is unable to communicate with a drive.

  • Page 131: Control Panel Messages

    SDA. (If there is only one line of text in the message, it is displayed on Line #1.) Column #2, the “ explanation of the message. ACL 4/52 Software Interface Guide Document 6211225-03 Appendix ,” shows the two lines Message ”...

  • Page 132: System States

    ACL 4/52 Software Interface Guide Document 6211225-03 Version 3.0 System States The system state describes the overall condition of the system including the status of the stop button, Load port and front door. It also monitors the activities that place the system in an on-line condition.
  • Page 133 S y s t e m Po w e r - U p . power is cycled from “ The Control Panel S y s t e m S t o p p e d . System States ACL 4/52 Software Interface Guide Document 6211225-03 Description ” to “ .”...

  • Page 134: Operator Messages

    ACL 4/52 Software Interface Guide Document 6211225-03 Version 3.0 Operator Messages Operator Messages assist on operator interacting with the library. These messages will obscure most other messages, but are temporary and will only last until the condition they are describing has past or they have been displayed too long (generally 80 sec).

  • Page 135: Menu Mode Messages

    Menu Mode Messages Refer to the ACL 4/52 Operators Manual (Document No. 6211222) for a detailed description of the Menu Mode Messages. Menu Mode Messages ACL 4/52 Software Interface Guide Document 6211225-03 Version 3.0...
  • Page 137 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 Appendix Version 3.0...

  • Page 139: Purpose And Scope

    This appendix presents a detailed discussion of the Automatic Drive Cleaning feature for the ACL 4/52 Library. Drive Cleaning Modes Two modes of drive cleaning support are provided on the ACL 4/52 library: Host Initiated Cleaning Mode and Fully Automatic Cleaning Mode. Host Initiated Cleaning Mode Drive cleaning in Host Initiated Cleaning Mode is initiated by the host.

  • Page 140: Selection Of Cleaning Mode

    ACL 4/52 Software Interface Guide Document 6211225-03 Version 3.0 Selection of Cleaning Mode The cleaning mode is selectable by using either the diagnostic software, the control panel, or a host initiated Mode Select command. A host initiated Mode Select command is the only way to permanently change the cleaning mode in the library’s NVRAM.

  • Page 141: Reporting Of Cleaning Mode

    “Report Clean Tape” from the “Config” Menu. In response, the current cleaning mode is displayed as well as the bar code label, the number of uses of the cleaning cartridges, and the “home and current” storage element location for each of the cleaning cartridges in the library.

  • Page 142: Identification

    ACL 4/52 Software Interface Guide Document 6211225-03 Version 3.0 Identification Cleaning cartridges are identified with a uniquely identifiable bar code. A bar code for a cleaning cartridge begins with the prefix “CLN”, for example “CLN001.” Storage and Tracking A cleaning cartridge is tracked by the library from the time that it is loaded into the library until the time that it is unloaded from the library.

  • Page 143: Monitoring Usage

    filled-in as well as possible changes to the Access bit (described below). A storage element that contains a cleaning cartridge that is not used up has the Access bit set to 1, the Except bit set to 1 and the status set to Cleaning Cartridge Installed (ASC=30 ASCQ=03).

  • Page 144: Monitoring Drives

    ACL 4/52 Software Interface Guide Document 6211225-03 Version 3.0 A data transfer element that is currently being cleaned as part of a fully automatic cleaning operation has the Access bit set to 0, the Except bit set to 1 and the status set to Cleaning Cartridge Installed (ASC=30 ASCQ=03).

  • Page 145: Selection Of Cleaning Cartridges

    Wherever possible, the library attempts to return the cleaning cartridge to its original storage element. If an unrecoverable error occurs during the movement of a cleaning cartridge...

  • Page 146: Supervising The Drive Cleaning Operation

    If an export or movement operation cannot be successfully completed due to unrecoverable errors, the library, wherever possible, attempts to return the cleaning cartridge to its original storage element so as to clear the transport element. If an unrecoverable error occurs during the movement of a cleaning...

  • Page 147: Unloading Cleaning Cartridges

    If a movement operation cannot be successfully completed due to unrecoverable errors, the library, wherever possible, attempts to return the cleaning cartridge back to its original storage element so as to clear the transport element. If an unrecoverable error occurs during the movement of a...
  • Page 148 C-12...
  • Page 149 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 ACL 4/52 Software Interface Guide Document 6211225-03 Appendix Version 3.0...

  • Page 151: Purpose And Scope

    Purpose and Scope This appendix presents a detailed discussion of the Exabyte EXB-120 Emulation Mode for the ACL 4/52 Library. It is intended to document the differences between the ACL 4/52 Standard Interface Mode and the Exabyte Emulation Mode. Host Interface Modes Two Host Interface modes are provided on the ACL 4/52 library: Standard Interface Mode and Exabyte EXB-120 Emulation Mode.

  • Page 152: Selection Of Host Interface Mode

    ACL 4/52 Software Interface Guide Document 6211225-03 Version 3.0 Selection of Host Interface Mode The Host Interface mode is selectable by using either the diagnostic software, control panel or a host initiated Mode Select command. The default Host Interface mode is Standard Interface Mode, as documented in the preceding sections of this manual.

  • Page 153: Reporting Of Host Interface Mode

    A bit value of 0 indicates that the Standard Interface Mode is enabled or that the mode is not changeable, as appropriate. Reporting of Host Interface Mode ACL 4/52 Software Interface Guide Document 6211225-03 Version 3.0...

  • Page 154: Scsi Command Differences

    Descriptor returns 52 bytes, omitting the ACL 4/52 vender unique bytes (bytes 52-53). Also, the Volume Identification field will only have valid data in the first 8 bytes (as opposed to 10 valid bytes in an ACL 4/52) with the remainder being blanks (20h).

  • Page 155: Receive Diagnostic Results (1Ch

    When in Exabyte Emulation Mode, the Request Sense command’s Data In phase only returns 18 bytes, omitting the ACL 4/52 vender specific Additional Sense Bytes (bytes 18-20). No attempt is made to map reporting of ACL 4/52 vender specific sense codes to Exabyte vender specific sense codes.

  • Page 156: Exabyte Emulation Design Philosophy

    The Write Firmware command should not act successful if not executed, so a Check Condition is returned. There are capabilities of the ACL 4/52 library that allow it to perform actions that an EXB-120 can not. This includes a move to the Transport Element, a move with the same source and target, or a third party reservation.

  • Page 157: Glossary

    The drive belt connecting the horizontal motor to the horizontal axis assembly. Host Computer The computer that issues SCSI commands to control the library robotics. Liquid Crystal Display ACL 4/52 Software Interface Guide Document 6211225-03 Version 3.0...
  • Page 158 ACL 4/52 Software Interface Guide Document 6211225-03 Version 3.0 Load Port MTBF MTTR NVRAM on-line pick place PROM rear panel RS-232 SCSI tape drive vertical belt vertical carriage assembly The component of the library that allows cartridges to be imported and exported.

  • Page 159: Index

    Save Data Pointer Offline Diagnostics (EIA/TIA-574) Operational Sequences Automatic Drive Cleaning Door Opened Library Unit Inventory 2-11 Offline Online Initialization Power-On System Stopped Related Documentation SCSI II terminology ACL 4/52 Software Interface Guide Document 6211225-03 Version 3.0 2-16 2-16 2-11 2-10...
  • Page 160 ACL 4/52 Software Interface Guide Document 6211225-03 Version 3.0 Sense Data Values Storage Elements Supported Messages mandatory optional Transport Element Index...

Table of Contents