NOHOLD EOF NOEOF SPOOL If the HOLD option is specified for a virtual printer or punch
that is transferred to a user for input (TO userid), that virtual device places a user hold status on the reader file.
The user receiving the file cannot read its status until it is
changed bv issuing the CHANGE command with the NJHOLD operand.
The spool file class of the virtual output device must match
the class of the receiver's virtual reader (or the virtual reader must have a class of *) in order for the spool file to
be processed. If these conditions are not satisfied, the reader appears empty to the virtual machine attempting to read
a file, even though reader files do exist.
If a virtual reader is operating with CaNT and HOLD, then
virtual reader files are saved and placed in a user HOLD status. The file cannot be read until it is changed (using
the CHANGE command) to a NOHOLD status.
resets the HOLD operand. Future files are not held. NOHOLD resets the HOLD operand in effect for the specified reader.
This operand can be overridden for an active file being closed by th9 CLOSE command usinq the HOLD or NOHOLD operand. If NOHOLD is specified, HOLD may not be specified.
sets a virtual end-of-file condition on the specified reader,
thereby ensuring that a unit exception condition is reflected
on the read that follows the reading of the last card in a
file. If EOF is specified, NOEOF may not be specified. that the reading continues to physical end-of-file.
The virtual reader stoP$ when no cards are lett in the reader
and when a unit check/intervention required status is pending.
If NOEOF is specified, EOF may not be specified. {
USerid}
SY;TEM transfers the output of the virtual device to the virtual card reader of the specified userid. If TO is omitted, the userid
may not be "TO" or "T". TO * may be coded if the output is to
be transferred to your own virtual card reader. If TO userid is specified, neither OFF nor FOR may be specified on the same
command line.
If you specify COpy with TO userid, the number of copies has no effect on the receiver of the spool file; he
receives only one copy_ However, if OFF or FOR is specified on
a subseauent command, the receiver of your spool file receives
the number of copies you specify via COpy. For example, if the
followinq command is entered: pun to usera copy 3 class b
the operand has no effect on the file goinq to USER!. However, if the command:
spool Dun off
-- or --
spool pun for usera Section 5. Format of CP 143
SPOOL is entered, the copy 3 specified in the first statement
affects subsequent punch files. TO SYSTEM is equivalent to specifying OFF and resets the
transferred spool option. FOR {
USerid}
SY;TEM OFF indicates the userid under which printed or punched output is
produced. The userid becomes the owner of the output spool
file and the distcode on the file is the distcode for the user
that is specified in the VM/370 directory. The file is not transferred to the user's reader input. The default setting is
for vour own virtual machine identification. FOR *, or FOR can be coded to specify your own identification and is
equivalent to the OFF option.
resets the transferred spool option. COPY[*lnn is the number of copies from 1 to 99 of each output file to be produced. When the optional asterisk (*) appears, the 3800 performs the duplication internallv, provided the spool file
contains sufficient information to be spooled to the 3800 printer. If there is insufficient information, the asterisk
is iqnored and printing occurs normally on the printer
assigned in the spool file class. CLOSE closes the specified device regardless of the CaNT setting the device. If CLOSE is specified, PURGE may not be specified. CLOSE does not affect the setting of any other operand and is proviied as a convenience to close a virtual output device. As example, this sequence of commands: SPOOL PRT CONT (print file)
(print file)
(print file) SPOOL NOCONT CLOSE PRT SPOOL PRT CONT (print file)
(print file)
can be replaced with the following sequence to achieve the
desired result: SPOOL PRT CO NT
(print file)
(print file)
(print file) SPOOL PRT CLOSE (print file)
(print file)
144 IBM VM/370 CP Command Reference for General Users
Previous Page Next Page