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

FLUSH
FLUSH
►►
Flush
Notes:
Authorization
Purpose
Operands
(1)
rdev
prtid
Usage Notes
ALL
HOld
1 rdev must be the real device number of a printer or punch.
Privilege Class: D
438 z/VM: CP Commands and Utilities Reference
Use FLUSH to do the following:
v Halt and immediately purge output on a real unit record device
It resumes activity with the next available spool file, if the unit record device meets
the following conditions:
v No intervention is required.
v The device was not drained.
v The device was not taken offline.
rdev
identifies the real device number of the real printer or punch whose current file
is to be terminated. Each rdev must be a hexadecimal device address between
X'0000' and X'FFFF'.
prtid
indicates that the entire command is to be passed for processing to the print
server virtual machine designated by prtid. The operand prtid is provided by the
print server virtual machine, which will enter the FLUSH command to an AFP. It
is 1 to 8 alphanumeric characters long. If you specify a prtid of four or fewer
characters, prtid must not contain all hexadecimal characters; because CP then
interprets prtid as rdev.
ALL
deletes all copies of the current output file. If more than one copy of the current
output file is being printed or punched and you specify ALL, all copies are
deleted. If you do not specify ALL, only the current copy is deleted; and the next
copy, if any, is printed or punched.
HOld
places the spool file in system hold status; the file is not purged. You can reset
the file status using the CHANGE command.
1. You normally use the FLUSH command when a mistake in output queuing has
occurred or a high-priority job must be started before the current job has
►◄