Configuring queue manager error logs

You can configure the error logs generated by queue managers so that, for example, certain types of message are filtered out, or messages are only logged once in a specified time period.

About this task

The queue manager error message handling is provided by a service named QMErrorLog. By default this service logs messages for each queue manager in the directory mqerr:/qmgrs/queue_manager in the files AMQERR01.LOG, AMQERR02.LOG, and AMQERROR03.LOG. The log messages roll over from one file to the next when the file size reaches 32 MB.

This base queue manager logging service is controlled by a stanza in the qm.ini file of each queue manager. If the QMErrorLog service is unmodified, the default settings for the service are used and there is no actual stanza to view in qm.ini. You can use commands to create and edit stanzas to customize features such as message filtering and size of log files before they are rotated. You cannot edit the qm.ini file directly on the appliance.

Changes to the QMErrorLog service stanzas in qm.ini only take effect after the queue manager is restarted.

You can, if required, use the diagnostic message services to produce additional, more customized log files, see IBM MQ diagnostic message services. You can also send queue manager messages to an appliance log target, see Appliance log targets.

Procedure

To view the current settings of the QMErrorLog service for a particular queue manager, enter the following command:
```
dspmqini -m queue_manager -s QMErrorLog
```
To configure a stanza for a QMErrorLog service, enter the following command:
```
setmqini -m queue_manager -s QMErrorLog -n service_name -k key_name -v key_value
```
The possible options for the -k argument are:
- ExcludeMessages
- SuppressMessages
- SuppressInterval
- FileSize
See IBM MQ diagnostic message services for a fuller description of each key, and possible values.