|Skip Navigation Links|
|Exit Print View|
|System Administration Guide: Printing Oracle Solaris 11 Express 11/10|
When a user submits a print request from a print client, the print request is added to a queue on the print server before it is sent to the printer. While a print request is in the queue, you can cancel or gain status information on the request from a client system. You must log in to the print server to move, hold, resume, or change the priorities of print requests with LP print service commands. These actions can help you keep printing services operating smoothly.
Table 9-1 Values for Changing the Priority of a Print Request
Only the most commonly used options are shown here. For other valid options, see the lpstat(1) man page.
# lpstat -o [list] | -u [user-list]
To specify multiple printer names, class names, and IDs for list, use a space or a comma to separate values. If you use spaces, enclose the list of values in quotation marks.
If you don't specify list, the status of print requests sent to all printers is displayed.
Shows the status of print requests for a specific user. user-list can be one or more user names.
To specify multiple users with this command, use a space or a comma to separate user names. If you use spaces, enclose the list of names in quotation marks.
If you don't specify user-list, the status of print requests for all users is displayed.
From left to right, the line shows the following information:
Output size in bytes
Date and time of the request,
Information about the request, such as “being filtered.”
Example 9-4 Checking the Status of Print Requests
The following example shows that user fred has one print request queued on the printer luna.
# lpstat luna-1 fred 1261 Jul 12 17:34
The following example shows that the user paul currently has no print requests in queue.
# lpstat -u paul
The following example shows that two print requests are queued on the printer moon.
# lpstat -o moon moon-78 root 1024 Jul 14 09:07 moon-79 root 1024 Jul 14 09:08
The enable and disable commands control whether a printer prints or stops printing requests that are in the print queue. When you disable a printer, the printer stops printing requests in the queue. However, requests are still added to the queue. You must set the printer to reject print requests so that requests are not added to the queue. For information about rejecting print requests, see Accepting or Rejecting Print Requests.
A printer is enabled to print and accepts print requests when the printer is added by using Oracle Solaris Print Manager. Oracle Solaris Print Manager does not provide any additional printer processing management.
You must enable the printer whenever it has been disabled, which can happen when a printer fault occurs. When you enable a printer, it prints requests from the print queue until the queue is empty, even if the print service rejects additional requests for the print queue.
The following figure shows the point at which the processing of print requests is interrupted when a printer is disabled.
# disable [-c | -W] [-r "reason"] printer-name
Cancels the current job, then disables the printer. The current job is not printed later.
Waits until the current job is finished before disabling the printer.
Provides users with a reason why the printer is disabled. The reason is stored and displayed whenever a user checks on the status of the printer by using the lpstat -p command.
Specifies the name of the printer that will stop printing print requests.
# enable printer-name
# lpstat -p printer-name
Example 9-5 Enabling or Disabling a Printer
The following example shows how to stop the current job on the printer luna, save the job to print later, and provide a reason why the printer has stopped printing print requests.
# disable -r "changing the form" luna
The following example shows how to start printing print requests on the printer luna.
# enable luna printer "luna" enabled
When you use the reject command, the print queue for a specified printer is turned off. No new print requests can enter the queue on the print server. However, all print requests that are in the queue are still printed. You must disable the printer if you want it to stop printing requests that are already in the queue. The following table compares the functions of the accept, reject, enable, and disable commands.
Table 9-2 Functions of accept, reject, enable, and disable Print Commands
If a print request is rejected, the LP print service writes or mails a message to the user who submitted the request. the message states that print requests are not being accepted for the specified printer.
You can also specify a reason for not accepting requests through the command line. The reason is displayed on a user's system when a user tries to check the printer's queue. The following figure shows the point at which the processing of print requests is interrupted when a print queue rejects print requests.
# reject [-r "reason"] printer-name
Provides users with a reason why the printer is rejecting print requests. The reason is stored and displayed whenever a user checks on the status of the printer by using the lpstat -p command.
Specifies the name of the printer that will stop accepting print requests.
The queued requests continue printing as long as the printer is enabled. For instructions on disabling a printer so that it stops printing, see How to Enable or Disable a Printer.
# accept printer-name
# lpstat -p printer-name
Example 9-6 Accepting or Rejecting Print Requests for a Printer
The following example shows how to stop the printer luna from accepting print requests.
# reject -r "luna is down for repairs" luna destination "luna" will no longer accept requests
The following example shows how to set the printer luna to accept print requests.
# accept luna destination "luna" now accepting requests
Three are three ways to use the cancel command:
Cancel requests from a specific user on all printers or specific printers
Cancel the job currently printing
When you use the cancel command, a message tells you the request or requests are canceled, and the next request in queue is being printed.
You can cancel a print request only under the following conditions:
You are the user who submitted the request and you are logged in on the system from which you submitted the request.
You are the user who submitted the request on any client system and the print server has the “user-equivalence” option configured for the printer in its /etc/printers.conf file.
You are logged in as superuser, lp, or have assumed an equivalent role on the print server.
To cancel a specific request, you need to know its request ID. The request ID contains the name of the printer, a dash, and the number of the print request. For example, luna-185.
For more details, see How to Check the Status of Print Requests.
# cancel request-id | printer-name
Specifies the request ID of a print request to be canceled. You can specify multiple request IDs with this command. Use a space or a comma to separate request IDs. If you use spaces, enclose the list of request IDs in quotation marks.
Specifies the printer for which you want to cancel the currently printing print request.
You can specify multiple printer names with this command. Use a space or a comma to separate printer names. If you use spaces, enclose the list of printer names in quotation marks.
# lpstat -o printer-name
Example 9-7 Canceling a Print Request
The following example shows how to cancel the luna-3 and luna-4 print requests.
# cancel luna-3 luna-4 request "luna-3" cancelled request "luna-4" cancelled
The following example shows how to cancel the print request that is currently printing on the printer luna.
# cancel luna request "luna-9" cancelled
# cancel -u user-list [printer-name]
Cancels the print request for a specified user.
Specifies the printer for which you want to cancel the print requests for a specified user.
printer-name can be one or more printer names. Use a space or a comma to separate printer names. If you use spaces, enclose the list of printer names in quotation marks.
If you don't specify the printer-name, the print requests for the specified user is canceled on all printers.
Example 9-8 Canceling a Print Request From a Specific User
The following example shows how to cancel all the print requests submitted by the user george on the printer luna.
# cancel -u george luna request "luna-23" cancelled
The following example shows how to cancel all the print requests submitted by the user george on all printers.
# cancel -u george request "asteroid-3" cancelled request "luna-8" cancelled
If you plan to change the way a printer is used or decide to take a printer out of service, you should set up the LP print service to reject additional print requests. Then, move or cancel any requests that are currently queued to the printer. You can use the lpmove command to move individual or all print requests to another local printer.
Request IDs are not changed when you move print requests, so users can still find their requests. Print requests that have requirements, such as a specific file content type or form, that cannot be met by the newly specified printer cannot be moved. These print requests must be canceled.
To move all print requests from one printer to another printer, you do not need to know the request IDs. However, first determine how many print requests are affected before you move them.
# lpstat -o printer-name1
# lpstat -a printer-name2
-a printer-name2 reports whether print destinations are accepting requests.
# lpmove printer-name1 printer-name2
Specifies the name of the printer from which all print requests will be moved.
Specifies the name of the printer to which all print requests will be moved.
For more information, see the lpmove(1M) man page.
If some requests cannot be printed on the destination printer, the requests are left in the original printer's queue. By using request IDs, you can also move specific print requests to another printer by using the lpmove command.
If you move all the print requests to another printer, the lpmove command automatically stops accepting print requests for the printer. This step is necessary if you want to begin accepting new print requests for the printer.
# accept printer-name1
# lpstat -o printer-name1
Ensure that all specified print requests were moved to the destination printer's queue.
# lpstat -o printer-name2
Example 9-9 Moving Print Requests to Another Printer
The following example shows how to move print requests from the printer luna to the printer terra. Then, the original printer, luna, is instructed to resume accepting print requests.
# lpmove luna terra # accept luna
After a user has submitted a print request, you can change its priority in the print server's queue by doing any of the following:
Putting any print request on hold if it has not finished printing. Putting a request on hold stops the request, if it is currently printing, and keeps it from printing until you resume printing it. Other print requests go ahead of the on-hold request.
Moving any print request to the head of the queue, where it will become the next job eligible for printing. If you want a job to start printing immediately, you can interrupt the job that is currently printing by putting it on hold.
Changing the priority of a job still waiting to be printed or moving the job in the queue. Doing so will move the job ahead of lower priority requests and behind other requests that are the same priority or higher priority.
For more information, see How to Check the Status of Print Requests.
# lp -i request-id -H change-priority
You can specify multiple request IDs with this command. Use a space or a comma to separate request IDs. If you use spaces, enclose the list of request IDs in quotation marks.
Specifies one of the three ways to change the priority of a print request: hold, resume, immediate.
For detailed information about valid values for change-priority, see Table 9-1.
You can also use the lp -q command to change the priority level of a specified print request. You can change the priority level from 0, the highest priority, to 39, the lowest priority.
Example 9-10 Changing the Priority of a Print Request
The following example shows how to change a print request with the request ID asteroid-79, to priority level 1.
# lp -i asteroid-79 -q 1