IBM MQ configuration file, mqs.ini

The IBM® MQ configuration file, mqs.ini, contains information relevant to all the queue managers on the node. It is created automatically during installation.

Note: For more information on how and when to edit the mqs.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.

Directory locations

[UNIX] [Linux] On UNIX and Linux®, the data directory and log directory are always /var/mqm and /var/mqm/log respectively.

[Windows] On Windows systems, the location of the data directory mqs.ini, and the location of the log directory, are stored in the registry, as their location can vary. The installation configuration information, which is contained in mqinst.ini on UNIX and Linux systems, is also in the registry, as there is no mqinst.ini file on Windows (see Installation configuration file, mqinst.ini).

The mqs.ini file for Windows systems is given by the WorkPath specified in the HKLM\SOFTWARE\IBM\IBM MQ key. It contains:

The names of the queue managers
The name of the default queue manager
The location of the files associated with each of them

On IBM i, the mqs.ini file is stored in /QIBM/UserData/mqm. The file contains:

The names of the queue managers.
The name of the default queue manager.
The location of the files associated with each queue manager.
Information identifying any API exits (see Configuring API exits for more information).

In particular, the mqs.ini file is used to locate the data associated with each queue manager.

Example mqs.ini file for UNIX and Linux


#***********************************************************************#
#* Module Name: mqs.ini                                                *#
#* Type       : IBM MQ Machine-wide Configuration File                 *#
#* Function   : Define IBM MQ resources for an entire machine          *#
#***********************************************************************#
#* Notes      :                                                        *#
#* 1) This is the installation time default configuration              *#
#*                                                                     *#
#***********************************************************************#
AllQueueManagers:
#***********************************************************************#
#* The path to the qmgrs directory, below which queue manager data     *#
#* is stored                                                           *#
#***********************************************************************#
DefaultPrefix=/var/mqm

LogDefaults:
   LogPrimaryFiles=3
   LogSecondaryFiles=2
   LogFilePages=4096
   LogType=CIRCULAR
   LogBufferPages=0
   LogDefaultPath=/var/mqm/log

QueueManager:
   Name=saturn.queue.manager
   Prefix=/var/mqm
   Directory=saturn!queue!manager
   InstallationName=Installation1

QueueManager:
   Name=pluto.queue.manager
   Prefix=/var/mqm
   Directory=pluto!queue!manager
   InstallationName=Installation2

DefaultQueueManager:
   Name=saturn.queue.manager

ApiExitTemplate:
   Name=OurPayrollQueueAuditor
   Sequence=2
   Function=EntryPoint
   Module=/usr/ABC/auditor
   Data=123

ApiExitCommon:
   Name=MQPoliceman
   Sequence=1
   Function=EntryPoint
   Module=/usr/MQPolice/tmqp
   Data=CheckEverything

Example mqs.ini file for Windows


#***********************************************************************#
#* Module Name: mqs.ini                                                *#
#* Type       : IBM MQ Machine-wide Configuration File                 *#
#* Function   : Define IBM MQ resources for an entire machine          *#
#***********************************************************************#
#* Notes      :                                                        *#
#* 1) This is the installation time default configuration              *#
#*                                                                     *#
#***********************************************************************#
AllQueueManagers:
#***********************************************************************#
#* The path to the qmgrs directory, below which queue manager data     *#
#* is stored                                                           *#
#***********************************************************************#
DefaultPrefix=C:\ProgramData\IBM\MQ

LogDefaults:
   LogPrimaryFiles=3
   LogSecondaryFiles=2
   LogFilePages=4096
   LogType=CIRCULAR
   LogBufferPages=0
   LogDefaultPath=C:\ProgramData\IBM\MQ\log

QueueManager:
   Name=saturn.queue.manager
   Prefix=C:\ProgramData\IBM\MQ
   Directory=saturn!queue!manager
   InstallationName=Installation1

QueueManager:
   Name=pluto.queue.manager
   Prefix=C:\ProgramData\IBM\MQ
   Directory=pluto!queue!manager
   InstallationName=Installation2

DefaultQueueManager:
   Name=saturn.queue.manager

ApiExitTemplate:
   Name=OurPayrollQueueAuditor
   Sequence=2
   Function=EntryPoint
   Module=C:\usr\ABC\auditor
   Data=123

ApiExitCommon:
   Name=MQPoliceman
   Sequence=1
   Function=EntryPoint
   Module=C:\usr\MQPolice\tmpq
   Data=CheckEverything

Example mqs.ini file for IBM i


#***********************************************************************#
#* Module Name: mqs.ini                                                *#
#* Type       : IBM MQ Configuration File                              *#
#* Function   : Define IBM MQ resources for the node                   *#
#*                                                                     *#
#***********************************************************************#
#* Notes      :                                                        *#
#* 1) This is an example IBM MQ configuration file                     *#
#*                                                                     *#
#***********************************************************************#
AllQueueManagers:
#***********************************************************************#
#* The path to the qmgrs directory, within which queue manager data    *#
#* is stored                                                           *#
#***********************************************************************#
DefaultPrefix=/QIBM/UserData/mqm

QueueManager:
Name=saturn.queue.manager
Prefix=/QIBM/UserData/mqm
Library=QMSATURN.Q
Directory=saturn!queue!manager

QueueManager:
Name=pluto.queue.manager
Prefix=/QIBM/UserData/mqm
Library=QMPLUTO.QU
Directory=pluto!queue!manager

DefaultQueueManager:
Name=saturn.queue.manager

Notes:

IBM MQ on the node uses the default locations for queue managers and the journals.
The queue manager saturn.queue.manager is the default queue manager for the node. The directory for files associated with this queue manager has been automatically transformed into a valid file name for the file system.
Because the IBM MQ configuration file is used to locate the data associated with queue managers, a nonexistent or incorrect configuration file can cause some or all IBM MQ commands to fail. Also, applications cannot connect to a queue manager that is not defined in the IBM MQ configuration file.

mqs.ini stanzas

Attention: This topic links to more information about the stanzas in the mqs.ini file. Each stanza contains information on the parameters in that stanza.