lprm(1)            UNIX System V(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 argument,
      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.
                Otherwise 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.

FILES
      /var/spool/lp/*     spooling directories

SEE ALSO
      lpq(1), lpr(1)

      lpsched(1M) in the System Administrator's Reference Manual
      cancel(1), lp(1) in the User's Reference Manual




10/89                                                                    Page 1

lprm(1)            UNIX System V(BSD Compatibility Package)             lprm(1)


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
            usually means the printer server started at boot time has died or
            is 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.

















Page 2                                                                    10/89