Using Fault Analyzer
- Introduction
- Real-time analysis
  - Dump suppression
  - Fault history file selection
  - Controlling the real-time analysis with options
  - JCL DD statements
  - The real-time analysis report
  - The SYSLOG summary
  - Using the program SNAP interface (IDISNAP)
  - Invoking Fault Analyzer from a Java try-catch block
    To capture the current Java™ state from a Java program, Fault Analyzer can be invoked to create a history file fault entry, along with an associated MVS™ SVC dump.
  - Invoking Fault Analyzer from Java dump events
  - Using the Fault Analyzer Java wrapper utility
    Fault Analyzer Java wrapper utility wraps a callable Java application in a try-catch block by using the FA Java class.
  - Using the Fault Analyzer JVMTI Agent
    Fault Analyzer provides a JVMTI (JVM Tool Interface) agent. The agent runs inside a Java™ Virtual Machine (JVM) and can inspect the state of the running Java application.
  - Dump registration processing
  - Real-time exclusion processing
  - Recovery fault recording
  - Using SLIP,COMP=0C4 with Fault Analyzer
  - Extended minidump data set (XDUMP)
  - Abend traps can prevent fault analysis
  - Capturing and displaying the abending job JCL
    When the JCLcapture option is in effect during real-time processing, Fault Analyzer attempts to obtain the JCL and save it in the fault entry. This feature is available with JES2 only.
- The Fault Analyzer ISPF interface
- Performing batch reanalysis
- Performing interactive reanalysis
- Performing CICS system abend dump analysis
- Formatting a CICS auxiliary trace data set
- Performing Java analysis
- The Fault Analyzer report
- Using non-ISPF interfaces to access Fault Analyzer history files

Controlling the real-time analysis with options

Set options globally, so they control the output for all jobs. However, you can also set an option just for one job. In this case, you should set the option in the user options file via the IDIOPTS DDname.

See Options for information about all available options and the different ways in which they can be specified.

Options that you are more likely to use for real-time analysis are:

RetainDump(ALL): Specify this option if you want to want to retain the SYSABEND, SYSUDUMP, or SYSMDUMP unconditionally. Without this option, many dumps are suppressed when Fault Analyzer deems that the analysis it has performed is adequate. This option does not affect the writing of the minidump to the history file. See RetainDump for more details.
The dump disposition part of this option is applicable to the use of the MVS™ IEAVTABX change options/suppress dump exit, IDIXDCAP, only.
Detail: Specify this option if you want to adjust the level of detail given in the real-time analysis report. (If a dump is produced, you can change this option when you perform a reanalysis.) See Detail for more detail.
Exclude: Specify this option if you want to exclude this job from analysis. See Exclude/Include for more detail.
NoDup: Specify this option if you want to change the way that duplicate faults are handled by default. See NoDup for more detail.
CICSDumpTableExclude: Specify this option if you want to exclude CICS® transaction fault analysis using the CICS® transaction dump code table. See CICSDumpTableExclude for more detail.

You can also use the DataSets option to point to listings and side files. See DataSets for more detail.

Rate this topic

5 stars 4 stars 3 stars 2 stars 1 star

Comment on this topic.

By clicking this box, you acknowledge that you are NOT a U.S. Federal Government employee or agency, nor are you submitting information with respect to or on behalf of one. HCL provides software and services to U.S. Federal Government customers through its partners immixGroup, Inc. Contact this team at https://hcltechsw.com/resources/us-government-contact. Do not include any personal data in this Comment box. Note: To report a problem or question about the product software, do not use this form. Instead, go to the IBM Software Support site.