Delete a queue manager

We can delete a queue manager using the dltmqm command. Alternatively, on Windows and Linux systems, we can use the IBM MQ Explorer to delete a queue manager.

Before starting

• Delete 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.
• 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; we are not told that the queue manager has been deleted.
• Delete a cluster queue manager does not remove it from the cluster. For more information, see the usage notes in dltmqm.

About this task

We can delete a queue manager by using the dltmqm 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 Set up security on UNIX, Linux, and Windows.)

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: We must use the dltmqm command from the installation associated with the queue manager that we are working with. We 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