Examines the spool queue.
lpq [ + [ Number ] ] [ -l ] [-P Printer ] [ JobNumber ] [ UserName ]
The lpq command reports the status of the specified job or all jobs associated with the specified UserName and JobNumber variables. JobNumber variable specifies the number of the job in the spool queue that you want to view. A UserName variable specifies viewing the jobs for the name of the person who submitted the job to that queue.
The lpq command reports on any jobs currently in the default queue when invoked without any options. Parameters supplied that are not recognized as parameters are interpreted as user names or job numbers to filter out only those jobs of interest.
For each job submitted (each job called by the lpr command), the lpq command reports the user's name, current rank in the queue, the name of the job, the job identifier (a number that can be supplied to the lprm command for removing a specific job), and the total size in blocks. Normally, only as much information as will fit on one line is displayed. Job ordering depends on the algorithm used to scan the spooling directory and is supposed to be FIFO (first-in-first-out). File names making up a job may be unavailable (when the lpr command is used as a sink in a pipeline). In this case, the file is indicated as - (standard input).
The display generated by the lpq command contains two entries for remote queues. The first entry contains the client's local queue and local device name and its status information. The second entry follows immediately; it contains the client's local queue name (again), followed by the remote queue name. Any jobs submitted to a remote queue are displayed first on the local side and are moved to the remote device as the job is processed on the remote machine.
Since the status commands communicate with remote machines, the status display may occasionally appear to hang while waiting for a response from the remote machine. The command will eventually time out if a connection cannot be established between the two machines.
|-l||Generates the long output format.|
|+ [ Number ]||Displays the spool queue until it empties. A Number variable is the time in seconds before the display regenerates.|
|-P Printer||Displays the spool queue for the printer specified by the Printer variable.|
To display a job number in the print queue lp0 , enter:
lpq -P lp0
This command displays a list similar to the following:
Queue Dev Status Job Files User PP % Blks CP Rnk lp0 dlp0 running 39 motd guest 10 83 12 1 1
|/usr/bin/lpq||Contains the lpq command.|
|/usr/sbin/qdaemon||Contains the queuing daemon.|
|/etc/qconfig||Contains the queue configuration file.|
|/etc/qconfig.bin||Contains the digested, binary version of the /etc/qconfig file.|
|/var/spool/lpd/qdir/*||Contains queue requests.|
|/var/spool/lpd/stat/*||Contains information on the status of the devices.|
|/var/spool/qdaemon/*||Contains temporary copies of enqueued files.|
The lpr command, lprm command, lpstat command, qchk command.
The qconfig file.
Checking Print Job Status in AIX Version 4.3 System User's Guide: Operating System and Devices.
Printers, Print Jobs, and Queues in AIX Version 4.3 System User's Guide: Operating System and Devices.
Spooler Overview for System Management in the AIX Version 4.3 Guide to Printers and Printing.