User Guide

Ampex 1308911-02 6-59
DD-2 Utilities Manual Pages dd2_unload_tape
6.19 dd2_unload_tape
NAME
dd2_unload_tape - unload the tape cartridge from the tape drive.
SYNOPSIS
dd2_unload_tape [ -f <device_special_file> ]
dd2_unload_tape -help [ help_type ]
DESCRIPTION
dd2_unload_tape unloads and ejects the tape cartridge from the drive after parking it at the
system zone nearest to the Beginning of Tape (BOT) side of the current position. System zone
locations depend on the tape format and might not correspond to the start of a partition. This
means that the only way to ensure that a tape unloads at BOT is to position it there before
calling dd2_unload_tape. For information on absolute and relative positioning, see
dd2_setpos_tape, and dd2_space_tape.
dd2_unload_tape invalidates any state information associated with the tape. For example, the
current position, tape format, and similar status are undefined after executing dst_unload().
dd2_unload_tape is available to all users.
OPTIONS
-f < device_special_file >
Specifies the device special file to use for the operation (see Appendix B).
ARGUMENTS
-help [ help_type ]
Displays help on stderr and invalidates all other options, cancelling any other actions. Valid
keywords for the optional help_type specification are: stdout, revision, and v_revision.
ENVIRONMENT
The $TAPE environment variable specifies the tape device to use if the
-f <device_special_file> option is omitted.