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

SPOOL
Usage Notes
1458 z/VM: CP Commands and Utilities Reference
Full-screen data output operations are not placed in the spool file. After the
console is closed, the file becomes a printer spool file. START applies only to
consoles.
STOp
terminates the spooling of display station input and output. STOP does not
close the console spool file. STOP applies only to consoles.
TErm
displays the display station input and output on your display screen and places
it in a spool file. The TERM operand has no effect unless the START function is
also in effect. TERM applies only to consoles.
NOTerm
suppresses the display of input and output on your display screen while placing
it in a spool file. The display of console input and output is not suppressed if:
v It is the result of CP commands entered from CP mode
v The output line immediately precedes a virtual machine read to the console.
The NOTERM operand has no effect unless the START function is in effect.
NOTERM applies only to consoles.
Full screen mode applications such as XEDIT and full screen CMS are not
supported when the console is spooled NOTERM.
ASYNChronous
indicates you want to process other commands while the SPOOL command
completes.
SYNChronous
prevents you from executing other commands until the SPOOL command
completes.
1. When specifying [TO] userid, if you omit the keyword TO, userid cannot be T
or TO. If you are transferring your output to your own virtual machine, you may
specify userid as an asterisk (*). If you specify TO userid, you cannot specify
either the OFF or FOR operand.
2. Full screen functions may hang a user whose console is spooled NOTERM.
For example, if a user is in XEDIT and tries to QUIT, the keyboard remains
locked.
3. SET IMSG OFF suppresses informational messages for this command.
4. A spool file is created when the first record for a printer or punch is processed
by the virtual unit record simulation routines in CP. CP associates this spool file
with the virtual unit record device and assigns it a number called the spoolid
(spool file identification). You can use spoolid to identify the file that you have
produced, and to manipulate the file using the z/VM CP spooling commands,
such as ORDER, CHANGE, and PURGE.
When you print or punch a file, CP displays its spoolid. You can use the
spoolid to find out various kinds of information about the file using the QUERY
command.
5. It is important to remember that the SPOOL command controls both
operational characteristics of your virtual spooling devices and the disposition
of files after they have been processed.
For example, you use the SPOOL command to select the files you want to
process on your virtual readers. The SPOOL READER command does not
change any of the characteristics associated with the files in your reader