NetBase for MPE Reference Guide

Chapter 13
13-20
Running NBCOPY
To start NBCOPY, run the program, NBCOPY.PUB.NETBASE. You will see the standard utility prompt,
the greater than sign (>). One or more copy commands can be entered. Each command will be
processed in turn unless NBCOPY is run from a job and an error is detected. In this case, all other
commands are flushed.
At the prompt, you must enter either a copy command, HELP, REDO, QUIT or EXIT. The HELP
command displays a quick reference chart for command syntax. The REDO command repeats the
last command entered, allowing you to edit it with standard line-editor commands before executing
it.
If NBCOPY is run programmatically, it will suspend rather than terminate when EXIT is entered.
This allows an application program to quickly activate it when it is needed again. To cause it to
terminate, use the QUIT command. Commands may be continued on subsequent lines if the &
character is specified at the end of a command line.
Like FCOPY, NBCOPY can use the INFO= parameter of the run command. Therefore, you can create a
UDC for copies, such as:
NBCOPY FROMF,TOF
RUN NBCOPY.PUB.NETBASE;INFO="FROM=!FROMF; TO=!TOF; STATS"
******************
EXPAND FILE,LIMIT
RUN NBCOPY.PUB.NETBASE;INFO="FROM=!FILE; LIMIT=!LIMIT; STATS"
******************
DUMPSET BASE,SET,MODE=5,FILE
RUN NBCOPY.PUB.NETBASE;&
INFO="FROM=!BASE,,!MODE; FROMSET=!SET; TO=!FILE; STATS"
******************
If the INFO= parameter is supplied, command input will be suppressed, so only one command can be
executed. If an error occurs, the JCW will be set to FATAL plus the number of the error that
occurred.
Note. If NetBase is not installed, or if its processes are not running, the following
message appears when you try to run NBCOPY:
ERROR 126: This program must be run through NetBase.
To correct it, verify that NetBase is installed and running. If you are copying from one
machine to another, and NetBase is not running on both machines, you may receive the
following message:
ERROR: REQUESTED NODE IS DOWN.
To correct it, start NetBase on the machine for which you specified a node name or
number.