User Guide

6-54 Ampex 1308911-02
Model No.
Running Head
dd2_space_tape DD-2 Utilities Manual Pages
The -space <spacing_spec> argument comprises a two-element specification ordered as
follows: -space :spacetype:count:. Each element must be delineated by colons and included
in the specification. Valid parameters for the elements are described below.
spacetype String that specifies the type of spacing performed:
• FM Space by filemarks.
• BLK Space by blocks.
• EOD Space to the end of recorded data in the current partition (in
which case count is ignored).
count Integer that specifies the number of filemarks or blocks to space over.
Use a positive value to space forward or a negative value to space
backward. The largest positive value allowed is 8388607 (0x7fffff ).The
largest negative value allowed is -8388608 (0xffffff).
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. Space forward past 100 logical tape blocks. The position after completing the space will
be 100 blocks forward from the starting position (unless EOD is encountered).
dd2_space_tape -space :BLK:100:
2. Space backward past 20 files. The position will be on the Beginning of Tape (BOT) side
of the last filemark spaced over (or at Beginning of Partition if BOP is encountered).
dd2_space_tape -space :FM:-20:
3. You can leave the count element empty if you specify EOD in the spacetype element.