Change configuration information on UNIX, Linux, and Windows

On UNIX, Linux , and Windows, we can change the IBM MQ configuration attributes that are held in configuration files, at the level of the node and of the queue manager.


On UNIX, Linux, and Windows platforms, we can change IBM MQ configuration attributes within the following files:

  • An IBM MQ configuration file (mqs.ini) to effect changes for IBM MQ on the node as a whole. There is one mqs.ini file for each node. For more information on the stanzas included in mqs.ini, see Attributes for changing IBM MQ configuration information.
  • A queue manager configuration file (qm.ini) to effect changes for specific queue managers. There is one qm.ini file for each queue manager on the node. For more information on the stanzas included in qm.ini, see Change queue manager configuration information.

Client configuration options are held separately, in the client configuration file, generally named mqclient.ini. For more information, see Configure a client using a configuration file.

A configuration file (or stanza file) contains one or more stanzas, which are groups of lines in the .ini file that together have a common function or define part of a system, such as log functions, channel functions, and installable services.

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 MQSC commands to fail. Also, applications cannot connect to a queue manager that is not defined in the IBM MQ configuration file.

Important: Any changes you make to a configuration file usually do not take effect until the next time the queue manager is started.


Procedure

  • Before editing a configuration file, back it up so that we have a copy that we can revert to, if the need arises.
  • Edit the configuration files using commands or a standard text editor. For more information, see Editing configuration files.
  • On Windows and Linux (x86 and x86-64) systems use IBM MQ Explorer to make changes to the configuration files. For more information, see Configure IBM MQ using MQ Explorer.
  • On Windows systems, as an alternative to using IBM MQ Explorer, use the amqmdain command to make changes to the configuration files. For more information, see amqmdain.