IBM MQ - Delete installation name (dltmqinst command / mqinst.ini)

by
Jeremy Canfield |
Updated: October 02 2023
| IBM MQ articles
If you are not familiar with what IBM MQ (message queue) is, check out our Getting Started page. This assumes you have installed MQ server.
On Linux, the /etc/opt/mqm/mqinst.ini file contains information about each installation of MQ server. On Windows, the information is stored in the registry. Following is an example of what would be in the mqinst.ini file.
Installation:
Name=Installation1
Description=
Identifier=1
FilePath/opt/mqm
Primary:
Name=Installation1
Installation name
Once the installation name has been defined, it cannot be changed.
- The dspmqinst command can be used to display information about an installation. By default, the first installation will have a name of "Installation1".
- The crtmqinst command can be used to defined an installation name for for additional installations.
- The setmqinst command can be used to update the mqinst.ini file to set an installation as the primary installation.
- The dltmqinst command can be used to delete an installation from the mqinst.ini file.
The dltmqinst command can be used to delete an installation, such as "Installation2". You would also need to use the -p option followed by the root directory of the installation or the -n option followed by the name of the installation, like this.
dltmqinst -p /opt/mqm2
dltmqinst -n Installation2
Did you find this article helpful?
If so, consider buying me a coffee over at