Deleting a queue manager

You can delete a queue manager using the dltmqm command or by using the WebSphere® MQ Explorer.

Before you begin

Stop the queue manager.

Procedure

Issue the following command: dltmqm QMB
Note: You must use the dltmqm command from the installation associated with the queue manager that you are working with. You can find out which installation a queue manager is associated with using the dspmq -o installation command.

Steps for deleting a queue manager

About this task

On WebSphere MQ for Windows and WebSphere MQ for Linux® (x86 and x86-64 platforms) systems, you can delete a queue manager as follows:

Procedure

  1. Open the WebSphere MQ Explorer.
  2. In the Navigator view, select the queue manager.
  3. If the queue manager is not stopped, stop it.
    1. Right-click the queue manager.
    2. Click Stop.
  4. Right-click the queue manager.
  5. Click Delete.

Results

The queue manager is deleted.
Attention:
  • Deleting a queue manager is a drastic step, because you also delete all resources associated with the queue manager, including all queues and their messages and all object definitions. If you use the dltmqm command, there is no displayed prompt that allows you to change your mind; when you press the Enter key all the associated resources are lost.
  • In WebSphere MQ for Windows, deleting a queue manager also removes the queue manager from the automatic startup list (described in Starting a queue manager). When the command has completed, a WebSphere MQ queue manager ending message is displayed; you are not told that the queue manager has been deleted.
  • Deleting a cluster queue manager does not remove it from the cluster. See the note in the description of dltmqm for more information.

For a description of the dltmqm command and its options, see dltmqm. Ensure that only trusted administrators have the authority to use this command. (For information about security, see Setting up security on UNIX, UNIX and Linux systems .)