Skip to main content

Software  >  Software Development  >  

Mustgather: Read first for problems encountered with Fault Analyzer for z/OS

 Technote (troubleshooting)
 
Problem(Abstract)
This document lists the documentation the Fault Analyzer support team will need to diagnose your problem. If you gather this documentation before calling support, it will expedite the troubleshooting process and save you time.
 
Resolving the problem
MustGather: Read first table of contents:

Gathering general information Gathering general information
Gathering component specific information Gathering problem specific information
Submitting information to IBM Support Submitting information to IBM Support
Gathering component specific information General hints and tips

What is a Mustgather document and how does it help me?



Gathering general information


General information is information that is needed for any reported problem, and this information includes the following:

  • The results of selecting HELP – ABOUT FAULT ANALYZER from the menu bar of any Fault Analyzer screen.
  • Your operating system, OS/390 or z/OS, and it's version and release.
  • The subsystem, if related to the problem, e.g. CICS, DB2, IMS, WAS, and the version, release, and modification numbers. If you do not know the subsystems used in your environment, please contact your system administrator.
  • Any OEM (non-IBM) tools, such as debuggers, or other abend analysis products that are related to this problem.
  • Was any software or hardware maintenance applied just before the problem began?
  • A complete description of the problem, including the following:
    • When did the problem first occur?
    • Is the problem a one time or recurring situation?
    • Can it be recreated at will?
    • COMPLETE information about the problem, including all commands, screens, keystrokes, outputs, etc.
  • A valid contact phone number and email address



Gathering problem specific information


Provide this information when directed by IBM. Click on the problem type or component that best describes your Fault Analyzer problem. This provides you with a list of documentation that the support team requires to diagnose your problem.


Fault Analyzer problems
Installation/Setup/Maintenance
Options Processing
Real-time Analysis
Interactive Reanalysis
Reports
History File
IDIS Subsystem
User Exits
IDIUTIL Issues
IDILANGX Issues
Performance
Product Documentation, Weblinks or Content
Specific Messages


Installation/Setup/Maintenance


Gather the following documentation for installation problems before calling IBM support:

  • The complete listing from your SMPE run for receive/apply/accept issues.
  • A copy of your IDICNF00 member for issues with the options.


Options Processing


Gather the following documentation for issues with Fault Analyzer options before calling IBM support:



Real-time Analysis


Gather the following documentation for issues involving Real-time Analysis before calling IBM support:



Interactive Reanalysis


Gather the following documentation for issues involving Interactive Reanalysis before calling IBM support:



Reports


Gather the following documentation for problems with Fault Analyzer reports before calling IBM support:

  • Copy of the report(s) in question along with screen captures or JCL showing how the report(s) were generated.

History File


Gather the following documentation for History file problems before calling IBM support:

  • Copy of your history file. If the issue is with a specific member, include only that member along with any members that have $$ as the first two characters of the member name.


IDIS Subsystem


Gather the following documentation for IDIS Subsystem problems before calling IBM support:

  • Restart the IDIS subsystem and if the problem continues, provide an IDITRACE.



User Exits


Gather the following documentation for problems with User exits before calling IBM support:

  • A copy of the user exit(s)
  • The compile/assemble used to create it
  • The SMPE used to install it along with the resulting joblog listing


IDIUTIL Issues


Gather the following documentation for problems with the IDIUTIL utility program before calling IBM support:

  • The JCL used to run IDIUTIL
  • The resulting joblog listing


IDILANGX Issues


Gather the following documentation for problems with IDILANGX or EQALANGX sidefiles before calling IBM support:

  • The compile listing used as input to IDILANGX
  • The JCL used to run IDILANGX
  • The resulting joblog listing


Performance


Gather the following documentation for Performance problems before calling IBM support:



Product Documentation, Weblinks, or Content


Gather the following documentation for any product documentation, Web information, or content issues before calling IBM support:

  • A copy of or reference to the documentation in question, or a reference to where information should be if the issue is missing documentation.


Specific Messages


Gather the following documentation for any of the listed messages below before calling IBM support:

  • IDI0012S - The generated SVC dump
  • IDI0069E - The joblog listing and if available, a SYSMDUMP
  • IDI0047S, IDI0092S, IDI0105S, and IDI0144E - Set a SLIP trap for the message as follows:
      SL SET, ID=xxxx,MSGID=IDI0nnnn,A-SVCD,END
      where xxxx is some identifier for this slip trap and nnnn are the final four characters of the message you are receiving.


Submitting information to IBM Support


After a PMR is open, you can submit diagnostic MustGather data to IBM using one of the following methods:

FTP diagnostic data to IBM

If FTP is not possible, email diagnostic data to techsupport@ecurep.ibm.com. You must add 'PMR xxxxx bbb ccc' (without the quotes) in the subject line of your email, where xxxxx is your pmr number, bbb is your branch office and ccc is your IBM country code (e.g. 12345 678 000 for the PMR 12345 from Branch 678 in the United States).

Always update your PMR to indicate that data has been sent. You can update your PMR, or open a new PMR, in one of two ways:

  • Online: Go to the Submit and track problems page on the IBM Software Support site (www.ibm.com/software/support/probsub.html) or ServiceLink or IBMLink to open an Electronic Service Response (ESR). Enter your information into the appropriate problem submission tool.
  • By phone: Call 1-800-IBMSERV (1-800-426-7378) in the United States or, from other countries, go to the contacts page of the IBM Software Support Handbook on the Web (techsupport.services.ibm.com/guides/contacts.html) and click the name of your geographic region.

General hints and tips


Search the Technotes database for items concerning Fault Analyzer.
Search our libraries for documentation and manuals.


What is a Mustgather document and how does it help me?


MustGather documents aid in problem determination and save time resolving Problem Management Records (PMRs). These documents are located on the product support sites and contain specific instructions about what documentation to gather for specific problems. You can find MustGather documents by searching on the word MustGather on the eSupport Web page:

http://www.ibm.com/software/awdtools/deployment/support/

Collecting MustGather data early, even before opening the PMR, helps IBM® Support quickly determine if:


  1. Symptoms match known problems (rediscovery).

  2. There is a non-defect problem that can be identified and resolved.

  3. There is a defect that identifies a workaround to reduce severity.

  4. Locating root cause can speed development of a code fix.




Receive weekly Support e-mail

Sign up for My Notifications to receive a customized weekly e-mail from IBM support. Learn about announcements and important technical support information.
 
 
 

Copyright and trademark information
IBM, the IBM logo and ibm.com are trademarks of International Business Machines Corp., registered in many jurisdictions worldwide. Other product and service names might be trademarks of IBM or other companies. A current list of IBM trademarks is available on the Web at "Copyright and trademark information" at www.ibm.com/legal/copytrade.shtml.
Rate this page
Please take a moment to complete this form to help us better serve you.
This material provides me with the information I need.




This material is clear and easy to understand.




Did the information help you to achieve your goal?
What updates, improvements, or related information would you like to see in this document?
Your response will be used to improve our document content. Requests for assistance, if applicable, should be submitted through your normal support channel as we cannot respond from this site.
Input the verification number to submit feedback:
Document information
 Product categories:
 Software
 Software Development
 Problem Determination Tools
 Fault Analyzer for z/OS
 Operating system(s):
  z/OS
 Software version:
  6.1, 7.1, 8.1, 9.1
 Reference #:
  1255056
 IBM Group:
 Software Group
 Modified date:
 2007-07-24

Translate My Page
 
 

Rate this page

Help us improve this page. Your response will be used to improve our document content. Requests for assistance, if applicable, should be submitted through your normal support channel as we cannot respond from this site.