FLUSH Use the FLUSH command to halt and immediately purge or, optionally, hold current output on a specified real unit record device. The device
resumes activity with the next SCheduled spool file. The format of the FLUSH command is:
Flush raddr [ALL] [HOld] L- _________________________________________________________________________ J raddr
ALL HOLD is the address (cuu) of the real
whose activity is to be terminated
or punch).
unit record output device
(that is, the real printer
deletes all copies of the current output file. If more than
one copy of the current output file is being printed or
punched and this option is specified, all copies are deleted;
if ALL is not specified, only the current copy is deleted and
the next copy, if any, is printed or punched.
places the spool file in system hold status. If this option
is specified, the terminated spool file is not purged, but is
put in a system hold status and can be reset using the CHANGE command. Y,§age 1. The FLUSH co •• and is usually invoked when it is apparent that a mistake in output queuing has occurred, or if a high priority job must be started before the current job has finished. For example, a file was directed to a printer that is equipped with the wrong
printer train to process that file, or a file was misdirected to the real punch-ratliet than a user·s virtual PUllch unit. For example: 2. FLUSH E HO Special handling is required if a spool file is started on a real
output device that cannot be made ready. When such a condition
arises, an error message is directed to the operator, who can
recover the file and restart it. To do so, he must enter the
following commands: FLUSH raddr [HOLD] DRAIN raddr
Following the entry of these commands, the "FATAL I/O ERROR" message is issusd to the operator and the de¥ice is logically offline. No attempt is made by the system to use the device until
the operator puts it back online via the VARY command.
If HOLD is specified, the file is placed in system hold status; if HOLD is not specified, the file is requeued and started on another device (if
one is available). Both the FLUSH and DRAIN commands must be issued to
recover the file.
14 VM/370 Operator's Guide

file RECDS norecs COpy - nn a typ The FILE HELD response is given in addition to the FLUSHED response if
the HOLD option is specified.
raddr
userid
file
norecs ·nn a
typ
is the real address of the printer or punch to be affected.
is the identification of the user who is to receive the
output.
is the unique spoolid number which identifies the file to the VM/370 system.
is the total number of logical records in the file.
is the number of copies remaining for the file, where 01 is
the last copy.
is the spool file class.
is the originating device type (PRT, CON, or PUN). Section 3. CP Commands 75