[UNIX, Linux, Windows, IBM i]

QMErrorLog stanza

You use the queue manager error log stanza QMErrorLog in the qm.ini file to tailor the operation and contents of IBM® MQ error logs.

The QMErrorLog service is the traditional IBM MQ diagnostics logging service used to output diagnostics messages pertaining to the queue manager. The QMErrorLog service runs continuously and cannot be turned off, but can be customized to some extent.

You can use the QMErrorLog stanza in the qm.ini file to exclude certain messages from being written to the queue manager error log. You can also suppress messages from being written to the error log for a given interval of time.

[Windows][Linux]Alternatively, instead of editing the qm.ini file directly, you can use the Extended Queue Manager properties page in IBM MQ Explorer to exclude and suppress messages with the Excluded messages, Suppressed messages and Suppressed messages interval attributes.

Attention:
  • [Windows]You can use IBM MQ Explorer to make the changes only if you are using a local queue manager on the Windows platform.
  • The QMErrorLog stanza is not applicable to the IBM MQ system configuration file, mqs.ini, or the client configuration file, generally named mqclient.ini.

The following attributes can be included in the QMErrorLog stanza:

ErrorLogSize= maxsize
Specifies the size of the queue manager error log which it is copied to the backup. maxsize must be in the range 32768 through 2147483648 bytes. If ErrorLogSize is not specified, the default value of 33554432 bytes (32 MB) is used.

You can use this attribute to reduce the maximum size back to the previous maximum of 2 MB, if required.

You can set the size of the log using the MQMAXERRORLOGSIZE environment variable.

ExcludeMessage= msgIds
Specifies messages that are not to be written to the queue manager error log.
See ExcludeMessage in Diagnostic message service stanzas for more information.
SuppressMessage= msgIds
Specifies messages that are written to the queue manager error log once only in a specified time interval. If the same message ID is specified in both SuppressMessage and ExcludeMessage, the message is excluded.
This option is not applicable to diagnostic message services defined in mqclient.ini. For more information, see SuppressMessage in Diagnostic message service stanzas.
SuppressInterval= length
Specifies the time interval, in seconds, in which messages specified in SuppressMessage are written to the queue manager error log once only. length must be in the range 1 through 86400 seconds. If SuppressInterval is not specified, the default value of 30 seconds is used.

Example stanza

      
QMErrorLog:
   ErrorLogSize=262144
   ExcludeMessage=7234
   SuppressMessage=9001,9002,9202
   SuppressInterval=30