FUP Commands
File Utility Program (FUP) Reference Manual—523323-014
2-44
COPY: Copy Form
SKIPIN num-eofs
moves the tape past num-eofs end-of-file (EOF) marks before the data
transfer begins (for magnetic tape only). You cannot specify this option if
in-filename is a tape DEFINE with LABELS set for labeled tape processing.
You must use the appropriate tape DEFINE attribute to skip files on a labeled
tape.
If you include the SKIPIN option (and in-filename is a tape DEFINE), FUP
displays this error message:
ERROR - SKIPIN PARAMETER NOT ALLOWED FOR
LABELED TAPES
Specify num-eofs as an integer in the range -255 through 255.
ï‚·
If you specify a positive value, the tape is forwarded past num-eofs EOF
marks and positioned immediately after the last EOF mark passed.
ï‚·
If you specify a negative value, the tape is rewound over num-eofs EOF
marks (-1 multiplied by num-eofs) and then moved forward and
positioned immediately ahead of the last EOF mark passed.
ï‚·
If you specify a value of zero, the SKIPIN option is ignored.
ï‚·
If you omit the SKIPIN option, the tape remains at its current position, and
the data transfer begins with the next physical record on tape.
TRIM [ trim-character ]
deletes any trailing characters matching trim-character. Specify
trim-character as either a single ASCII character in quotation marks:
"c"
Or specify it as an integer in the range 0 through 255 that specifies a byte
value:
{ 0:255 }
[ NO ] UNLOADIN
specifies whether the tape is unloaded after it is rewound (for magnetic tape
only). The default is UNLOADIN. (The tape is unloaded after it is rewound.)
This option also applies to labeled tapes.
VARIN
reads variable-length, blocked records. These records can be produced using
the COPY command option VAROUT on page 2-49.
Note. For more information, see the Guardian User’s Guide .
Note. The trim-character default is an ASCII null character (binary 0).