[AIX, Linux, Windows]

Queue manager configuration files, qm.ini

A queue manager configuration file, qm.ini, contains information relevant to a specific queue manager.

There is one queue manager configuration file for each queue manager. The qm.ini file is automatically created when the queue manager with which it is associated is created.

Note: For more information on how and when to edit a qm.ini file and on when any changes that you make to the file take effect, see Changing IBM MQ configuration information in .ini files on Multiplatforms.

From IBM MQ 9.0.4 and IBM MQ 9.0.0 Fix Pack 2, the strmqm command checks the syntax of the CHANNELS and SSL stanzas in the qm.ini file before starting the queue manager fully, which makes it much easier to see what is wrong, and correct it quickly if strmqm finds that the qm.ini file contains any errors. For more information, see strmqm.

Location of the qm.ini files

[AIX][Linux]On AIX® and Linux® systems, a qm.ini file is held in the root of the directory tree occupied by the queue manager. For example, the path and the name for a configuration file for a queue manager called QMNAME is:

/var/mqm/qmgrs/QMNAME/qm.ini
[Windows]On Windows systems, the location of the qm.ini file is given by the WorkPath specified in the HKLM\SOFTWARE\IBM\WebSphere MQ key. For example, the path and the name for a configuration file for a queue manager called QMNAME is as follows:

C:\ProgramData\IBM\MQ\qmgrs\QMNAME\qm.ini
[IBM i]A qm.ini file is held in the mqmdata directory/QMNAME/qm.ini, where mqmdata directory is /QIBM/UserData/mqm by default and QMNAME is the name of the queue manager to which the initialization file applies.
Note: You can change the mqmdata directory in the mqs.ini file.

The queue manager name can be up to 48 characters in length. However, this does not guarantee that the name is valid or unique. Therefore, a directory name is generated based on the queue manager name. This process is known as name transformation. For a description, see IBM MQ file names and Object names on IBM i.

qm.ini stanzas

Attention:
  • This topic links to more information about the stanzas in the qm.ini file. Each stanza contains information on the parameters in that stanza, including an example where appropriate.
  • Each stanza shows the platform, or platforms, of IBM MQ for Multiplatforms to which that stanza applies.