User Guide

Ampex 1308904-X4 Preliminary Draft 4-31
ACL Application Programmer’s Guide aclPosition
4.15 aclPosition
NAME
aclPosition() - position the designated storage bin in front of the tape drive (2XX, 4XX), or
position the cartridge handler in front of the designated element (8XX).
SYNOPSIS
#include <acl.h>
int aclPosition(char *device, int dest_addr);
DESCRIPTION
For a 2XX or 4XX ACL, aclPosition() moves the designated storage bin in front of the tape
drive. For an 8XX ACL, aclPosition() moves the cartridge handler to the designated element
(tape drive, storage bin or IMEX bin).
aclPosition() is available to all users.
PARAMETERS
*device Pointer or string specifying the device special file associated with the
ACL.
*dest_addr) Destination address (2XX, 4XX) - you can specify any of the storage
element addresses: 1000d – 1006d (3E8h – 3EEh).
Destination Address (8XX) - You can specify any of the following
element addresses:
Tape drive 100d – 103d (64h – 67h).
Storage bin 1000d – 1247d (3E8h – 4DFh).
IMEX bin 10d – 17d (0Ah – 11h).
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.