HCL Z Abend Investigator User’s Guide and Reference V1 R1
Accessibility features for Z Abend Investigator
About this document
Who should use this document
Organization of this document
How to read the syntax diagrams
Using Z Abend Investigator
Introduction
The analysis engine
The analysis process
Real-time abend analysis
Real-time SNAP analysis
Fault reanalysis
Batch reanalysis
Interactive reanalysis
Fault history files
Associated dump data sets
Special members in the history file data set
Supported application environments
Binder-related dependencies
Setting up existing programs for fault analysis
Additional region size required
Compiler listing or side file selection criteria
Special processing of Language Environment CEEWUCHA abends
WTO routing and descriptor codes used by Z Abend Investigator
CICS Storage Accounting Area (SAA) overlay assistance
Real-time analysis
Dump suppression
Z Abend Investigator and CICS global user exits
Fault history file selection
Controlling the real-time analysis with options
Pointing to listings with JCL DD statements
The real-time analysis report
Combining Z Abend Investigator real-time reports
Controlling the SYSOUT class of real-time reports
Suppressing real-time reports
The SYSLOG summary
Using the program SNAP interface (HFZSNAP)
HFZSNAP invocation
Entry specifications
Input parameter list
Return specifications
Example 1 (COBOL)
Example 2 (PL/I: non-DLL)
Example 3 (PL/I: 31-bit DLL)
Example 4 (PL/I: 64-bit DLL)
Example 5 (Assembler)
Invoking Z Abend Investigator from a Java try-catch block
Invoking Z Abend Investigator from Java dump events
Using the Z Abend Investigator Java wrapper utility
Using the Z Abend Investigator JVMTI Agent
Dump registration processing
Real-time exclusion processing
Duplicate fault processing
Recovery fault recording
RFR dump titles
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
The Z Abend Investigator ISPF interface
Invoking the interface
ISPF split screen support
The Fault Entry List display
Using views
Changing the history file or view displayed
Fault entry list column configuration
Available columns
Sorting and matching fault entries
Additional ways to match and select faults
Cursor-selecting a matching value
Over-typing existing values
Using the MATCH command
Applying an action to a particular fault
History file properties
New history file allocation
Change fault history file settings
Resetting history file access information
Refreshing fault entry information
Implicit refresh
Updates pending
Fault entry expiration control
Action-bar pull-down menus
Commands
CE
CICSD
CICSLINK
CICSSTG
COLS
COPY
DISASM
DSECT
DUPS
EDIT
EXEC
FIND
HFZSINFO
INFO
JCL
LOOKUP
MATCH
NEXT
NOTE
NOTELIST
PREV
QUIT
REFRESH
RESET
RPTFIND
RUNCHAIN
SHOW
SHOWFREE
STCK
STGMAP
VIEWS
Z Abend Investigator preferences
BatchOpts
Viewing a saved report
Adding or removing blank lines
Adding or removing help text
Setting preferred formatting width
Displaying user-selected message or abend code explanations
Copying interactive displays to a file
Displaying product copyright, license, and version information
Deleting history file entries
Locking a fault entry
Viewing fault entry information
Viewing the fault entry duplicate history
Expanding and collapsing duplicate fault entries
Copying history file entries
Moving history file entries
Transmitting history file entries
Packaging fault entries
Security considerations
Specifying 64-bit addresses
Using the interactive HFZS subsystem interface
Managed history files
Excluded history files
Selected history files
Performing batch reanalysis
Batch reanalysis options
Initiating batch reanalysis
Data sets used for batch reanalysis
Creating your own batch reanalysis job
Performing interactive reanalysis
Interactive reanalysis options
Initiating interactive reanalysis
Status pop-up display
General information about the interactive report
Exit from the interactive report
Primary option: Synopsis
Primary option: Event Summary
Detailed Event Information
Primary option: Open Files
Primary option: CICS Information
CICS Control Blocks
CICS Transaction Storage Summary
CICS Transaction Storage
Last CICS 3270 Screen Buffer
Summarized CICS Trace
CICS Trace Formatting
CICS Recovery Manager
CICS Levels, Commareas, and Channels
CICS Monitoring Data
CICS Event Program Information
Primary option: Messages
Primary option: Db2 Information
Primary option: IMS Information
Primary option: Storage Areas
Primary option: Java Information
Primary option: Language Environment Heap Analysis
Primary option: MTRACE Records
Primary option: Abend Job Information
Primary option: User Notes
Primary option: Z Abend Investigator Options
Displaying associated storage areas
Hiding the hex-value column
Collapsing level 88 items
Showing all COBOL base locators
Expanding messages and abend codes
Displaying source code
Displaying storage locations
Displaying data areas
Creating and managing user notes
Displaying CICS transaction storage (CICSSTG)
Displaying the address space storage map (STGMAP)
Displaying PSW information
Mapping storage areas using DSECT information
HFZDSECT concatenation
Indexing your DSECT data sets ($DINDEX member)
Displaying chained data areas
Disassembling object code
Converting STORE CLOCK values
User-specific report formatting
Prompting for compiler listing or side file
Controlling prompting
Data sets used for interactive reanalysis
Refresh processing
COBOL Explorer
COBOL Explorer example
Performing CICS system abend dump analysis
Setting options for CICS system abend analysis
User exits
Selecting a CICS dump data set
Selecting an address space to analyze
Displaying the CICS system abend interactive report
Fastpath navigation
Option 1: Synopsis
Option 2: Abend Job Information
Option 3: CICS System Information
Sorting and matching table displays
Option 4: Options in Effect
Creating a history file entry
Formatting a CICS auxiliary trace data set
Selecting a CICS auxiliary trace data set
Specifying CICS Trace Selection Parameters
Performing Java analysis
Selecting a Java dump data set
Java fault entry reanalysis
Displaying the Java information in the interactive report
Java event replacement in Z Abend Investigator event list
Java information reporting limitations
Java application samples
Sample 1 (HFZSJAV1): Enterprise PL/I invoking Java in batch
Sample 2 (HFZSJAV2): Enterprise COBOL invoking Java in batch
Sample 3 (HFZSJAV3): 64-bit Enterprise PL/I invoking Java in batch
Sample 4 (HFZSJAV4): IMS Java batch processing sample
Sample 5 (HFZSJAV5): C++ program invoking Java in batch
Sample 6 (HFZSJAV6): Call a Java batch application with the Z Abend Investigator wrapper utility
The Z Abend Investigator report
General report information
Most significant abend code
Open file record information
Spanned record interpretation
COBOL suppressed copybooks
Main report sections
The prolog section
The synopsis section
The summary section
Maximum call depth
The event details section
The system-wide information section
The abend job information section
The options section
The epilog section
Sample reports
Z Abend Investigator installation and administration
Preparing to customize Z Abend Investigator
Checklist for installing and customizing Z Abend Investigator
Library names after you finish installing
Storage recommendations
Exits for invoking Z Abend Investigator
Invocation for non-CICS transaction abends
Summary of exit usage
Invocation for CICS transaction abends
SVC dump registration
Language Environment options required for invocation of Z Abend Investigator
LE options required for non-CICS abends
LE options required to capture Java application abends
LE options required for CICS abends
Running Z Abend Investigator with similar third-party products
MVS dump data set size
Application-handled error conditions
Setting Z Abend Investigator SLIP traps
Customizing the operating environment for Z Abend Investigator
Making Z Abend Investigator modules available
Defining program control access to Z Abend Investigator programs
Restricting change of history file settings
Setting up the message and abend code explanation repository
Managing recovery fault recording data set access
SDUMP recovery fault recording data sets
Using the XFACILIT resource class for SDUMP RFR data sets
TDUMP recovery fault recording data sets
Using the XFACILIT resource class for TDUMP RFR data sets
RFR TDUMP XFACILIT example
Managing XDUMP data set access
Using the XFACILIT resource class for XDUMP data sets
Managing copied SDUMP data set access
Using the Z Abend Investigator HFZS subsystem
Sysplex-wide subsystem inter-communication
Caching of history file $$INDEX data
Starting the HFZS subsystem
HFZS subsystem storage requirements
HFZS subsystem requirements for DB2
HFZS subsystem requirements for Java
Specifying an HFZJLIB DD statement
Specifying a default JVM for Java dump analysis
Stopping the HFZS subsystem
Modifying your ISPF environment
Allocating ISPF data sets
Making the Z Abend Investigator HFZSCMDS command table available
Updating the ISPF selection panel
Invoking Z Abend Investigator using an ISPF 3.4 line command
Invoking Z Abend Investigator from SDSF (SFA command)
Invoking the LOOKUP command using cursor selection (LOOKC command)
Providing ISPF interface defaults for new users
Providing installation-specific batch reanalysis JCL control statements
Increasing the display area for Z Abend Investigator reports
Customize Z Abend Investigator by using USERMODs
Enabling Z Abend Investigator to be invoked
Installing the MVS change options/suppress dump exit HFZXDCAP
Enabling the Language Environment abnormal termination exit (HFZXCEE or HFZXCE64)
Working with applications that use a non-Language Environment run time
Eliminating the need for a dump DD statement (++HFZTABD)
Obtaining load modules from CA-Panexec
Using a nonstandard LE parameter list separator character (++HFZOPT1)
Suppressing HFZXDCAP real-time analysis if prior exit RC=8 (++HFZOPT2)
Customize Z Abend Investigator by using an HFZOPTLM configuration-options module
Specifying an alternative parmlib data set for HFZCNFxx (CNFDSN)
Changing the default recovery fault recording IEATDUMP data set name (RFRDSN)
Changing the action of Z Abend Investigator when invoked via the CICS XDUREQ global user exit (CICSNOA)
Specifying an alternative security server test data set name (SSCHKDSN)
Specifying the extended minidump data set name pattern (XDUMPDSN)
Specifying the copied SDUMP data set name pattern (SDUMPDSN)
HFZOPTLM data set name symbol substitution
Setting up history files
Determining what size history files to allocate
Allocating a PDS or PDSE for a history file
Allocating secondary space for history files
Converting history files between PDS and PDSE
AUTO-managed PDSE history files
Changing the size of a PDSE history file
Providing the name of a history file to Z Abend Investigator
Setting up views
Specifying a default column layout
Specifying initial fault entry selection criteria
View considerations if not using XFACILIT resource class
Managing history files across MVS systems without shared DASD
Automated implementation
On-demand implementation
Sharing of history files across a sysplex
Managing history file fault entry access
Using the XFACILIT resource class for history file fault entries
XFACILIT implementation example 1
XFACILIT implementation example 2: Using global access table
XFACILIT implementation example 3: Using ACF2
Using the HFZXFXIT user exit
Entry specifications
Input parameter list
Return specifications
Example (C)
Setting and changing default options for the site
Parmlib member HFZCNFxx
Controlling which jobs are analyzed with Exclude processing
Fast Exclude options processing
Controlling report detail
Limiting the size of minidumps
Pointing to listings and REXX exec libraries
Suppressing noncritical SYSLOG messages
Customizing the Fault Entry List display
Specifying the cultural environment
Providing compiler listings or Z Abend Investigator side files
COBOL Report Writer Precompiler
Required compiler options for HFZLANGX
TEST option considerations
DEBUG option considerations
Limitations when using COBOL NOTEST(DWARF,SOURCE)
Naming compiler listings or side files
Creating side files with the HFZLANGX utility
Formatting side files with the HFZLANGP utility
Naming CSECTs for Z Abend Investigator
Locating compiler listings or side files
HFZTRACE information
Using the HFZXSFOR compiler listing/side file search and override exit
HFZXSFOR invocation
Entry specifications
Input parameter list
Return specifications
Example (Assembler)
Compiler listings and side file attributes
Using the HFZRLOAD DDname for CSECT mapping
HFZDATST side file availability test utility
ISPF-packed compiler listings
Providing Java source information to Z Abend Investigator
Examples: Using HFZJAVA DD and HFZJAVA HFZOPTS
Compiling Java for optimal debugging
Generating debugging information with common Java build tools
Customizing the CICS environment
Configuring Language Environment for CICS to invoke Z Abend Investigator
Defining required programs to CICS
Adding the required programs to the startup PLT
Adding the required programs to the shutdown PLT
Enabling dynamic control of analysis of CICS transaction abends
Using CFA to FORCEPURGE the currently analyzed task
SVC dump screening
Sample definition job
Controlling CICS transaction abend analysis
Using CFA from a CICS terminal
Clearing the NoDup(CICSFAST(…)) recording area
HFZTRACE under CICS
Using CFA from an MVS console
Ensuring transaction abend analysis is not suppressed by DUMP(NO)
CICS NoDup(CICSFAST) override assembler exit (HFZNDFUE)
Invocation
Entry specifications
Input parameter list
Return specifications
Example
CICS trace considerations
Preventing LE from causing the CICS trace to wrap
Specifying CICS options through the HFZOPTS DDname
Language Environment abend considerations
Capture of abends running on CICS user key open TCBs (L9 TCBs)
Installing the MVS post-dump exit HFZXTSEL
Storage requirements
Maximizing CICS transaction abend analysis performance
Implementing an XEIIN global user exit
Disabling 3270 screen buffer capture
Customizing the DB2 environment
Binding DB2
DB2 and Language Environment
Improving Z Abend Investigator DB2 performance
Customizing the IMS environment
IMS and Language Environment
Customizing the Z Abend Investigator Japanese feature
Allocating ISPF data sets
Setting the national language
Verifying Z Abend Investigator customization
Verifying the use of Z Abend Investigator with assembler
Verifying the use of Z Abend Investigator with COBOL
Verifying the use of Z Abend Investigator with PL/I
Verifying the use of Z Abend Investigator with C
Verifying the HFZXCEE Language Environment exit enablement
Verifying the HFZTABD USERMOD installation
Verifying Z Abend Investigator customization under CICS
CICS IVP: 0C1 in program HFZXFA
CICS IVP: EXEC CICS DUMP DUMPCODE(FAD1)
CICS IVP: EXEC CICS ABEND ABCODE(FLT1)
CICS IVP: EXEC CICS ABEND ABCODE(FLT2)
Verifying the use of Z Abend Investigator with DB2
Using a C program
Using a COBOL program
Verifying the use of Z Abend Investigator through ISPF
Verifying the recovery fault recording setup
Verifying dump registration (IEAVTSEL)
Managing history files (HFZUTIL utility)
HFZUTIL control statements
FILES control statement
LISTHF control statement
DELETE control statement
SETFAULTPREFIX control statement
SETMAXFAULTENTRIES control statement
SETMINFAULTENTRIES control statement
IMPORT control statement
EXPORT control statement
EXITS control statement
Examples
Example 1. Listing history file entries
Example 2. Deleting history file entries by date
Example 3. Deleting history file entries by utilization
Example 4. Changing history file fault prefix characters
Example 5. Creating a self-maintaining history file
Example 6. Importing history file entries
HFZUTIL batch utility user exit samples
Providing application-specific explanations and descriptions
User-defined message explanations
User-defined abend code explanations
User-defined program descriptions
Maintaining Z Abend Investigator
Disabling Z Abend Investigator
Temporarily uninstalling Z Abend Investigator
Turning off Z Abend Investigator with a JCL switch (HFZOFF)
Turning off Z Abend Investigator using an environment variable (_HFZ_OFF)
Customizing Z Abend Investigator by using user exits
Invocation parameters
Global environment data area (ENV)
User exit type specific data area
Supported exit programming languages
Determining which exit type is invoking a common user exit
Data area version checking
Diagnostic tracing
Tracing user exit parameter list values
Tracing REXX EXECs
Descriptions of fault analysis user exit types
Analysis Control user exit
Purpose
When invoked
Parameters
REXX
Load module
Example
Analysis Control user exit (MVS SVC Dump registration)
Purpose
When invoked
Parameters
Example
Compiler Listing Read user exit
Purpose
When invoked
Parameters
REXX
Load module
Example
Message and Abend Code Explanation user exit
Purpose
When invoked
Parameters
REXX
Load module
Example
Formatting user exit
Purpose
When invoked
Parameters
Sample Formatting user exits
End Processing user exit
Purpose
When invoked
Parameters
REXX
Load module
Example
End Processing user exit (Fault entry refresh)
Purpose
When invoked
Parameters
Example
Notification user exit
Purpose
When invoked
Parameters
REXX
Load module
Calling a non-REXX logging routine from REXX
Example 1
Example 2
Example 3
Example 4
Notification user exit (MVS SVC Dump registration)
Purpose
When invoked
Parameters
Example
Descriptions of HFZUTIL batch utility user exit types
HFZUTIL Import user exit
Purpose
When invoked
Parameters
REXX
Load module
Example
HFZUTIL Delete user exit
Purpose
When invoked
Parameters
REXX
Load module
Example
HFZUTIL ListHF user exit
Purpose
When invoked
Parameters
REXX
Load module
Example 1: Invoking the HFZUTIL ListHF user exit
Example 2: Creating a custom report and CSV file of fault entries with the HFZUTIL ListHF user exit
Example 3: Collecting abend data for later statistical analysis with the HFZUTIL user exit
User exit REXX commands
Evaluate command
Parameters
Return codes
Example
HFZALLOC command
Return codes
Example
HFZDDTEST command
Return codes
Example
HFZDSECTdsn command
Return codes
Example
HFZDSNTEST command
HFZEventInfo command
Parameters
Return codes
Example
HFZFREE command
Return codes
Example
HFZGET command
HFZModQry command
Return codes
Example
HFZPUT command
HFZRegisterFaultEntry command
Return codes
Example
HFZWRITE command
Return codes
Example
HFZWTO command
Return codes
Example
List command
Parameters
Return codes
Example
Note command
Parameters
Return codes
Example
Formatting tags
ADDR (address)
Description
AREA (area)
Description
DD (definition description)
Description
DATA (data)
Description
DL (definition list)
Description
DT (definition term)
Description
DUMP (EBCDIC dump)
Description
DUMPA (ASCII dump)
Description
HP (highlighted phrase)
Description
L (line)
Description
LI (list item)
Description
NOTEL (note list)
Description
P (paragraph)
Description
TH (table heading)
Description
U (underline)
Description
UL (unordered list)
Description
The HFZXUFMT load module Formatting user exit
HFZXUFMT functions
HFZXDLOC – Locate dump storage using system buffering
HFZXEINF – Obtain event information
HFZXGETN – Get data area decimal character field value
HFZXGETS - Get data area character field as C string
HFZXGETX – Get data area hexadecimal character field value
HFZXLIST – Print storage area in report
HFZXNOTE – Write simple line of text to report
HFZXTRCE – Write simple line of text to HFZTRACE
HFZXWRIT – Write formatted text to report
HFZXWTO – Write message to MVS console
HFZXXLOC – Locate dump storage using own buffering
Z Abend Investigator reference information
Options
Where to specify options
Parmlib member HFZCNF00
User-options module HFZCNFUM
The _HFZ_OPTSFILE environment variable
User options file HFZOPTS
The JCL EXEC statement PARM field
The _HFZ_OPTS environment variable
Option descriptions
AdditionalHFZOffDD
CallEqaueDat
CICSDumpTableExclude
CICSTraceMax
DataSets
Data set logical replacement or concatenation order
Dropping HFZCNF00 parmlib member data set specifications
DataSets option data set name substitution symbols
Symbol substring specification
DeferredReport
Detail
DumpDSN
DumpRegistrationExits
ErrorHandler
Exclude/Include
Using Exclude/Include options with dump registration processing
Exclude/Include trace information
Exclude/Include wildcard examples
Exits
Dropping HFZCNF00 parmlib member user exit specifications
FAISPFopts
BatchOpts
GlobalExclude
HistCols
InitHist
InteractiveExitPromptSeconds
FaultID
GenerateSavedReport
Include
JclCapture
Language
LangxCapture
Locale
LoopProtection
MaxMinidumpPages
NoDup
NoDup(ImageFast(…))
NoDup(CICSFAST(…))
Changing the NoDup(CICSFAST) option
NoDup(NORMAL(…))
Trace information
PermitLangx
Using wildcards
Combining multiple option specifications
Maximum length of suboptions
PreferredFormattingWidth
PrintInactiveCOBOL
Quiet
RefreshExits
RetainCICSDump
RetainDump
Snapdata
Source
SpinHFZREPRT
StoragePrintLimit
StorageRange
SystemWidePreferred
Data areas
Non-REXX user exit buffered data format
Data area descriptions
CTL - Analysis Control user exit parameter list
ENV - Common exit environment information
EPC - End Processing user exit parameter list
LST - Compiler Listing Read user exit parameter list
NFY - Notification user exit parameter list
UFM - Formatting user exit parameter list
UTL - HFZUTIL Batch Utility user exit parameter list
XPL - Message and Abend Code Explanation user exit parameter list
Return codes
Messages
Z Abend Investigator messages
HFZLANGX messages
Sample customized ISPF interface front-end
Fault History File or VIEW name
MATCH on program name
Installing the sample application
How the sample works
Technical details for screen size adjustments
Notices
Glossary
Accessibility features for Z Abend Investigator
About this document
Who should use this document
Organization of this document
How to read the syntax diagrams
Using Z Abend Investigator
Introduction
The analysis engine
The analysis process
Real-time abend analysis
Real-time SNAP analysis
Fault reanalysis
Batch reanalysis
Interactive reanalysis
Fault history files
Associated dump data sets
Special members in the history file data set
Supported application environments
Binder-related dependencies
Setting up existing programs for fault analysis
Additional region size required
Compiler listing or side file selection criteria
Special processing of Language Environment CEEWUCHA abends
WTO routing and descriptor codes used by Z Abend Investigator
CICS Storage Accounting Area (SAA) overlay assistance
Real-time analysis
Dump suppression
Z Abend Investigator and CICS global user exits
Fault history file selection
Controlling the real-time analysis with options
Pointing to listings with JCL DD statements
The real-time analysis report
Combining Z Abend Investigator real-time reports
Controlling the SYSOUT class of real-time reports
Suppressing real-time reports
The SYSLOG summary
Using the program SNAP interface (HFZSNAP)
HFZSNAP invocation
Entry specifications
Input parameter list
Return specifications
Example 1 (COBOL)
Example 2 (PL/I: non-DLL)
Example 3 (PL/I: 31-bit DLL)
Example 4 (PL/I: 64-bit DLL)
Example 5 (Assembler)
Invoking Z Abend Investigator from a Java try-catch block
Invoking Z Abend Investigator from Java dump events
Using the Z Abend Investigator Java wrapper utility
Using the Z Abend Investigator JVMTI Agent
Dump registration processing
Real-time exclusion processing
Duplicate fault processing
Recovery fault recording
RFR dump titles
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
The Z Abend Investigator ISPF interface
Invoking the interface
ISPF split screen support
The Fault Entry List display
Using views
Changing the history file or view displayed
Fault entry list column configuration
Available columns
Sorting and matching fault entries
Additional ways to match and select faults
Cursor-selecting a matching value
Over-typing existing values
Using the MATCH command
Applying an action to a particular fault
History file properties
New history file allocation
Change fault history file settings
Resetting history file access information
Refreshing fault entry information
Implicit refresh
Updates pending
Fault entry expiration control
Action-bar pull-down menus
Commands
CE
CICSD
CICSLINK
CICSSTG
COLS
COPY
DISASM
DSECT
DUPS
EDIT
EXEC
FIND
HFZSINFO
INFO
JCL
LOOKUP
MATCH
NEXT
NOTE
NOTELIST
PREV
QUIT
REFRESH
RESET
RPTFIND
RUNCHAIN
SHOW
SHOWFREE
STCK
STGMAP
VIEWS
Z Abend Investigator preferences
BatchOpts
Viewing a saved report
Adding or removing blank lines
Adding or removing help text
Setting preferred formatting width
Displaying user-selected message or abend code explanations
Copying interactive displays to a file
Displaying product copyright, license, and version information
Deleting history file entries
Locking a fault entry
Viewing fault entry information
Viewing the fault entry duplicate history
Expanding and collapsing duplicate fault entries
Copying history file entries
Moving history file entries
Transmitting history file entries
Packaging fault entries
Security considerations
Specifying 64-bit addresses
Using the interactive HFZS subsystem interface
Managed history files
Excluded history files
Selected history files
Performing batch reanalysis
Batch reanalysis options
Initiating batch reanalysis
Data sets used for batch reanalysis
Creating your own batch reanalysis job
Performing interactive reanalysis
Interactive reanalysis options
Initiating interactive reanalysis
Status pop-up display
General information about the interactive report
Exit from the interactive report
Primary option: Synopsis
Primary option: Event Summary
Detailed Event Information
Primary option: Open Files
Primary option: CICS Information
CICS Control Blocks
CICS Transaction Storage Summary
CICS Transaction Storage
Last CICS 3270 Screen Buffer
Summarized CICS Trace
CICS Trace Formatting
CICS Recovery Manager
CICS Levels, Commareas, and Channels
CICS Monitoring Data
CICS Event Program Information
Primary option: Messages
Primary option: Db2 Information
Primary option: IMS Information
Primary option: Storage Areas
Primary option: Java Information
Primary option: Language Environment Heap Analysis
Primary option: MTRACE Records
Primary option: Abend Job Information
Primary option: User Notes
Primary option: Z Abend Investigator Options
Displaying associated storage areas
Hiding the hex-value column
Collapsing level 88 items
Showing all COBOL base locators
Expanding messages and abend codes
Displaying source code
Displaying storage locations
Displaying data areas
Creating and managing user notes
Displaying CICS transaction storage (CICSSTG)
Displaying the address space storage map (STGMAP)
Displaying PSW information
Mapping storage areas using DSECT information
HFZDSECT concatenation
Indexing your DSECT data sets ($DINDEX member)
Displaying chained data areas
Disassembling object code
Converting STORE CLOCK values
User-specific report formatting
Prompting for compiler listing or side file
Controlling prompting
Data sets used for interactive reanalysis
Refresh processing
COBOL Explorer
COBOL Explorer example
Performing CICS system abend dump analysis
Setting options for CICS system abend analysis
User exits
Selecting a CICS dump data set
Selecting an address space to analyze
Displaying the CICS system abend interactive report
Fastpath navigation
Option 1: Synopsis
Option 2: Abend Job Information
Option 3: CICS System Information
Sorting and matching table displays
Option 4: Options in Effect
Creating a history file entry
Formatting a CICS auxiliary trace data set
Selecting a CICS auxiliary trace data set
Specifying CICS Trace Selection Parameters
Performing Java analysis
Selecting a Java dump data set
Java fault entry reanalysis
Displaying the Java information in the interactive report
Java event replacement in Z Abend Investigator event list
Java information reporting limitations
Java application samples
Sample 1 (HFZSJAV1): Enterprise PL/I invoking Java in batch
Sample 2 (HFZSJAV2): Enterprise COBOL invoking Java in batch
Sample 3 (HFZSJAV3): 64-bit Enterprise PL/I invoking Java in batch
Sample 4 (HFZSJAV4): IMS Java batch processing sample
Sample 5 (HFZSJAV5): C++ program invoking Java in batch
Sample 6 (HFZSJAV6): Call a Java batch application with the Z Abend Investigator wrapper utility
The Z Abend Investigator report
General report information
Most significant abend code
Open file record information
Spanned record interpretation
COBOL suppressed copybooks
Main report sections
The prolog section
The synopsis section
The summary section
Maximum call depth
The event details section
The system-wide information section
The abend job information section
The options section
The epilog section
Sample reports
Z Abend Investigator installation and administration
Preparing to customize Z Abend Investigator
Checklist for installing and customizing Z Abend Investigator
Library names after you finish installing
Storage recommendations
Exits for invoking Z Abend Investigator
Invocation for non-CICS transaction abends
Summary of exit usage
Invocation for CICS transaction abends
SVC dump registration
Language Environment options required for invocation of Z Abend Investigator
LE options required for non-CICS abends
LE options required to capture Java application abends
LE options required for CICS abends
Running Z Abend Investigator with similar third-party products
MVS dump data set size
Application-handled error conditions
Setting Z Abend Investigator SLIP traps
Customizing the operating environment for Z Abend Investigator
Making Z Abend Investigator modules available
Defining program control access to Z Abend Investigator programs
Restricting change of history file settings
Setting up the message and abend code explanation repository
Managing recovery fault recording data set access
SDUMP recovery fault recording data sets
Using the XFACILIT resource class for SDUMP RFR data sets
TDUMP recovery fault recording data sets
Using the XFACILIT resource class for TDUMP RFR data sets
RFR TDUMP XFACILIT example
Managing XDUMP data set access
Using the XFACILIT resource class for XDUMP data sets
Managing copied SDUMP data set access
Using the Z Abend Investigator HFZS subsystem
Sysplex-wide subsystem inter-communication
Caching of history file $$INDEX data
Starting the HFZS subsystem
HFZS subsystem storage requirements
HFZS subsystem requirements for DB2
HFZS subsystem requirements for Java
Specifying an HFZJLIB DD statement
Specifying a default JVM for Java dump analysis
Stopping the HFZS subsystem
Modifying your ISPF environment
Allocating ISPF data sets
Making the Z Abend Investigator HFZSCMDS command table available
Updating the ISPF selection panel
Invoking Z Abend Investigator using an ISPF 3.4 line command
Invoking Z Abend Investigator from SDSF (SFA command)
Invoking the LOOKUP command using cursor selection (LOOKC command)
Providing ISPF interface defaults for new users
Providing installation-specific batch reanalysis JCL control statements
Increasing the display area for Z Abend Investigator reports
Customize Z Abend Investigator by using USERMODs
Enabling Z Abend Investigator to be invoked
Installing the MVS change options/suppress dump exit HFZXDCAP
Enabling the Language Environment abnormal termination exit (HFZXCEE or HFZXCE64)
Working with applications that use a non-Language Environment run time
Eliminating the need for a dump DD statement (++HFZTABD)
Obtaining load modules from CA-Panexec
Using a nonstandard LE parameter list separator character (++HFZOPT1)
Suppressing HFZXDCAP real-time analysis if prior exit RC=8 (++HFZOPT2)
Customize Z Abend Investigator by using an HFZOPTLM configuration-options module
Specifying an alternative parmlib data set for HFZCNFxx (CNFDSN)
Changing the default recovery fault recording IEATDUMP data set name (RFRDSN)
Changing the action of Z Abend Investigator when invoked via the CICS XDUREQ global user exit (CICSNOA)
Specifying an alternative security server test data set name (SSCHKDSN)
Specifying the extended minidump data set name pattern (XDUMPDSN)
Specifying the copied SDUMP data set name pattern (SDUMPDSN)
HFZOPTLM data set name symbol substitution
Setting up history files
Determining what size history files to allocate
Allocating a PDS or PDSE for a history file
Allocating secondary space for history files
Converting history files between PDS and PDSE
AUTO-managed PDSE history files
Changing the size of a PDSE history file
Providing the name of a history file to Z Abend Investigator
Setting up views
Specifying a default column layout
Specifying initial fault entry selection criteria
View considerations if not using XFACILIT resource class
Managing history files across MVS systems without shared DASD
Automated implementation
On-demand implementation
Sharing of history files across a sysplex
Managing history file fault entry access
Using the XFACILIT resource class for history file fault entries
XFACILIT implementation example 1
XFACILIT implementation example 2: Using global access table
XFACILIT implementation example 3: Using ACF2
Using the HFZXFXIT user exit
Entry specifications
Input parameter list
Return specifications
Example (C)
Setting and changing default options for the site
Parmlib member HFZCNFxx
Controlling which jobs are analyzed with Exclude processing
Fast Exclude options processing
Controlling report detail
Limiting the size of minidumps
Pointing to listings and REXX exec libraries
Suppressing noncritical SYSLOG messages
Customizing the Fault Entry List display
Specifying the cultural environment
Providing compiler listings or Z Abend Investigator side files
COBOL Report Writer Precompiler
Required compiler options for HFZLANGX
TEST option considerations
DEBUG option considerations
Limitations when using COBOL NOTEST(DWARF,SOURCE)
Naming compiler listings or side files
Creating side files with the HFZLANGX utility
Formatting side files with the HFZLANGP utility
Naming CSECTs for Z Abend Investigator
Locating compiler listings or side files
HFZTRACE information
Using the HFZXSFOR compiler listing/side file search and override exit
HFZXSFOR invocation
Entry specifications
Input parameter list
Return specifications
Example (Assembler)
Compiler listings and side file attributes
Using the HFZRLOAD DDname for CSECT mapping
HFZDATST side file availability test utility
ISPF-packed compiler listings
Providing Java source information to Z Abend Investigator
Examples: Using HFZJAVA DD and HFZJAVA HFZOPTS
Compiling Java for optimal debugging
Generating debugging information with common Java build tools
Customizing the CICS environment
Configuring Language Environment for CICS to invoke Z Abend Investigator
Defining required programs to CICS
Adding the required programs to the startup PLT
Adding the required programs to the shutdown PLT
Enabling dynamic control of analysis of CICS transaction abends
Using CFA to FORCEPURGE the currently analyzed task
SVC dump screening
Sample definition job
Controlling CICS transaction abend analysis
Using CFA from a CICS terminal
Clearing the NoDup(CICSFAST(…)) recording area
HFZTRACE under CICS
Using CFA from an MVS console
Ensuring transaction abend analysis is not suppressed by DUMP(NO)
CICS NoDup(CICSFAST) override assembler exit (HFZNDFUE)
Invocation
Entry specifications
Input parameter list
Return specifications
Example
CICS trace considerations
Preventing LE from causing the CICS trace to wrap
Specifying CICS options through the HFZOPTS DDname
Language Environment abend considerations
Capture of abends running on CICS user key open TCBs (L9 TCBs)
Installing the MVS post-dump exit HFZXTSEL
Storage requirements
Maximizing CICS transaction abend analysis performance
Implementing an XEIIN global user exit
Disabling 3270 screen buffer capture
Customizing the DB2 environment
Binding DB2
DB2 and Language Environment
Improving Z Abend Investigator DB2 performance
Customizing the IMS environment
IMS and Language Environment
Customizing the Z Abend Investigator Japanese feature
Allocating ISPF data sets
Setting the national language
Verifying Z Abend Investigator customization
Verifying the use of Z Abend Investigator with assembler
Verifying the use of Z Abend Investigator with COBOL
Verifying the use of Z Abend Investigator with PL/I
Verifying the use of Z Abend Investigator with C
Verifying the HFZXCEE Language Environment exit enablement
Verifying the HFZTABD USERMOD installation
Verifying Z Abend Investigator customization under CICS
CICS IVP: 0C1 in program HFZXFA
CICS IVP: EXEC CICS DUMP DUMPCODE(FAD1)
CICS IVP: EXEC CICS ABEND ABCODE(FLT1)
CICS IVP: EXEC CICS ABEND ABCODE(FLT2)
Verifying the use of Z Abend Investigator with DB2
Using a C program
Using a COBOL program
Verifying the use of Z Abend Investigator through ISPF
Verifying the recovery fault recording setup
Verifying dump registration (IEAVTSEL)
Managing history files (HFZUTIL utility)
HFZUTIL control statements
FILES control statement
LISTHF control statement
DELETE control statement
SETFAULTPREFIX control statement
SETMAXFAULTENTRIES control statement
SETMINFAULTENTRIES control statement
IMPORT control statement
EXPORT control statement
EXITS control statement
Examples
Example 1. Listing history file entries
Example 2. Deleting history file entries by date
Example 3. Deleting history file entries by utilization
Example 4. Changing history file fault prefix characters
Example 5. Creating a self-maintaining history file
Example 6. Importing history file entries
HFZUTIL batch utility user exit samples
Providing application-specific explanations and descriptions
User-defined message explanations
User-defined abend code explanations
User-defined program descriptions
Maintaining Z Abend Investigator
Disabling Z Abend Investigator
Temporarily uninstalling Z Abend Investigator
Turning off Z Abend Investigator with a JCL switch (HFZOFF)
Turning off Z Abend Investigator using an environment variable (_HFZ_OFF)
Customizing Z Abend Investigator by using user exits
Invocation parameters
Global environment data area (ENV)
User exit type specific data area
Supported exit programming languages
Determining which exit type is invoking a common user exit
Data area version checking
Diagnostic tracing
Tracing user exit parameter list values
Tracing REXX EXECs
Descriptions of fault analysis user exit types
Analysis Control user exit
Purpose
When invoked
Parameters
REXX
Load module
Example
Analysis Control user exit (MVS SVC Dump registration)
Purpose
When invoked
Parameters
Example
Compiler Listing Read user exit
Purpose
When invoked
Parameters
REXX
Load module
Example
Message and Abend Code Explanation user exit
Purpose
When invoked
Parameters
REXX
Load module
Example
Formatting user exit
Purpose
When invoked
Parameters
Sample Formatting user exits
End Processing user exit
Purpose
When invoked
Parameters
REXX
Load module
Example
End Processing user exit (Fault entry refresh)
Purpose
When invoked
Parameters
Example
Notification user exit
Purpose
When invoked
Parameters
REXX
Load module
Calling a non-REXX logging routine from REXX
Example 1
Example 2
Example 3
Example 4
Notification user exit (MVS SVC Dump registration)
Purpose
When invoked
Parameters
Example
Descriptions of HFZUTIL batch utility user exit types
HFZUTIL Import user exit
Purpose
When invoked
Parameters
REXX
Load module
Example
HFZUTIL Delete user exit
Purpose
When invoked
Parameters
REXX
Load module
Example
HFZUTIL ListHF user exit
Purpose
When invoked
Parameters
REXX
Load module
Example 1: Invoking the HFZUTIL ListHF user exit
Example 2: Creating a custom report and CSV file of fault entries with the HFZUTIL ListHF user exit
Example 3: Collecting abend data for later statistical analysis with the HFZUTIL user exit
User exit REXX commands
Evaluate command
Parameters
Return codes
Example
HFZALLOC command
Return codes
Example
HFZDDTEST command
Return codes
Example
HFZDSECTdsn command
Return codes
Example
HFZDSNTEST command
HFZEventInfo command
Parameters
Return codes
Example
HFZFREE command
Return codes
Example
HFZGET command
HFZModQry command
Return codes
Example
HFZPUT command
HFZRegisterFaultEntry command
Return codes
Example
HFZWRITE command
Return codes
Example
HFZWTO command
Return codes
Example
List command
Parameters
Return codes
Example
Note command
Parameters
Return codes
Example
Formatting tags
ADDR (address)
Description
AREA (area)
Description
DD (definition description)
Description
DATA (data)
Description
DL (definition list)
Description
DT (definition term)
Description
DUMP (EBCDIC dump)
Description
DUMPA (ASCII dump)
Description
HP (highlighted phrase)
Description
L (line)
Description
LI (list item)
Description
NOTEL (note list)
Description
P (paragraph)
Description
TH (table heading)
Description
U (underline)
Description
UL (unordered list)
Description
The HFZXUFMT load module Formatting user exit
HFZXUFMT functions
HFZXDLOC – Locate dump storage using system buffering
HFZXEINF – Obtain event information
HFZXGETN – Get data area decimal character field value
HFZXGETS - Get data area character field as C string
HFZXGETX – Get data area hexadecimal character field value
HFZXLIST – Print storage area in report
HFZXNOTE – Write simple line of text to report
HFZXTRCE – Write simple line of text to HFZTRACE
HFZXWRIT – Write formatted text to report
HFZXWTO – Write message to MVS console
HFZXXLOC – Locate dump storage using own buffering
Z Abend Investigator reference information
Options
Where to specify options
Parmlib member HFZCNF00
User-options module HFZCNFUM
The _HFZ_OPTSFILE environment variable
User options file HFZOPTS
The JCL EXEC statement PARM field
The _HFZ_OPTS environment variable
Option descriptions
AdditionalHFZOffDD
CallEqaueDat
CICSDumpTableExclude
CICSTraceMax
DataSets
Data set logical replacement or concatenation order
Dropping HFZCNF00 parmlib member data set specifications
DataSets option data set name substitution symbols
Symbol substring specification
DeferredReport
Detail
DumpDSN
DumpRegistrationExits
ErrorHandler
Exclude/Include
Using Exclude/Include options with dump registration processing
Exclude/Include trace information
Exclude/Include wildcard examples
Exits
Dropping HFZCNF00 parmlib member user exit specifications
FAISPFopts
BatchOpts
GlobalExclude
HistCols
InitHist
InteractiveExitPromptSeconds
FaultID
GenerateSavedReport
Include
JclCapture
Language
LangxCapture
Locale
LoopProtection
MaxMinidumpPages
NoDup
NoDup(ImageFast(…))
NoDup(CICSFAST(…))
Changing the NoDup(CICSFAST) option
NoDup(NORMAL(…))
Trace information
PermitLangx
Using wildcards
Combining multiple option specifications
Maximum length of suboptions
PreferredFormattingWidth
PrintInactiveCOBOL
Quiet
RefreshExits
RetainCICSDump
RetainDump
Snapdata
Source
SpinHFZREPRT
StoragePrintLimit
StorageRange
SystemWidePreferred
Data areas
Non-REXX user exit buffered data format
Data area descriptions
CTL - Analysis Control user exit parameter list
ENV - Common exit environment information
EPC - End Processing user exit parameter list
LST - Compiler Listing Read user exit parameter list
NFY - Notification user exit parameter list
UFM - Formatting user exit parameter list
UTL - HFZUTIL Batch Utility user exit parameter list
XPL - Message and Abend Code Explanation user exit parameter list
Return codes
Messages
Z Abend Investigator messages
HFZLANGX messages
Sample customized ISPF interface front-end
Fault History File or VIEW name
MATCH on program name
Installing the sample application
How the sample works
Technical details for screen size adjustments
Notices
Glossary