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.

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

On UNIX 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

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

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.