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.

Recommendation: To edit the /etc/qconfig file, use the chque, mkque, rmque, chquedev, mkquedev, and rmquedev commands or SMIT. Further, it is recommended to run these commands during slow or off-peak time.
If manual editing of the /etc/qconfig file is necessary, you can first issue the enq -G command to bring the queuing system and the qdaemon to a halt after all jobs are processed. Then you can edit the /etc/qconfig file and restart the qdaemon with the new configuration.

Flags

Item Description
-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.

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

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

chque  -qlp0  -a 'host = fred'

Files

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