User Guide

Ampex 1308911-02 6-49
DD-2 Utilities Manual Pages dd2_setpos_tape
6.16 dd2_setpos_tape
NAME
dd2_setpos_tape - positions the tape drive to the specified location.
SYNOPSIS
dd2_setpos_tape -position position_spec [ -f <device_special_file> ]
dd2_setpos_tape -help [ help_type ]
DESCRIPTION
dd2_setpos_tape positions the tape drive to the specified location. This is the data block
address at which the next read or write operation occurs, and is often referred to as the current
position. Initiating a write operation at any position other than end of data (EOD), invalidates
all data in the partition located beyond the current position.
There are two position forms: DD-2 and token. The DD-2 position form consists of a partition
ID (PTID), file section number (FSN), and a logical data block number (LDBN). Associated
with a DD-2 position are its parent volume ID and its absolute double frame number (ADFN).
The token position form contains all the position elements given above, packed into an array.
It is portable across UNIX host platforms.
dd2_setpos_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.
-position <
position_spec>
Specifies the location you want the tape drive to position to. You must provide a -position
<position_spec> argument for this utility (except when using the -help argument).