All subsequent printed output directed to ycur printer at virtual
address OOE (all output) is processed as class Y. If you place a HOLD on your printer or punch, any files that you
print or punch are not released to the control spooling queue
until you specifically alter the hold status. By placing your output
spool files in a hold status, you can select which files you print or
punch, and you can purge duplicate or unwanted files. To place printer
and punch output files in a hold status issue the commands:
cp spool printer hold
cp spool punch hold When you issue a SPOOL command for a unit
refer to it by its virtual address, as well as
type (for example, CP SPOOL E HOLD). record device, you can by its generic device When you have placed a hold status on printer or punch files and you
produce an output file for one of these devices, CP sends you a message to remind you that you have placed the file in a hold: PRT FILE xxx x FOR userid COpy xx HOLD If, however, you have issued the command:
cp set msg off
then you do not receive the message. When you place a reader file in a hold status, then the file remains
in the card reader until you remove the hold status and read it, or you
purge it. COpy: If you want multiple copies of a spool file, you should use the COpy operand of the SPOOL command:
cp spool printer copy 10 If you enter this command, then all subsequent printer files that you
produce are each printed 10 times, until you change the COPY attribute
of your printer. FOR: You can spool printed or punched output under another userid's name by-using the FOR operand of the SPOOL command. For example, if you
enter:
cp spool printer for charlie
Then, all subsequent printer files that you produce have, on the output
separator page, the userid CHARLIE and the distribution code for that
user. The spool file is then under the control of that user, and you
cannot alter it further. You can print or punch many spool files, but have them print or punch as one continuous spool file if you use the CONT operand
on the SPOOL command. For example, if you issue the following sequence
of commands:
cp spool punch cant to brown
punch asml assemble
punch asm2 assemble
punch asm3 assemble
cp spool punch nocont
cp close punch
114 IBM VM/370 eMS User's Guide

Then, the three files ASK1 ASSEMBLE, ASM2 ASSEMELE, and ASM3 ASSEKBLE, are punched to user BROWN as a single spool file. When user BROWN reads
this file onto a disk, however, CMS creates separate disk files. %Q: When you spool your printer or punch to another userid, all output from that device is transferred to the virtual card reader of the userid
you specify. When you are punching a eMS disk file, as in the example
above, you should use the TO operand of the SPOOL command to specify the
destination of the punch file. You can also use this operand to place outFut in your own virtual
card reader by using the * operand:
cp spool printer to *
After you enter this command, subsequent printed output is placed in
your virtual card reader. You might use this technique as an alternative way of preventing a printer file from printing, or, if you choose to
read the file onto disk from your reader, of creating a disk file from printer output.
Similarly, if you are creating punched output in a program and you
want to examine the output during testing, you could enter:
cp spool punch to *
so that you do not punch any real cards or transfer a virtual punch file
to another user.
ALTERING SPOOL FILES After you have requested that VM/370 print or punch a file, or after you
have received a file in your virtual card reader and before the file is
actually printed, punched, or read, you can alter some of its
characteristics, change its destination, or delete it altogether. Every spool file in the VM/370 system has a unique four-digit number
from 0 to 9900 assigned to it, called a spoolid. You can use the spoolid
of a file to identify it when you want to do scmething to it. You can
also change a group of files, by specifying that all files of a
particular class be altered in some way, or you can manipulate all of
your spool files for a certain device at the same time.
The CP commands that allow you to manipulate spool files are CHANGE, ORDER, PURGE, and TRANSFER. In addition, you can use the CP QUERY command to list the status and characteristics of spool files associated
with your userid. When you use any of these commands to reference spool files of a
particular device, you have the choice of referring to the files by class or by spoolid. You can also specify ALL. For example, if you
enter the command:
cp query printer all
you might see the display: ORIGINID FILE CLASS RECDS CPY HOLD DATE TIME NAME SCARLET 0211 D PRT 000140 01 USER 07/09 10:25:23 TARA SCARLET 0245 A PRT 000026 01 NONE 07/09 10:25:41 CMSLIB TYPE DIST FILE BIN015 MACLIB BIN015 Section 7. Using Real Printers, Punches, Readers, and Tapes 115