qchk Command

AIX Version 4.3 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 Web-based System Manager Printer Queues application (wsm printers fast path) to run this command. 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.
-W	Specifies information be displayed in wide-form mode with longer queue and device names. 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. This flag only applies to AIX Version 4.2.1 or later.
-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 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 Version 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 Version 4.3 Guide to Printers and Printing.

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

The /etc/qconfig file.

Setting up and running Web-based System Management in AIX Version 4.3 System Management Guide: Operating System and Devices.

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