|
Need help using a product?
|
|
|
|
User manual AMPEX DATA DST ACL APPLICATION PROGRAMMING INTERFACE (LIBACL) PROGRAMMER S GUIDE, PART NO. 1308904-X4
Diplodocs help download the user guide AMPEX DATA DST ACL APPLICATION PROGRAMMING INTERFACE (LIBACL) PROGRAMMER S GUIDE, PART NO. 1308904-X4 .
Preview of the first 3 pages of manual
You either have JavaScript turned off or an old version of Adobe Flash Player Get the latest Flash Player.
Manual abstract: user guide AMPEX DATA DST ACL APPLICATION PROGRAMMING INTERFACE (LIBACL) PROGRAMMER S GUIDE, PART NO. 1308904-X4
Detailed instructions for use are in the User's Guide. DST/DIS
Automated Cartridge Library
UNIX Application Programmer's Guide
®
TM
1308904-X4
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 UNIX is registered trademark licensed exclusively by X/Open Co., Ltd. DIS is a trademark of Ampex Corporation. DST is a registered trademark of Ampex Corporation.
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 401 Broadway Redwood City, CA 94063-3199 Copyright © 1996 by Ampex Corporation All rights reserved Part No. 1308904-X4 Issued: September 1997
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 1.9 Introduction ....................................................................................................1-1 Supported UNIX Operating Systems .............................................................1-1 Manual Contents ............................................................................................1-2 Notational Conventions ..................................................................................1-2 Notices and Notes ...........................................................................................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.4.7 2.5 2.5.1 2.5.2 2.5.3 2.5.4 2.5.5 Introduction ....................................................................................................2-1 The Ampex Automated Cartridge Library Device Driver .............................2-1 Native Device Drivers ....................................................................................2-1 libacl API Overview .......................................................................................2-3 Operation of libacl ......................................................................................2-3 Function Return Values ..............................................................................2-4 Errors ..........................................................................................................2-4 Platform and Drive Compatibility ..............................................................2-4 ACL Driver Version Compatibility............................................................2-4 Open behavior.............................................................................................2-4 Restrictions .................................................................................................2-5 ACL Utilities Overview .................................................................................2-5 Exit Status...................................................................................................2-5 Platform and Drive Compatibility ..............................................................2-5 ACL Driver Version Compatibility............................................................2-5 Open behavior.............................................................................................2-5 Restrictions .................................................................................................2-6
Ampex 1308904-X4
Preliminary Draft
iii
Running Contents Head
Model No. ACL Application Programmer's Guide
Section 3
ACL Operational Characteristics
3.1 3.2 3.3 3.3.1 Introduction .................................................................................................... 3-1 SCSI Commands ............................................................................................ 3-1 ACL Configuration ........................................................................................ 3-2 Addressable Elements ................................................................................ 3-2 Element SCSI Addresses ....................................................................... 3-2 Element Location Names....................................................................... 3-3 Barcode Reader .......................................................................................... 3-6 SCSI Target Configuration ........................................................................ 3-6 Product Information ................................................................................... 3-7 Multiple Port and Multiple Initiator Considerations.................................. 3-7 Configuration Parameters .......................................................................... 3-7 Power Up and Hard Reset.......................................................................... 3-8 Tape Cartridge Loading and Unloading ........................................................ 3-9 Series 2XX and 4XX ................................................................................. 3-9 Series 8XX ................................................................................................. 3-9 Loading a Tape Cartridge ...................................................................... 3-9 Unloading a Tape Cartridge................................................................... 3-9 Tape Cartridge Movement ........................................................................... 3-10 CHS Positioning .......................................................................................... 3-10 Operational Status ........................................................................................ 3-10 Unit Ready Status .................................................................................... 3-10 Initialize Element Status .......................................................................... 3-10 Read Element Status ................................................................................ 3-11 Internal Logs ............................................................................................ 3-13 Sense Data................................................................................................ 3-13
3.3.2 3.3.3 3.3.4 3.3.5 3.3.6 3.3.7 3.4 3.4.1 3.4.2
3.5 3.6 3.7 3.7.1 3.7.2 3.7.3 3.7.4 3.7.5
Section 4
libacl API Functions
4.1 4.2 4.3 4.4 4.5 4.6 4.7 4.8 4.9 4.10 4.11 4.12 4.13 4.14 4.15 4.16 4.17 4.18 Introduction .................................................................................................... 4-1 libacl_intro_api .............................................................................................. 4-2 aclGeneric ...................................................................................................... 4-7 aclAuditLibrary .............................................................................................. 4-9 aclAuditElement .......................................................................................... 4-12 aclGetElemData ........................................................................................... 4-15 aclGetErrorLog ............................................................................................ 4-17 aclGetParam ................................................................................................. 4-18 aclGetStaticLog ........................................................................................... 4-21 aclGetVersion .............................................................................................. 4-22 aclInit ........................................................................................................... 4-24 aclMoveCartridge ........................................................................................ 4-25 aclMoveVolume .......................................................................................... 4-27 aclPark ......................................................................................................... 4-29 aclPosition .................................................................................................... 4-31 aclRelease .................................................................................................... 4-33 aclReserve .................................................................................................... 4-35 aclReqSense ................................................................................................. 4-36
iv
Preliminary Draft
Ampex 1308904-X4
ACL Application Programmer's Guide
Contents
4.19 4.20 4.21 4.22
aclRezero ......................................................................................................4-38 aclSetParam ..................................................................................................4-39 aclStatus .......................................................................................................4-42 aclTUR .........................................................................................................4-43
Section 5
ACL Utilities
5.1 5.2 5.3 5.4 5.5 5.6 5.7 5.8 5.9 5.10 5.11 5.12 5.13 5.14 Introduction ....................................................................................................5-1 acl_intro ..........................................................................................................5-2 acl_audit_library .............................................................................................5-8 acl_audit_element .........................................................................................5-11 acl_errlog_library .........................................................................................5-14 acl_getparam_library ....................................................................................5-17 acl_init_chs ...................................................................................................5-21 acl_move_tape ..............................................................................................5-23 acl_move_volume ........................................................................................5-26 acl_park_chs .................................................................................................5-27 acl_query_library .........................................................................................5-29 acl_setparam_library ....................................................................................5-32 acl_statlog_library ........................................................................................5-36 acl_status_library .........................................................................................5-38
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-6 CHS Failure, Error, and Warning Codes .....................................................A-13
Ampex 1308904-X4
Preliminary Draft
v
Running Tables Head
Model No. ACL Application Programmer's Guide
Tables
2-1 3-1 3-2 A-1 A-2 A-3 A-4 A-5 ACL Operations ................................................................................................................ 2-1 SCSI Address Assignments for 8XX ACL Storage and IMEX Elements ......................... 3-4 ACL Behavior Parameter Descriptions .............................................................................. 3-8 Error/Event Parameter Identification Code Descriptions.................................................. A-1 Sense Key Code Descriptions ........................................................................................... A-4 ASC/ASCQ Conditions ..................................................................................................... A-5 Vendor- ...
|
