Deleting a queue manager

You can delete a queue manager using the dltmqm control command. Alternatively, on Windows and Linux® systems, you can use the IBM® MQ Explorer to delete a queue manager.

Before you begin

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 control 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.
On 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, an IBM 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. For more information, see the usage notes in dltmqm.

About this task

You can delete a queue manager by using the dltmqm control command. 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 AIX®, Linux, and Windows.)

[Windows] [Linux] Alternatively, on Windows and Linux (x86 and x86-64 platforms) systems, you can delete a queue manager by using the IBM MQ Explorer.

Procedure

To delete a queue manager by using the dltmqm command, complete the following steps:
1. Stop the queue manager.
2. 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.
To delete a queue manager by using the IBM MQ Explorer, complete the following steps:
1. Open the IBM MQ Explorer.
2. In the Navigator view, select the queue manager.
3. If the queue manager is not stopped, stop it.
  To stop the queue manager, right-click it and then click Stop.
4. Delete the queue manager.
  To delete the queue manager, right-click it and then click Delete.

Results

The queue manager is deleted.