FCOPY Reference Manual (32212-90008)

94 Chapter5
FCOPY Functions
SKIPEOF
SKIPEOF
Instructs FCOPY to skip end-of-file (EOF) markers on a serial storage device in order to
position the device at the desired file before copying.
Syntax
;SKIPEOF=[{+
-}
from-eofs
from-file-number
][,{ {+
-}
to-eofs
to-file-number
}]
Where:
+/− Specifies forward (+) or reverse (−) movement.
from-eofs Is a positive integer specifying how many files to skip on the "from" device.
from-file-number Is an integer specifying an absolute file number on the "from" device.
Absolute file numbers begin with 1.
to-eofs Is a positive integer specifying how many files to skip on the "to" device.
to-file-number Is an integer specifying an absolute file number on the "to" device.
File Attributes
The files that use the SKIPEOF function (either the fromfile or the tofile, or both) must
reside on unlabeled magnetic tapes, serial disks, or cartridge tapes. The fromfile must have
read access, and the tofile must have write access.
Operation
SKIPEOF lets you specify particular files on unlabeled magnetic tapes, cartridge tapes, and
serial disks.
Absolute File Numbers
In the syntax description of the SKIPEOF function,
from-file-number and
to-file-number represent absolute file numbers. Absolute file numbers refer to specific
files on a tape or serial disk. Tape and serial disk files are sequentially numbered,
beginning with 1. You can use file numbers to identify the files you want to copy. For
example, to copy from the fourth file on a tape, specify 4 as the
from-file-number ,
SKIPEOF=4.
When you specify a
from-file-number or a to-file-number , such as SKIPEOF=,2, the
SKIPEOF function positions the tape at the beginning of the specified file. The tape's
position before you issue the command does not affect the file copied. Figure 5-6 illustrates
this process.