qadm Command

AIX Version 4.3 Commands Reference, Volume 4

qadm Command

Purpose

Performs system administration functions for the printer spooling system.

Syntax

qadm { -G } | { [ -D Printer ] [ -K Printer ] [ -U Printer ] [ -X Printer ] }

Description

The qadm command is a front-end command to the enq command. This command brings printers, queues, and the spooling system up or down and also cancels jobs. The qadm command translates the requested flags into a format that can be run by the enq command.

The qadm command works only on local print jobs. Remote print is not supported.

Note: You must either have root user authority or belong to the printq group to run this command.

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

Flags

-D Printer	Brings down the printer you name in the Printer variable. The qdaemon process stops sending jobs to the device. Entering the qchk -P Printer command, where Printer matches the Printer variable in the -D flag, reports the device is down. The qadm command allows current jobs to finish before stopping the printer.
-G	Gracefully brings down the queuing system. This flag temporarily interrupts the qdaemon process after all currently running jobs on all queues are finished. Use of this flag is the only way to bring the system down without causing such problems as jobs hanging up in the queue.
-K Printer	Brings down the printer you name in the Printer variable, ending all current jobs immediately. Jobs remain in the queue and run again when the printer is brought back up.
-U Printer	Brings up the printer you name in the Printer variable. The qdaemon process sends jobs to the printer again. Entering the qchk -P Printer command, where Printer matches the Printer variable in the -U flag, reports the device is ready.

-X Printer

Cancels all the jobs of the user that excuted the command. If you have root user privileges or are a member of the printq group, then all jobs on the queue system will be cancelled.

Note: When -U and -D flags are used together, the -U flag has higher priority.

Examples

To bring the queuing system down gracefully, enter:
```
qadm -G
```
To cancel all of a particular user's jobs on printer lp0 , or all jobs on printer lp0 if you are have root user authority, enter:
```
qadm -X lp0
```
To bring up the printer lpd0 attached to queue lp0 , enter:
```
qadm -U lp0:lpd0
```

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, qcan command, qdaemon command, qchk command, qpri command, qprt command.

The /etc/qconfig file.

Starting and Stopping a Print Queue in the AIX Version 4.3 Guide to Printers and Printing.

Spooler Overview for System Management in the AIX Version 4.3 Guide to Printers and Printing.

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