Error log directories on UNIX, Linux, and Windows
IBM® MQ uses a number of error logs to capture messages concerning its own operation of IBM MQ, any queue managers that you start, and error data coming from the channels that are in use. The location of the error logs depends on whether the queue manager name is known and whether the error is associated with a client.
The location the error logs are stored in depends on whether the queue manager name is known and
whether the error is associated with a client. MQ_INSTALLATION_PATH
represents the high level directory where IBM MQ is
installed.
- If the queue manager name is known, the location of the error log is shown in Table 1.
Table 1. Queue manager error log directory Platform Directory UNIX and Linux® systems /var/mqm/qmgrs/ qmname /errors
Windows systems MQ_INSTALLATION_PATH
\QMGRS\ qmname \ERRORS\AMQERR01.LOG - If the queue manager name is not known, the location of the error log is shown in Table 2.
Table 2. System error log directory Platform Directory UNIX and Linux systems /var/mqm/errors
Windows systems MQ_INSTALLATION_PATH
\QMGRS\@SYSTEM\ERRORS\AMQERR01.LOG - If an error has occurred with a client application, the location of the error log on the client
is shown in Table 3.
Table 3. Client error log directory Platform Directory UNIX and Linux systems /var/mqm/errors
Windows systems MQ_DATA_PATH\ERRORS\AMQERR01.LOG
In IBM MQ for Windows, an indication of the error is also added to the Application Log, which can be examined with the Event Viewer application provided with Windows systems.
Early errors
There are a number of special cases where these error logs have not yet been established and an error occurs. IBM MQ attempts to record any such errors in an error log. The location of the log depends on how much of a queue manager has been established.
If, because of a corrupt configuration file for example, no location information can be
determined, errors are logged to an errors directory that is created at installation time on the
root directory ( /var/mqm
or C:\Program Files\IBM\MQ
).
If IBM MQ can read its configuration information, and
can access the value for the Default Prefix, errors are logged in the errors subdirectory of the
directory identified by the Default Prefix attribute. For example, if the default prefix is
C:\Program Files\IBM\MQ
, errors are
logged in C:\Program Files\IBM\MQ\errors
.
For further information about configuration files, see Changing IBM MQ and queue manager configuration information.