User's Reference > Operation > Spooler > SP-JOBS and Related Procedures > Action Code 12 Kill Printing and SP-KILL

Comment on this topic

Documentation Comments

Use this form to comment on this topic. You can also provide any general observations about the Online Documentation, or request that additional information be added in a future release.

RealityV15.1Online Documentation (MoTW) Revision 7

Action Code 12 Kill Printing and SP-KILL (Spooler) (m604905+killprinting.htm)

To

Reality

Version

Topic

Submitted by

Company

Location

Email address

Comment

 

 

Action Code 12 Kill Printing and SP-KILL

Aborts permanently the printing of a job currently being despooled.

The job can be selected by specifying:

Prompts

Job (J), Despooler (D), or Queue>

TCL Syntax

SP-KILL {job-file} job-id (J{F}

SP-KILL despooler-name (D

SP-KILL queue-name

Prompt/Syntax Elements

queue-name is the name of the formqueue containing the print job to kill.

despooler-name (Despooler)
is the name of the Despooler which is despooling the print job to kill.

job-id (Job) is the name of the print job to kill.

job-file specifies the job file to be used for the duration of the command execution. If you specify job-file you must also use the F option.

Options

D Defines the preceding parameter to be a Despooler name.

F Specifies that the first parameter after the verb is the required job file.

J Defines the preceding parameter to be a job name.

If no option is specified, the action is executed by formqueue.

Specified Job File

Only job-ids of print jobs in the currently specified job file are recognised and killed. The specified job file must be local.

You can specify job-file in the TCL command statement and at the SP-JOBS action code prompt. At the Job (J) prompt you enter the new specified job file name using the same syntax as at TCL, that is,

job-file job-id (JF

Comments

If you specify the Despooler or queuename, printing of the current print job is aborted and the job is deleted, unless the job is in a Hold file.

If you specify the job-id, printing of the job is stopped and the job is marked 'Killed', unless the job is in a Hold file.

Examples

Killing a Print Job by Specifying the Job-Id

To kill the print job ADMIN12, before it prints, enter:

SP-KILL ADMIN12 (J

Or alternatively, enter:

SP-JOBS

and select Action Code 12 on the Print Jobs screen.

At the next prompt, enter the job-id , as follows:

Job (J), Despooler (D), or Queue> ADMIN12 (J

Killing a Print Job by Specifying the Despooler

To kill the print job currently being despooled by PTR12, enter:

SP-STOP PTR12 (D

Or alternatively, enter:

SP-JOBS

and select Action Code 12 on the Print Jobs screen.

At the next prompt, enter the Despooler name , as follows:

Job (J), Despooler (D), or Queue> PTR12 (D

Killing Print Job by Specifying the Formqueue

To kill the print job being despooled from the formqueue STANDARD, enter:

SP-STOP STANDARD

Or alternatively, enter:

SP-JOBS

and select Action Code 12 on the Print Jobs screen.

At the next prompt, enter the formqueue name , as follows:

Job (J), Despooler (D), or Queue> STANDARD

RealityV15.1 (MoTW) Revision 7Comment on this topic