User Guide

4-2 Ampex 1308910-01

Model No.

Running Head

libacl Overview ACL Application Programmer’s Guide

4.2.2 Libacl Functions Summary

aclAuditElement() Retrieve the status of a single element from the ACL internal database.

aclAuditLibrary() Retrieve the status of all elements from the ACL internal database.

aclGetElemData() Get element counts and starting addresses.

aclGetParam() Get current ACL conﬁguration parameter settings.

aclGetStatus() Get current ACL status information and sense data

aclGetVersion() Get ACL vendor, product, software version, and software release

information.

aclInit() Update element status in the ACL internal database.

aclMoveCartridge() Move a tape cartridge from one ACL location to another.

aclMoveVolume() Move the speciﬁed tape cartridge to another ACL location.

aclPark() Park the ACL cartridge handling system (DST 412).

aclSetParam() Change ACL conﬁguration parameter(s).

aclTUR() Verify that the ACL is ready to perform all operations.

4.2.3 ACL Elements

SCSI addresses are assigned to all ACL elements (locations) that can contain a tape cartridge.

libacl API functions recognize the addresses listed below.

Note: For bin conﬁguration, see paragraph 3.2.1 on page 3-1.

DST 412 ACLs can move a tape cartridge from a storage bin to the tape drive, or from the tape

drive to a storage bin

DST 712 and DST 812 ACLs can move a tape cartridge to or from any of the addressable

elements (tape drive, storage bin, IMEX bin, or CHS)

4.2.4 Return Values

All libacl API functions except acl_audit_element() and acl_audit_library() return 0 on

success or

-1 on failure. The two audit functions return zero on failure or the number of

elements they are reporting status for on success.