lprm(1)                 (BSD Compatibility Package)                 lprm(1)

NAME
     lprm - remove jobs from the printer queue

SYNOPSIS
     /usr/ucb/lprm [-Pprinter] [-] [job# ...] [username ...]

DESCRIPTION
     lprm removes a job or jobs from a printer's spooling queue. Since the
     spool directory is protected from users, using lprm is normally the
     only method by which a user can remove a job.

     Without any arguments, lprm deletes the job that is currently active,
     provided that the user who invoked lprm owns that job.

     When the privileged user specifies a username, lprm removes all jobs
     belonging to that user.

     You can remove a specific job by supplying its job number as an argu-
     ment, which you can obtain using lpq(1). For example:

          lpq  -Phost
          host is ready and printing
          Rank Owner   Job     Files   Total Size
          active       wendy   385     standard input  35501 bytes
          lprm -Phost 385

     lprm reports the names of any files it removes, and is silent if there
     are no applicable jobs to remove.

     lprm Sends the request to cancel a job to the print spooler, lpsched.

OPTIONS
     -Pprinter Specify the queue associated with a specific printer. Other-
               wise the value of the PRINTER variable in the environment is
               used. If this variable is unset, the queue for the default
               printer is used.

     -         Remove all jobs owned by you. If invoked by the privileged
               user, all jobs in the spool are removed. Job ownership is
               determined by the user's login name and host name on the
               machine where the lpr command was executed.

DIAGNOSTICS
     lprm: printer: unknown printer
          The printer was not found in the System V LP database. Usually
          this is a typing mistake; however, it may indicate that the
          printer does not exist on the system. Use lptstat -p to find the
          reason.

     lprm: error on opening queue to spooler
          The connection to lpsched on the local machine failed. This usu-
          ally means the printer server started at boot time has died or is



Page 1                       Reliant UNIX 5.44                Printed 11/98

lprm(1)                 (BSD Compatibility Package)                 lprm(1)

          hung. Check if the printer spooler daemon /usr/lib/lpsched is
          running.

     lprm: Can't send message to the LP print service
     lprm: Can't receive message from the LP print service
          These indicate that the LP print service has been stopped. Get
          help from the system administrator.

     lprm: Received unexpected message from the LP print service
          It is likely there is an error in this software. Get help from
          system administrator.

     lprm: Can't cancel request
          You are not allowed to remove another's request.

NOTES
     An active job may be incorrectly identified for removal by an lprm
     command issued with no arguments. During the interval between an
     lpq(1) command and the execution of lprm, the next job in queue may
     have become active; that job may be removed unintentionally if it is
     owned by you. To avoid this, supply lprm with the job number to remove
     when a critical job that you own is next in line.

     Only the privileged user can remove print jobs submitted from another
     host.

     lp is the preferred interface.

FILES
     /var/spool/lp/*
          Spooling directories

SEE ALSO
     cancel(1), lp(1), lpq(1), lpr(1), lpsched(1M).




















Page 2                       Reliant UNIX 5.44                Printed 11/98