i5/OS and UNIX systems

In WebSphere MQ for iSeries and WebSphere MQ on UNIX(R) systems, there are configuration files to hold basic configuration information about the WebSphere MQ installation.

There are two configuration files: one applies to the machine, the other applies to an individual queue manager.

WebSphere MQ configuration file

This holds information relevant to all of the queue managers on the WebSphere MQ system. The file is called mqs.ini . It is fully described in the WebSphere MQ System Administration Guide for WebSphere MQ for UNIX systems, and in the WebSphere MQ for iSeries V6 System Administration Guide for WebSphere MQ for iSeries.

Queue manager configuration file

The queue manager configuration file holds configuration information relating to one particular queue manager. The file is called qm.ini.

It is created during queue manager creation and may hold configuration information relevant to any aspect of the queue manager. Information held in the file includes details of how the configuration of the log differs from the default in WebSphere MQ configuration file.

The queue manager configuration file is held in the root of the directory tree occupied by the queue manager. On WebSphere MQ for Windows, the information is held in the registry. For example, for the DefaultPath attributes, the queue manager configuration files for a queue manager called QMNAME would be:

For UNIX systems:

/var/mqm/qmgrs/QMNAME/qm.ini

An excerpt of a qm.ini file follows. It specifies that the TCP/IP listener is to listen on port 2500, the maximum number of current channels is to be 200 and the maximum number of active channels is to be 100.

     TCP:
       Port=2500
     CHANNELS:
       MaxChannels=200
       MaxActiveChannels=100

In MQSeries(R) V5.2 and WebSphere MQ, you can specify a range of TCP/IP ports to be used by an outbound channel. One method is to use the qm.ini file to specify the start and end of a range of port values. The example below shows a qm.ini file specifying a range of channels:

     TCP:
       StrPort=2500
       EndPort=3000
     CHANNELS:
       MaxChannels=200
       MaxActiveChannels=100

If you specify a value for StrPort or EndPort then you must specify a value for both. The value of EndPort must always be greater than the value of StrPort.

The channel tries to use each of the port values in the range specified. When the connection is successful, the port value is the port that the channel then uses.

For i5/OS:

/QIBM/UserData/mqm/qmgrs/QMNAME/qm.ini

For more information about qm.ini files see Appendix B. Configuration file stanzas for distributed queuing.