User Guide

Ampex 1308910-01 4-23

libacl API Functions aclMoveVolume

4.11 aclMoveVolume

NAME

aclMoveVolume() - move the speciﬁed tape cartridge to another ACL location.

SYNOPSIS

#include <acl.h>

int aclMoveVolume(char *device, char *barcode, unsigned int dea);

DESCRIPTION

aclMoveVolume() moves the speciﬁed tape cartridge to another ACL location. This function

fails if the barcode ID is not found, the target location is full, an invalid target location is

speciﬁed, or a cabinet door is open.

The DST 412 ACL can only move a tape cartridge to a storage bin or the tape drive. The

DST 712 and DST 812 ACL can move a tape cartridge to 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).

aclMoveVolume() is available to all users.

PARAMETERS

*device Pointer or string specifying the device special ﬁle associated with the

ACL.

*barcode The barcode ID of the tape cartridge that you want to move. This value

must be a null terminated ASCII string containing one to six decimal

digits. Longer strings will be truncated.

dea The address of the element to which you want to move the tape

cartridge.

Valid addresses for a DST 412 ACL are:

Tape drive 100 (0x64).

Storage bin 1000-1006 (0x3E8-0x3EE).