User Guide

Ampex 1308911-02 6-51
DD-2 Utilities Manual Pages dd2_setpos_tape
If this element is left empty, the utility fails unless you specify the
partition ID, in which case tape positions to FSN 1 of the specified
partition. Setting the FSN element to -1 sets the position to the end of
data (EOD) of the target partition.
ldbn Logical Data Block Number (LDBN), numbered starting at zero for the
first data block in the file section.
If this element is left empty, the command fails unless you specify the
file section number or partition ID, in which case tape positions to
LDBN O of the specified FSN or FSN 1 of the specified partition.
Setting the LDBN to -1 sets the position to the EOF of the target file
section.
To specify a DD-2 token, provide a two-element -position <position_spec> argument ordered
as follows: -position :postype:token:. Valid parameters for the elements are listed below.
Use only a token specification that you have retrieved by getting a position; see
dd2_getpos_drive. Do not attempt to build a token yourself.
postype Must contain the literal string Token, signifying that the position is
in the token form.
token A 40-byte self-contained token expressed as a hexadecimal value.
ENVIRONMENT
The $TAPE environment variable specifies the tape device to use if the
-f <device_special_file> option is omitted.
EXIT STATUS
The dd2 utilities use the following exit status codes, and may also produce output to -stdout
on success:
0 Operation succeeded.
nonzero Operation failed.
A nonzero return value describes the error encountered error during processing (see “Exit
Status” on page 6-5).
EXAMPLES
1. Assume the current position is ADFN 1234, partition 0, file section number 25, and logical
data block number 234. To change position to data block 278 with all other elements of
the position remaining the same, you can leave all elements empty except postype and
ldbn: