Action Code 14 Clear Queue and SP-CLEAR

Deletes all print jobs in the specified job file from a specified formqueue.

Prompts

Form Queue -

TCL Syntax

SP-CLEAR {job-file} queue-name {(options}}

Prompt/Syntax Elements

queue-name (Form Queue -)
is the name of the formqueue to be cleared.

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

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

U Determines the job files containing all print jobs in the formqueue from their PRINT.JOB.CONTROL items.  This means all jobs in the formqueue are deleted irrespective of job file.

Restrictions

Print jobs with 'Open' and 'Edit' status cannot be cleared.

Comments

Both 'Queued' and 'Print' jobs can be deleted.  Print jobs being printed are killed, then deleted from the formqueue.

Only print jobs from the specified job file are cleared, unless you use the U option, in which case all print jobs are cleared from the queue.

Example

To delete all print jobs from the formqueue FINANCE regardless of job file, enter:

SP-CLEAR FINANCE (U

Alternatively, enter:

SP-JOBS (U

then select Action Code 14 on the Print Jobs screen.

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

Form Queue - FINANCE

The formqueue FINANCE is now empty.

If the jobs to be deleted are in the job file INVOICES which is not currently the specified job file, enter:

SP-CLEAR INVOICES FINANCE (F

This will then clear all jobs in file INVOICES from formqueue FINANCE.