User Guide

Ampex 1308904-X4 Preliminary Draft 4-27

ACL Application Programmer’s Guide aclMoveVolume

4.13 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.

2XX and 4XX ACLs can only move a tape cartridge to a storage bin or the tape drive. 8XX

ACLs 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(3) function before calling the

aclMoveCartridge() function.

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 six character ASCII string with no trailing null character.

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

cartridge.

Valid addresses for a 2XX or 4XX ACL are:

Tape drive 100 (0x64).

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