User Guide

Ampex 1308904-X4 Preliminary Draft 4-15
ACL Application Programmer’s Guide aclGetElemData
4.6 aclGetElemData
NAME
aclGetElemData() - get element count and SCSI addresses.
SYNOPSIS
#include <acl.h>
int aclGetElemData(char *device, aclElemData_t *elemdata);
DESCRIPTION
aclGetElemData() retrieves element data such as SCSI address assignments and element
counts. This information is used to determine the inputs to the aclMoveCartridge() and
aclMoveVolume() functions. See libacl_api_intro(3) for information on ACL address
assignments.
aclGetElemData() is available to all users.
PARAMETERS
*device Pointer or string specifying the device special file associated with the ACL.
*elemdata Pointer to a structure of type
aclElemData_t.
USAGE
aclGetElemData() reports element data in the *elemdata structure.
Writer_Note: “Transfer element “ should be “data transfer element”.
typedef struct
{
unsigned int XportCount; /* transport element count */
unsigned int XportStart; /* transport element start address */
unsigned int StorCount; /* storage element count */
unsigned int StorStart; /* storage element starting address */
unsigned int ImexCount; /* import/export element count */
unsigned int ImexStart; /* import/export element starting address */
unsigned int XferCount; /* transfer element count */
unsigned int XferStart; /* transfer element starting address */
}aclElemData_t;