User Guide

Ampex 1308904-X4 Preliminary Draft 4-25

ACL Application Programmer’s Guide aclMoveCartridge

4.12 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 speciﬁed source location to the speciﬁed

destination location. This function fails if the source location is empty, the destination location

is full, an invalid source or destination location is speciﬁed, or a cabinet door is open.

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

from the tape drive to a storage bin. 8XX ACLs 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(3) function before calling the

aclMoveCartridge() function.

aclMoveCartridge() is available to all users. See libacl_api_intro(3) for information on ACL

address assignments.

PARAMETERS

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

ACL.

sea, dea Source and destination addresses.

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

Tape drive 100 (0x64).

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

Valid addresses for an 8XX ACL are:

Tape drive 100-103 (0x64-0x67).

Storage bin 1000-1247 (0x3E8-0x4DF).

IMEX bin 10-17 (0x0A-0x12).

Transport (CHS) 01.