Commands Reference, Volume 4

qchk Command

Purpose

Displays the status of a print queue.

Syntax

qchk [ -A ] [ -L | -W ] [ -P Printer ] [ -# JobNumber ] [ -q ] [ -u UserName ] [ -w Delay ]

Description

The qchk command displays the current status information regarding specified print jobs, print queues, or users. Use the appropriate flag followed by the requested name or number to indicate specific status information. If you run the qchk command with no flags, the status of the default queue is returned.

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 qchk fast path to run this command.

Flags

-# JobNumber	Requests the status of the job number specified by the JobNumber variable. The qchk command looks for JobNumber on the default queue when the -#JobNumber flag is used alone. To search for JobNumber on all queues -# flag must be used with the -A flag. The -# flag may also be used in conjunction with the -P Queue flag. Notes: Specify the -P Queue to override the default destination printer. If jobs 1, 2, and 3 are in the printer queue, and you specify that you want the status of job 3 while job 1 is running, the status information will show job 1 and job 3, not only job 3. If you specify a job number that does not exist, the system displays the current job number on the queue instead of an error message.
-A	Requests the status of all queues.
-L	Specifies information be displayed in long-form mode. This flag cannot be used with the -W flag. If the -L flag and the -W flag are used simultaneously, the first one specified takes precedence.
-P Printer	Requests the status of the printer specified by the Printer variable.
-q	Requests the status of the default print queue.
-u UserName	Requests the status of all print jobs sent by the user specified by the UserName variable.
-W	Specifies information be displayed in wide-form mode with longer queue names, device names, and job numbers. Larger job number information is available on AIX 4.3.2 and later. This flag cannot be used with the -L flag. If the -L flag and the -W flag are used simultaneously, the first one specified takes precedence.
-w Delay	Updates requested status information at intervals, in seconds, as specified by the Delay variable until all print jobs are finished.

Examples

To display the default print queue, enter:
qchk -q

To display the long status of all queues until empty, while updating the screen every 5 seconds, enter:
qchk -A -L -w 5

To display the status for printer lp0, enter:
qchk -P lp0

To display the status for job number 123, enter:
qchk -# 123

To display the status of all print jobs while restricting the queue status to only printer lp0, enter:
qchk -A -P lp0

To display the wide status of the default print queue for AIX 4.2.1 or later, enter:
qchk -W -q

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

Spooler Overview for System Management in the AIX 5L Version 5.2 Guide to Printers and Printing.

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

The /etc/qconfig file.

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

Checking Print Job Status (qchk Command) in the AIX 5L Version 5.2 Guide to Printers and Printing.