User Guide

Ampex 1308904-X4 Preliminary Draft 4-29
ACL Application Programmer’s Guide aclPark
4.14 aclPark
NAME
aclPark() - park the ACL cartridge handling system (2XX, 4XX).
SYNOPSIS
#include <acl.h>
int aclPark(char *device);
DESCRIPTION
aclPark() parks the ACL cartridge handling system (CHS) so that the front door of the ACL
can be opened to insert or remove tape cartridges. Opening the front door locks the CHS in
the parked position.
Unparking of the CHS occurs when the front door is closed after being opened (or the ACL is
commanded to reposition the CHS before the front door is opened). Closing the front door also
causes the ACL to perform an initialization routine that updates element status in the internal
database.
aclPark() 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.