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 Printer Queues application in Web-based System Manager (wsm) to change printer characteristics.

You could also use the System Management Interface Tool (SMIT) smit qadm fast path to run this command.

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 hanging 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 and Trusted AIX® 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 associated with this command, see the lssecattr command or the getcmdattr subcommand.

Examples

  1. To bring the queuing system down gracefully, enter:

    qadm  -G

  2. 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

  3. To bring up the printer lpd0 attached to queue lp0, enter:

    qadm  -U lp0:lpd0

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.