Administer IBM MQ by using control commands
The control commands provide a way to perform a number of IBM MQ administration tasks on UNIX, Linux, and Windows.
To issue control commands, your user ID must be a member of the mqm group for most control commands. For more information about this, see Authority to administer IBM MQ on UNIX, Linux, and Windows. In addition, note the environment-specific information. for the platform, or platforms, your enterprise uses.
When using control commands that operate on a queue manager, we must use the command from the installation associated with the queue manager we are working with.
When using control commands that operate on a queue manager configured to use connection authentication with CHCKLOCL(REQUIRED), and a failure to connect is observed, either
- Supply a user ID and password if the control command allows this.
- Use MQSC equivalents of the control commands where those exist.
- Start the queue manager using the -ns option, while control commands that cannot connect need to be run.
For a full list of the control commands see, The IBM MQ control commands.
Use control commands on Windows systems
In IBM MQ for Windows, you enter control commands at a command prompt.
The control commands and their flags are not case-sensitive, but arguments to those commands, such as queue names and queue manager names, are case-sensitive.
For example, in the command:crtmqm /u SYSTEM.DEAD.LETTER.QUEUE jupiter.queue.manager
- The command name can be entered in uppercase or lowercase, or a mixture of the two. These are all valid: crtmqm, CRTMQM, and CRTmqm.
- The flag can be entered as -u, -U, /u, or /U.
- SYSTEM.DEAD.LETTER.QUEUE and jupiter.queue.manager must be entered exactly as shown.
Use control commands on UNIX and Linux systems
In IBM MQ for UNIX and Linux systems, you enter control commands in a shell window.
In UNIX environments, control commands, including the command name itself, the flags, and any arguments, are case-sensitive. For example, in the command:crtmqm -u SYSTEM.DEAD.LETTER.QUEUE jupiter.queue.manager
- The command name must be crtmqm, not CRTMQM.
- The flag must be -u, not -U.
- The dead-letter queue is called SYSTEM.DEAD.LETTER.QUEUE.
- The argument is specified as jupiter.queue.manager, which is different from JUPITER.queue.manager.
Take care to type the commands exactly as you see them in the examples.
Parent topic: Administer IBM MQ
Related information