[z/OS]

Collecting information for C client problems on z/OS

If you need assistance to resolve a client problem on IBM® MQ for z/OS®, you might need to collect troubleshooting information to include with your support case to help find a solution to the problem.

Before you begin

Before you start this task, check:
  • The level of IBM MQ client code that is installed on the client machine.
  • That the client connection channel on the client machine is properly defined.

About this task

If you can reproduce the client problem or the problem is happening right now, you can generate data to provide more information about the problem.

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

Procedure

  1. Generate the following traces while the problem is happening:
    1. Generate a GTF trace.
    2. Generate a MSTR internal trace.
    3. Generate a CHIN trace.
  2. Optionally, use the following information:
  3. Collect the IBM MQ data.
    1. Record the version and release number of IBM MQ for z/OS and the product at the other end of the channel.
      For IBM MQ for z/OS, either look for message CSQY000I in the MSTR job log, or use the DISPLAY QMGR VERSION command. For other platforms, see Displaying the IBM MQ version.
    2. Record the operating system version and maintenance level on both sides of the channel.
      For the z/OS operating system, find the version in the output of /D IPLINFO in SDSF. For other platforms, see Operating system version and maintenance level.
    3. Provide the client connection and server connection channel definitions.
  4. Use the AMATERSE utility before uploading to ECUREP, and ensure you specify the case number with which the data is associated.

    For more information, see Using AMATERSE in the z/OS Communications Server: IP Diagnosis Guide.

  5. 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.