FreeKB - primary installation (setmqinst command / mqinst.ini)
IBM MQ - primary installation (setmqinst command / mqinst.ini)

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.

 


Unset Primary Installation

The setmqinst command updates the mqinst.ini file. The -x option unsets an installation as the primary installation. You should always unset an installation before setting an installation as the primary installation. You would also need to use the -p option followed by the root directory of the primary installation or the -n option followed by the name of the installation, like this.

setmqinst -x -n Installation1
setmqinst -x -p /opt/mqm

 


Set Primary Installation

The -i option sets an installation as the primary installation. After unsettting an installation, you will need to provided the full path to the setmqinst command, or update the PATH variable to contain the full path to the setmqinst command. You would also need to use the -p option followed by the root directory of the primary installation or the -n option followed by the name of the installation, like this.

/opt/mqm/bin/setmqinst -i -n Installation2
/opt/mqm/bin/setmqinst -i -p /opt/mqm2

 


Description

Optionally, the -d option can be use to define "description" in the mqinst.ini file. You would also need to use the -p option followed by the root directory of the primary installation or the -n option followed by the name of the installation, like this.

setmqinst -d "Installation 2" -n Installation2

 



Add a Comment




We will never share your name or email with anyone. Enter your email if you would like to be notified when we respond to your comment.




Please enter ca1c7 in the box below so that we can be sure you are a human.




Comments