tcl.stopptr

Verb: Access/Spooler, Releases: AP and R83

Stops printer.

Syntax

stopptr {options}

Description

stops the specified printer at the end of the current print job.

If the printer is inactive, it stops immediately. If it is active, it stops at the end of the current print file. If the current print file is specified to print multiple copies, the printer stops after the completion of the current copy.

'sys2' privileges are required to use 'stopptr'.

Executing this command without specifying a printer attempts to stop printer 0.

Options

printer.number{-printer.number} Designates the printer number, or range of printer numbers to stop. Must be between 0 and the maximum printer number. The maximum printer number is the actual number of ports on the system, plus 4.

b Stops all printers.

d Deletes printer, or all printers if used with the 'b' option. (The 'd' option only works in R83 implementations.) Using this option is identical to using the 'sp-kill dn', which kills printer 'n' after completing the current job.

s Suppresses display of error messages.

w Waits until the printer has completed printing any print file and is inactive. This option can be used, for example, when the 'stopptr' verb is issued from a macro, followed by a 'startptr' verb. This ensures that the printer is stopped before 'startptr' is executed.

Example

stopptr 1
printer # 1 set to stop

stopptr b
printer # 0 set to stop but is still active
printer # 1 set to stop

stopptr 1w

Sets printer #1 to stop, then waits for printer #1 to become inactive before
returning to TCL.

See Also

Command Name Type Description
tcl.sp-kill Verb: Access Stops Spooler entry output.
spooler.options Definition Standard Spooler options.
tcl.startspooler Verb: Access Initializes the Spooler.
tcl.listptr Verb: Access Displays printers.
tcl.sp-status Verb: Access Displays status of Spooler processes.
tcl.startshp Verb: Access Starts shared printer under Unix.
tcl.listpeqs Verb: Access Displays printer queue elements.
spooler.commands Introductory Description of Spooler.
system.privileges Definition Description of privilege levels.
tcl.startptr Verb: Access Initializes Spooler-controlled printer.
tcl.stopptr.link Verb: Access

User Comments

What do you think?

Share your experience or ask a question by using the form below.

Login to leave your comments.