User Guide

4-36 Preliminary Draft Ampex 1308904-X4
Model No.
Running Head
aclReqSense ACL Application Programmer’s Guide
4.18 aclReqSense
NAME
aclReqSense() - retrieve ACL SCSI sense data.
SYNOPSIS
#include <acl.h>
int aclReqSense(char *device, sense_data_t *sp, int size);
Writer_Note: Should we list the sense_data_t structure in the man page and describe the structure
members? Even if we do so, the supporting detail necessary to interpret the sense data
is currently published only in the ICD which the customer doesn’t get. I plan to include
the detail in some future release of the libacl Programmer’s Guide, but I have no idea
when that will be as eight months have elapsed since I last had a chance to work on it.
DESCRIPTION
aclReqSense() issues a SCSI Request Sense command to the ACL to retrieve the current
Sense Data. This function is usually called to determine the condition(s) that caused the
previous function to fail.
• The ACL clears Sense Data prior to executing any command other than Request Sense
and sets Sense Data when a command results in a Check Condition or Command
Terminated status. Separate Sense Data is preserved for each initiator. Sense Data is
cleared after it is retrieved by a Request Sense command.
• In general, the ACL retains the original Sense Data when an error occurs executing a
Request Sense command. However, when the error occurs parsing the command
descriptor block (CDB), the original Sense Data is lost and is replaced with Sense Data
corresponding to the parsing error
aclReqSense() is available to all users.
PARAMETERS
*device Pointer or string specifying the device special file associated with the
ACL.
*sp Pointer to a structure of type
sense_data_t.
Writer_Note: Need input for size parameter.
size (TBS)