[UNIX, Linux, Windows, IBM i]

Collecting information for Java and JMS application problems on Multiplatforms

If you need assistance from to resolve a problem with a Java or JMS application on Multiplatforms, you might need to collect troubleshooting information to include with your support case to help find a solution to the problem.

Before you begin

IBM® recommends using the IBM MQ classes for Java in Java Platform, Enterprise Edition (Java EE) application servers such as WebSphere® Application Server. If you are using the IBM MQ classes for Java in a Java EE environment, review the restrictions and other considerations for their usage.

Before you start this task, answer the following questions about the problem:
  • What Java or JMS problem did you observe on the system?
  • What time did the Java or JMS problem start and when did it stop?
  • Were any Java exceptions reported, and did they include a Java call stack?
  • Which queue managers, queues and topics does the Java or JMS application use?

About this task

It is essential to gather information from the system when the Java or JMS problem is happening in order to identify the cause.

After collecting the troubleshooting information, you can send it to IBM.

Procedure

  1. Generate an IBM MQ classes for Java trace or an IBM Java Message Service trace, depending on whether your application uses the IBM MQ Java or JMS interface.
    If your application is running under WebSphere Application Server, follow the trace instructions for that environment.
  2. Generate a trace of the client application while the problem is happening:
  3. Collect the following information for the Java or JMS application:
    1. If your application is running in WebSphere Application Server, use its collector tool to gather information about the application server and its configuration, JNDI definitions, FFDC files, logs, and any traces generated in Steps 1 and 2:
    2. If your application is running in another Java application server or in a Java Platform, Standard Edition (Java SE) environment, collect the following files:
      • The standard output stream data (for example, System.out or similar files).
      • The standard error stream data (for example, System.err or similar files).
      • The Java virtual machine log files (for example, native_stdout.log and native_stderr.log or similar files).
      • The mqjms.log file, found by default in the application's current working directory.
      • The mqjms_PID.trc file, named for the process ID of the Java virtual machine, found in the same directory.
      • Any FFST files found in the FFDC subdirectory of the application's current working directory.
  4. Place the Java or JMS traces and logs from Steps 1 to 3, and, where applicable, the WebSphere Application Server collector, in the top-level IBM MQ errors directory.
    The automatic and manual data collection processes in Step 5 both collect files found in this directory.
  5. Collect the IBM MQ data.
    You can do this either automatically or manually:
    • Collect the data automatically by using the runmqras command as described in Collecting troubleshooting information automatically with runmqras. Be sure to collect the runmqras trace section, and from queue managers the defs and topic sections as well, and to specify your case number as shown in the following example for collecting output from queue manager QMA:
      runmqras -section defs,topic,trace -qmlist QMA -caseno TS001234567
      To collect output from a client, specify the trace section and your case number as shown in the following example:
      runmqras -section trace -caseno TS001234567
    • Alternatively, collect the data manually as described in Collecting troubleshooting information manually.
  6. Send the information that you have collected to IBM.

    A good description of the problem and the data is the most important information you can provide to IBM. Do not send data without providing a description!

    For FTP and email instructions, see Exchanging information with IBM Software Support.

    To open or update a case, go to the IBM My Support site.
    Note: Always update your case to indicate that data was sent.

    If you need to speak with IBM Software Support, contact your country representative. If you need to speak with IBM Support in the US, you can call 1-800-IBM-SERV.