Commands Reference, Volume 4

qhld Command

Purpose

Holds and releases a spooled print job.

Syntax

qhld [ -r ] { -#JobNumber [ -PQueue ] | -PQueue | -uUser [ -PQueue ] }

Description

The qhld command holds print jobs in a spooled state. The job to be held is designated by job number, queue, or user name. The -r flag releases the hold on the print job.

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 hold 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 hold job number 2123, specifying qhld -# 123, causes the qdaemon to hold 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 hold a specific job number.

Flags

-#JobNumber	Specifies the print job number to be held.
-PQueue	Specifies the print queue to be held.
-r	Releases the print job by number, queue, or user name.
-uUser	Specifies the name of user whose print jobs are to be held.

Examples

To hold the print job number 300, enter:
```
qhld -#300
```
To hold all print jobs on queue lp0, enter:
```
qhld -P lp0
```
To hold all jobs that belong to user fred, enter:
```
qhld -u fred
```
To release job number 300, enter:
```
qhld -#300 -r
```
To release all the jobs on queue lp0, enter:
```
qhld -Plp0 -r
```
To release all jobs that belong to user fred, enter:
```
qhld -u fred -r
```

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 qprt command, qmov command, enq command,

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

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