tcl.sp-kill Verb: Access/Spooler

tcl.sp-kill

Command tcl.sp-kill Verb: Access/Spooler
Applicable release versions: AP, R83
Category Spooler (24)
Description stops spooler entry output or removes printers.

More specifically, it provides the following functions:

1) To abort the currently active print job(s) immediately.

2) To dequeue print file(s) on the optionally specified printer.

3) To remove printers from the Spooler system.

If no options are specified, "sp-kill" aborts the current print job on printer 0 (zero). Unless the user-id (or account name in R83) has sys2 privileges, only print files generated by the current user-id (or account name in R83) invoking the "sp-kill" can be aborted. "sys2" privileges allow termination of any print file.
Syntax sp-kill {options}
Options printer.number{-printer.number} Aborts jobs on a given printer number, or a range of printer numbers, between 0 and the maximum printer number.

a Stops Spooler entry or entries created by the current user-id. (or account name in R83).

b All entries. When used with the "d" option, this kills all printers. When used with the "f" option, this kills all open jobs. When used without any other option, this aborts all active printers.

c Kills all copies of the spooler entry or entries, rather than just the current copy. This is a available in Advanced Pick releases 6.1.0 and higher only.

dprinter.number{-printer.number} Deletes given printer(s) from the system. This requires a "sys2" privilege level. When used with the "w" option, it waits until the current job completes, rather than aborting it immediately.

f{file.number{-file.number}} Returns Spooler entries to available hold file status. The beginning and ending file numbers must be in the range (0-600).

n Suppresses abort message on output when directed to a printer. Also see "s" option.

o Used with the "f" option, this unlinks print file(s) already being output.

s Suppresses system messages. Also see "n" option.

u Used with the "d" option, this deletes printer 0 (zero) only.

w Waits until all processes have finished. Use of this option with "sp-kill" is identical to using the "stopptr dn", which causes printer "n" to die after the current job. Note that "sp-kill" and "stopptr" are not exactly synonyms, and "sp-kill" cannot be removed, as it has several other features which "stopptr" does not perform. These are two totally different commands which merely have overlapping options.
Example
sp-kill 1
Kills the print job on printer 1.

sp-kill of7 
Kills print file 7, even if it is being output, and returns it to an available, 
hold file status.

sp-kill
Kills the current print file on printer 0.

sp-kill a
Kills all print files currently being output, that were generated by the 
current user-id.

sp-kill a2
Kills the print file on printer 2.

sp-kill 3-5
kills the print file(s) going to printers 3, 4, and 5.

sp-kill b
Kills all print files going to all printers.

sp-kill f5-10
Changes print files 5 through 10 to hold files.

sp-kill bf
Changes all print files going to all printers into hold files.

sp-kill d1
Deletes printer 1 from the system.

sp-kill d3-5
Deletes printers 3, 4, and 5 from the system.

sp-kill bd
Deletes all printers from the system.
Purpose
Related spooler.commands
spooler.options
tcl.stopptr
tcl.startptr
tcl.listpeqs
tcl.sp-edit
tcl.shp-kill
tcl.sp-kill.link