Attributes for changing queue manager configuration information

The attributes used to modify the configuration of an individual queue manager override any settings for IBM MQ .


On UNIX and Linux systems, you modify queue manager configuration information by editing the qm.ini configuration file. When you are defining a stanza in qm.ini, we do not need to start each item on a new line. We can use either a semicolon (;) or a hash character (#) to indicate a comment.

On Windows and Linux x86-64 systems, we can modify some configuration information by using the IBM MQ Explorer. However, because there are significant implications to changing installable services and their components, the installable services are read-only in the IBM MQ Explorer. You must therefore make any changes to installable services by using regedit on Windows, and by editing the qm.ini file on UNIX and Linux.


Procedure

For more details on changing queue manager configuration information, see the following subtopics:.

  • Automatic configuration of qm.ini at startup
    From IBM MQ Version 9.2.0, we can configure your queue manager to automatically apply the contents of a file, or set of files, containing qm.ini overrides, on every queue manager start.
  • AccessMode stanza of the qm.ini file
    Access Mode applies to Windows servers only. The AccessMode stanza of the qm.ini file is set by the -a [r] option on the crtmqm command. Do not change the AccessMode stanza after the queue manager has been created.
  • ApiExitLocal stanza of the qm.ini file
    For a server, use the Exits queue manager properties page from the IBM MQ Explorer, or the ApiExitLocal stanza of the qm.ini file to identify API exit routines for a queue manager. For a client, modify the ApiExitLocal stanza in the mqclient.ini file to identify API exit routines for a queue manager.
  • AutoCluster stanza of the qm.ini file
    Used when the queue manager starts to identify if the cluster is a member of an automatic cluster, and can identify the full repositories of the cluster.
  • AutoConfig stanza of the qm.ini file
    The attributes of the AutoConfig stanza are frequently used as part of setting up uniform clusters.
  • Channels stanza of the qm.ini file
    These attributes determine the configuration of a channel.
  • Connection stanza of the qm.ini file
    Use the Extended queue manager properties page from the IBM MQ Explorer, or the Connection stanza in the qm.ini file to specify the default bind type. Note that create a Connection stanza if we need one.
  • Diagnostic message logging
    The diagnostic message logs of IBM MQ are a mechanism, to allow various components of the IBM MQ system, to report diagnostic messages relating to IBM MQ configuration and runtime state changes and issues.
  • ExitPath stanza of the qm.ini file
    Use the Exits queue manager properties page from the IBM MQ Explorer, or the ExitPath stanza in the qm.ini file to specify the path for user exit programs on the queue manager system.
  • ExitPropertiesLocal stanza of the qm.ini file
    Use the Cluster queue manager properties page from the IBM MQ Explorer, or the ExitPropertiesLocal stanza in the qm.ini file, to specify information about exit properties on a queue manager. Alternatively, we can set it using the amqmdain command.
  • Filesystem stanza of the qm.ini file
    By default, only members of the mqm group can write directly to error log files and First Failure Data Capture files. We can use the Filesystem stanza to allow users who are not members of the mqm group to access error directories and files.
  • Log stanza of the qm.ini file
    Use the Log queue manager properties page from the IBM MQ Explorer, or the Log stanza in the qm.ini file, to specify information about logging on a queue manager.
  • LU62 stanza of the qm.ini file (Windows only)
    Use the LU6.2 queue manager properties page from the IBM MQ Explorer, or the LU62 stanza in the qm.ini file, to specify SNA LU 6.2 protocol configuration parameters. They override the default attributes for channels.
  • NETBIOS stanza of the qm.ini file (Windows only)
    Use the Netbios queue manager properties page from the IBM MQ Explorer, or the NETBIOS stanza in the qm.ini file, to specify NetBIOS protocol configuration parameters. They override the default attributes for channels.
  • RestrictedMode stanza of the qm.ini file
    This option applies to UNIX and Linux systems only. The RestrictedMode stanza is set by the -g option on the crtmqm command. Do not change this stanza after the queue manager has been created. If we do not use the -g option, the stanza is not created in the qm.ini file.
  • Security stanza of the qm.ini file
    Use the Security stanza in the qm.ini file to specify options for the Object Authority Manager (OAM).
  • Service stanza of the qm.ini file
    You change installable services on Windows by using regedit, and on UNIX and Linux by using the Service stanza in the qm.ini file.
  • ServiceComponent stanza of the qmi.ini file
    We must specify service component information when you add a new installable service. On Windows systems use regedit, and on UNIX and Linux systems use the ServiceComponent stanza in the qm.ini file. The authorization service stanza is present by default, and the associated component, the OAM, is active.
  • SPX stanza of the qm.ini file (Windows only)
    Use the SPX queue manager properties page from the IBM MQ Explorer, or the SPX stanza in the qm.ini file, to specify SPX protocol configuration parameters. They override the default attributes for channels.
  • SSL stanza of the qm.ini file
    Use the SSL stanza of the queue manager configuration file to configure TLS channels on your queue manager.
  • Subpool stanza of the qm.ini file
    This stanza is created by IBM MQ. Do not change it.
  • TCP stanza of the qm.ini file
    Use the TCP queue manager properties page from the IBM MQ Explorer, or the TCP stanza in the qm.ini file, to specify Transmission Control Protocol/Internet Protocol (TCP/IP) configuration parameters. They override the default attributes for channels.
  • TuningParameters stanza of the qm.ini file
    Use the TuningParameters stanza in the qm.ini file to specify options for tuning the queue manager.
  • Variables stanza of the qm.ini file
    Configuration variables for use with automatic uniform clusters.
  • XAResourceManager stanza of the qm.ini file
    Use the XA resource manager queue manager properties page from the IBM MQ Explorer, or the XAResourceManager stanza in the qm.ini file, to specify the following information about the resource managers involved in global units of work coordinated by the queue manager.

Parent topic: Change IBM MQ and queue manager configuration information


Related tasks


Related reference


Related information