NetBase for MPE Reference Guide

NetBase Utilities
13-17
Parameter Description
TO=
Specifies the file to which to copy (output file). If omitted, this
parameter defaults to *QCOUTPUT. If specified without a file name,
$STDLIST is assumed.
If the specified file exists, it is erased unless a file equation is issued
specifying ACC=OUTKEEP. Data sets are never erased.
If the TO file does not exist, it will be built as a copy of the FROM file,
with the same limit, extents and user labels. If the FROM file is a KSAM
file, the new TO file will not be a KSAM file unless the KEYFILE=
parameter is also specified (see below).
TO= (continued)
When the TO file is a data set, you must specify the database with the
TO= parameter. The format is the same as the FROM= database
specification:
TO=basename[,password],mode
The mode must be 1, 3 or 4. If you specify mode 1, the TOSET will be
locked while all entries in an input block are being put into the set. If
the input blocking factor is large, the data set could be locked for quite a
long time while the puts are processed.
Mode 3 is by far the fastest mode to use, but it does have a potential
problem. Using the exclusive write mode causes NBCOPY to turn off
posting for the data set with the DBCONTROL procedure. If the system
should fail while the entries are being put, the database will be flagged
as bad. You must weigh the benefits of really high speed against the
odds of the system crashing when deciding the mode.
If you are copying to another machine, NetBase must be running on
both machines. The node may be specified either by name or number.
The syntax for specifying a node is:
TO=database[:node][,password],mode
When specifying a node, the database (or file) is sent to the same group
and account on the receiving machine if none are specified. To specify a
different location, use this syntax:
FROM=filename.group.acct;TO=filename.diffgroup.diffacct:node
TOSET=
Specifies the data set into which records will be added (with DBPUT). A
TO database must be specified with the TO= parameter, prior to this
parameter.
Continued