Detailed instructions for use are in the User's Guide.
DST
Automated Cartridge Library UNIX Application Programmer's Guide
®
1308910-01
NOTICE The contents of this technical manual have been checked and are believed to be accurate. However, no responsibility is assumed for any inaccuracies in the information provided herein. Ampex Corporation reserves the right to make changes without notice to improve reliability, function or design.
TRADEMARKS AIX is a registered trademark of International Business Machines Corporation. DEC is a trademark of Digital Equipment Corporation. DST is a registered trademark of Ampex Corporation. DIS is a trademark of Ampex Corporation. IRIX is a registered trademark of Silicon Graphics Incorporated. Solaris is a registered trademark of Sun Microsystems, Inc. UNIX is registered trademark licensed exclusively by X/Open Co., Ltd. All other trademarks and registered trademarks are the property of their respective holders.
COPYRIGHT INFORMATION U.S. GOVERNMENT RESTRICTED RIGHTS: Software and any documentation are provided with RESTRICTED RIGHTS. Use, duplication, or disclosure by the Government is subject to restrictions as set forth in subparagraph (c)(1)(ii) of the Rights in Technical Data and Computer Software clause at DFARS 252.227-7013 and Rights in Data-General, including Alternate III, at FAR 52.227-14, as applicable. Prepared by Technical Publications Ampex Corporation 500 Broadway Redwood City, CA 94063-3199 Copyright © 1998 by Ampex Corporation All rights reserved Part No. Ampex 1308910-01 Issued: July 1998
ACL Application Programmer's Guide
Contents
Contents
Section 1 General Information
1.1 1.2 1.3 1.4 1.5 1.6 1.7 1.8 Introduction ....................................................................................................1-1 Supported UNIX Operating Systems .............................................................1-2 Contents ..........................................................................................................1-2 Notational Conventions ..................................................................................1-3 Related Documents ........................................................................................1-4 Training Services ............................................................................................1-5 Technical Support ..........................................................................................1-5 Documentation Support ..................................................................................1-5
Section 2
ACL Software Overview
2.1 2.2 2.3 2.4 2.4.1 2.4.2 2.4.3 2.4.4 2.4.5 2.4.6 2.5 2.5.1 2.5.2 2.5.3 2.5.4 2.5.5 Introduction ....................................................................................................2-1 Ampex ACL Device Driver ...........................................................................2-1 Native Device Drivers ....................................................................................2-1 libacl API Overview .......................................................................................2-3 Operation of libacl ......................................................................................2-3 Function Return Values ..............................................................................2-3 Errors ..........................................................................................................2-3 UNIX Platform Compatibility ....................................................................2-3 Open behavior.............................................................................................2-3 Restrictions .................................................................................................2-4 ACL Utilities Overview .................................................................................2-4 Exit Status...................................................................................................2-4 Errors ..........................................................................................................2-4 UNIX Platform Compatibility ....................................................................2-4 Open behavior.............................................................................................2-4 Restrictions .................................................................................................2-4
Section 3
ACL Operational Characteristics
3.1 3.2 3.2.1 Introduction ....................................................................................................3-1 ACL Configuration ........................................................................................3-1 Addressable Elements.................................................................................3-1 DST 412 ACL ........................................................................................3-2 DST 712 ACL ........................................................................................3-2 DST 812 ACL ........................................................................................3-2 Barcode Reader...........................................................................................3-5 Product Information....................................................................................3-5 Multiple Port and Multiple Initiator Considerations ..................................3-6
3.2.2 3.2.3 3.2.4
Ampex 1308910-01
iii
Running Contents Head
Model No. ACL Application Programmer's Guide
3.2.5 3.2.6 3.3 3.3.1 3.3.2
3.4 3.5 3.5.1 3.5.2 3.5.3 3.5.4 3.5.5
Configuration Parameters .......................................................................... 3-6 Power Up and Hard Reset.......................................................................... 3-7 Tape Cartridge Loading and Unloading ........................................................ 3-8 DST 412 ..................................................................................................... 3-8 DST 712 and DST 812............................................................................... 3-8 Loading a Tape Cartridge ...................................................................... 3-8 Unloading a Tape Cartridge................................................................... 3-8 Tape Cartridge Movement ............................................................................. 3-9 Operational Status .......................................................................................... 3-9 Unit Ready Status ...................................................................................... 3-9 Initialize Element Status ............................................................................ 3-9 Read Element Status ................................................................................ 3-10 Internal Logs ............................................................................................ 3-10 Sense Data and Status .............................................................................. 3-11
Section 4
libacl API Functions
4.1 4.2 4.2.1 4.2.2 4.2.3 4.2.4 4.3 4.4 4.5 4.6 4.7 4.8 4.9 4.10 4.11 4.12 4.13 4.14 Introduction .................................................................................................... 4-1 libacl Overview .............................................................................................. 4-1 Applicability .............................................................................................. 4-1 Libacl Functions Summary ........................................................................ 4-2 ACL Elements............................................................................................ 4-2 Return Values............................................................................................. 4-2 aclAuditElement ............................................................................................ 4-4 aclAuditLibrary .............................................................................................. 4-7 aclGetElemData ........................................................................................... 4-10 aclGetParam ................................................................................................. 4-12 aclGetStatus ................................................................................................. 4-15 aclGetVersion .............................................................................................. 4-18 aclInit ........................................................................................................... 4-20 aclMoveCartridge ........................................................................................ 4-21 aclMoveVolume .......................................................................................... 4-23 aclPark ......................................................................................................... 4-25 aclSetParam ................................................................................................. 4-26 aclTUR ......................................................................................................... 4-29
Section 5
ACL Utilities
5.1 5.2 5.2.1 5.2.2 5.2.3 5.2.4 5.2.5 5.2.6 5.2.7 Introduction .................................................................................................... 5-1 ACL Utilities Overview ................................................................................. 5-1 Applicability .............................................................................................. 5-1 Utilities Summary ...................................................................................... 5-2 Input Conventions...................................................................................... 5-2 Output Conventions ................................................................................... 5-3 Arguments.................................................................................................. 5-3 Options....................................................................................................... 5-4 ACL Locations........................................................................................... 5-4
iv
Ampex 1308910-01
ACL Application Programmer's Guide
Contents
5.2.8 5.2.9 5.3 5.4 5.5 5.6 5.7 5.8 5.9 5.10 5.11 5.12 5.13 5.14
DST 412 ACL ........................................................................................5-5 DST 712 ACL ........................................................................................5-5 DST 812 ACL ........................................................................................5-6 Environment ...............................................................................................5-6 Exit Status...................................................................................................5-7 acl_audit_element ...........................................................................................5-9 acl_audit_library ...........................................................................................5-13 acl_errlog_library .........................................................................................5-16 acl_getparam_library ....................................................................................5-19 acl_init_chs ...................................................................................................5-23 acl_move_tape ..............................................................................................5-25 acl_move_volume ........................................................................................5-27 acl_park_chs .................................................................................................5-29 acl_query_library .........................................................................................5-31 acl_setparam_library ....................................................................................5-34 acl_statlog_library ........................................................................................5-37 acl_status_library .........................................................................................5-39
Appendix A
Returned Sense Data
A.1 A.2 A.3 A.4 A.5 Error/Event Parameter Identification Codes .................................................A-1 Sense Key Codes ...........................................................................................A-4 Additional Sense Codes and Qualifiers .........................................................A-5 Vendor-Specific ACL Condition Codes .......................................................A-7 CHS Failure, Error, and Warning Codes .....................................................A-16
Appendix B
Previous ACL Model Name and Address Assignments
B.1 Introduction .................................. ...
