IBM Software Group

IBM Fault Analyzer for z/OS

Program Number 5655-S15

Mentor Workshop

2008 IBM Corporation March 13, 2008 01

IBM Software Group

IBM trademarks
The following terms are trademarks of International Business Machines Corporation in the United States, other countries, or both: AD/Cycle BookManager CICS C/370 CICS COBOL/370 DB2 DFSORT eServer IBM IMS IMS/ESA Language Environment MVS MVS/ESA
2008 IBM Corporation March 13, 2008

RACF Redbooks S/390 System/390 VisualAge VS COBOL II VTAM WebSphere z/OS zSeries

Fault Analyzer Tutorial

zSeries PD Tools

Fault Analyzer training: sections

Introduction Fault Analyzer files, setup, and options Real-time fault analysis report Using the online interface Fault reanalysis Interactive reanalysis tour Interactive reanalysis example Batch reanalysis CICS, DB2, & IMS support Saving and using program source information Using options Hints & tips
2008 IBM Corporation March 13, 2008

Fault Analyzer Tutorial

zSeries PD Tools

What is Fault Analyzer ?

Fault Analyzer is a tool that helps you determine the cause of an application abend
so you can more quickly identify and resolve the problem

Delivers information about an application when it has abended, to help you assess:
What happened, and why? What program? What line of source code? What source variables were involved?

2008 IBM Corporation March 13, 2008

Fault Analyzer Tutorial

zSeries PD Tools

Environments and languages supported

Fault Analyzer can capture abends in these environments: z/OS OS/390 LE (Language Environment) CICS IMS DB2 MQSeries UNIX System Services
2008 IBM Corporation March 13, 2008

Source information can be mapped for these IBM compilers: COBOL PL/I Assembler C/C++

Fault Analyzer Tutorial

zSeries PD Tools

What features does Fault Analyzer have ?

Real-Time Analysis
Detailed information is captured automatically when an application abends An analysis report is generated

Online Interface
View an analysis report Perform a reanalysis
Easiest way to Easiest way to research an abend research an abend

Interactive Reanalysis

Quick point-and-shoot navigation of abend info Apply program source information

Batch Reanalysis
Run a utility to generate a new analysis report Apply program source information

2008 IBM Corporation March 13, 2008

Fault Analyzer Tutorial

zSeries PD Tools

Real-Time analysis how it works

1. An application abends.
The system intercepts the abend and calls a Fault Analyzer exit. The exit invokes FA. Real-Time Analysis z/OS
Application

Abend

(batch or online)

2. FA reads options that

control whether it will analyze the abend, how to process, and which Fault History file to use
Installation options are specified for the system Options can be overridden for a job step or online region FA Invocation Exit Options

Fault Analyzer

2008 IBM Corporation March 13, 2008

Fault Analyzer Tutorial

zSeries PD Tools

Real-Time analysis how it works

Real-Time Analysis

3. Fault Analyzer examines

programs and the environment in the application address space

z/OS
Application

Abend
FA Invocation Exit Options

4. FA gets source info for

application programs
Source info can be a Sysdebug file, a side file, or a compiler listing Multiple data sets can be searched

Fault Analyzer

Sysdebug files, Compiler Listings, or Side Files

2008 IBM Corporation March 13, 2008

Fault Analyzer Tutorial

zSeries PD Tools

Real-Time analysis how it works

5. A new Fault Entry is written
to a Fault History File. The entry contains:
Info about the application The Analysis Report A mini-dump of the application (this enables reanalysis)

Real-Time Analysis z/OS

Application

Abend
FA Invocation Exit Options

Fault History File

6. The Analysis Report is

written to SYSOUT (batch jobs only)

Fault Entry SYSOUT

Fault Analyzer

Sysdebug files, Compiler Listings, or Side Files

Analysis Report

2008 IBM Corporation March 13, 2008

Fault Analyzer Tutorial

zSeries PD Tools

The online interface

The online interface is available in TSO and CICS Use online interface to:
Display a list of abends View real-time reports Perform reanalysis Delete fault entries

ISPF

TSO Fault Analyzer

Fault History Files

Fault Entries Compiler Listings

The CICS interface looks the same as the TSO interface, with minor restrictions Any abend can be viewed from either interface
2008 IBM Corporation March 13, 2008

CICS

CICS Fault Analyzer

Sysdebug, Side Files

Fault Analyzer Tutorial

zSeries PD Tools

The online interface

Available line commands are shown here

and entered here

A list of abends in a A list of abends in a fault history file fault history file Batch and online abends Batch and online abends may be in the same list may be in the same list

2008 IBM Corporation March 13, 2008

Fault Analyzer Tutorial

zSeries PD Tools

The real-time analysis report

Synopsis and the suspected cause of a failure
abending program active line of source code active variables

Explanation of error messages / codes File and Database detail Program details:
Variables / storage Compile, link, load, and entry point information

System information:
z/OS, CICS, DB2, IMS

2008 IBM Corporation March 13, 2008

Fault Analyzer Tutorial

zSeries PD Tools

View a real-time analysis report

To View an Analysis Report: Use the Fault Analyzer TSO online interface
- OR ISPF

For any abend

TSO Fault Analyzer CICS Fault Analyzer

CICS

Use the Fault Analyzer CICS online interface

- OR Browser

Fault Entry Fault History File

Use a Web Browser

- OR SDSF

z/OS HTTP Server SYSOUT

View or print your batch job's SYSOUT

Default is SYSOUT=* DD name is IDIREPRT
2008 IBM Corporation March 13, 2008

For batch abends

Printed output
zSeries PD Tools

Analysis Report

Fault Analyzer Tutorial

Interactive reanalysis
The easiest way to research an abend A function of the online interface Quickly navigate to:
Synopsis Any program in the call chain Program variables and their values File and database detail CICS, DB2, and IMS info Program source listing Storage areas
2008 IBM Corporation March 13, 2008

Point and Shoot Point and Shoot navigation navigation

Fault Analyzer Tutorial

zSeries PD Tools

Interactive reanalysis
Online panels to research abend information
Online interface
Options

Fault History File Fault Analyzer Online Interface

Fault Entry

You can apply source information, even if source info was not available when the program abended A source info file can be created after the abend You do NOT have to reproduce the abend

Sysdebug Files, Side Files, or Compiler Listings Optional Compiler

Program Source

2008 IBM Corporation March 13, 2008

Fault Analyzer Tutorial

zSeries PD Tools

Batch reanalysis
A batch utility to generate a new analysis report Apply source information, even if the source info was not available during RealTime analysis Fault Analyzer generates JCL JCL can be edited, submitted, and saved
Sysdebug Files, Side Files, or Compiler Listings Optional Compiler
Program Source

Use the online interface to Use the online interface to generate and submit JCL for a generate and submit JCL for a batch reanalysis job batch reanalysis job
Online interface
ISPF

Fault History File

Fault Entry Fault Analyzer Batch Reanalysis Job Analysis Report (SYSOUT)

2008 IBM Corporation March 13, 2008

Fault Analyzer Tutorial

zSeries PD Tools

IBM PD Tools (including Fault Analyzer) information is on the Web

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

Select Fault Analyzer Select Fault Analyzer from the list. from the list.

2008 IBM Corporation March 13, 2008

Fault Analyzer Tutorial

zSeries PD Tools

You can get Fault Analyzer manuals from the IBM Web site
http://www.ibm.com/software/awdtools/faultanalyzer/

Select Library from the Select Library from the menu. menu.

2008 IBM Corporation March 13, 2008

Fault Analyzer Tutorial

zSeries PD Tools

You can get Fault Analyzer manuals from the IBM Web site
http://www.ibm.com/software/awdtools/faultanalyzer/library/

Right-click to download Right-click to download Click to view Click to view

2008 IBM Corporation March 13, 2008

Fault Analyzer Tutorial

zSeries PD Tools

You can get Fault Analyzer manuals from the IBM Web site

2008 IBM Corporation March 13, 2008

Fault Analyzer Tutorial

zSeries PD Tools

Feedback
Your feedback is valuable
You can help improve the quality of IBM Education Assistant content to better meet your needs by providing feedback.

Did you find this module useful?

Did it help you solve a problem or answer a question?

Do you have suggestions for improvements?

Click to send e-mail feedback:

mailto:iea@us.ibm.com?subject=Feedback_about_FA01Introduction.ppt

This module is also available in PDF format at: ../FA01Introduction.pdf

2008 IBM Corporation March 13, 2008

Fault Analyzer Tutorial

zSeries PD Tools

IBM Software Group

IBM Fault Analyzer for z/OS

Program Number 5655-S15

Mentor Workshop

2008 IBM Corporation March 13, 2008 01