User Guide

Ampex 1308910-01 3-11
ACL Operational Characteristics Operational Status
• acl_statlog_library retrieves 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.5.5 Sense Data and Status
The ACL sets Sense Data when a command results in Check Condition status and clears the
Sense Data prior to executing any command other than the SCSI Request Sense command.
When an ACL utility fails, the Sense Data is retrieved automatically and reported in the exit
status messages; when a libacl function fails, you can call the aclGetStatus() function
immediately to retrieve the Sense Data.
In addition to the Sense Data, aclGetStatus() also reports:
• A device error code (Ecode) that indicates the type of failure. A value of 2 indicates an
invalid device and a value of
3 indicates a function execution error.
• Vendor specific additional-sense data consisting of the following:
– Conditional data that might provide more information about the cause of the
command failure.
– Status data that provides information about the current operational state. Since this
data is not related to a command failure, it is always available and can also be
retrieved by the acl_status_library utility.
The Sense Data that can be retrieved by aclGetStatus() includes the following
Sense Key The SCSI sense key value describing the condition (see
Table A-1. on page A-4).
Sense Code The SCSI ASC/ASCQ value describing the condition (see
Table A-2. on page A-5).
Condition Code Vendor-specific condition code (see Table A-3. on page A-7).
The conditional data that can be retrieved by aclGetStatus() includes the following
Failure Code Vendor-specific failure code (see Table A-4. on page A-16); valid only
when the CHS was unable to complete the previous command.
Warning Code Vendor-specific warning code (see Table A-4. on page A-16); valid only
when the CHS completed the previous command but detected a
problem.
Error Code Vendor-specific error code (see Table A-4. on page A-16); valid only
when the CHS did not attempt to execute the previous command.
Door Status Open or closed; valid when door status changes and whenever a door is
open.