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

CLOSE
available for processing. You can transfer a file to another user by using the
TO operand of the TRANSFER or CHANGE commands.
Note: An external security manager, if installed, may prevent you from
transferring a spool file to another user unless you are specifically
authorized to enter the TRANSFER and CHANGE commands. For
additional information, contact your security administrator.
7. You can specify a file name and file type to help you identify a file and its
contents. The file name and file type you assign have no effect on the way
CMS names the file if it is read using the CMS READCARD or CMS DISK
LOAD commands.
8. If you are closing a reader, the file that is being processed is purged unless
HOLD or KEEP is in effect for the device or for the file. Use the appropriate
CLOSE command option to override the effect of HOLD, NOHOLD, KEEP, or
NOKEEP established for the reader or for the file.
9. If an input spool file has been only partially read (that is, your virtual machine
did not get an end-of-file indication), you must enter a CLOSE READER
command.
10. If the TO option is used to direct a file to a new user, the spool file ID number
changes. The new number is obtained from the recipient’s pool of available
IDs. Thus, if user SAM enters CLOSE READER TO HARRY, he gets a
response: RDR 0003 SENT TO HARRY RDR AS 0018. HARRY now has a file
number 18.
If an external security manager is installed on your system, you may not be
authorized to transfer a spool file to another user with the CLOSE TO
command. For additional information, contact your security administrator.
11. The disposition of a spool file that is to be processed on a real unit record
device depends upon the resolution of HOLD, CONT, and KEEP status as
implied by the device using the SPOOL and CLOSE commands.
For example, suppose your virtual printer is spooled CONT, and you enter
close prt class z. Since you did not specify the CLOSE operand EOF, the
file does not become available for processing on a real printer.
After completion of the CLOSE command, CP checks the hold status of the file
to determine whether the files you closed can be processed. Thus, if hold is in
effect for any of the closed files because you specified HOLD on the CLOSE
command or because hold was set for the device using the SPOOL command,
the file is not processed.
For readers only, the net effect of file status, device options, and the CLOSE
command overrides is shown in Table 5.
Table 5. Effect of File Status, Device Options, and CLOSE Command Options on Reader
Files
Options in Effect
for the Input File
64 z/VM: CP Commands and Utilities Reference
System Action
NOKEEP/NOHOLD The file is purged.
NOKEEP/HOLD The file is not purged and remains available for processing
in HOLD status.
KEEP/NOHOLD The file is not purged. It is set in NOHOLD/KEEP status and
is not available for processing.
KEEP/HOLD The file is not purged. It is set in HOLD/KEEP status and is
not available for processing.