User Guide

Ampex 1308904-X4 Preliminary Draft 3-13
ACL Application Programmer’s Guide Operational Status
3.7.4 Internal Logs
You can use the following functions and 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).
• aclGetErrorLog() and acl_errlog_library retrieve 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
• aclGetStaticLog() and acl_statlog_library retrieve entries from the static log. This log
contains information about ACL internal software performance and protocol tasks; the
information is intended for use by Ampex factory personnel.
3.7.5 Sense Data
The ACL sets Sense Data when a command results in Check Condition status (see
Appendix A for descriptions of ACL Sense Data codes). You can use the following functions
and utilities to retrieve the Sense Data: aclReqSense(), aclStatus(), and acl_status_library.
Writer_Note: The following listing is based on the acl_status_library man page only. I have not yet
received the man page inputs for aclReqSense() and aclStatus(). [Vaughn gave me an
E-mail that suggested aclStatus() would be used to parse the data returned for
aclReqSense()].
The information returned includes the following
• SCSI Sense Data
– Sense Key The SCSI sense key value describing the condition (see
Table A-2).
– Sense Code The SCSI ASC/ASCQ value describing the condition (see
Table A-3).
• Additional Sense Data
– Condition Code Vendor-specific condition code (see Table A-4).
– CHS position 2XX, 4XX - The current position of the ACL cartridge
handling system; i.e., parked (0) or the address of the storage
bin positioned in front of the drive (100d–106d).
– 8XX - The address of the element at which the cartridge
handler is positioned; i.e. drive (100d–103d), storage bin
(1000d–1247d), or IMEX bin (10d–17d).
– Door Status Indicates whether door status is open or closed; sent by ACL
when door status changes and whenever a door is open.