The STOPPTR command stops one or more printers after the current print jobs, if any, have finished printing. You must have SYS2 privileges to use this command.
Format
|
STOPPTR [n [-m]] [B] [W] |
Parameter(s)
|
n |
Number of the printer you want to stop. If no printer is specified, printer number 0 is stopped. |
|
n-m |
Specifies a range of printers. |
|
B |
Stops all printers. |
|
W |
Causes the process to wait until the printer is inactive before it returns the terminal to the TCL prompt. |
Description
If the printer is printing multiple copies, it stops when the current copy has finished printing.
When an inactive printer is successfully stopped, the following message is displayed:
|
PRINTER # n SET TO STOP AND IS INACTIVE. |
Parameter(s)
|
n |
Printer number. |
If the printer is still printing, the following message is displayed:
|
PRINTER # n SET TO STOP BUT IS STILL ACTIVE. |
After the current file is finished printing, the printer becomes inactive.
The W option is useful when you are using certain Procs to handle the Spooler. For example, since the STARTPTR command will not work if the printer is still active, you should always use STOPPTR with the W option before using STARTPTR to ensure that the printer is inactive before the process returns to the Proc.