Troubleshooting

If a problem occurs with CICS Explorer®, you might be able to resolve it yourself by consulting existing troubleshooting documentation. If you cannot resolve it yourself, you need to collect necessary troubleshooting data (MustGather) before contacting IBM Support.

Consulting existing troubleshooting documentation to resolve the problem

  1. See Frequently asked questions (FAQs) for common problems and their solutions.
  2. Force the data trace to be written to the error log. See Capturing trace data.
  3. View the error log to identify the cause of the error. See Viewing the error log.
  4. See CICS Explorer (CNX) messages and z/OS Explorer (IZE) Messages in IBM Explorer for z/OS documentation for further explanation and suggested response, or search IBM Support Portal on known problems using symptoms such as the message number and error codes.

Collecting MustGather to work with IBM Support

  1. Prepare general information:
    • A complete description of the problem that includes the following questions:
      • When did the problem first occur?
      • Is the problem a one-time failure or recurring?
      • Was software or hardware maintenance applied?
      • Did the failure occur while doing a specific task?
      • Is the failure occurring in more than one address space?
    • CICS Explorer product version, release, and maintenance level.
    • Operating system version, release, and maintenance level.
    • Related products version, and release levels.
    • Your valid contact phone number and email address.
  2. Gather the component-specific information based on the type of problem that you experience:
  3. Send the MustGather data that you have collected to IBM Support.

    For example, you can go to the IBM Support Portal to open a case for a problem. Remember to update the Service Request (problem record) to indicate that data has been sent. If you have a "Preferred Care option for IBM Z®" that includes Support access for Q&A, you can also ask non-defect installation and usage questions.

    Follow the instructions to open a case:
    • Click 'Open a case' on the home page
      Open a case page view
    • Enter 'CICS Transaction Server' in the Product field.
      Product field view
    • Choose the 'CICS Explorer 5.5' value from the drop-down list of the Product Version field.
      Drop-down list of the Product Version field
    • Enter other fields on the page based on your project requirements.
    • Click 'Submit case' placed at the end of the page.
      Submit case view

    To open and vote for an enhancement request for IBM Z Software products, see IBM Ideas Portal.