Delete a multi-instance queue manager
On Multiplatforms, to delete a multi-instance queue manager completely, we use the dltmqm command to delete the queue manager, and then remove instances from other servers using either the rmvmqinf or dltmqm commands.
Run the dltmqm command to delete a queue manager that has instances defined on other servers, on any server where that queue manager is defined. You do not need to run the dltmqm command on the same server that you created it on. Then run the rmvmqinf or dltmqm command on all the other servers which have a definition of the queue manager.
We can only delete a queue manager when it is stopped. At the time you delete it no instances are running, and the queue manager, strictly speaking, is neither a single or a multi-instance queue manager; it is simply a queue manager that has its queue manager data and logs on a remote share. When you delete a queue manager, its queue manager data and logs are deleted, and the queue manager stanza is removed from the mqs.ini file on the server on which we issued the dltmqm command. We need to have access to the network share containing the queue manager data and logs when you delete the queue manager.
On other servers where you have previously created instances of the queue manager there are also entries in the mqs.ini files on those servers. We need to visit each server in turn, and remove the queue manager stanza by running the command rmvmqinf Queue manager stanza name.
On UNIX and Linux systems, if you have placed a common mqs.ini file in network storage and referenced it from all the servers by setting the AMQ_MQS_INI_LOCATION environment variable on each server, then we need to delete the queue manager from only one of its servers as there is only one mqs.ini file to update.
Example
- First server
- dltmqm QM1
- Other servers where instances are defined
- rmvmqinf QM1 , or
Parent topic: Multi-instance queue managers