User Guide

4-24 Preliminary Draft Ampex 1308904-X4
Model No.
Running Head
aclInit ACL Application Programmer’s Guide
4.11 aclInit
NAME
aclInit() - update element status in the ACL internal database.
SYNOPSIS
#include <acl.h>
int aclInit(char *device);
DESCRIPTION
aclInit() directs the ACL cartridge handling system to audit the contents of all elements
(locations) and update their status in the ACL internal database. Use of this utility is optional
since the ACL automatically performs an initialization routine whenever it detects any
condition that could cause element status to change.
aclInit() is available to all users.
PARAMETERS
*device Pointer or string specifying the device special file associated with the
ACL.
ENVIRONMENT
When the $RETRY_ON_RESET environment variable is set, all libacl functions
automatically perform one retry when a failure is caused by a SCSI Bus Device Reset of the
ACL.
RETURN VALUES
Exit status codes are:
0 DST_SUCCESS.
-1 DST_FAILURE.
SEE ALSO
libacl_api_intro(3), acl_init_chs(1)
DST/DIS Automated Cartridge Library Application Programming Interface (libacl)
Programmer’s Guide