IBM MQ configuration files

Technote (FAQ)


Question

Where does IBM MQ store configuration information, such as the list of installations on a system, the location of queue managers, settings for specific queue managers, and client application settings?

Answer

IBM MQ stores its configuration information in text files, except on Windows where it historically stored such information in the Windows registry. However, WebSphere MQ V7.0.1 and later releases have begun migrating data out of the Windows registry and into text files.



Accessing the Windows registry

In order to view, add, or modify registry keys and values on Windows, use the regedit.exe program which is part of the operating system.

IBM MQ ships a program called amquregn.exe which will display the values of all the MQ registry entries. The amquregn.ctl file, located in the MQ bin directory, tells it what registry keys to display. Run the amquregn program from the bin directory as suggested, or pass the full path to its control file:


    Running amquregn

    C:\Program Files (x86)\IBM\WebSphere MQ\bin> amquregn amquregn.ctl

    C:\> "C:\Program Files (x86)\IBM\WebSphere MQ\bin\amquregn" "C:\Program Files (x86)\IBM\WebSphere MQ\bin\amquregn.ctl"




IBM MQ installations

IBM MQ V8.0, WebSphere MQ V7.5 and V7.1 on Linux, UNIX and Windows allow allow multiple installations on a single operating system. The location and attributes of each installation is stored as follows:


    Linux and UNIX

    /etc/opt/mqm/mqinst.ini


    Windows

    HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\IBM\WebSphere MQ\Installation or
    HKEY_LOCAL_MACHINE\SOFTWARE\IBM\WebSphere MQ\Installation



IBM MQ queue managers

The list of queue managers, their locations, and some defaults for new queue managers are stored as follows:


    Linux and UNIX

    /var/mqm/mqs.ini


    Windows (IBM MQ V8.0, WebSphere MQ V7.1 and later releases)

    If you have only IBM MQ V8.0 or WebSphere MQ V7.1 or later installed, you must find the WebSphere MQ WorkPath by looking at its registry value or using amquregn. Note that "WorkPath" is case-sensitive:

    HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\IBM\WebSphere MQ\WorkPath or
    HKEY_LOCAL_MACHINE\SOFTWARE\IBM\WebSphere MQ\WorkPath


    Use amquregn to find the WorkPath value:

    C:\Program Files (x86)\IBM\WebSphere MQ_2\bin> amquregn amquregn.ctl | findstr WorkPath
        .."WorkPath"="C:\\Program Files (x86)\\IBM\\WebSphere MQ"
        ...."WorkPath"="C:\\Program Files (x86)\\IBM\\WebSphere MQ"


    Use the WorkPath (ignoring any doubled back-slashes) to locate the mqs.ini file:

    C:\Program Files (x86)\IBM\WebSphere MQ\mqs.ini


    Windows (WebSphere MQ V7.0 and previous releases)

    If you have WebSphere MQ V7.0 or older installed, then queue manager information is still held in the Windows registry. Later versions co-existing with WebSphere MQ V7.0.1 will store their information in the registry until WebSphere MQ V7.0.1 is uninstalled from the system:

    HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\IBM\MQSeries\CurrentVersion\Configuration or
    HKEY_LOCAL_MACHINE\SOFTWARE\IBM\MQSeries\CurrentVersion\Configuration



    IBM i

    /QIBM/UserData/mqm/mqs.ini




Queue manager configuration and status

Each queue manager has a pair of files which describes information such as the size, type, number, and location of its log files, tuning parameters, security information, and runtime status information. In order to find these files you must examine the QueueManager stanzas in the mqs.ini file, or for WebSphere MQ V7.0.1 and older releases, see the note below.

If you defined a multi-instance queue manager, the "DataPath" value gives the full path to the queue manager directory, where its configuration files are held. For regular queue managers, you must start with the "Prefix" directory, add a subdirectory named "qmgrs", then append the "Directory" value to find the queue manager. Please note that the directory names chosen by WebSphere MQ may differ slightly from the actual queue manager name.

IBM i does not support multi-instance queue managers and will not have a "DataPath" value. Queue managers on IBM i have an extra value called "Library", but it is not used to locate the queue manager directory and may be ignored.


    A regular queue manager on Linux or UNIX

    QueueManager:
        Name=UNIX.QMGR
        Prefix=/var/mqm
        Directory=UNIX!QMGR
        InstallationName=Installation1


    Configuration file: /var/mqm/qmgrs/UNIX!QMGR/qm.ini
    Status file: /var/mqm/qmgrs/UNIX!QMGR/qmstatus.ini


    A multi-instance queue manager on Linux or UNIX

    QueueManager:
        Name=MULTI/INSTANCE/QMGR
        Prefix=/var/mqm
        Directory=MULTI&INSTANCE&QMGR
        DataPath=/var/prod/shared/qmgrs/MULTI&INSTANCE&QMGR
        InstallationName=Production75


    Configuration file: /var/prod/shared/qmgrs/MULTI&INSTANCE&QMGR/qm.ini
    Status file: /var/prod/shared/qmgrs/MULTI&INSTANCE&QMGR/qmstatus.ini


    A regular queue manager on Windows

    QueueManager:
        Name=WINDOWS.QMGR
        Prefix=C:\Program Files (x86)\IBM\WebSphere MQ
        Directory=WINDOWS!QMGR
        InstallationName=Staging71


    Configuration file: C:\Program Files (x86)\IBM\WebSphere MQ\Qmgrs\WINDOWS!QMGR\qm.ini
    Status file: C:\Program Files (x86)\IBM\WebSphere MQ\Qmgrs\WINDOWS!QMGR\qmstatus.ini


    A multi-instance queue manager on Windows

    QueueManager:
        Name=MULTI/INSTANCE/QMGR
        Prefix=C:\Program Files (x86)\IBM\WebSphere MQ
        Directory=MULTI&INSTANCE&QMGR
        DataPath=D:\Staging\Shared\Qmgrs\MULTI&INSTANCE&QMGR
        InstallationName=Staging71


    Configuration file: D:\Staging\Shared\Qmgrs\MULTI&INSTANCE&QMGR\qm.ini
    Status file: D:\Staging\Shared\Qmgrs\MULTI&INSTANCE&QMGR\qmstatus.ini


    A queue manager on IBM i

    QueueManager:
        Name=IBM_I.QMGR
        Prefix=/QIBM/UserData/mqm
        Library=QMIBM_I.QM
        Directory=IBM_I.QMGR


    Configuration file: /QIBM/UserData/mqm/qmgrs/IBM_I.QMGR/qm.ini
    Status file: /QIBM/UserData/mqm/qmgrs/IBM_I.QMGR/qmstatus.ini




WebSphere MQ V7.0.1 on Windows stores information about multi-instance queue managers in the qm.ini and qmstatus.ini files as described above. Otherwise, WebSphere MQ V7.0.1 stores information about regular queue managers in the Windows registry, just as older WebSphere MQ versions did:


    WebSphere MQ V7.0.1 and older configuration information

    HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\IBM\MQSeries\CurrentVersion\Configuration\QueueManager\QMGRNAME or
    HKEY_LOCAL_MACHINE\SOFTWARE\IBM\MQSeries\CurrentVersion\Configuration\QueueManager\QMGRNAME


    WebSphere MQ V7.0.1 and older status information

    HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\IBM\MQSeries\CurrentVersion\Status\QueueManager\QMGRNAME or
    HKEY_LOCAL_MACHINE\SOFTWARE\IBM\MQSeries\CurrentVersion\Status\QueueManager\QMGRNAME




Client configuration

IBM MQ clients also have a configuration file which can control information such as the client channel table location, network options, and handling of message properties. This file may exist in several different places (or not at all) as described in the WebSphere MQ Information Center.


    Linux and UNIX

    /var/mqm/mqclient.ini


    Windows (IBM MQ V8.0, WebSphere MQ V7.1 and later releases)

    In IBM MQ V8.0 and WebSphere MQ V7.1 and later releases, the mqclient.ini location came from the WorkPath registry value:

    HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\IBM\WebSphere MQ\WorkPath or
    HKEY_LOCAL_MACHINE\SOFTWARE\IBM\WebSphere MQ\WorkPath


    Use amquregn to find the WorkPath value:

    C:\Program Files (x86)\IBM\WebSphere MQ_1\bin> amquregn amquregn.ctl | findstr WorkPath
        .."WorkPath"="C:\\Program Files (x86)\\IBM\\WebSphere MQ"
        ...."WorkPath"="C:\\Program Files (x86)\\IBM\\WebSphere MQ"


    Use the WorkPath (ignoring any doubled back-slashes) to locate the mqclient.ini file:

    C:\Program Files (x86)\IBM\WebSphere MQ\mqclient.ini


    Windows (WebSphere MQ V7.0 only)

    In WebSphere MQ V7.0 only, the mqclient.ini location came from the FilePath registry value:

    HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\IBM\WebSphere MQ\FilePath or
    HKEY_LOCAL_MACHINE\SOFTWARE\IBM\WebSphere MQ\FilePath


    Use amquregn to find the FilePath value:

    C:\Program Files (x86)\IBM\WebSphere MQ\bin> amquregn amquregn.ctl | findstr FilePath
        ...."FilePath"="C:\\Program Files (x86)\\IBM\\WebSphere MQ"


    Use the FilePath (ignoring any doubled back-slashes) to locate the mqclient.ini file:

    C:\Program Files (x86)\IBM\WebSphere MQ\mqclient.ini


    IBM i

    /QIBM/UserData/mqm/mqclient.ini




Versions of WebSphere MQ before V7.0 did not have the mqclient.ini file. WebSphere MQ clients could read a limited number of parameters (like the "KeepAlive" setting) from the following locations:

    Linux and UNIX

    /var/mqm/qm.ini


    Windows

    HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\IBM\MQSeries\CurrentVersion\Configuration or
    HKEY_LOCAL_MACHINE\SOFTWARE\IBM\MQSeries\CurrentVersion\Configuration


    IBM i

    WebSphere MQ did not support client applications running on IBM i prior to WebSphere MQ V7.1.

Product Alias/Synonym

WebSphere MQ WMQ

Rate this page:

(0 users)Average rating

Add comments

Document information


More support for:

WebSphere MQ
Configuration

Software version:

5.3, 6.0, 7.0, 7.1, 7.5, 8.0

Operating system(s):

AIX, HP-UX, IBM i, Linux, Solaris, Windows

Software edition:

All Editions

Reference #:

1621003

Modified date:

2014-05-23

Translate my page

Machine Translation

Content navigation