Open System Services Shell and Utilities Reference Manual (G06.29+, H06.08+, J06.03+)

User Commands (c) cancel(1)
NAME
cancel - Removes job requests from the line printer spooling queue
SYNOPSIS
cancel [request-ID ...] location ...
The cancel command removes one or more requests from a printer’s spool queue.
DESCRIPTION
Because the spooling directory is protected from users, using the cancel command is normally
the way a user can remove a request.
Users can cancel jobs they initiated. Superusers with special privileges can cancel jobs initiated
by other users.
You can remove an individual request from a queue by specifying its request ID. (You can obtain
the request ID by using the lp command.)
The argument location specifies a spooler location where the job request to be removed resides.
If no ID is specified, all the jobs initiated by the user that reside in the specified location are can-
celed. If location is not specified, the system default location is used.
The cancel command does not return a message if there are no requests in the queue that match
the request list.
The cancel command kills an active daemon, if necessary, before removing any spooling files. If
a daemon is killed, a new one is automatically restarted upon completion of file removals.
You cannot use cancel to remove another user’s job unless you have superuser privileges.
cancel can remove only jobs in the READY or HOLD state (see the reference page for the lpstat
command). When a job request is under the control of another process, such as a PRINT process,
cancel has no effect.
Environment Variables
LANG Provides a default value for the internationalization variables that are unset
or null. If the LANG variable is unset or null, the corresponding value from
the implementation-specific default locale is used. If any of the internation-
alization variables contain an invalid setting, the cancel command behaves
as if none of the variables have been defined.
LC_ALL
When set with a nonempty string, overrides the values of all other interna-
tionalization variables.
LC_CTYPE
Determines the locale for the interpretation of sequences of bytes of text data
as characters (for example, single-byte as opposed to multibyte characters in
arguments and input files).
LC_MESSAGES
Determines the locale to be used to affect the format and contents of diagnos-
tic messages written to the standard error file and informative messages writ-
ten to the standard output file.
NLSPATH
Determines the location of message catalogs for processing the
LC_MESSAGES variable.
527188-021 Hewlett-Packard Company 2−65