IBM MQ Troubleshooting and support

If we are having problems with your queue manager network or IBM MQ applications, use the techniques described to help you diagnose and solve the problems.

About this task

For an introduction to troubleshooting and support, see Troubleshooting overview.

There are some initial checks that we can make for the platform to help determine the causes of some common problems. See the appropriate topic for the platform:

• Making initial checks on UNIX, Linux, and Windows
• Making initial checks on IBM i
• Making initial checks on z/OS

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 we 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:

• Use error logs
• Use trace
• Problem determination on z/OS
• First Failure Support Technology (FFST)

For information about recovering after a problem, see Recovering after failure.

We can also read the general troubleshooting guidance in the following topics:

• IBM Support Assistant (ISA)
• Searching knowledge bases
• Contacting IBM Software Support
• Getting product fixes

If an IBM MQ component or command has returned an error, and we 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 you have a problem with the 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 the 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 the IBM software, we 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.
• 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 used 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 we 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 we 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 we 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 we 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 Managed File Transfer
  Use the following reference information to help you to diagnose errors in Managed File Transfer:
• MQ Telemetry troubleshooting
  Look for a troubleshooting task to help you solve a problem with running MQ Telemetry applications.
• Troubleshooting the IBM MQ Console and REST API
  Diagnose problems with the IBM MQ Console and REST API by looking at the available logs. When asked by IBM staff, you might also need to configure trace.
• Troubleshooting IBM MQ Internet Pass-Thru
  There are a number of steps we can follow to help determine the nature of any problems you might encounter when using IBM MQ Internet Pass-Thru (MQIPT).
• XMS .NET troubleshooting
  Use these tips to help you troubleshoot problems with using XMS.
• Troubleshooting RDQM configurations
  These topics give information that is useful for troubleshooting RDQM high availability (HA) and disaster recovery (DR) configurations.
• Recovering after failure
  Follow a set of procedures to recover after a serious problem.

Related information

• Troubleshooting and support reference