User Guide

Ampex 1308904-X4 Preliminary Draft 5-23
ACL Application Programmer’s Guide acl_move_tape
5.8 acl_move_tape
NAME
acl_move_tape - move a tape cartridge from one ACL location to another.
SYNOPSIS
acl_move_tape -sourcelocation <location> -targetlocation <location>
[ -device device_special_file ] [ -retry_on_reset ]
acl_move_tape -help [ help_type ]
DESCRIPTION
acl_move_tape moves a tape cartridge from the specified source location to the specified
destination location. It fails if the source location is empty, the destination location is full, an
invalid source or destination is specified, 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 named locations (tape drive, storage bin, IMEX bin, or CHS).
When the source location is a 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, issue a dst_unload_tape(1) command before issuing the
acl_move_tape command
acl_move_tape is available to all users. See the acl_intro(1) manual page for ACL naming
conventions and general information on command-line options and arguments.
OPTIONS
-device device_special_file
Specifies the device special file to use for the operation.
-retry_on_reset
Specifies that the utility perform one retry automatically when a failure is caused by a SCSI
Bus Device Reset of the ACL.
ARGUMENTS
Writer_Note: Bug RWCra01725 states “How would a user know about '-help v_revision'??? It does
not seem to show up in the usage stuff.” Should we cover this in the man page?