IBM Support

IBM MQ for z/OS joblogs / IBM MQ Distributed error logs

Troubleshooting


Problem

Here are the directions to find IBM MQ error logs.

Resolving The Problem

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

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



HPE NonStop
IBM i
UNIX® and Linux®
Windows®
z/OS®


HPE NonStop
The IBM MQ for HPE NonStop (previously known as 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.

IBM i
The IBM MQ for IBM i error logs are located in the following directories:

/QIBM/UserData/mqm/errors
/QIBM/UserData/mqm/qmgrs/<queueManagerName>/errors



The error log files are named: AMQERR01.LOG, AMQERR02.LOG, and AMQERR03.LOG.
UNIX and Linux
The IBM MQ for UNIX error logs are located in the following directories:

/var/mqm/errors
/var/mqm/qmgrs/<queueManagerName>/errors


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 IBM MQ utility "dspmqinf".

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

$ dspmqinf QMGRMI

QueueManager:
Name=QMGRMI
Directory=QMGRMI
Prefix=/var/mqm
DataPath=/910MI/qmdata/QMGRMI

.
The error logs will be located in the subdirectory
/910MI/qmdata/QMGRMI/errors

 
Windows
The IBM MQ for Windows error logs are located in the following directories.
This is the default directory path; however, it might have been changed at installation time.

C:\ProgramData\IBM\MQ\errors
C:\ProgramData\IBM\MQ\qmgrs\<queueManagerName>\errors

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 by using the dspmqinf command.

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

dspmqinf TEST

QueueManager:
Name=TEST
Directory=TEST
Prefix=C:\ProgramData\IBM\MQ
DataPath=share\\data\\TEST


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

z/OS
The IBM MQ for 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 IBM MQ subsystem identifier (SSID).

[{"Line of Business":{"code":"LOB45","label":"Automation"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Product":{"code":"SSYHRD","label":"IBM MQ"},"ARM Category":[{"code":"a8m0z0000001iitAAA","label":"Troubleshooting"}],"ARM Case Number":"","Platform":[{"code":"PF002","label":"AIX"},{"code":"PF010","label":"HP-UX"},{"code":"PF011","label":"HPE NonStop"},{"code":"PF012","label":"IBM i"},{"code":"PF016","label":"Linux"},{"code":"PF033","label":"Windows"},{"code":"PF035","label":"z\/OS"},{"code":"PF055","label":"zLinux"}],"Version":"All Version(s)"},{"Line of Business":{"code":"LOB15","label":"Integration"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Product":{"code":"SSFKSJ","label":"WebSphere MQ"},"ARM Category":[{"code":"a8m0z0000001iitAAA","label":"Troubleshooting"}],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"All Version(s)"}]

Product Synonym

WMQ WebSphere MQ

Document Information

Modified date:
01 July 2021

UID

swg21172370