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

Usage Notes
If you want to name files in a format suitable for MVS use (for example,
SYS1.SYSLIB.MAC1), use dsname. This name can be up to 24 characters
long; however, if dsname is more than 16 characters long, it is truncated.
The fname ftype specification permits you to name a file in CMS file name and
file type format. The fields fname and ftype are one- to eight-character
alphanumeric names. If you omit ftype, blanks are substituted.
If specified, the NAME option must be the last operand entered.
NOName
resets the name information to blanks.
PUrge
closes and purges the spool file on the specified device regardless of the cont,
keep, and hold setting for the device.
Printer
PRT
PUnch
PCH
Reader
RDR
are used with the TO operand to specify the file queue to which the spool file is
to be directed. If you do not specify a queue, the file is directed to the reader.
SYNChronous
ASYNChronous
indicates whether the command issuer wishes to wait for the CLOSE command
to complete.
If you specify ASYNCHRONOUS, you are free to process other commands
while the CLOSE command completes. When it does, CP will notify you with a
device end (DE) interrupt on the device affected.
If you specify SYNCHRONOUS, you are prevented from executing any other
commands until the CLOSE command completes. When the command
completes, the file will have been closed by CP.
1. SET IMSG OFF suppresses informational messages for this command.
2. The options of the CLOSE command override the corresponding options in
effect for the device you are closing. If you do not specify any optional
operands, the options in effect for the device, or the status of the file you are
processing, determines the file disposition.
3. Although the CLOSE options FLASH, FCB, MODIFY, and CHARS can be
specified for any virtual device except a reader, they only lead to system action
when a spool file with these attributes is printed on a CP-driven 3800 printer.
4. A user can cancel settings of the CHARS, MODIFY, or FCB options by
specifying NULL in the name fields of these operands. In this case, NULL
performs the same function as OFF.
CLOSE
5. The keyword OFF, which resets attributes to their default values, cannot also
be used as the name specified in a FORM, FLASH, FCB, MODIFY, DISTcode,
or CHARS operand. Similarly, NULL cannot be used to specify a CHARS,
MODIFY, or FCB name.
6. If you close an output device (printer, punch, console) and the file you created
is in hold, that file is not available for processing. If the file is not in hold, it is
Chapter 2. CP Commands 63