Previous | Table of Contents | Next |
DESCRIPTION
The external lprm command removes print jobs from a printer s spool queue. The spool queue is a system controlled directory and normal users cannot directly manipulate the files within the queue. Therefore, to remove a print job you must use the lprm command.
By default lprm , without options or arguments, removes the currently active print job, assuming the user running lprm owns the active print job. If you specify a print job number, lprm only removes that specific print job.
The names of all print jobs removed from the queue are displayed to your screen. If no print jobs are removed, no message is returned.
When the super-user specifies a user_name , all jobs belonging to that user are removed from the print queue.
COMMAND FORMAT
Following is the general format of the lprm command.
lprm [ -Pprinter ] [ - ] [ job# ] [ username ... ]
Options
The following list describes the options and their arguments that may be used to control how lprm functions.
-P printer | Specify the printer queue for a certain physical printer. If you do not specify this option, the value of the PRINTER variable is used as the print queue. If PRINTER is not set, then the print queue for the default printer is used. |
- | Remove all jobs owned by you. If you are the super-user, all jobs are removed from the specified queue. |
Arguments
The following list describes the arguments that may be passed to the lprm command.
job# | The number of the print job to remove, which is currently spooled in a print queue |
username | The name of the user whose print jobs are removed. Only the super-user can specify a different username . |
DIAGNOSTICS AND BUGS
If you receive the following message when using lprm , contact your system administrator.
lprm: printer: cannot restart printer daemon
This message indicates that the lpd on your system is not working properly or has failed. This usually requires the system administrator to terminate the printer daemon and restart it or, if it has failed, just restart it.
Depending on printer and system speeds, you may perform an lprm that removes the second job in queue by accident . This condition occurs when you have spooled two or more jobs in the print queue back to back. You want to remove the active print job. You run lpq to identify the active job; you run lprm to remove the job. When you check again, the first two jobs appear to be removed. What actually happened was the first job printed and your lprm command removed the second job, which became active. To prevent this from occurring, specify the job# you want to remove.
RELATED COMMANDS
Refer to the lpq and lpr commands described in modules 80 and 81. @H2 = RELATED FILES The lprm command accesses the following files to perform the requests .
/etc/printcap | Printer characteristics database. |
/usr/spool/* | Location of printer spooling directories. |
/usr/spool/l*/lock | Lock file containing the current daemons PID and the active print job number. |
APPLICATIONS
The lprm command provides you with the ability to remove print jobs you have decided you no longer need printed, thus saving paper and time for yourself and other users.
TYPICAL OPERATION
In this activity you use the lprm command to remove a print job. Begin at the shell prompt.
cj> lpq lj is ready and printing Rank Owner Job Files Total Size active mylogin 295 /etc/passwd 5938 bytes
cj> lprm 295 dfA295cj dequeued cfA295cj dequeued
Previous | Table of Contents | Next |