VISTA Plus for MPE Administrator's Guide

NBSpool Commands
3-9
VSAVE Command
The VSAVE command stores a subset of spool files to a folder, creating the folder if necessary. A
folder is a term used to describe a file that contains reports. As spool files are copied to the folder,
they are compressed. This reduces the disk space required by up to fifty percent (50%). Spool files
within a folder can be viewed with the VISTA Online Report Viewer program.
The VSAVE command also enables you to create a folder. As a result, if a folder with the same
name already exists it will be purged after confirmation from the user. Folders are created with a
file code of 878 to identify them from other files.
If the VSAVE command’s LIMIT parameter is specified, the folder will be built with enough
directory space to contain the requested number of files and will allow you to avoid expanding the
folder immediately. 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 only the current spool file subset. This
parameter is ignored if the folder already exists.
The VSAVE command’s APPEND parameter adds the current spool file subset to an existing
folder. If the folder does not exist, this parameter is ignored and a folder is created. A LIMIT
parameter sufficient to contain the current subset, plus all subsequent additions, must be specified
when the folder is created for an APPEND to be used later on that folder. If a folder is too small to
hold new spool files, it can be expanded by copying it to a larger file with the same file code and
record size. To increase the size of the directory, or to increase the number of sectors reserved for
the folder, type:
VISTACLN.PUB.NETBASE,MENU
Select the option to expand the folder. Two options affect the condition of the spool files. If the
VSAVE command’s NEWPRI parameter is used, each spool file will have its print output priority
changed to the specified value. This occurs as each file is successfully placed in a folder file. The
VSAVE command’s PURGE parameter causes the spool files to be purged after all files are
successfully added to a folder.
Using the PRINTDEF program, you can create a printer definition which can be associated with a
spool file subset. If you’ve specified a 45-line page, VISTA will display the file in 45-line pages.
Press Ctrl+y to terminate the command immediately. If the VSAVE command’s PURGE
parameter was specified, none of the spool files will be purged.