NetBase for MPE Reference Guide

NetBase Utilities
13-19
Parameter Description
LIMIT=
Specifies the file limit of the TO file. This assumes the TO file is a new
file. If the TO file is not specified, the FROM file is copied to a temporary
file of the same name, purged, and the temporary file is saved as the
new FROM file. The net effect is to change the limit of the FROM file. For
example, to change the limit of the file NAMES.DATA to 5000, you would
enter:
>FROM=NAMES.DATA;LIMIT=5000
If the limit you specify is less than the current EOF, the copy will stop
when the file fills up, and some records will be lost. However, the
original file will be left untouched since it only is purged after a
successful copy. The temporary file will contain the partially completed
copy.
NEW
Specifies that the TO file cannot already exist. If the TO file exists, the
copy will not proceed. This protects existing TO files from being
obliterated.
NOLABELS
Prevents user labels from being copied to the TO file.
OLD
Specifies that the TO file must exist. This prevents NBCOPY from
creating a new TO file.
REBLOCK
If the FROM file and TO file do not have the same record size, the copy
will not occur unless the REBLOCK option is specified. This is discussed
in the limitations section.
RELEASE
When the current copy operation completes, the TO file limit is set to the
current EOF.
SKIPEOF=
This has the same format as the FCOPY parameter of the same name. It
is useful for skipping past files on a tape. The full syntax is:
SKIPEOF=[from-eofs][,to-eofs]
If this parameter is specified for a non-tape file, it is ignored.
START=
Specifies the first record to be copied from the FROM file. The first
record of a file is considered to be record 0.
STATS
Displays a block of status information after the copy is complete. This
includes the number of I/Os, records transferred, and records transferred
per second.
When you specify any of the above parameters, a copy operation will begin. If you have set up file
equations for both QCINPUT and QCOUTPUT, you can just specify >STATS to begin a copy. As the
copy is performed, you may hit Ctrl-Y to see how far along the copy is.