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 could also use the System Management Interface Tool (SMIT) smit qadm fast path to run this command.

Flags

Table 1. Flags
Item	Description
-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 that hangs up in the queue.
-K `Printer`	Brings down the printer that 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
-U `Printer`	Brings up the printer that 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 executed 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 canceled.

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

Security

Attention RBAC users: This command can perform privileged operations. Only privileged users can run privileged operations. For more information about authorizations and privileges, see Privileged Command Database in Security. For a list of privileges and the authorizations that are associated with this command, see the lssecattr command or the getcmdattr subcommand.

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

Table 2. Files
Item	Description
/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.