CLOSE PUR3E If input file is closed with the HOLD option, the file is
saved and not purged from the system. The saved file is avai13ble for virtual machine and user processing and is not
placed in a user hold status. Input spool files that are
closed are normally purged from the virtual machine.
closes and immediately purges from the virtual machine the
output spool files. No output file is produced. DIST distcode
uses the one-to eight-character alphameric identification
(distcode) on the output separators of printer and punch
instead of the identification specified in the VM/310 directory. The distribution code is changed for this file
only and does not affect other files or change the VM/310 directory. If the file is spooled to another user, this
option has no effect. NTiME fn [ftl
assigns identification to the spool file in the eMS format
filename and filetype. The filename, fn, is a one-to
eiqht-character alphameric name assigned to the file for
identification. The filetype, ft, is a one-to
eight-character alphameric type assigned to the file for
identification. If ft is not the filetype is set
to blanks. NTiME dsnalte assiqns identification to the spool file in a non-CMS format.
The dsname field is a 1-to 24-character field suitable for OS or DOS files (for example, SYS1.SYSLIB.MYMAC). Only 20 characters of the 24-character dsname are displayed by QUERY, even though a name of up to 24 characters is valid. 1. If the file is an input reader file, the file being processed is plrged unless SPOOL READER HOLD was previously specified (see the The effect of HOLD or NOHOLD for a particular file
established by the SPOOL command can be overridden by specifying NOH-OLD or HOLD, respectively, in the CLOSE command.
2. If an input spool file is read but the read is not completed (that
is, the virtual machine does not get a last-card indication), you
must issue a CLOSE READER command in order to be able to read that
file (or to read any other file). Unless you specify HOLD when you close a reader file, the file is purged.
3. If the file is an output file on a printer, punch, or console, the
file is either queued for output on a real unit record device, or,
if the virtual output device is transferred (by use of the "SPOOL TO userid" command), the file is queued for input to the
receivinq user.
4. You can specify distcibution code
its contents.
a filename and filetype and an
to aid in later identification of the IBM LP Command Reference for General Users optional
file and

r CLOSE s. FiguLe 7 shows what happens to an input file in your virtual reader
when the CLOSE command is issued with the HOLD or NJHOLD operand in
effect. The CLOSE command can result in an input file being purged
or s3.ved. (CLOSE Command Settinq) Norm3.l EOF In /:) oF:::I" 1 ... \ ....... _.-\,4 ...... '- CLOSE) CLOSE CLOSE HOLD CLOSE NOHOLD SPOOL Command Options Set for a virtual Input Device NOHOLD File purged
File purged
File saved
File purged HOLD File saved
File saved
File saved I I ----------------------------1
File purged I ----------------------1 INote: The term "saved" means that the file is neither purged
lin HOLD st3.tus. A subsequent READ could read this file.
nor is itl I L ____ J
Figure 7. Action on CLOSE for a Virtual Input Device.
r I I 6. FiguLe 8 shows what happens to a file in your virtual output device
when the CLOSE command is issued with the HOLD, NOHaLD, CONT, and NOCONT operands in effect. SPOOL Command Options Set for a Virtual Output Device
1 (C LOSE Command
sett inq) NOHOLD NOCO}!T HOLD NOCONT NOHOLD HOLD CONT CONT CLOSE CLOSE HOLD IFile released I File held Ifor processinql IFile held I File held
iNo I I No
action
1
iNo action
1 I ac tion 1 INo action
1 CLOSE NOHOLD IFile released IFile released INo action
1 INo action
1
lfor processinglfor processinql I 1 INc is taken until you issue a SPOOL {PRTIPUN} NOCONT command. I Then vou can issue a CLOSE command to release the file for I processinq.
L
Fiqure 8. Taken on CLOSE for a Virtual Output Device Section 5. Format of CP Commands 55