IBM MQ Troubleshooting and support
If you are having problems with your queue manager network or IBM MQ applications, use the techniques described to help you diagnose and solve the problems.
For an introduction to troubleshooting and support, see Troubleshooting overview .
There are some initial checks that we can make for your platform to help determine the causes of some common problems. See the appropriate topic for your platform:
For information about solving problems, see Making initial checks .
For information about solving problems for MQ Telemetry, see MQ Telemetry troubleshooting .
For information about solving problems when you are using channel authentication records, see Channel authentication records troubleshooting .
Information that is produced by IBM MQ can help you to find and resolve problems. For more information, see the following topics:
For information about recovering after a problem, see Recovering after failure .
We can also read the general troubleshooting guidance in the following topics:
If an IBM MQ component or command has returned an error, and you want further information about a message written to the screen or the log, we can browse for details of the message, see Reason codes and exceptions .
Troubleshooting overview
Troubleshooting is the process of finding and eliminating the cause of a problem. Whenever we have a problem with your IBM software, the troubleshooting process begins as soon as you ask yourself "what happened?"
Making initial checks
There are some initial checks that we can make that may provide answers to common problems that you may have.
Reason codes and exceptions
We can use the following messages and reason codes to help you solve problems with your IBM MQ components or applications.
IBM Support Assistant (ISA)
The IBM Support Assistant (ISA) helps you to resolve questions and problems with IBM software products by providing access to support-related information and troubleshooting tools.
Searching knowledge bases
If we have a problem with your IBM software, you want it resolved quickly. Begin by searching the available knowledge bases to determine whether the resolution to your problem is already documented.
Contacting IBM Software Support
Grade the severity of the problem, describe the problem and gather background information, then report the problem to IBM Software Support.
Get product fixes
A product fix might be available to resolve your problem. We can determine what fixes are available by launching a query from the IBM Support Assistant.
First Failure Support Technology (FFST)
First Failure Support Technology (FFST) for IBM MQ provides information about events that, in the case of an error, can help IBM support personnel to diagnose the problem.
Use error logs
There are a variety of error logs that we can use to help with problem determination and troubleshooting.
Use trace
We can use different types of trace to help you with problem determination and troubleshooting.
Problem determination on z/OS
IBM MQ for z/OS, CICS, Db2, and IMS produce diagnostic information which can be used for problem determination.
Problem determination in DQM
Aspects of problem determination relating to distributed queue management (DQM) and suggested methods of resolving problems.
Channel authentication records troubleshooting
If you are having problems using channel authentication records, check whether the problem is described in the following information.
Commands troubleshooting
Troubleshooting advice for errors that appear when we use special characters in descriptive text.
Distributed publish/subscribe troubleshooting
Use the advice given in the subtopics to help you to detect and deal with problems when we use publish/subscribe clusters or hierarchies.
Troubleshooting IBM MQ client for HP Integrity NonStop Server
Provides information to help you to detect and deal with problems when you are using the IBM MQ client for HP Integrity NonStop Server.
Java and JMS troubleshooting
Use the advice that is given here to help you to resolve common problems that can arise when you are using Java or JMS applications.
Resolving problems with IBM MQ MQI clients
This collection of topics contains information about techniques for solving problems in IBM MQ MQI client applications.
Multicast troubleshooting
The following hints and tips are in no significant order, and might be added to when new versions of the documentation are released. They are subjects that, if relevant to the work that you are doing, might save you time.
Queue manager clusters troubleshooting
Use the checklist given here, and the advice given in the subtopics, to help you to detect and deal with problems when we use queue manager clusters.
Queue managers troubleshooting
Use the advice given here to help you to resolve common problems that can arise when we use queue managers.
Undelivered messages troubleshooting
Use the advice given here to help you to resolve problems when messages do are not delivered successfully.
TLS troubleshooting information
Use the information listed here to help you solve problems with your TLS system.
Troubleshooting RDQM configurations
These topics give information that is useful for troubleshooting RDQM high availability (HA) and disaster recovery (DR) configurations.
MQ Telemetry troubleshooting
Look for a troubleshooting task to help you solve a problem with running MQ Telemetry applications.
Recovering after failure
Follow a set of procedures to recover after a serious problem.
Related information