Commands Reference, Volume 1

chque Command

Purpose

Changes the queue name.

Syntax

chque -q Name [ -a 'Attribute=Value' ... ]

Description

The chque command changes the queue name by changing the stanza in the qconfig file specified by the -q flag. Within that stanza, each attribute that matches one of the Attribute = Value pairs given on the command line will be replaced by the one on the command line. If no match is found, the Attribute = Value pair is added to the end of the stanza. The device attribute cannot be changed.

You can use the Printer Queues application in Web-based System Manager (wsm) to change printer queue characteristics. You could also use the System Management Interface Tool (SMIT) smit chque fast path to run this command.

Note: Do not edit the qconfig file while there are active jobs in any queue. Editing includes both manual editing and use of the chque, mkque, rmque, mkquedev, rmquedev, or chquedev commands. It is recommended that all changes to the qconfig file be made using these commands. However, if manual editing is desired, first issue the enq -G command to bring the queuing system and the qdaemon to a halt after all jobs are processed. Then edit the qconfig file and restart the qdaemon with the new configuration.

Flags

-a 'Attribute = Value'	Specifies the 'Attribute = Value' to be added or replaced by the one entered on the command line. For a list of valid attributes, refer to the /etc/qconfig file.
-q Name	Specifies the current Name of the queue and of the stanza in the qconfig file that is to be changed.

Examples

To change the name of the host to fred for queue lp0, enter:

chque -qlp0 -a 'host = fred'

Files

/usr/bin/chque	Contains the chque command.
/etc/qconfig	Contains the configuration file.

Related Information

The chquedev command, lsque command, mkque command, rmque command.

The qconfig file.

For information on installing the Web-based System Manager, see Chapter 2: Installation and System Requirements in AIX 5L Version 5.2 Web-based System Manager Administration Guide.

Changing / Showing Queue Characteristics in AIX 5L Version 5.2 Guide to Printers and Printing.

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

Printer-Specific Information in AIX 5L Version 5.2 Guide to Printers and Printing.

Printer Support in AIX 5L Version 5.2 Guide to Printers and Printing.

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

Virtual Printer Definitions and Attribute in AIX 5L Version 5.2 Guide to Printers and Printing.

Printer Colon File Conventions in AIX 5L Version 5.2 Guide to Printers and Printing.