User`s guide

COPY
an operation at the point you specify. For all operations, omitting the value
argument has the same effect as setting value equal to 0 (value is interpreted as
a decimal number). Since this option applies to the device and not to the files,
you can specify one /POSITION:value option for the output file and one for the
input file.
The /POSITION and /DEVICE options are mutually exclusive.
The following table lists the operation initiated by each value specified with the
/POSITION:value option in a magtape read (copy from tape) operation.
Magtape Read Operations Specified with the /POSITION:value Option
Value Operation
0 The tape rewinds and the handler searches for the file you specify. If
you specify more than one file, the tape rewinds before each search.
If the file specification contains a wildcard, the tape rewinds only
once and then the handler copies all the appropriate files.
A positive
integer
The handler looks for the file at file sequence number value. If
the file it finds there is the one you specify, the handler copies it.
Otherwise, it displays an error message. If you use a wildcard in
the file specification, the handler goes to the file sequence number
value and then begins to look for the appropriate files.
-1 The handler starts its search at the current position. Note that if
the current position is not the beginning of the tape, it is possible
that the file you specify will not be found, even though it does exist
on the tape.
The following table lists the operation initiated by each value specified with the
/POSITION:value option in a magtape write (copy to tape) operation.
Magtape Write Operations Specified with the /POSITION:value Option
Value Operation
0 The tape rewinds before the handler copies each file. A warning
message displays on the terminal if the handler finds another file
on the tape with the same name and file type, and the handler does
not copy the file.
A positive
integer
The handler goes to file-sequence number value or to the logical end-
of-tape, whichever comes first. Then it enters the file you specify.
If you specify more than one file, or if you use a wildcard in the
file specification, the tape does not rewind before the handler writes
each file, and the handler does not check for duplicate file names.
52 RT–11 Command Descriptions