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

DRAIN UR
Usage Notes
Responses
1. Use the DRAIN command to bring the spooling system or a specified device to
a controlled halt. You would normally drain all unit record devices before a
system shutdown, and drain a printer before you change the contents of the
UCS printer buffer.
2. A device is drained immediately if it is not active when the DRAIN command is
issued; otherwise, it is drained when processing of the current file has
completed. You can restart a drained device by issuing the START command. If
you enter a START command to a device before draining has been completed,
the device does not enter drained status, and it continues processing.
3. If you specify more than one real device number, execution of the DRAIN
command terminates upon encountering an nonvalid real device number. None
of the remaining devices are drained.
4. For a printer ID, the virtual machine associated with the printer ID processes the
DRAIN command. Therefore, the options given on the DRAIN command must
be valid for the virtual machine that is doing the processing.
When you enter the DRAIN, DRAIN PRINTER, DRAIN ALL, DRAIN UR, DRAIN
UR PRINTER, or DRAIN UR ALL commands, all printers associated with all
prtids are drained.
The following section lists the printer, punch, and reader responses that occur when
drained status has been attained. An explanation of the various options that appear
in the responses follows the last response.
Inactive Printer Responses:
For every inactive printer that attains the drained status, the first line of the
response is the same. The second line varies based upon printer type.
PRT rdev DRAINED userid CLASS c ...
PRT rdev FORM form {AUTO } {SEP } {NO3800 } [DEFFCB] LIMIT [NONE]
{MANUAL} {NOSEP} {BEG3800} [FILEFCB] [nnnnnnnnnn ]
{SETUP } {ANY3800}
For 3800 printers the third line is:
PRT rdev FLASH name IMAGE imagelib CHARS name FCB {name} {HOLD } LPP nnn
{ 6 } {PURGE}
{ 8 }
{ 10 }
{ 12 }
For impact printers the third line is:
PRT rdev {NOFOLD} IMAGE imagelib CHARS chars [FCB name] [INDEX nn] LPP nnn
{FOLD }
The fourth line of the response for all printers is:
PRT rdev DEST {dest1} DEST {dest2 } DEST {dest3 } DEST {dest4 }
{OFF } {- NONE -} {- NONE -} {- NONE -}
The last line of the response for 3800 printers is:
PRT rdev {AFP } {MARK }
{NOAFP} {NOMARK}
344 z/VM: CP Commands and Utilities Reference
The last line of the response for impact printers is: