QMErrorLog stanza on UNIX, Linux, and Windows
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.
We can use the QMErrorLog stanza in the qm.ini file to exclude certain messages from being written to the queue manager error log. We can also suppress messages from being written to the error log for a given interval of time.
Alternatively, instead of editing the qm.ini file directly, we 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:
- We can use IBM MQ Explorer to make the changes only if we 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.
We can use this attribute to reduce the maximum size back to the previous maximum of 2 MB, if required.
We can set the size of the log using the MQMAXERRORLOGSIZE attribute in the mq.ini file.
- ExcludeMessage= msgIds
- Specifies messages that are not to be written to the queue manager error log.
- 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.
- 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.
Parent topic: Diagnostic message logging
Related concepts
Related reference