[ Previous | Next | Table of Contents | Index | Library Home | Legal | Search ]

Commands Reference, Volume 4


qpri Command

Purpose

Prioritizes a job in the print queue.

Syntax

qpri -# JobNumber -a PriorityNumber

Description

The qpri command prioritizes a job in a print queue by specifying the job number and giving it a priority number.

The qpri command works only on local print jobs and the local side of remote queues. Remote print jobs are not supported. Also, you must have root user authority or belong to the printq group to run this command.

You can use the Printer Queues application in Web-based System Manager (wsm) to change printer characteristics.

You could also use the System Management Interface Tool (SMIT) smit qpri fast path to run this command.

In AIX 4.3.2 and above, qstatus was enhanced to improve the administration of local queues showing duplicate 3-digit job numbers. You can use the -W flag with the enq, qchk, lpstat, and lpq status commands to display more job number digits.

If your queue display shows duplicate 3-digit job numbers, use qchk -W to list job numbers with greater precision. You can then alter the priority of a specific job.

For example, qchk might display job number 123 twice while, qchk -W would display job number 1123 and 2123. If you want to alter the priority of job number 2123, specifying qpri -# 123, causes the qdaemon to alter the priority of the first matching job number it finds in its internal list, which may be 1123. By having the additional information that the qstatus -W provides, you can alter the priority of a specific job number.

Flags


-# JobNumber Specifies the job number on which to change priority.
-a PriorityNumber Specifies the new priority number for the print job specified by the JobNumber variable. The range of priority numbers is 1 through 20, except for the root user or a member of the printq group, who can select priority numbers from 1 through 30.

Example

To change job number 123 to priority number 18, enter:
qpri -# 123 -a 18

Files


/usr/sbin/qdaemon Contains the qdaemon daemon.
/var/spool/lpd/qdir Contains the job description files.
/var/spool/lpd/stat Contains information on the status of the devices.
/var/spool/qdaemon Contains the temporary copies of enqueued files.
/etc/qconfig Contains the configuration file.
/etc/qconfig.bin Contains the digested, binary version of the /etc/qconfig file.

Related Information

The enq command, qadm command, qcan command, qchk command, qprt command.

The /etc/qconfig file.

Prioritizing a Print Job (qpri Command) in AIX 5L Version 5.1 System User's Guide: Operating System and Devices.

For information on installing the Web-based System Manager, see Chapter 2: Installation and System Requirements in AIX 5L Version 5.1 Web-based System Manager Administration Guide.


[ Previous | Next | Table of Contents | Index | Library Home | Legal | Search ]