WebSphere MQ error logs

Technote (troubleshooting)


Problem(Abstract)

Directions to find WebSphere MQ and MQSeries error logs.

Resolving the problem

The messages that are recorded in the error logs and job logs are the most important information that you can provide when reporting an MQ problem.

Select one of the following platforms to find the location of the MQ error logs:

HP NSS
i5/OS
OpenVMS
UNIX and Linux
VSE
Windows
z/OS


HP NSS
The WebSphere MQ for HP NSS error logs are located in the following directories:


/var/mqm/errors
/var/mqm/qmgrs/<qmname>/errors

The error log files are named; AMQERR01.LOG, AMQERR02.LOG and AMQERR03.LOG.

Notes:

  • If the queue manager name is not known then the error message is written to an error log file in the errors subdirectory. For example, if the default prefix is /usr/ibm/wmq/GA/var/mqm, the error message is written to an error log file in the directory /usr/ibm/wmq/GA/var/mqm/errors
  • If the queue manager name is known, then the error message is written to an error log file in the queue manager’s errors directory.


i5/OS
The WebSphere MQ for i5/OS error logs are located in the following directories:

/QIBM/UserData/mqm/errors
/QIBM/UserData/mqm/qmgrs/<queueManagerName>/errors
/QIBM/UserData/mqm/qmgrs/&SYSTEM/errors (not used at V6 and higher)

The error log files are named; AMQERR01.LOG, AMQERR02.LOG and AMQERR03.LOG.
OpenVMS
The WebSphere MQ HP OpenVMS error logs are located in the following directories:


MQS_ROOT:[MQM.ERRORS]AMQERR01.LOG
MQS_ROOT:[MQM.QMGRS.QMgrName.ERRORS]AMQERR01.LOG
MQS_ROOT:[MQM.QMGRS.$SYSTEM.ERRORS]AMQERR01.LOG
- The error log files are named; AMQERR01.LOG, AMQERR02.LOG and AMQERR03.LOG.

MQS_ROOT:[MQM.ERROR]VMSERR.LOG

Notes:

  • If an error has occurred with a client application: MQS_ROOT:[MQM.ERRORS]AMQERR01.LOG
  • If the queue manager name is known and the queue manager is available: MQS_ROOT:[MQM.QMGRS.QMgrName.ERRORS]AMQERR01.LOG
  • If the queue manager is not available: MQS_ROOT:[MQM.QMGRS.$SYSTEM.ERRORS]AMQERR01.LOG



UNIX and Linux
The WebSphere MQ for UNIX error logs are located in the following directories:


/var/mqm/errors
/var/mqm/qmgrs/<queueManagerName>/errors
/var/mqm/qmgrs/@SYSTEM/errors (not used at V6 and higher)

The error log files are named; AMQERR01.LOG, AMQERR02.LOG and AMQERR03.LOG.

+ Note about Multi-Instance queue managers.
The error logs for a multi-instance queue manager are located in subdirectory "errors" of the directory mentioned in the "DataPath" specified in the stanza for the queue manager in the /var/mqm/mqs.ini file, which can be obtained by the MQ utility "dspmqinf".

For example, the dspmqinf output for queue manager named QMGRMI:

$ dspmqinf QMGRMI

QueueManager:
Name=QMGRMI
Directory=QMGRMI
Prefix=/var/mqm
DataPath=/701MI/qmdata/QMGRMI
.
The error logs will be located in the subdirectory
/701MI/qmdata/QMGRMI/errors




VSE
MQSeries uses the SYSTEM.LOG queue defined in the global system definition as its primary message log and additional informational messages are output to the VSE console. Typically, these detail starting, stopping, and initializing MQSeries for VSE If the SYSTEM.LOG queue is unavailable, the messages are directed to the CICS CSMT log.

These messages should always be reviewed carefully for any error messages. The type of messages included in the SYSTEM.LOG queue can now be controlled by using the ’Log and Trace Settings’.

Refer to the MQSeries for VSE System Management Guide, “Queue Manager Log and Trace Settings” on page 74 for details. Note that the types of messages put to the SYSTEM.LOG queue can be controlled
using the LOG SETTINGS. When trying to resolve problems, ensure that all messages of all severity are
selected to be logged. You can view the contents of the system log using the Master Terminal transaction (MQMT) option 4 (Browse Queue Records).


Windows
The WebSphere MQ for Windows error logs are located in the following directories.
This is the default directory path, however it may have been changed at install time.

c:\Program Files\IBM\WebSphere MQ\errors
c:\Program Files\IBM\WebSphere MQ\qmgrs\<queueManagerName>\errors
c:\Program Files\IBM\WebSphere MQ\qmgrs\@SYSTEM\errors (not used at V6 and higher)

The error log files are named; AMQERR01.LOG, AMQERR02.LOG and AMQERR03.LOG.

+ Note about Multi-Instance queue managers.
The error logs for a multi-instance queue manager are located in subdirectory "errors" of the
directory mentioned in the "DataPath" specified in the stanza for QueueManager using the
dspmqinf command.

For example, the dspmqinf output for queue manager named TEST:

dspmqinf TEST

QueueManager:
Name=TEST
Directory=TEST
Prefix=C:\Program Files\IBM\WebSphere MQ
DataPath=share\\data\\TEST

If share is \\wmq.ibm.com\MQHA in the UNC format, the error logs will be located in path:\\wmq.ibm.com\MQHA\data\TEST\errors



z/OS
The WebSphere MQ for OS/390 and z/OS job logs are located in the following:

Syslog
MSTR job log
CHIN job log

The job logs are named; xxxxMSTR, and xxxxCHIN. Where xxxx is the WMQ subsystem identifier (ssid).

Product Alias/Synonym

WMQ WebSphere MQ

Rate this page:

(0 users)Average rating

Add comments

Document information


More support for:

WebSphere MQ
Documentation

Software version:

5.3, 5.3.1, 6.0, 7.0, 7.1, 7.5

Operating system(s):

AIX, HP-UX, IBM i, Linux, OpenVMS, Solaris, Tandem NSK, VSE, Windows, z/OS

Reference #:

1172370

Modified date:

2013-02-18

Translate my page

Machine Translation

Content navigation