Open System Services Shell and Utilities Reference Manual (G06.25+, H06.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 internationalization 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 internationalization
variables.
LC_CTYPE
Determines the locale for the interpretation of sequences of bytes of text data as char-
acters (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 diagnostic mes-
sages written to the standard error file and informative messages written to the standard
output file.
NLSPATH
Determines the location of message catalogs for processing the LC_MESSAGES vari-
able.
527188-003 Hewlett-Packard Company 2−33