Using Z Abend Investigator
- 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 (HFZSNAP)
    - HFZSNAP invocation
  - Invoking Z Abend Investigator from a Java try-catch block
    To capture the current Java™ state from a Java program, Z Abend Investigator can be invoked to create a history file fault entry, along with an associated MVS™ SVC dump.
  - Invoking Z Abend Investigator from Java dump events
  - Using the Z Abend Investigator Java wrapper utility
    Z Abend Investigator Java wrapper utility wraps a callable Java application in a try-catch block by using the FA Java class.
  - Using the Z Abend Investigator JVMTI Agent
    Z Abend Investigator 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 Z Abend Investigator
  - 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, Z Abend Investigator attempts to obtain the JCL and save it in the fault entry. This feature is available with JES2 only.
- The Z Abend Investigator 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 Z Abend Investigator report

Using the program SNAP interface (HFZSNAP)

A program SNAP interface is provided to assist users in debugging problems with applications that do not abend, or that for any other reason cannot be analyzed by Z Abend Investigator using one of the normal abend invocation exits described in Exits for invoking Z Abend Investigator. This interface permits a call to Z Abend Investigator from anywhere within an application program to request an analysis of the current environment. For 24-bit and 31-bit programs, the program SNAP interface module name is HFZSNAP. For 64-bit programs, the module name is HFZSNAP6.

An example of where a call to HFZSNAP might be used is in a DB2® application after execution of an SQL statement that results in a negative SQLCODE.

Apart from the way in which Z Abend Investigator is invoked, there is no difference between this type of analysis and any other real-time analysis caused by an abend.

This exit can extract WTO console messages related to the current job from the master trace table and include these messages in the analysis report, except when running under CICS.

It is recommended that you invoke HFZSNAP dynamically to ensure that you are always using the most current version:

If the invoking program is compiled with the DLL option, then invocations of HFZSNAP need to be STATIC rather than DYNAMIC.
For programs written in C, HFZSNAP can only be invoked dynamically.