NBSpool for MPE Reference Guide

NBSpool Output Commands
3-115
VSAVE
The
VSAVE
command processes and saves spool files for later viewing by the VISTA Plus online
report viewer. Compression and translation of the spool files occurs as the command executes. If
necessary, default parameters about the page format can be overridden with the
LPP
or
PRINTER
parameters. The
VSAVE
command operates only on spool files in the
READY
state that are not
empty. Pressing
Ctrl+y
will terminate this command.
The folder file is created by this command. If a file with the same name already exists, it will be
purged unless the
APPEND
or
LIMIT
parameters are specified. Folder files are created with a file code
of
878
to identify them from other files on the system. If the
PURGE
parameter was specified, all of
the spool files will be purged after being saved into the folder.
The default lines per page is assumed to be
60
lines. This value is used only if the original spool file
does not explicitly contain form feeds. The
VSAVE
command will automatically page break after the
proper number of lines per page if no form feeds are encountered.
If the
LIMIT
parameter is specified, the folder file will be built with enough directory space to
contain the requested number of files. If the limit is specified, the size of the folder (in sectors) must
also be specified. If this parameter is omitted, the folder will be built large enough to hold the
current spool file subset only. This parameter is ignored if the folder already exists.
The
APPEND
parameter will append the current spool file subset to an existing folder file. If the
folder does not exist, this parameter is ignored. A
LIMIT
parameter must be specified when the
folder is created for an
APPEND
to be used later in that folder file.
Two parameters affect the condition of the spool files. If the
NEWPRI
parameter is used, each spool
file will have its outpri changed to the specified value as each file is successfully saved. The
PURGE
parameter causes the saved spool files to be purged after all files are saved.
To save a spoolfiles form message,
VSAVE
works in conjunction with the following
VISTAINI
parameter:
$PRINT-USE-FORMID-FORMS
.