NBSpool for MPE Reference Guide

Chapter 3
3-20
COPY
The
COPY
command copies one or more spool files to a remote node. When the command is first
executed, NBSpool will contact the remote computer and establish a connection. Any subsequent
access to that node will not require an additional connection. This command may be stopped at any
time by pressing
Ctrl+y
. If a copy is in process, the unfinished remote copy will be purged.
Note. Unlike the
MOVE
command, the
COPY
command does not purge the original
spool file. The
COPY
command only operates on spool files in the
READY
state.
If NBSpool is running in a NetBase environment, a remote session to the node receiving the spool
file is not required since NetBase will automatically handle the transfer. The node name or node
number used in the command should be consistent with the node names or numbers used in the
NetBase configuration.
If NetBase is not installed, the RPM service of
NS
will be used to create the process
NBSPOOLT
on
the remote computer. A
DSLINE
command is required to specify the destination node. Programmatic
logons are supported if the
LOGON=
parameter is specified in the
DSLINE
command, and a remote
session does not exist in the environment.
Spool files will be left unchanged unless the
NEWPRI
parameter is specified, which causes
successfully copied spool files to be altered in priority. New spool files will have the job/session
number changed to include an apostrophe, for example
#S’10
.
If the
NEWTIME
parameter is specified, the remote spool files will have a creation date/time of the
current time. This allows the user to order the spool files for printing on systems with the native
mode spooler, since the
NMS
prints in creation sequence within a priority.
If a spool file is to be transferred to an HP-UX computer, either the
DEST
or
HPUX
parameter must
be specified. The
OUTPRI
and
COPIES
parameters are translated to the UNIX equivalents. Other
parameters affecting the destination spool file are not applicable. This feature requires the HP-UX
option to be purchased.
Forms handling on NetWare are controlled by the
FORM NUMBER
. The
FORM
parameter allows
either the form name or number to be specified for a subset of spool files. If a form name is
specified, NBSpool will look for a
CI
variable or JCW with the same name as the form name. If it
exists, the value will be used as the form number.
If NBSpool encounters a Workstation Configurator TermType file, it will open the termtype file,
look for a TVFC file associated with the file, open the VFC file, and extract the initialization string.
If any of these steps fail, an error will occur and the command will continue to execute. The
NOENV
keyword disables this feature.