z/VM: CP Commands and Utilities Reference - z/VM - IBM

SPOOL
Authorization
Purpose
Operands
Options
Privilege Class: G
1452 z/VM: CP Commands and Utilities Reference
Use SPOOL to set control options for one or more of your virtual spool devices. The
options you select modify operational functions associated with your virtual reader,
printer, punch, or console. These options also control the disposition of files after
they have been processed.
Reader
RDR
Printer
PRT
PUnch
PCH
CONsole
vdev
modifies the options for all of your virtual readers, printers, punches, or console
spooling devices, including the starting or stopping of spooling operations.
Alternatively, you can enter the virtual device number vdev of the virtual
spooling device whose options you want to modify.
HOld
NOHold
indicates whether you want to HOLD files.
If you specify HOLD for an output device, all the files created by the device are
placed in user hold status. When a spool file is in user hold status, it is not
processed at its destination device (the real printer, punch, or virtual reader)
until you remove the hold status by issuing the CHANGE command with the
NOHOLD option.
If you specify HOLD for an input device, files are retained after they have been
read. Unless you specify the KEEP operand for the file or for the device, the file
remains in the reader queue and is the next file eligible for processing. This is
in contrast to the hold status on a spool file, which makes the file ineligible for
processing.
A reader may not be spooled with the string CONT/RESCAN/HOLD/NOKEEP,
as this would cause the same file to be processed repeatedly. If a SPOOL
command is issued which would result in the reader being spooled with this
combination, the reader will be spooled KEEP to remove the conflict.
Specify NOHOLD to allow files to be purged after processing.
KEep
NOKeep
indicates whether you want to retain a spool file after it has been processed.
Specify KEEP if you want to retain files after they have been processed.