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

CLOSE
HOld
NOHold
controls the user hold status.
62 z/VM: CP Commands and Utilities Reference
For output devices, HOLD prevents files from being punched or printed on a
real device by putting a user hold status on the file. If you specify NOHOLD,
you override the spool device HOLD option and prevent the file from being
placed in hold status.
For input devices, the HOLD/NOHOLD options override the setting for the
virtual device or the spool file. The file is not put in hold status unless the KEEP
option is also specified. If you specify HOLD, the file is not purged after
processing and remains eligible for the device. If you specify NOHOLD, the file
is purged unless you also specify the KEEP option.
KEep
NOKeep
controls the keep status, which indicates whether the current spool file is to be
placed in user HOLD after processing.
For output files, the keep status is placed on the spool file. After it is printed or
punched, the file is assigned user hold status and is not purged. The file’s
KEEP status is retained. Specify NOKEEP to override the current keep setting
for the device so that keep is not set on the spool file.
For input files, KEEP overrides the keep setting on either the virtual reader or
the spool file. After processing, the file is placed in hold status, and the KEEP
option on the file remains unchanged. Specify NOKEEP to override either file or
device keep characteristics. The disposition of a file closed NOKEEP (whether it
is purged or retained) is controlled by the hold status of the virtual reader. If it
were closed KEEP, it would never be purged.
MOdify name n
assigns a copy modification module to be used when printing the spool file on
the 3800. This function makes it possible to alter text by not printing certain
information or by adding labels to output. The name variable must be one to
four characters long.
The n variable selects one of the character sets specified by the CHARS
operand to be used for the copy modification text. The value of 0, 1, 2, or 3
corresponds to the order in which the character sets have been specified. If n is
not specified, the first character set (0) is assumed.
MOdify OFF
resets the modify parameters. Blanks are inserted into the modify-name field of
the spool file and, when the file is printed, no modification occurs. The modify
number (n) is set to 0.
MSG
NOMsg
indicates whether you want to be informed about file printing and punching. If
you specify MSG, you are informed of file printing and punching. The message
is sent to you when the file begins either printing or punching on a real device.
Specify NOMSG to reset the MSG option.
NAme dsname
NAme fname ftype
enables you to assign a name to the spool file for identification.