User Guide

Ampex 1308910-01 4-21
libacl API Functions aclMoveCartridge
4.10 aclMoveCartridge
NAME
aclMoveCartridge() - move a tape cartridge from one ACL location to another.
SYNOPSIS
#include <acl.h>
int aclMoveCartridge(char *device, unsigned int sea, unsigned int dea);
DESCRIPTION
aclMoveCartridge() moves a tape cartridge from the specified source location to the specified
destination location. This function fails if the source location is empty, the destination location
is full, an invalid source or destination location is specified, or a cabinet door is open.
The DST 412 ACL can only move a tape cartridge from a storage bin to the tape drive, or from
the tape drive to a storage bin. The DST 712 and 812 ACL can move a tape cartridge to or from
any of the addressable elements (tape drive, storage bin, IMEX bin, or CHS).
When the source location is a tape drive, the tape cartridge to be moved must already be
located in the drive load port; that is, the drive must have already ejected the cartridge. To force
the drive to eject the tape cartridge, invoke the dst_unload() function before calling the
aclMoveCartridge() function (see the DST/DIS Tape Drive UNIX Programmer’s Guide).
aclMoveCartridge() is available to all users. See the libacl Overview manual page for
information on ACL address assignments.
PARAMETERS
*device Pointer or string specifying the device special file associated with the
ACL.
sea, dea Source and destination addresses.
Valid addresses for a DST 412 ACL are:
Tape drive 100 (0x64).
Storage bin 1000-1006 (0x3E8-0x3EE).
Valid addresses for DST 712 ACL are:
Tape drive 2000 - 2001
Storage bin 5000 - 5114 (maximum number of bins)
IMkEX bin 10 -11
Transport 1