User Guide

3-10 Ampex 1308910-01
Model No.
Running Head
Operational Status ACL Application Programmer’s Guide
When necessary, an initiator can use the aclInit() function or the acl_init_chs utility to force
the ACL to perform an initialization routine.
3.5.3 Read Element Status
You can use the following functions and utilities to retrieve current ACL element status from
the internal database:
• aclAuditElement() and acl_audit_element retrieve the status of a single element.
• aclAuditLibrary() and acl_audit_library retrieve the status of all elements.
The following information is reported for the various elements:
• Name/Address – identifies the element by location name and/or SCSI address.
• Type – indicates the element type; i.e., storage (bin), transport (CHS), data transfer (tape
drive), or import/export (IMEX).
• Status – indicates whether the element is in a normal or abnormal/unknown state.
• Access Permission – indicates whether the ACL can transfer a tape cartridge to or from
the element.
• Contents – indicates whether the element contains a tape cartridge.
• Volume Tag – indicates the barcode ID of the tape cartridge in the element (not valid for
a DST 412 transport element).
• Tape Cartridge Size – indicates the size of the tape cartridge in the element (not valid for
the transport element).
• CHS Position – indicates the current position of the CHS (valid for the transport element
only).
• Door Status – indicates whether the ACL door(s) are open or closed (valid for the
transport element only).
You can also use the aclGetStatus() function or the acl_status_library utility to obtain door
status or CHS position.
3.5.4 Internal Logs
You can use the following utilities to retrieve entries from internal logs containing statistics
kept by the ACL. This information is valid for the current operating session (that is, for the
period since power on or the last reset).
• acl_errlog_library retrieves entries from the error/event log. This log lists internal
events that might be useful to service personnel in diagnosing and correcting problems;
the events are reported in order of occurrence, starting with the most recent