User Guide

Ampex 1308910-01 4-15
libacl API Functions aclGetStatus
4.7 aclGetStatus
NAME
aclGetStatus() - get current ACL status information and sense data.
SYNOPSIS
#include <acl.h>
int aclGetStatus( char *device, aclStatus_t *acl_status_ptr, int *acl_errocode_ptr );
DESCRIPTION
aclGetStatus() is normally called to determine why the previous function failed, but you can
also call it at any time to get current ACL operational status. In order to get valid information
on why the previous function failed, aclGetStatus() must be called before issuing any other
libacl function calls and before exiting the application.
aclGetStatus() is available to all users.
PARAMETERS
*device Pointer or string specifying the device special file associated with the
ACL.
*acl_status_ptr Pointer to a structure of type
aclStatus_t which reports current
status information and sense data.
*acl_errocode_ptr Pointer to an integer containing the device error code (
Ecode); 2
indicates an invalid device and 3 indicates a function execution error.
USAGE
aclGetStatus() reports status and sense data in the *acl_status_ptr structure, and a device
error code in the *acl_errocode_ptr integer.
typedef struct
{
unsigned int valid;
unsigned int skey;
unsigned int scode ;
door_enum door;
unsigned int posn;
acl_cond_enum cond;
unsigned int robot_fail;
unsigned int robot_err;