User Guide

Ampex 1308911-02 6-21
DD-2 Utilities Manual Pages dd2_getpos_tape
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.
-stdout <
output_spec>
Specifies the output fields written to stdout. You must provide a -stdout <output_spec>
argument except when using the -help argument.
The -stdout <output_spec> argument supports the following keywords:
%volid The volume ID in the VFI area on the tape. This is an arbitrary
6-byte value. The %volid field name displays the volume ID as an
ASCII string on output. This field causes all bytes to be displayed,
even control characters and other "unprintable" characters. If the
volume ID contains unprintable characters, you might want to use
the %hexvolid field name instead.
%hexvolid The volume ID in the VFI area on the tape. This is an arbitrary
6-byte value. The %hexvolid field name displays the volume ID as
a 12-digit hex value on output.
%adfn Absolute Double Frame Number - The number of the physical
block that contains the current location.
%ptid Partition Identification Number - The number of the partition that
contains the current location. Partitions are numbered sequentially
on the tape, starting at zero.
%fsn File Section Number - The number of the file section that contains
the current location. Files are numbered sequentially within a
partition starting at one.
%ldbn Logical Data Block Number - The block number of the current
location. Data blocks are numbered sequentially within a file
section starting at zero.
%token A 40-byte self-contained token expressed as a hexadecimal value.
The token position form is portable across platforms and Ampex
DD-2 tape drives.
%remcap Estimated remaining capacity (in physical blocks) in the partition
past the current tape position.
%dis Current time code location on a DIS formatted cartridge. Displayed
as a decimal integer representing milliseconds.