chque Command

AIX Version 4.3 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 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 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.

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

Changing / Showing Queue Characteristics in AIX Version 4.3 Guide to Printers and Printing.

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

Printer-Specific Information in AIX Version 4.3 Guide to Printers and Printing.

Printer Support in AIX Version 4.3 Guide to Printers and Printing.

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

Virtual Printer Definitions and Attribute in AIX Version 4.3 Guide to Printers and Printing.

Printer Colon File Conventions in AIX Version 4.3 Guide to Printers and Printing.