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

queue, but simply indicates whether a file is purged or retained after being
read, and if it is retained, whether the file remains eligible for immediate
reprocessing.
SPOOL
The files in your reader queue are controlled through a combination of file
characteristics and the options in effect for the virtual reader on which they are
processed. Input files do not derive their characteristics from the reader, except
for hold status, which is set as a function of the KEEP option. Table 19
summarizes the disposition of a reader file after it has been processed,
depending on the hold/keep settings specified for the reader, and the keep
setting of the file.
For output devices (virtual printers, punches, and consoles) use the SPOOL
command to define the characteristics of the spool files you are creating. You
can use the SPOOL command to indicate whether files are to be held from
further processing, and whether they are to be retained after they have been
processed. This information is associated with the spool file itself, regardless of
the characteristics of the device on which the file is to be processed. In
addition, use SPOOL to direct the output files that you are creating to unit
record devices (readers, printers, and punches) associated with other virtual
machines.
Table 19. Disposition of Reader Files Depending upon HOLD/KEEP Settings
File
Status
Device Options Disposition
NOKEEP NOHOLD/NOKEEP The file is purged.
NOKEEP NOHOLD/KEEP The file is retained in user hold status. KEEP is not set
on the file.
NOKEEP HOLD/NOKEEP The file is retained and remains eligible for processing
on your virtual reader.
NOKEEP HOLD/KEEP The file is retained in user hold status. KEEP is not set
on the file.
KEEP Any setting The file is retained in user hold status. KEEP status
remains on the file.
All of your output files derive their characteristics from the virtual device on
which they were created. If the output device is spooled with the KEEP and
NOHOLD options, the file is printed or punched, and then placed in HOLD
status, retaining its KEEP characteristics. If you change the file status to
NOHOLD, the file is processed at the real device one more time and once
again is placed in HOLD status. If you do not want to retain the file, you must
change both its NOHOLD status and NOKEEP characteristic, or purge it using
the PURGE command.
6. Unless you reset these values, the following options are the default values for
your spool files:
Device Default Options
Reader
NOHOLD NOKEEP NOCONT NORESCAN EOF CLASS A ¹
Punch
NOHOLD NOKEEP NOCONT CLASS A¹ OFF COPY 001 NOMSG
NONAME NOEOF DEST OFF
Printer
NOHOLD NOKEEP NOCONT CLASS A¹ OFF COPY 001 NOMSG
NONAME NOEOF DEST OFF
Console
NOHOLD NOKEEP NOCONT CLASS T¹ OFF COPY 001 TERM TO *
PRINTER NOMSG STOP NONAME NOEOF DEST OFF
Chapter 2. CP Commands 1459