Abend-AID for CICS User`s Guide

Abend-AID for CICS
User’s Guide
Release 17.02
ii
Abend-AID for CICS User’s Guide
Please direct questions about Abend-AID for CICS
or comments on this document to:
Compuware Customer Support
https://go.compuware.com/
This document and the product referenced in it are subject to the following legends:
Copyright 1994-2017 Compuware Corporation. All rights reserved. Unpublished rights reserved under the
Copyright Laws of the United States.
U.S. GOVERNMENT RIGHTS-Use, duplication, or disclosure by the U.S. Government is subject to
restrictions as set forth in Compuware Corporation license agreement and as provided in DFARS
227.7202-1(a) and 227.7202-3(a) (1995), DFARS 252.227-7013(c)(1)(ii) (OCT 1988), FAR 12.212(a) (1995),
FAR 52.227-19, or FAR 52.227-14 (ALT III), as applicable. Compuware Corporation.
This product contains confidential information and trade secrets of Compuware Corporation. Use,
disclosure, or reproduction is prohibited without the prior express written permission of Compuware
Corporation. Access is limited to authorized users. Use of this product is subject to the terms and
conditions of the user’s License Agreement with Compuware Corporation.
Abend-AID, Compuware, FrontLine, Xpediter/CICS, and Xpediter/TSO are trademarks or registered
trademarks of Compuware Corporation.
CICS, DB2, IBM, IMS, Language Environment, MVS/ESA, Softcopy Reader, VisualAge, VTAM, WebSphere,
and z/OS are trademarks or registered trademarks of International Business Machines Corporation.
Adobe® Reader® is a trademark of Adobe Systems Incorporated in the United States and/or other
countries.
All other company and product names are trademarks or registered trademarks of their respective owners.
Doc. JUL2017
June 27, 2017
iii
Contents
Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xix
Intended Audience . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xix
User’s Guide Organization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xix
Notation Rules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xx
Related Publications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xxi
Online Help . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xxi
IBM Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xxi
Online Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xxii
Getting Help . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xxii
Compuware FrontLine Customer Support Website . . . . . . . . . . . . . . . . . xxii
Contacting Customer Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xxii
Phone . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xxii
Web . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xxii
Mail . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xxii
Corporate Website. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xxii
Abend-AID for CICS Customer Support . . . . . . . . . . . . . . . . . . . . . . . . . .xxiii
Part 1. Abend-AID for CICS Basics
Chapter 1. Abend-AID for CICS Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-1
System Environment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-1
Product Components . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-1
Transaction Dump Capture Component . . . . . . . . . . . . . . . . . . . . . . . . . . 1-1
Transaction Dump Interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-2
Transaction Dump Capture Address Space (TDCAS) . . . . . . . . . . . . . 1-2
Region Dump Capture Component . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-3
Region Dump Interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-4
MVS Post-Dump Exit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-5
Viewing Server Component . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-5
Product Functions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-7
Dump-Independent Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-7
Transaction Abend Analysis Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-7
Region Dump Analysis Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-9
General Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-11
Online Help . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-12
Screen Help . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-12
Field Help . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-12
Message Help . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-13
Command Help . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1-13
Chapter 2. Getting Started . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-1
Logging On to Abend-AID for CICS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-1
Selecting a Viewing Server (ISPF Access Only) . . . . . . . . . . . . . . . . . . . . . . . . . . 2-2
Displaying Server Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-3
Selecting an Entry . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-3
Exiting Abend-AID for CICS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-4
Chapter 3. Abend-AID for CICS Interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-1
Screen Layout . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3-1
Screen Borders . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3-2
iv
Abend-AID for CICS User’s Guide
Scroll Information Fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Masking and Sorting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Rearrange Column Headings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Row Field . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Up/Down Scroll Field. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Left/Right Scroll Field . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
COMMAND and OPTION Fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Line Commands. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Screen Attribute Defaults . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Screen Access . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Menu Selections . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Cursor Point-and-Shoot Feature . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Using a Mouse with the Point-and-Shoot Feature . . . . . . . . . . . . . .
ASSIST Function . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Navigation Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Fast-Path Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Jump Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Primary Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Command Availability . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
ISPF/TSO Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
3-2
3-3
3-3
3-3
3-4
3-4
3-4
3-5
3-5
3-6
3-6
3-7
3-7
3-7
3-7
3-8
3-8
3-8
3-9
3-9
Chapter 4. Working with Dumps . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-1
Fault Summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-1
Abend-AID Directory. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-3
Automatically Restoring Mask and Sort Values . . . . . . . . . . . . . . . . . . . . 4-3
Types of Directory Entries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-6
Line Commands. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-6
Transaction Entry Information Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-9
Region Entry Information Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-10
Entry Users Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-10
Duplicate History Log . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-11
Duplicate Dump Expiration Interval . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-12
Duplicate Dump Suppression and Region Dumps . . . . . . . . . . . . . . . . . 4-13
Contact Information Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-13
Chapter 5. Accessing Storage Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Displaying Control Blocks and Storage Information . . . . . . . . . . . . . . . . . . . .
CORE Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
HEXD Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Control Blocks and Storage Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Using the Memory Display Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Offset Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
FIND Command. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Find for Storage Display Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Tracking Storage Navigation (Paperclip Function) . . . . . . . . . . . . . . . . . . . . . .
Current Paperclip Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Saved Paperclip List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Running Control Block Chains. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
5-1
5-1
5-1
5-1
5-1
5-2
5-4
5-4
5-5
5-5
5-5
5-7
5-7
Chapter 6. Displaying DSECTs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Displaying Control Blocks in DSECT Format . . . . . . . . . . . . . . . . . . . . . . . . . .
Selecting the Appropriate DSECT Type. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
CICS Transaction Server DSECTs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
MVS DSECTs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
6-1
6-1
6-3
6-3
6-8
Chapter 7. Printing Abend-AID for CICS Information . . . . . . . . . . . . . . . . . . . . . . 7-1
Online Printing Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-1
v
Print Options and Initiation Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7-1
Printing Screen Images . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-3
Printing Abend-AID for CICS-Supplied Reports . . . . . . . . . . . . . . . . . . . . . . . . 7-5
Complete Transaction Abend Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-5
Transaction Abend Summary Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-6
Complete DB2 Transaction Abend Report . . . . . . . . . . . . . . . . . . . . . . . . .7-6
DB2 Transaction Abend Summary Report . . . . . . . . . . . . . . . . . . . . . . . . .7-7
Region Dump Summary Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-7
Printing Directory Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-8
Part 2. Transaction Abend Processing
Chapter 8. Analyzing Transaction Abends . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-1
Diagnostic Summary. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .8-1
Program Detail Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-6
Task Detail Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-7
Terminal Detail Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-9
Call Detail Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-10
Program Listing Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-11
Accessing Storage for a Variable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-12
Impact Analysis Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-13
Impact Analysis Results Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-13
Impacts - Programs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-14
Impacted By - Programs Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-15
Impacts - Data Items Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-16
Impacted By - Data Items Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-17
Program Details Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-18
Data Item Details Screen. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-19
Impact Analysis Listing. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-20
3270 Bridge Information Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-20
Expanded Data Field Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-21
DFHRPL Concatenation Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-21
User Execute Interface Block Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-22
Last 3270 Screen Image . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-23
Data Stream Analysis Screen. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-23
Program Call Trace Summary Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-24
PSW Information Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-25
PSW Analysis Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .8-26
Registers Screen. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-26
Floating-Point Registers Screen. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-27
Floating Point Interpretation Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-28
Transaction Abend Control Blocks Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-28
DB2 Information Screens . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-29
DB2 Information Menu. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-29
Host Variables Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-30
Bind Information Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-31
Precompile Information Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-32
Columns Referenced Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-32
Package Dependencies Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-32
SQL Communications Area . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-33
RCT Detail Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-33
WebSphere MQ Information Screens . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-34
WebSphere MQ Information Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . .8-35
WebSphere MQ Reason Code Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-35
Last WebSphere MQ Call Information Screen . . . . . . . . . . . . . . . . . . . . . 8-36
Handle Information Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-37
vi
Abend-AID for CICS User’s Guide
Message Descriptor Screens . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
PMO Detail Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Message Buffer Area Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Local Queue Definition Screens. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Open Options Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
PMO Options Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Report Options Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
GMO Detail Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Match Options Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Alias Queue Definition Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
GMO Options Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Opened Queues at Dump Time Screen . . . . . . . . . . . . . . . . . . . . . . . . . .
WebSphere MQ System Information Screen . . . . . . . . . . . . . . . . . . . . . .
Hogan Information Screens . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
DL/I Information Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
MSA Information Screens . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
MSA Information Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
DCI and Application DMCBS Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . .
DCI Trace Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
8-38
8-39
8-40
8-40
8-41
8-42
8-43
8-43
8-44
8-44
8-45
8-46
8-46
8-47
8-49
8-50
8-50
8-51
8-51
Chapter 9. Displaying Additional Transaction Abend Information . . . . . . . . . . . . 9-1
Program Information Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-1
Program Link Information Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-2
Program Summary Information Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-4
Compiler Options Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-5
Extended Search Listing Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-6
Field Usage Summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-7
Other Fields Screen. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-7
Program Call Trace Summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-8
COBOL Perform Flow Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-8
Program Levels Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-9
Channels Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-10
Containers Screen. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-10
Container Segments Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-11
Optional z/Architecture Features Screen. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-11
COBOL Storage Areas Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-12
Working Storage. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-13
Linkage Section . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-13
External Cells . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-14
Task Global Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-14
Local Storage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-14
Dynamic Storage Area . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-15
PL/I Storage Selection List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-15
PL/I Storage Display . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-16
PL/I Storage Areas Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-17
Automatic Storage Areas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-17
Static Storage Areas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-18
Controlled Storage Area . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-18
External Storage Areas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-19
Assembler Storage Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-19
Assembler Storage Area Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-20
Storage Disassembly Screen. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-21
Data Locator Search Criteria Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-22
Data Locator Results Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-23
File Request Summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-24
Record Image Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-24
File Detail Screens . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-25
vii
File-Related Areas Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-26
File Recovery Information Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-26
CICS Web Interface Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-27
LE Information Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-28
LE Options Control Block Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-28
LE Information Summary Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-28
Chapter 10. Managing Source Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-1
Source Directory Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-1
Using Distributed Viewing Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . .10-3
Source Program Directory. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-5
Source Mismatch Selection Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-7
Source Program Directory Screen for Source Mismatch Selection . . . . . . . . . . 10-8
Convert Program Compiler Listing Screen. . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-9
Utilities Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-11
No Source Selected Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-12
Chapter 11. Using Abend-AID for CICS with Language Environment . . . . . . . . 11-1
LE Support. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-1
LE Information in the Abend-AID for CICS Report . . . . . . . . . . . . . . . . . . . . . 11-1
Abend-AID for CICS Processing of Abends . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-2
Chapter 12. Analyzing Data Exceptions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12-1
Analyzing a Sample S0C7 Data Exception . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12-1
Part 3. Region Dump Processing
Chapter 13. Importing Region Dumps . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-1
Required Dump Dataset Attributes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-1
Impact on the Abend-AID Directory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-2
Impact on Dump Analysis . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-2
Importing Dumps Automatically . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-2
Importing Dumps Manually. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-3
SVC Dump Import Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-3
MVS MODIFY Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-3
Chapter 14. Analyzing CICS Region Dumps . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14-1
Diagnostic Summary for CICS Region Dumps. . . . . . . . . . . . . . . . . . . . . . . . . 14-1
Task Detail Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14-5
Task/Wait Analysis Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14-6
Task Summary Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14-7
Task/Wait Analysis Screen. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14-7
Program Level Summary. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14-9
Channels Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14-9
Containers Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14-10
Trace Listing Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .14-11
Kernel Domain Error Table Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14-12
Enqueue Summary Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14-14
Program Change Summary Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14-15
Storage Addressability Summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .14-16
Storage Address Analysis Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14-17
Chapter 15. Analyzing SVC Dumps . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15-1
SVC Dump Diagnostic Summary Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . .15-1
Memory Display Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15-4
Scrollable Information. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15-4
Primary Commands. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15-5
viii
Abend-AID for CICS User’s Guide
Paperclip Function . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15-5
Chain Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15-5
PSW Analysis Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15-5
Storage Disassembly Screen. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15-6
Dump Header Record Screen. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15-7
SDUMP/SYSDUMP Common Section Screen . . . . . . . . . . . . . . . . . . . . . . . . . 15-8
Registers Upon Entry to Dump Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15-9
Registers Upon Entry to Dump (Control and Floating Point Registers) Screen 159
Floating Point Interpretation Screen. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15-10
System Diagnostic Work Area Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15-11
Task Control Block Screen. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15-11
RTM2 Work Area Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15-12
Chapter 16. Analyzing Storage Violations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16-1
Storage Violation Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16-1
Storage Violation Debugging Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16-2
Chapter 17. Analyzing MVS Virtual Storage . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17-1
Private Storage Analysis. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17-3
User Region Analysis . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17-5
LSQA Analysis . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17-14
Enhanced Memory Display . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17-21
Common Storage Analysis . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17-25
Common Storage Users . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17-27
SQA Analysis . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17-31
CSA Analysis . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17-34
Link Pack Areas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17-38
Nucleus Areas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17-40
Allocated Storage Map. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17-42
64-bit Memory Analysis . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17-44
Chapter 18. Analyzing WebSphere MQ Queue Manager Dumps . . . . . . . . . . . . 18-1
Task List Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-1
Execution Block(s) Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-3
Execution Block Detail Screen. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-3
Active Handles Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-4
Handle Detail Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-5
Connected Address Spaces Screen. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-5
Agent Control Elements Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-6
WebSphere MQ Information Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-7
Communication Vector Table Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-8
Early Processing Block Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-8
System Communication Block . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-9
Release Information Block . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-10
Part 4. Setting User Controls
Chapter 19. Setting User Controls . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
User Profile Screen. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Print Options. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Screen Attributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
PF Keys. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Default PF Key Definitions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Modifying PF Key Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
19-1
19-1
19-3
19-3
19-5
19-5
19-6
ix
Part 5. Commands
Chapter 20. Abend-AID for CICS Command Syntax . . . . . . . . . . . . . . . . . . . . . . 20-1
Reading Syntax Diagrams . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20-1
Accessing Command Syntax Online . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20-2
Accessing Available Commands Online. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20-2
Chapter 21. Abend-AID for CICS Commands: A through L . . . . . . . . . . . . . . . . 21-1
ABENDTXT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-1
ACTIONS. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-1
ACTREGN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-1
ACTTRANS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-2
ADSTCK . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-2
AID . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-2
AMODE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-2
AP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-3
ARCH . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-4
ARRANGE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-4
ASCB . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-5
ASIDLIST . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-6
ASMAP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .21-6
ASSIST . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .21-6
ASXB . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-6
ATTRBUTE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-7
AUTO . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-7
BA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-8
BACKWARD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-8
BIND . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-8
BLOG. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-8
BORDERS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-9
BOTTOM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-9
BRIDGE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-9
BRKEEP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .21-10
BRSA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-10
BRTASK . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-10
CALLTRAC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-10
CANCEL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-10
CAPTURE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-11
CB . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-11
CC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-11
CHAIN. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .21-11
CHANGES . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-12
CICSENV . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-12
CICSINFO . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-12
CLEARIDX. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-13
CLIP. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-13
CLR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-14
CMDLIST. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-14
COBOL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .21-15
COLSREF . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-16
COMM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .21-16
CONTROL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-16
CORE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-16
CRETRIEV . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-17
CSA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-17
CSASP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-18
x
Abend-AID for CICS User’s Guide
CSASUM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
CSSTEXT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
CSSUTIL. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
CURSOR. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
CUSTOM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
CUSTUSER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
CVT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
CWI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
DATASTRM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
DB2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
DBCTLACT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
DBCTLSUS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
DBCTLUSE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
DCIDMCBS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
DCITRACE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
DCT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
DCTE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
DD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
DDANCH . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
DDSUMM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
DECODE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
DEFAULTS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
DELETECF . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
DEPN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
DFHRPL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
DH . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
DHANCH . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
DHDCSUMM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
DIAG . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
DIRECTRY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
DIRSCAN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
DISASM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
DLI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
DM. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
DMPHDR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
DMPPROF . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
DOMAINS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
DOWN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
DP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
DS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
DSA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
DSANCH . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
DSECT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
DSNLIST. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
DSQUEUE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
DSSTAT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
DSSUMM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
DTA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
DU . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
DUANCH . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
DUSYS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
DUTRANS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
EBUS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
EIBS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
EIBU . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
EJ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
21-18
21-18
21-18
21-19
21-19
21-20
21-20
21-20
21-20
21-20
21-21
21-21
21-21
21-22
21-22
21-22
21-22
21-23
21-23
21-23
21-23
21-24
21-24
21-24
21-25
21-25
21-25
21-25
21-26
21-26
21-26
21-26
21-27
21-27
21-28
21-28
21-28
21-29
21-29
21-30
21-30
21-30
21-30
21-31
21-31
21-31
21-32
21-32
21-32
21-32
21-33
21-33
21-33
21-33
21-34
21-34
xi
EJANCH. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-34
EM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-34
END . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-35
ENQ. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-35
ENQSUMM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-35
ESRCH . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .21-35
EXIT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-35
EXTERNAL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-36
EXTRN. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .21-36
FC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-36
FCRQSUMM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-37
FCT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-37
FCTE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-37
FILE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-37
FILEAREA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-38
FILEDET . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-38
FILEREC. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-38
FIND . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-39
Executing FIND from the Memory Display . . . . . . . . . . . . . . . . . . . . . . 21-39
Executing FIND from Screens Other Than the Memory Display . . . . . . 21-40
FLOAT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .21-40
FORWARD. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-41
GC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-41
GO. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-41
HELP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-41
HEXD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-42
HISTORY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-42
HOGAN. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-43
HOSTVAR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-43
IBMMSG . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-43
IC. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-43
IE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-44
IEANCH. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-44
II . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-44
IIANCH . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-44
IMPORT. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-44
INFO . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-45
INSTRUCT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-45
INTFLOAT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-45
IPCS. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-45
ITCB . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-46
ITRACE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .21-46
JOBCARD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-46
JPASUMM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-46
KE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-46
KEANCH . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-47
KEDOMAIN. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-47
KEER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-47
KESUMM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-47
KEYS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-48
LD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-48
LDMAP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .21-48
LDNIU . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .21-48
LDPROGS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-49
LDSUMM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-49
LEFT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-49
xii
Abend-AID for CICS User’s Guide
LEINFO . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
LEOCB . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
LEVELS. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
LG . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
LGANCH . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
LGBRSUMM. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
LGGLSUMM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
LGJLSUMM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
LGJMSUMM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
LGSTSUMM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
LINECMDS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
LINK. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
LIST . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
LLESUMM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
LM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
LMANCH . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
LMODINFO . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
LMSUMM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
LOCL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
LOG . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
LOGSPOOL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
LPAMAP. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
LPRINT. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
LSQASP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
LSQASUM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
LSR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
L3270 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
21-50
21-50
21-50
21-50
21-50
21-51
21-51
21-51
21-51
21-52
21-52
21-52
21-52
21-53
21-53
21-53
21-53
21-53
21-54
21-54
21-54
21-55
21-55
21-56
21-57
21-57
21-57
Chapter 22. Abend-AID for CICS Commands: M through Z . . . . . . . . . . . . . . . . 22-1
MAINMENU . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22-1
MAINTCF. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22-1
MAPD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22-1
MATCH . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22-3
MCT. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22-4
ME . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22-4
MEANCH . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22-5
MESUMM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22-5
MLOG . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22-5
MLVL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22-5
MM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22-6
MN. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22-6
MNANCH . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22-6
MNDICT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22-6
MNMCT. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22-7
MNSTAT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22-7
MNTMA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22-7
MODE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22-7
MQINFO . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22-7
MSA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22-8
MSGHELP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22-8
MSGS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22-8
MVSENV . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22-9
MVSINFO. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22-9
MVSSTG. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22-9
NEWS. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22-10
NOTE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22-10
NOTFYRG . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22-10
xiii
NOTFYTR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22-10
NOTIFY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22-11
NQ. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22-11
NQANCH . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22-11
NQPLSUMM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22-11
NUCMAP. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22-12
@offset . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22-12
-offset . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .22-12
#offset . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .22-12
+offset . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .22-13
OPFL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22-13
OT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22-13
PA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22-13
PAANCH . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22-14
PCLP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22-14
PCT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22-14
PCTE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22-14
PFKEYS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .22-15
PG . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22-15
PGANCH . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22-15
PGMDET . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22-15
PGMLINK . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22-16
PGMSUMM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22-16
PLI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22-16
PLIST . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22-16
PPT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22-17
PPTE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22-17
PRECOMP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22-17
PRINT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22-18
PRINTIDX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22-19
PROFILE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22-19
PROG. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22-20
PRTOPTS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22-20
PSA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22-20
PSW . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22-20
PT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22-20
PTANCH . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22-21
PVTSP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22-21
PVTSUM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22-21
RCTD. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22-21
REGIONS. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22-21
REGS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22-22
REMOTE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22-22
RESMGR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22-22
RESET . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22-22
RESETDAE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22-23
RESTORE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22-23
RETRIEVE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22-23
RETURN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22-24
REXX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22-24
RFIND . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22-24
RIGHT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .22-25
RM. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22-25
RMANCH . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22-25
RMUWSUMM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22-25
RPL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22-26
xiv
Abend-AID for CICS User’s Guide
RX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
RZ. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
SACLIP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
SAVE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
SCRATTR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
SCREEN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
SD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
SDPLIST . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
SERVINFO . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
SH . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
SHOWCOPY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
SHUTDOWN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
SIT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
SIT2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
SITENEWS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
SITOVER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
SITPRV . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
SITXRF . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
SJ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
SJANCH . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
SM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
SMANCH . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
SMAP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
SMDSUMM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
SMSUSP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
SMTSUMM. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
SMX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
SO . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
SOANCH . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
SOLTSUMM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
SORTA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
SORTD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
SOTCSUMM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
SOURCE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
SQASP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
SQASUM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
SQLCA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
SRCDIR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
SSA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
ST . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
STATIC. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
STORAGE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
SUBS. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
SUMMARY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
SYSLOG . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
TACB . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
TASK . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
TASKLIST . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
TASKS. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
TASKSUMM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
TCA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
TCBJST . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
TCBLLE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
TCBS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
TCLASS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
TCT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
22-26
22-26
22-26
22-27
22-27
22-27
22-27
22-28
22-28
22-28
22-28
22-29
22-29
22-29
22-30
22-30
22-30
22-30
22-31
22-31
22-31
22-31
22-32
22-32
22-32
22-32
22-32
22-33
22-33
22-33
22-33
22-34
22-34
22-34
22-35
22-35
22-35
22-36
22-36
22-36
22-36
22-37
22-37
22-37
22-37
22-38
22-38
22-38
22-38
22-38
22-39
22-39
22-39
22-39
22-40
22-40
xv
TCTP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22-40
TCTS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22-40
TCTT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22-41
TCTTE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .22-41
TD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22-41
TERM. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22-41
TESTSCR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22-42
TGT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22-42
TI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22-42
TM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22-43
TMA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22-43
TMLB. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22-43
TMSUMM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22-43
TOP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22-43
TR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22-44
TRACE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .22-44
TRANCH . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22-44
TRANGBL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22-44
TS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22-45
TSANCH . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22-45
TSBCSUMM. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22-45
TSBRSUMM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22-45
TSQSUMM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22-46
TSSYSUMM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22-46
TST . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22-46
TSVCSUMM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22-46
TXN. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22-47
UET . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22-47
UNSTCK . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22-47
UP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22-48
UPCB . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22-48
US . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22-48
USANCH . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22-48
USER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22-49
USERDIAG. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22-49
USERPROF . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22-49
USIDSUMM. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22-49
UTCB. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22-50
VSMAP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .22-50
WB. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22-50
WBANCH . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22-50
WBRQSUMM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .22-50
WBSTSUMM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22-51
WHERE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .22-51
WHO . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22-52
WORK . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .22-53
XM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22-53
XMANCH . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22-53
XMSUMM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22-54
XS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22-54
XSANCH . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22-54
XSSUP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22-54
ZOSSDMP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22-55
xvi
Abend-AID for CICS User’s Guide
Part 6. REXX API
Chapter 23. Using the Abend-AID for CICS REXX API . . . . . . . . . . . . . . . . . . . . .
Invoking the Abend-AID for CICS REXX API . . . . . . . . . . . . . . . . . . . . . . . . .
Coding Abend-AID for CICS REXX API Programs . . . . . . . . . . . . . . . . . . . . .
Toleration Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Sample Abend-AID for CICS REXX API Program SAMPREXX . . . . . . . . . . . .
23-1
23-1
23-1
23-1
23-2
Chapter 24. REXX API Functions and Commands . . . . . . . . . . . . . . . . . . . . . . . . 24-1
Abend-AID for CICS REXX API Special Variables . . . . . . . . . . . . . . . . . . . . . . 24-1
Abend-AID for CICS REXX API Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . 24-1
FXADD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24-1
FXDATE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24-2
FXDIV . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24-3
FXDSDUP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24-3
FXDSLEN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24-4
FXDSMSK . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24-5
FXDSOFF . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24-5
FXDSSCL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24-6
FXDSTYP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24-7
FXGET . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24-8
FXGETC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24-9
FXINFO . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24-10
FXJDATE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24-11
FXMODE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24-11
FXMULT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24-12
FXREM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24-13
FXSTIME . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24-13
FXSUB . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24-14
FXSYMBOL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24-14
FXTABENT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24-15
FXTM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24-16
FXTRACE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24-17
Abend-AID for CICS REXX API Commands . . . . . . . . . . . . . . . . . . . . . . . . . 24-17
FXHEXD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24-17
FXPCLEAR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24-18
FXPCLIP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24-18
FXPSHOW . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24-18
Part 7. Appendixes
Appendix A. Supplied Transaction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Controlling the Dump Interface Manually. . . . . . . . . . . . . . . . . . . . . . . . . . . .
Transaction Dump Interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Region Dump Interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Modifying Temporary Transaction Dump Profiles. . . . . . . . . . . . . . . . . . . . . .
A-1
A-1
A-2
A-2
A-3
Appendix B. Non-Error Condition Transaction Dumps . . . . . . . . . . . . . . . . . . . . . B-1
Examples . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B-1
Appendix C. Internal Transaction Abends . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
AAB1, AAB2, and AAB3 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
AAB4 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
ERAA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
ER24 and ER25 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
FXAE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
C-1
C-1
C-1
C-1
C-1
C-1
xvii
FXAS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
FXAV . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
FXBV . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
FXVW . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
U3264 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
C-2
C-2
C-2
C-2
C-2
Appendix D. Symbols List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . D-1
MVS Symbols List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . D-1
CICS Transaction Server Symbols List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . D-1
Glossary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . G-1
Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . I-1
xviii
Abend-AID for CICS User’s Guide
xix
Introduction
Intro
This guide describes how to use Abend-AID for CICS to analyze CICS transaction and region
dumps.
Note:
The information presented on the Abend-AID for CICS screens may vary for
different releases of CICS Transaction Server (CTS) for z/OS. The illustrations in
this guide show the information presented for CTS version 5 release 4 unless
otherwise noted. Some screens display the CTS release level. For version 5 release
4 these screens display 7.1.0.
Intended Audience
This guide is intended for the following audience:
•
•
•
•
System programmers
Application programmers
Application managers
Technical support managers.
A working knowledge of CICS is necessary to derive the most benefit from this
document.
User’s Guide Organization
This guide is organized into seven main parts:
Part 1, “Abend-AID for CICS Basics”
Part 1 describes Abend-AID for CICS facilities, functions, and procedures common to
both transaction abend processing and region dump processing. Topics presented in Part
1 include:
•
•
•
•
•
•
•
•
•
•
Abend-AID for CICS architecture
Displaying online help
Accessing and exiting the product
Starting, stopping, and selecting servers
Selecting dumps
Displaying information about dumps
Navigating in storage
Displaying control block information
Displaying DSECTs
Printing information
Part 2, “Transaction Abend Processing”
Part 2 describes procedures specific to transaction abend processing. Topics presented in
Part 2 include:
•
•
•
•
Analyzing transaction abends
Managing source files
Using Abend-AID for CICS with Language Environment
Analyzing data exceptions
xx
Abend-AID for CICS User’s Guide
Part 3, “Region Dump Processing”
Part 3 describes procedures specific to region dump processing. Topics presented in Part 3
include:
•
•
•
•
•
•
Importing region dumps
Analyzing region dumps
Analyzing SVC dumps
Analyzing storage violations
Analyzing MVS virtual storage
Analyzing WebSphere MQ queue manager dumps
Part 4, “Setting User Controls”
Part 4 describes the steps for changing the user interface defaults that are initially set
during installation. These defaults include the following:
•
•
•
•
User profiles
Print options
Screen attributes
PF key settings
Part 5, “Commands”
Part 5 is a user reference that describes the product’s commands. Scan Part 5 to become
familiar with its content or to look up a specific command, but reading Part 5 from
beginning to end is unnecessary.
Part 6, “REXX API”
Part 6 describes the Abend-AID for CICS REXX application program interface (API) and
the commands and functions supported with it.
Part 7, “Appendixes”
Topics presented in the appendixes include:
•
•
•
•
Description of the CICS transaction supplied with
Non-error condition Abend-AID for CICS transaction dumps
The Abend-AID for CICS internal transaction abends.
The symbols Abend-AID for CICS uses for CICS dumps
Like Part 5, the appendixes are intended as a user reference. Page through them to
become familiar with their contents, but reading them in their entirety is not necessary.
For more details about the contents of this guide, refer either to the start of Parts 1
through 7, or to the table of contents.
Notation Rules
This guide uses the following notation rules:
• Bold highlighting is used for headings and for commands you are instructed to type
in the COMMAND or OPTION fields. It is also used for referring to screen field names
and field data and is used in examples of command syntax.
• Italic highlighting is used for emphasizing important terms or phrases, for command
variables, and for document titles.
• Notes provide additional information about the current topic.
• Cautions warn of system failures or other problems that can occur if you fail to
follow documented procedures.
Introduction
xxi
Related Publications
User documentation is now provided in two online formats with Abend-AID for CICS:
PDF and HTML. These formats are available on Compuware’s FrontLine customer support
website at https://go.compuware.com.
Print complete documentation sets as needed from the PDF files supplied on the product
documentation site.
The following documents comprise the documentation set that is supplied with AbendAID:
• Abend-AID Installation and Customization Guide: Provides instructions for installing
Abend-AID, Abend-AID for CICS, and the Abend-AID Viewer. It includes information
about setting up these products to fit the development and system configurations at
your site.
• Abend-AID Messages and Codes: Lists the informational and error messages and their
explanations that you may encounter while using Abend-AID, Abend-AID for CICS or
the Abend-AID Viewer. It also describes any recommended user response. These
messages are also available for downloading from the FrontLine Web site to a
Chicago-Soft, Ltd.’s MVS/QuickRef™ database.
• Abend-AID Quick Configuration Guide: Provides the minimal instructions to configure
Abend-AID.
• Abend-AID Reference Summary: Provides a handy summary of the Abend-AID Viewer,
Abend-AID for CICS, the Abend-AID Web Browser Interface, Abend-AID report
sections, Abend-AID for CICS SNAP-AID, and Abend-AID DD statements.
• Abend-AID Release Notes: Provides a summary of the enhancements for the current
release and the supported environments.
• Abend-AID User/Reference Guide: Provides guidelines and instructions for using AbendAID basic language support, Extended Language Support (XLS), SNAP-AID, AbendAID for DB2, Abend-AID for IMS, Abend-AID for IDMS, Abend-AID DD statements,
and the Abend-AID Viewer.
• Abend-AID for CICS User’s Guide: Describes the functions and features of Abend-AID for
CICS. It also contains problem determination examples that illustrate the product’s
use.
• Abend-AID Fault Analytics Installation Guide: Provides information about how to install,
configure, and customize the Abend-AID for CICS Fault Analytics option. Refer to the
online help for information about using this option.
Online Help
You can find online help information for most screens, fields, and commands by using
the PF1 (HELP) key.
IBM Documentation
You can find more information related to Abend-AID in the following IBM publications:
• z/OS Language Environment Customization Guide: Discusses Language Environment for
z/OS.
• z/OS Initialization and Tuning Reference: Describes APF authorization and the use of
(E)LPA.
• z/OS MVS Programming: Authorized Assembler Services Guide: Describes APF authorization.
xxii
Abend-AID for CICS User’s Guide
Online Documentation
The Abend-AID for CICS Receive from Network (RFN) product installation package does
not include the product documentation. Access the Abend-AID for CICS documentation
from the FrontLine customer support website at https://go.compuware.com in the
following electronic formats:
• Release Notes in HTML format
• Product manuals in PDF format
• Adobe PDF index file (PDX file).
The product documentation is available for viewing or downloading:
• View PDF files with the free Adobe Reader, available at http://www.adobe.com.
• View HTML files with any standard web browser.
Getting Help
Compuware provides a variety of support resources to make it easy for you to find the
information you need.
Compuware FrontLine Customer Support Website
You can access online information for Compuware products via our FrontLine customer
support website at https://go.compuware.com.
Compuware FrontLine provides access to critical information about your Compuware
products. You can review frequently asked questions, read or download documentation,
access product fixes, or e-mail your questions or comments. The first time you access
Compuware FrontLine, you are required to register and obtain a password. Registration is
free.
Contacting Customer Support
Phone
• USA and Canada: 1-800-538-7822 or 1-313-227-5444.
• All other countries: Contact your local Compuware office. Contact information is
available at https://go.compuware.com.
Web
You can report issues via the Quick Link Create & View Support Cases on the
Compuware FrontLine home page.
Note:
Please report all high-priority issues by telephone.
Mail
Compuware Customer Support
Compuware Corporation
One Campus Martius
Detroit, MI 48226-5099
Corporate Website
To access Compuware’s site on the Web, go to http://www.compuware.com.
Introduction
xxiii
The Compuware site provides a variety of product and support information.
Abend-AID for CICS Customer Support
At Compuware, we strive to make our products and documentation the best in the
industry. Feedback from our customers helps us to maintain our quality standards.
If a problem arises while installing Abend-AID for CICS, consult the documentation or
the Abend-AID for CICS technical representative at your site. If the problem persists,
please obtain the following information before calling Compuware’s 24-hour product
support hotline. This information may be required to help determine the cause of the
problem:
• The Abend-AID for CICS release you are using. (To find the release level, enter the
SERVINFO fast-path command on any Abend-AID for CICS screen. Position the
cursor on the RELEASE field of the displayed screen and press Enter.)
• The CICS release you are using.
• The DB2 release you are using.
• The error message, if any, that was displayed. Please note the entire message as some
messages report specific information such as parameter values.
• All Abend-AID for CICS output for the task you were trying to perform.
• The MVS dump containing the Abend-AID for CICS failure.
• A tape copy of the SVC, SLIP, or SYSMDUMP dump you were trying to import or view.
• The CICS region JES job log.
• The MVS SYSLOG for the involved time period.
• Screen prints of the Dump Analysis Message Log that show the results of importing
the region dump.
Note: To display the Dump Analysis Message Log, either select a region dump from
the Directory with the G (Messages) line command, or type MLOG in the
COMMAND (or OPTION) field on any Abend-AID for CICS screen and press
Enter. For MLOG to function, however, you must first select a region dump
from the Abend-AID Directory.
• The contents of the viewing server, TDCAS, and CICS region JES output files.
• Any relevant SMP/E output.
• Any other relevant screen prints.
xxiv
Abend-AID for CICS User’s Guide
Part 1.
1
Abend-AID for CICS Basics
Part 1 of this guide describes Abend-AID for CICS facilities, functions, and procedures
common to transaction abend processing and region dump processing. Before attempting
to use Abend-AID for CICS, you should read this part of the guide in its entirety.
The following chapters are in Part 1:
Chapter 1, “Abend-AID for CICS Overview”
Chapter 1 defines the system environment needed to support Abend-AID for CICS, it
summarizes the product’s architecture and general functions, and it describes how to
access the online help facility.
Chapter 2, “Getting Started”
Chapter 2 describes the steps for accessing the product; starting, stopping, or
selecting a server; selecting a dump; and exiting the product.
Note:
Many Abend-AID for CICS functions become available only after you have
selected an entry from the Abend-AID Directory. For the list of these
functions, refer to Chapter 2.
Chapter 3, “Abend-AID for CICS Interface”
Chapter 3 describes the format of Abend-AID for CICS screens and the methods for
navigating from screen to screen within the product.
Chapter 4, “Working with Dumps”
Chapter 4 describes in detail how to select and analyze Abend-AID for CICS entries
and display basic information about them. The screens described in this chapter
include the following:
–
–
–
–
Fault Summary
Abend-AID Directory
Entry Information
Duplicate History
Chapter 5, “Accessing Storage Information”
Chapter 5 describes how to display control block information related to a transaction
or region dump. It also describes how to locate and track address information in the
Memory Display screen, which displays dump storage in hexadecimal format.
Chapter 6, “Displaying DSECTs”
Chapter 6 explains how to display CICS control blocks in DSECT format. DSECTs that
Abend-AID for CICS supports are also listed.
Abend-AID for CICS User’s Guide
Chapter 7, “Printing Abend-AID for CICS Information”
Chapter 7 describes how to print Abend-AID for CICS information for transaction
abends and region dumps.
1-1
Chapter 1.
Abend-AID for CICS Overview
Chap 1
This chapter defines the system environment needed to support Abend-AID for CICS, and
it describes the product’s architecture. Additionally, it lists the functions and features
available for dump analysis, and it details how to access online help for the product’s
screens, fields, messages, and commands.
System Environment
For the most current information regarding Abend-AID for CICS’s supported operating
systems, programming languages, and databases, refer to the Abend-AID for CICS release
notes. The latest version of the release notes is available with the Abend-AID for CICS
documentation set on Compuware’s FrontLine website at https://go.compuware.com.
Product Components
The Abend-AID for CICS architecture consists of three major components:
• Transaction dump capture component
• Region dump capture component
• Viewing server component.
Abend-AID for CICS also requires Compuware’s Enterprise Common Components (ECC),
Release 16.05 or more current, which is comprised of the following single-image, SMP/Einstalled components:
•
•
•
•
•
Compuware Shared Services (CSS)
License Management System (LMS)
Compuware Mainframe Services Controller (CMSC)
Host Communications Interface (HCI
Compuware Base Services
Note:
New with Release 17.02, Embedded Source Support (ESS) requires ECC Release
17.02. Abend-AID for CICS automatically uses ESS records at view time to
provide source support for COBOL 5.1 and more current programs preprocessed
or postprocessed with the Compuware Language Processor.
Refer to the Enterprise Common Components (ECC) documentation set for a description
of these ECC facilities. The ECC documentation set is available on Compuware’s
FrontLine website at https://go.compuware.com.
Transaction Dump Capture Component
Figure 1-1 illustrates the transaction dump capture component. For transaction dumps,
the dump capture component consists of the transaction dump interface and the transaction
dump capture address space (TDCAS).
1-2
Abend-AID for CICS User’s Guide
Figure 1-1. Abend-AID for CICS Transaction Dump Capture Component
CICS Region
Transaction
Dump
Interface
Customization
File
(VSAM)
Transaction Dump
Capture Subsystem
Transaction
Databases
(VSAM)
Transaction
Dump Capture
Address Space
Shared
Directory
(VSAM)
Transaction Dump Interface
The transaction dump interface is the portion of the transaction dump capture
component that runs in the CICS address space. It is started and stopped using the AAON
transaction, or with entries in the CICS PLT. Very little Abend-AID for CICS code actually
runs in the CICS address space. Most of the dump capture and processing is done in the
transaction dump capture address space (TDCAS).
The transaction dump interface is a CICS dump domain exit. The transaction dump
interface determines whether Abend-AID for CICS is to process a transaction abend. If
the interface determines that the abend requires processing, it passes control to the
TDCAS using the transaction dump capture subsystem to facilitate communication.
Note:
Abend-AID for CICS will not process a transaction abend if any of the following
situations exist:
• Abend-AID for CICS is currently processing an abend for the same task.
• The site has suppressed duplicate dumps, the abend is a duplicate of a
previous abend, and the duplicate dump expiration interval has not expired.
• The abend matches an exception condition for which the site has specified
dumps are not taken.
• The CICS region is currently at a short-on-storage condition.
• The CICS region does not currently have enough storage for Abend-AID for
CICS to process the abend.
• CICS is in the process of shutting down.
• The transaction dump capture address space is not active.
Transaction Dump Capture Address Space (TDCAS)
The transaction dump capture address space (TDCAS) is responsible for transaction dump
capture and processing. One TDCAS is required on every MVS image where you use
Abend-AID for CICS. You can have more than one TDCAS per image, but this is normally
Abend-AID for CICS Overview
1-3
not necessary. The TDCAS must be active to capture Abend-AID for CICS transaction
dumps, so Compuware recommends that you start it as an automatically started task after
each IPL. If the TDCAS is not available, Abend-AID for CICS invokes an IBM transaction
dump instead of an Abend-AID for CICS transaction dump.
The first TDCAS started on an MVS image starts a subsystem that is used for
communication between the CICS region and the TDCAS. All TDCASs on the image use
this single subsystem for communication. This subsystem must be unique; it cannot be
the same subsystem you use for Abend-AID for CICS TSO/ISPF and/or CICS viewing
access.
When a dump occurs, the TDCAS allocates a data space into which it writes dump data.
You control how much of the captured data is written to the data space, using the
DATASPACE TDCAS configuration parameter. Compuware recommends that you write
only part of the data — the volatile storage areas — to the data space. The remainder of
the captured storage is written directly to the transaction database. This option offers
excellent performance while minimizing the amount of auxiliary storage used by the
transaction dump capture process.
You can also choose to write all of the dump data to a data space. While this approach
has significant performance benefits, it could possibly cause an MVS system problem,
such as an auxiliary storage shortage, if multiple transaction dumps are being taken in
rapid succession. For this reason, ensure that you have sufficient auxiliary storage
available before selecting this option.
Finally, you can choose to bypass the data space creation, and write transaction dump
data directly to a transaction database. This method is significantly slower than using a
data space, and may impact your CICS region if multiple transaction dumps are being
taken in rapid succession. Compuware does not recommend that you write dumps
directly to transaction databases.
The CICS region references information from the Abend-AID for CICS customization file
to determine which shared directory is associated with the CICS region. Customization
information also indicates what transaction databases are candidates to contain dumps
for this CICS region. Using this information, the TDCAS determines to which transaction
database it should write dump information.
Note:
The TDCAS also writes some parameter information to the customization file
directly, but it does not reference this file during normal processing.
After the data is written to the data space, TDCAS routines analyze the data. Analysis
information and dump storage are written to the appropriate transaction database, and
the data space is deleted.
Region Dump Capture Component
Note: Abend-AID for CICS does not require any modifications to CICS to capture region
dumps. The information in this section describes optional facilities that you can
install to capture additional region information or to automatically import
region dumps into Abend-AID for CICS.
The optional dump capture component for region dumps consists of a region dump
interface, and an MVS post-dump exit. Abend-AID for CICS uses these facilities to import
dumps automatically, to copy dumps, to gather program change summary information,
and to notify users when CICS region dumps occur.
Figure 1-2 illustrates the region dump capture component, which is an optional part of
the Abend-AID for CICS architecture. Further, the region dump interface, and MVS postdump exit are independent of one another, so you only have to install the ones you
want.
1-4
Abend-AID for CICS User’s Guide
Note:
If you do not install the MVS post-dump exit, you can still manually import
SDUMPs into Abend-AID for CICS via the product’s online dump dataset import
facility.
Figure 1-2. Abend-AID for CICS Region Dump Capture Component
Customization
File
(VSAM)
Viewing Server
2
Region
Dump
Datasets
1
3
CICS Region
Region Dump
Interface
MSDCCOPY
Procedure
2
2
MVS
Post-Dump
Exit
(DMPSRV)
Dump
Information
File
(VSAM)
2
Figure 1-2 illustrates the region dump capture flow. The numbers in this figure have the
following explanations:
1. SYS1.DUMPxx or SDUMP to an MVS automatically allocated dataset, without auto
import. This method is normal dump capture, without the MVS post-dump exit.
2. SYS1.DUMPxx or SDUMP to an MVS automatically allocated dataset, with auto
copy/auto import. This method uses the MVS post-dump exit.
3. Dump information file updated by the viewing server whenever a region dump is
imported, regardless of how it is being imported, and occurs for all methods,
including manual dump import.
Region Dump Interface
The Abend-AID for CICS region dump interface does not participate in dump capture. Its
purpose is to capture the data necessary to build the Program Change Summary display.
Abend-AID for CICS Overview
1-5
If the region dump interface is not active, this data is not captured, but dump capture
and processing continues.
The region dump interface is a CICS dump domain exit. This optional interface allows
Abend-AID for CICS to gather the information necessary to produce a Program Change
Summary, which highlights programs that have been recently linked or zapped.
Notes:
1. The region dump interface is not required to capture region dumps. It is required only
to capture information about recently changed programs in the DFHRPL
concatenation. If this list is captured, you can view it through the Abend-AID for
CICS region dump display screens. Entering the CHANGES fast-path command
displays the Program Change Summary screen.
2. Capturing the program change summary information adds a small amount of
overhead to the dump capture process. Usually this amount is insignificant, but if
you see any performance degradation at dump capture time, you can turn off the
region dump interface while still leaving the transaction dump interface active.
MVS Post-Dump Exit
This optional exit performs the following tasks:
• Determines if your site wants to copy a SYS1.DUMPxx dataset to another dataset after
a CICS region dump is initially taken to the SYS1.DUMPxx dataset.
• Schedules automatic import of region dumps copied from SYS1.DUMPxx datasets by
Abend-AID for CICS or for region dumps taken to automatically allocated dump
datasets.
• Notify a user when a region dump is taken.
Remember, if your site does not configure the Abend-AID for CICS installation to import
region dumps automatically, you can still import them manually via the dump dataset
import facility.
Viewing Server Component
The viewing server is an MVS address space that allows you to view captured dump
information. It also performs import and analysis of CICS region dumps for use by
Abend-AID for CICS. The viewing server must be active for Abend-AID for CICS to display
transaction abend information or to import or display region dumps. The viewing server
does not have to be active for Abend-AID for CICS to capture transaction or region
dumps.
Figure 1-3 illustrates the Abend-AID for CICS viewing server component. You must have
at least one viewing server, but you can configure more than one. The number of viewing
servers you have depends on your site’s configuration requirements.
1-6
Abend-AID for CICS User’s Guide
Figure 1-3. Abend-AID for CICS Viewing Server Component
Shared
Directory
(VSAM)
Region
Dump
Dataset
Report
Databases
Dump
Information
File
(VSAM)
Scratchpad
Listing File
Customization
File
(VSAM)
Source
Listing
Files
Viewing
Server
Work File
(VSAM)
Viewing
Server
Region
System
DSECT
File
(VSAM)
Persistent
Data
File
(VSAM)
Viewing Access
(TSO/ISPF, CICS,
VTAM, Web
Browser Interface)
User
DSECT
File
(VSAM)
A Scratchpad listing file (CWPDDIO) is included in the viewing server startup JCL. This
file is required — without it the viewing server will not start. The Scratchpad listing file is
a single DDIO source file. It will be allocated and formatted during the creation of the
other viewing server datasets. It will hold the listings that are created from compiler
listings. As new listings are added to the file, older listings are removed.
The viewing server handles automatic and manual import of region dumps. If you are
using automatic region dump import, the viewing server periodically scans for the
presence of new dumps to import. This scan results in minimal CPU overhead, and you
can tune the scan interval using the IMPORT_SAMPLE_RATE viewing server
configuration parameter.
You can view Abend-AID for CICS dump information from three interfaces: TSO/ISPF, a
VTAM application, or CICS.
Abend-AID for CICS Overview
1-7
Product Functions
Abend-AID for CICS provides dump navigation and diagnostic functions to help you
identify the problems that cause CICS transaction abends and region outages. Some
functions are always available; others are only available once a transaction or region
dump is selected for analysis. The rest of this section describes:
• “Dump-Independent Functions” on page 1-7
• “Transaction Abend Analysis Functions” on page 1-7
• “Region Dump Analysis Functions” on page 1-9
Dump-Independent Functions
Dump-independent functions are always available. If no dump is selected, access these
functions by entering the fast-path command on the Command or Option line and
pressing Enter. The fast-path commands are shown in parentheses after the function
name. You can also access these functions from the Primary Options menu (Figure 1-4
and Figure 1-5) that is displayed once a dump is selected.
• Fault Summary (SUMMARY) — The Abend-AID for CICS Fault Summary lists the
number of transaction, region, and non-CICS entries for each region and each userdefined region group. When you select a region, a region group, or a dump type
subset of a region or region group from the Fault Summary, Abend-AID for CICS
displays an Abend-AID Directory of the entries specific to your selection.
• Abend-AID Directory (DIRECTORY) — The Abend-AID Directory lists the type and
number of transaction and region entries available for each described region or
region group.
• Dataset Import (IMPORT) — The import function makes region dumps available to
Abend-AID for CICS. Three methods for importing dumps are possible:
– Automatically via the MVS post-dump exit
– Manually from the Dataset Import screen
– Manually from the MVS console.
• User Control Facility (USER) — The User Control Facility provides a wide range of
administrative features that enable you to tailor the user interface, and access the
product customization screens.
• Source Directory (SRCDIR) — The Source Directory displays the source
listings/source listing shared directories that have been written to a source support
dataset. Although the Source Directory is a dump-independent function, source
support is available for transaction entries only.
• Distributed Viewing Support (DVS) — This facility lets users view dumps captured
at remote sites using source information maintained at a central site. DVS eliminates
the need to distribute the source listing information to remote sites in order to view
diagnostics for transaction abends in source format.
Transaction Abend Analysis Functions
The Primary Option menu shown in Figure 1-4 is displayed after you select a transaction
entry for analysis. The numbered options at the top of the screen are the transaction
abend analysis functions.
1-8
Abend-AID for CICS User’s Guide
Figure 1-4. Primary Options Menu for Transaction Abend Analysis
Abend-AID -------------------- Primary Options ------------------------------- 
OPTION ===>


1 DIAG
Diagnostic Summary
7 FILE
File Request Summary


2 PROG
Program Information
8 DB2
DB2 Information


3 TRACE
CICS Trace
9 L3270
Last 3270 Screen


4 TERM
Terminal Detail
10 *MQINFO WebSphere MQ Information


5 TASK
Task Detail
11 *CWI
CICS Web Interface


6 CB
Control Blocks/Storage
12 *LEINFO LE Information




D DIRECTRY Abend-AID Directory
R SRCDIR
Source Directory


S SUMMARY Fault Summary
U USER
User Control Facility


N NEWS
Product News
X EXIT
Exit 
Diagnostic Summary
Displays a thorough analysis of CICS transaction abends, including PL/I, DB2,
Hogan, and MSA abends, to help you determine the cause of the transaction failure.
Program Information
Identifies all programs involved in an abending task, and it provides direct access to
specific program information, such as COBOL linkage, COBOL external data, and
program storage.
CICS Trace
Displays internal CICS trace information for an abending task in IBM format. Full,
short, and abbreviated trace tables in IBM format are available for CICS Transaction
Server for z/OS and OS/390. Full and abbreviated trace tables in IBM format are
available for CICS 4.1.
Terminal Detail
Provides terminal-related information for the terminal associated with the task at the
time of the abend.
Task Detail
Provides a detailed analysis of the selected task at the time of the transaction abend.
Control Blocks/Storage
Lists the control blocks related to the failing transaction and provides access to the
dump’s hexadecimal storage. In addition, the paperclip function tracks your
navigation through storage.
File Request Summary
Lists all files with areas remaining on the storage chain for the abending transaction.
For each file, detailed statistics are available, including information on file access and
file requests.
DB2 Information
Displays DB2 information such as SQL information, pertinent dates, and DB2
subsystem information. This function is only available if your site has installed DB2
support.
Abend-AID for CICS Overview
1-9
Last 3270 Screen
Shows the exact screen image that was displayed when the abend occurred.
Duplicate History
Displays a log of duplicate dump suppression activity. Abend-AID for CICS can
suppress duplicate transaction dumps, which allows you to track recurring
transaction failures without having to store redundant information.
WebSphere MQ Information
Provides access to WebSphere MQ Information associated with the selected
transaction abend. This option is only available if your site is licensed for Abend-AID
for WebSphere MQ.
CICS Web Interface Information
Provides enhanced diagnostics with web-specific information for abending
applications that use the CICS Web Interface (CWI).
Language Environment Info
Provides access to the Language Environment (LE) information, including the LE
Options Control Block screen, which lets customers using Language Environment (LE)
easily identify LE runtime options in effect at the time of the failure in their COBOL or
PL/I program and the LE Information Summary screen, which also provides LE heap
and stack analysis.
Region Dump Analysis Functions
The Primary Option menu shown in Figure 1-5 is displayed after you select a region entry
for analysis. The numbered options at the top of the screen are the region abend analysis
functions.
Figure 1-5. Primary Options Menu for Region Dump Analysis
Abend-AID ------------------- Primary Options ------------------------------- 
OPTION ===>


1 DIAG
Diagnostic Summary
6 MVSINFO MVS Information


2 TASKS
Task/Wait Analysis
7 IPCS
IPCS Command Facility


3 TRACE
CICS Trace Listing
8 DOMAINS CICS Domain Analysis


4 CICSINFO CICS Information
9 ZOSSDMP z/OS SVC Dump Analysis


5 CB
Control Blocks/Storage




D DIRECTRY Abend-AID Directory
I IMPORT
Dataset Import


S SUMMARY Fault Summary
U USER
User Control Facility


X EXIT
Exit
N NEWS
Product News
Diagnostic Summary
Displays a thorough analysis of CICS region failure. You can display this summary in
either a full-text format for novice users, or an abbreviated format for experienced
users.
1-10
Abend-AID for CICS User’s Guide
Task/Wait Analysis
Lists information from the transaction manager, kernel domain, and dispatcher
domain.
CICS Trace Listing
Traces the path of application programs for complex problems involving system
interactions. Full, short, and abbreviated trace listings are available in IBM format.
CICS Information
Displays the CICS Information menu that provides access to the:
–
–
–
–
CICS Environment Summary
Program Change Summary
DFHRPL Concatenation
CICS Resource Managers.
Control Blocks/Storage
Lists the dump control blocks from which you can display information in
interpreted, hexadecimal, or DSECT format. It also provides access to a dump’s
hexadecimal storage. To help with dump analysis, FIND and CHAIN commands are
provided. In addition, the paperclip function tracks your navigation through storage.
MVS Information
Provides access to general MVS information including:
– Summary information about the MVS environment, including job step run time,
CPU time, paging statistics, EXCP count, and MVS region size.
– A TCB summary that includes the TCB address and type, request block address
and type, PSW, instruction length, interrupt code, offset, and last instruction.
Further, for both CICS and non-CICS dumps, it provides access to the RTM2 work
area, the save area trace, and the request block registers for each TCB in the
dump.
– The JES2 SYSLOG that lists the SYSLOG messages for the abending region from
the last two JES2 buffers.
– MVS virtual storage analysis that shows allocations of virtual storage in the
Private, Common Service (CSA), and Global System Queue (SQA) areas of address
spaces contained in the SVC dump dataset when the dump was taken.
– Summary that displays a list of programs found in the job pack area (JPA) of the
selected address space.
– Summary that displays a list of programs found in all of the task load lists.
– Language Environment (LE) information, including an LE information summary
from which you can access additional LE heap and stack analysis information.
IPCS Command Facility
Provides accesses to a facility in which you enter IPCS commands. This option is only
available if your installed IPCS support.
CICS Domain Analysis
Provides access to summary and detailed information about the following domains.
•
Kernel Domain
•
Enqueue Manager
•
Storage Manager
•
Security Domain
•
Dispatcher Domain
•
User Domain
•
Lock Manager
•
Intersystems Communication
•
Loader Domain
•
Log Manager
Abend-AID for CICS Overview
•
Temporary Storage Domain
•
CBTS Domain
•
Local Catalog
•
CBTS Event Manager
•
Domain Manager
•
CBTS Scheduler Services
•
Parameter Domain
•
Recoverable Resource Manager
•
Global Catalog
•
Sockets Domain
•
Message Domain
•
Web Domain
•
Trace Domain
•
Document Handler Domain
•
Dump Domain
•
IP ECI Domain
•
Timer Domain
•
IIPO Domain
•
Statistics Domain
•
Enterprise Java Domain
•
Monitoring Domain
•
Pipeline Domain
•
Application Domain
•
Object Transaction Service
•
Recovery Manager
•
Partner Domain
•
Directory Manager
•
RequestStreams Domain
•
Program Manager
•
JVM Domain
•
Transaction Manager
•
Debugging Profile Domain
•
Resource Lifecycle Manager
•
Event Processing Domain
•
XML Parsing
•
WEB2.0 Domain
•
Region Status Domain
1-11
WebSphere MQ Queue Manager Address Space Analysis
Provides access to WebSphere MQ queue manager address space information for
region dumps. This option is only available if your site is licensed for Abend-AID for
WebSphere MQ.
CICS Web Interface Information
Provides enhanced diagnostics with web-specific information for CICS region dumps
that use the CICS Web Interface (CWI).
z/OS SVC Dump Analysis
Provides information about SVC dumps in the z/OS environment, including
information from the prefixed saved area (PSA), the communications vector table
(CVT), the address space control block (ASCB), and the address space extension block
(ASXB). It also provides a summary of the subsystems found in the dump and
detailed information for each of the address spaces active in the MVS image at the
time of the dump. This function also displays the address of the SVC dump
parameter list and the settings at the time of the dump.
General Features
Abend-AID for CICS has several features that enhance its analysis capabilities, including
the following:
• Tab-selectable fields that display control blocks in interpreted, hexadecimal, or
DSECT format, or that display additional related information.
• WHO, MATCH, and WHERE analysis commands for region dumps that enable you to
determine the ownership of any piece of storage, the tasks having addressability to
the storage, and the location and ownership of data that matches data having
overlaid storage.
1-12
Abend-AID for CICS User’s Guide
• Extensive print capabilities that allow you to print individual screens, groups of
screens, formatted DSECTs, and storage.
• Screen attributes you can customize to change screen colors, to turn screen borders
on or off, to turn reverse video on or off, and to show or hide line command and
screen footer information.
• A FIND command that is available on all scrollable screens, including storage
displays.
• A facility that allows you to define your own control blocks to the system, so that
Abend-AID for CICS can display them in DSECT format.
• A notepad facility that you can use to maintain notes (ISPF access only).
• A REXX application program interface (API) that lets you process REXX EXECs
against transaction and region dumps.
Online Help
Online help is available for any Abend-AID for CICS screen, field, system message, or
command.
Screen Help
Screen help explains the purpose of each screen. To display screen help, use either of the
following methods:
• Position the cursor off any data field or system message, and then press PF1. (PF1 is
the default Help key.)
• Type HELP in the COMMAND (or OPTION) field on any Abend-AID for CICS screen,
including field-level help screens, and then press the Enter key.
Field Help
At a minimum, field help defines a field’s label; for example, “TCB is the task control
block.” In many cases, field help also describes the purpose of the field and how to use
the information it contains. To display field help, use either of the following methods:
• Position the cursor on the field, and then press PF1.
• Type HELP in the COMMAND field, move the cursor to the appropriate field, and
then press the Enter key.
Abend-AID for CICS Overview
1-13
Message Help
Abend-AID for CICS displays error, warning, and informational messages on the third
line of each screen. To display help text that explains the meaning and significance of
these messages, use one of the following methods:
• Position the cursor on the message, and then press PF1.
• Type HELP in the COMMAND (or OPTION) field, position the cursor on the message,
and then press Enter.
• Type MSGHELP messageid in the COMMAND (or OPTION) field, and then press Enter.
Note:
To use this method, drop the first three characters and the last character of
the message ID. For example, to display help text for message FDBSI0052E,
type:
MSGHELP SI0052
With the MSGHELP command, you can display the help text of any message — even
messages not currently displayed.
Note: Depending on your site’s configuration and how you accessed a particular screen,
the MSGHELP command may not be available for some messages.
Command Help
Command help describes the function, syntax, and restrictions (if any) of primary and
fast-path commands. If warranted, an example showing the use of the command is also
provided.
• In the COMMAND (or OPTION) field, type HELP followed by the name of the
command. Then press the Enter key. For example, to display help text for the FIND
command, type:
HELP FIND
• Type either CMDLIST or HELP COMMANDS in the COMMAND (or OPTION) field,
and then press Enter to display the list of commands. Place the cursor on the desired
command, and then press Enter.
• Position the cursor on the line command or its descriptive text, and then press Enter.
To list the commands available from the currently displayed screen or field, use the
ASSIST command or press PF24. (PF24 is the default ASSIST key.) For more information,
refer to “ASSIST” on page 21-6.
Notes:
1. ASSIST is valid on only some screens at the screen level, but is available for all tabselectable fields.
2. To display the current PF-key settings, type KEYS in the COMMAND (or OPTION)
field, and then press Enter.
1-14
Abend-AID for CICS User’s Guide
2-1
Chapter 2.
Getting Started
Chap 2
This chapter describes the following procedures:
• Logging onto Abend-AID for CICS from ISPF/PDF, VTAM, CICS, or the Abend-AID
Web Browser Interface
• Selecting a viewing server
• Selecting an entry from the Abend-AID Directory
• Exiting Abend-AID for CICS.
Logging On to Abend-AID for CICS
Abend-AID for CICS supports the following access methods:
ISPF/PDF
Select the option defined for Abend-AID for CICS on your ISPF/PDF
Primary Option (or other) menu, or execute the CLIST defined for
Abend-AID for CICS.
VTAM
If your site uses a session manager, Abend-AID for CICS may be defined
as an option that you can select from the application selection (or
other) menu.
If your site has not defined Abend-AID for CICS as a menu option, enter
the following logon command:
LOGON APPLID(applid-name)
Note:
The parentheses are required as shown.
Once you enter the logon command, Abend-AID for CICS displays the
Server Logon screen, which shows your terminal ID in the Userid field
by default. Enter your user ID in this field if you want to use the
settings established in your user profile. Refer to Chapter 19, “Setting
User Controls” for additional information. If your site is using external
security, you must enter your user ID and password.
CICS
Enter an AADF transaction command directly from CICS on any blank
screen. The following AADF transaction commands are valid:
• AADF: Displays the Abend-AID Directory for all transaction and
region abends matching the job name of the CICS region.
• AADFS: Displays the Fault Summary.
• AADFT: Displays the Diagnostic Summary for the most recent
transaction abend that occurred at your terminal in the CICS
region.
• AADFTM: Displays the Primary Options menu for the most recent
transaction abend at your terminal in the CICS region.
• AADFX: Displays the Diagnostic Summary for the most recent
transaction abend in the CICS region.
2-2
Abend-AID for CICS User’s Guide
• AADFXM: Displays the Primary Options menu for the most recent
transaction abend in the CICS region.
• AADF number: Displays the Diagnostic Summary for the specified
directory entry.
• AADM: Displays the Abend-AID for CICS demonstration
transaction menu.
Notes:
1. Before you can access Abend-AID for CICS from CICS, the
transaction dump interface must be active in the CICS region. For
specifics, see Appendix A, “Supplied Transaction”.
2. If you do not sign onto CICS, the CICS DFLTUSER parameter
(CICSUSER) is used to access Abend-AID for CICS. User profiles
changes may take effect only temporarily because multiple users
can change the same profile.
Web
Enter your site’s URL for the Abend-AID Web Browser Interface:
http://host_name:TCP_PORT/AAVIEW.HTML
or
http://IP_address:TCP_PORT/AAVIEW.HTML
For the steps required to establish these access methods, refer to the Abend-AID Installation
and Customization Guide.
Selecting a Viewing Server (ISPF Access Only)
If you are accessing a viewing server from ISPF and your site has only one active viewing
server, Abend-AID for CICS automatically logs you onto that viewing server and displays
the Fault Summary screen. However, if your site has more than one active viewing server,
Abend-AID for CICS displays the Server Selection screen. As shown in Figure 2-1, this
screen lists the viewing servers currently active on your system.
Figure 2-1. Server Selection Screen
Compuware Abend-AID -------- Server Selection -------------- ROW 1 TO 2 OF 2
COMMAND ===>
SCROLL ===> CSR 
Copyright Compuware Corporation 1994-2016 

Current Server Name: SERVER2 

Press Enter to reselect the current server, or place your cursor on a listed
server and press Enter. 

Name
Description
SERVER1
Fault Management Server1
SERVER2
Fault Management Server2
******************************* BOTTOM OF DATA ********************************

To select a viewing server, place the cursor on the appropriate application ID (APPLID)
and press Enter. After you select a viewing server, its APPLID is retained in your ISPF
profile. To select this same viewing server in the next session, simply press Enter from the
Server Selection Screen.
Getting Started
Note:
2-3
To change viewing servers, you must first exit Abend-AID for CICS. For the
supported methods, refer to “Exiting Abend-AID for CICS” on page 2-4.
To bypass the Server Selection screen and reselect the last viewing server you accessed,
type X.P in the Option field on the ISPF/PDF Primary Option Menu, where X is the sitedefined option for Abend-AID for CICS. The Fault Summary screen, which is described in
“Fault Summary” on page 4-1, is displayed.
Displaying Server Information
The Server information screeen, shown in Figure 2-2, displays information about the
Abend-AID for CICS viewing server and the identity and number of active users. Access
this screen from any Abend-AID for CICS screen by entering the SERVINFO fast-path
command.
Figure 2-2. Server Information Screenoramtion about
Compuware Abend-AID ------- Server Information --------- Row 000001 of 000001 
COMMAND ===>
SCROLL ===> PAGE 

Server Name........................... Server1

Server Description.................... AA DEVELOPMENT

Number of Active Users................ 1


To display the release information for the server select RELEASE

To display the CSS release level and fixes select CXRELSMP


Terminal/

Userid
Jobname
Access

******** ********
***********

CICSUSR
TCW00397
ISPF (HCI)

****************************** BOTTOM OF DATA *********************************


To access detailed information about the Abend-AID for CICS release pcurrently running
on this server use the cursor point-and-shoot feature to position the cursor on the
RELEASE field and press Enter. To display information about the Compuware Shared
Services (CSS) release currently running on this server, use the cursor point-and-shoot
feature to position the cursor on the CXRELSMP field and press Enter.
Selecting an Entry
The Fault Summary is the first screen displayed if you access from ISPF or VTAM, and the
Abend-AID Directory is the first screen displayed if you access from CICS. Refer to
Chapter 4, “Working with Dumps” for a detailed description of these screens. With ISPF
or VTAM access, you can also automatically reselect the last dump you were viewing by
enabling this functionality using the User Profile screen, as described in “User Profile
Screen” on page 19-1.
Note:
Automatically selecting the last dump is not supported if you are using CICS
access.
Tab to a field on the summary that reflects the directory entries you want to see, and
press Enter to display the Abend-AID Directory. You can select an entry from the AbendAID Directory in one of three ways:
2-4
Abend-AID for CICS User’s Guide
• Type an M next to the entry you want to select and press Enter. This line command
selects the entry and displays the Primary Options menu. A system message on the
menu confirms the current entry number.
• Type an S next to the entry you want to select and press Enter. This line command
selects the entry and displays the corresponding diagnostic summary that Abend-AID
for CICS has generated. A system message on the diagnostic summary confirms the
current entry number.
• Place the cursor next to the appropriate entry number and press Enter. Like the M
line command, this action selects the entry and displays the Primary Options menu.
Regardless of the method you use, all Abend-AID for CICS functions that are dumpdependent become available once you have successfully selected an entry.
Note:
The following Abend-AID for CICS functions are available only after you have selected an
entry from the Abend-AID Directory and if you are licensed for that product:
– Transaction Entry Functions
•
•
•
•
•
•
•
•
•
•
•
•
Diagnostic Summary
Program Information
CICS Trace
Terminal Detail
Task Detail
Control Blocks/Storage
File Request Summary
DB2 Information
Last 3270 Screen image
WebSphere MQ Information
CICS Web Interface
LE Information.
– Region Entry Functions
•
•
•
•
•
•
•
•
•
Diagnostic Summary
Task/Wait Analysis
CICS Trace Listing
CICS Information
Control Blocks/Storage
MVS Information
IPCS Command Facility (requires installed IPCS support)
CICS Domain Analysis
z/OS SVC Dump Analysis
Exiting Abend-AID for CICS
To exit Abend-AID for CICS from any screen, type EXIT or =X in the COMMAND (or
OPTION) field, and then press Enter.
Pressing the END PF key backs you out, one screen at a time. PF3 is the default END PF
key. Pressing the RETURN PF key returns you to either the Fault Summary (ISPF or VTAM
access) or the Abend-AID Directory (CICS access). PF4 is the default RETURN PF key. Press
the END PF key to exit from either of these screens.
If you want Abend-AID for CICS to display a confirmation window before exiting the
product when you press the END PF key from the Fault Summary or the Abend-AID
Directory, enable this functionality by using the User Profile screen, as described in “User
Profile Screen” on page 19-1.
3-1
Chapter 3.
Abend-AID for CICS Interface
Chap 3
This chapter describes the general format of Abend-AID for CICS screens and the
different methods available for accessing them.
Screen Layout
All Abend-AID for CICS screens have the same basic format. As shown in Figure 3-1, a
title line, a command line, and a message line comprise the first three lines.
Note:
Menu screens list an OPTION field on the command line; data screens list a
COMMAND field.
Figure 3-1. Basic Screen Format (Borders On)
Borders
Abend-AID ---------------- No Source Available ----------------------------COMMAND ===>
MSDSD5500I There is no source listing available for this program name
There is no Compuware Source Listing available to provide source support
for this program name. To provide source support you can either convert an
existing compiler listing into a Compuware Source Listing or you can create
a Compuware Source Listing by compiling the program.
Program Information
Program Name.................
Compile Date.................
Compile Time.................
Program Language.............
Language Release.............
PLTTEST
10FEB2006
00:00:00
ASSEMBLER
UNKNOWN
Select one of the following options to create a Compuware Source listing:
To have Abend-AID convert an existing compiler listing, select CONVERT
To use site customized utilities (ISPF only), select UTILITIES
To continue without source-level support, select NO SOURCE
For all Compuware-processed assembler listings, select LISTALL
Entry=0076771(H01AC089)
Code=ASRA
SERVER1























AssistMenu=PF24
Following the message line is the presentation area, which consists of menu selections or
data fields whose arrangement and content differ from screen to screen. In addition,
Abend-AID for CICS dynamically adjusts the information that appears in the
presentation area, based on your terminal size.
The last line displays the currently selected entry’s identification number, job name,
abend code, and viewing server name. It also identifies the PF key for listing the
commands available from the screen. Initially, this default is PF24 for the commands list.
Note:
The information displayed on the last line appears only if screen borders are
turned on.
3-2
Abend-AID for CICS User’s Guide
The remainder of this section describes the following screen components:
•
•
•
•
•
Screen borders
Scroll information fields
COMMAND and OPTION fields
Line commands
Screen attribute defaults
Screen Borders
Display Abend-AID for CICS screens with no borders, a partial border, or a full border.
The top border is always displayed, but you can choose to display the side and/or bottom
borders. The default for the border display is set in the User Profile screen’s Display
screen borders field. To override this default for the current session only, type the
BORDERS command with the appropriate parameters in the COMMAND (or OPTION)
field on any Abend-AID for CICS screen and press Enter. For the BORDERS command’s
syntax, refer to “BORDERS” on page 21-9. For information on setting the color of the
border, refer to “Screen Attributes” on page 19-3 or setting other defaults on the User
Profile screen, refer to “User Profile Screen” on page 19-1.
Scroll Information Fields
The presentation area on Abend-AID for CICS screens can contain a fixed data area, a
scrollable data area, or both. As shown in Figure 3-2, the fixed data area, if present,
appears above the scrollable data area. Further, some screens contain an additional fixed
data area that appears at the bottom of the screen.
Figure 3-2. Data Screen with Fixed and Scrollable Areas
Abend-AID ---------------- Kernel Task Summary --------- Row 000001 of 000024 
COMMAND ===>
SCROLL ===> PAGE 
MFDFD1106I Dump analysis completed for dump 76,732, ASID 01DA, jobname (PFHBXT6
Total Number of Kernel Tasks............... 44

Number of Kernel Tasks Allocated........... 23


M Monitoring Detail
T Trace Table


Kernel
Task

Task
Status
TCA
DTA
Number Tran KTCB
Error

******** ************* ******* ******* ****** **** ****** *****

_ KETA0001 KTCB STEP
KTCBJS

_ KETA0002 KTCB QR
DTA0002
KTCBQR

_ KETA0003 KTCB RO
DTA0003
KTCBRO

_ KETA0004 KTCB CO
DTA0004
KTCBCO

_ KETA0005 NOT RUNNING
DTA0005
0
KTCBFO

_ KETA0006 NOT RUNNING
DTA0006
0
KTCBRO

_ KETA0007 NOT RUNNING
TCA0007 DTA0007
19
CSHQ KTCBQR

_ KETA0008 NOT RUNNING
DTA0008
0

_ KETA0009 NOT RUNNING
DTA0009
0
KTCBQR

_ KETA000A NOT RUNNING
DTA000A
0

_ KETA000B NOT RUNNING
TCA000B DTA000B
4
CSOL

_ KETA000F NOT RUNNING
TCA000F DTA000F
6
CSSY KTCBQR

Type a line command and press Enter to process it 
Fixed data
area
Mask Line
Scrollable
data area
You cannot change the relative position of the fields listed in a fixed data area. In
addition, the IBM terminal emulation you are using has no effect on their arrangement.
Note:
You can display Abend-AID for CICS on any terminal or PC emulating either an
IBM 3270 (MOD2 through MOD5), or an IBM 3290.
Scrollable data areas, in comparison, automatically expand or contract to fill the
available screen space. For example, a screen emulating an IBM 3270 MOD2 terminal
displays up to 24 rows of information in an 80-character format (Figure 3-2 on page 3-2),
Abend-AID for CICS Interface
3-3
but a screen emulating a MOD5 terminal displays up to 27 rows of information in a 132character format.
Masking and Sorting
The scrollable data area includes a mask line that you can use to tailor the contents of the
scrollable data area. The mask acts as a filter, and only the list entries that match each
column mask value appears in the scrollable data area. To mask the data in any column,
type the characters of the data you wish to display, and press Enter. The asterisk (*)
character is the wildcard character.
For example, to display Kernel Task Summary information only for kernel tasks with a
transaction ID beginning with the characters CS, enter CS** in the mask line in the TRAN
column.
To reset the column mask to all wildcard characters for an individual column, clear the
column mask using the space bar or the Erase EOF key.
You can also sort the scrollable column data by each of the column headings by using the
SORT primary commands. These commands rearrange the column data alphabetically or
chronologically in ascending or descending order, depending on which command you
use or which column you choose to sort by. New with Release 11.2, the SORTD primary
command rearranges the column data alphabetically or chronologically in descending
order. See “SORTA” or “SORTD” on page 22-34 for more information. By default, AbendAID for CICS does not restore the mask and sort parameters from your last session on the
Abend-AID Directory and the Source Program Directory.
Rearrange Column Headings
In addition, you can use the ARRANGE primary command to rearrange the columns on
any screen that contains columns for the current session. Your new settings are saved for
future use on the Fault Summary, Abend-AID Directory, File Request Summary, and
Task/Wait Analysis screens. If you save the rearranged columns, the screen displays
Customized View in the bottom-right.
Valid only on Abend-AID Viewer screens with left-right scrollable columns such as the
Abend-AID Directory, the ARRANGE command lets you rearrange the position of the
columns on the screen where you enter this command. In the pop-up window that is
displayed, you can enter the following line commands next to the desired column in the
list of screen column headings:
•
•
•
•
•
M (Move column)
A (After column)
B (Before column)
L (Lock/Unlock column toggle)
H (Hide/Show column toggle)
After you’ve made your changes, type END (or press the PF3 key) to save your changes,
CANCEL to exit the pop-up window without saving, or RESET to restore the screen
column defaults. See “ARRANGE” on page 21-4 for more information.
Row Field
Screens that have an up/down scrollable area include a Row field in their title line. This
field lists two numbers: the row number of the first row currently displayed and the total
number of rows in the scrollable area. For example, in Figure 3-3, Row 000001 of 000024
indicates that the first row currently displayed is also the first row of 24 total rows.
3-4
Abend-AID for CICS User’s Guide
Figure 3-3. Location of Scrolling Information Fields
Row indicator for
scrollable area
Abend-AID ---------------- Kernel Task Summary --------- Row 000001 of 000024 
COMMAND ===>
SCROLL ===> PAGE 
MFDFD1106I Dump analysis completed for dump 76,732, ASID 01DA, jobname (PFHBXT6
Total Number of Kernel Tasks............... 44

Number of Kernel Tasks Allocated........... 23


M Monitoring Detail
T Trace Table


Kernel
Task

Task
Status
TCA
DTA
Number Tran KTCB
Error

******** ************* ******* ******* ****** **** ****** *****

_ KETA0001 KTCB STEP
KTCBJS

_ KETA0002 KTCB QR
DTA0002
KTCBQR

_ KETA0003 KTCB RO
DTA0003
KTCBRO

_ KETA0004 KTCB CO
DTA0004
KTCBCO

_ KETA0005 NOT RUNNING
DTA0005
0
KTCBFO

Default
up/down
scroll
indicator
<== ==>
symbols
indicate
left/right
scrollable
area
Up/Down Scroll Field
Screens that have a scrollable area also have a SCROLL field listed immediately below the
Row field. To scroll through the data, press the UP and DOWN PF keys. (PF7 and PF8 are
the defaults.) The number of rows scrolled depends on the SCROLL field’s listed value,
such as CSR, PAGE, or MAX. To change the scroll amount, overtype the listed value with
a different amount. (Abend-AID for CICS supports the same scroll amount values used in
ISPF.) You also can use the UP, DOWN, TOP, and BOTTOM commands to scroll through
the data. For information about the UP and DOWN commands, refer to “Default PF Key
Definitions” on page 19-5, and for information about the TOP and BOTTOM commands,
refer to Part 5, “Commands”.
Left/Right Scroll Field
Some screens have a left/right scrollable area. If so, left (<==) and right (==>) arrow
symbols appear immediately below the SCROLL field (Figure 3-3 on page 3-4). If the
screen scrolls in only a left or right direction, then only the arrow indicating that
direction is shown.
To scroll left or right, press the LEFT or RIGHT PF key. (PF10 and PF11 are the defaults.)
The number of columns scrolled depends on the SCROLL field’s listed value. You also can
use the LEFT and RIGHT commands to scroll through the data. For information about
these commands, refer to “Default PF Key Definitions” on page 19-5.
COMMAND and OPTION Fields
All data screens have a Command field on their command line, as shown in Figure 3-4. In
comparison, all menu screens have an OPTION field on their command line. Though
these two fields have different names, they perform the same function of providing a
location from which you can execute Abend-AID for CICS commands.
Abend-AID for CICS Interface
3-5
Figure 3-4. Location of Command Fields
Command
field
Line
Commands
and
command
names
Line
Command
entry fields
Abend-AID ---------------- Kernel Task Summary --------- Row 000001 of 000024 
COMMAND ===>
SCROLL ===> PAGE 
MFDFD1106I Dump analysis completed for dump 76,732, ASID 01DA, jobname (PFHBXT6
Total Number of Kernel Tasks............... 44

Number of Kernel Tasks Allocated........... 23


M Monitoring Detail
T Trace Table


Kernel
Task

Task
Status
TCA
DTA
Number Tran KTCB
Error

******** ************* ******* ******* ****** **** ****** *****

_ KETA0001 KTCB STEP
KTCBJS

_ KETA0002 KTCB QR
DTA0002
KTCBQR

_ KETA0003 KTCB RO
DTA0003
KTCBRO

_ KETA0004 KTCB CO
DTA0004
KTCBCO

_ KETA0005 NOT RUNNING
DTA0005
0
KTCBFO

_ KETA0006 NOT RUNNING
DTA0006
0
KTCBRO

_ KETA0007 NOT RUNNING
TCA0007 DTA0007
19
CSHQ KTCBQR

_ KETA0008 NOT RUNNING
DTA0008
0

_ KETA0009 NOT RUNNING
DTA0009
0
KTCBQR

_ KETA000A NOT RUNNING
DTA000A
0

_ KETA000B NOT RUNNING
TCA000B DTA000B
4
CSOL

_ KETA000F NOT RUNNING
TCA000F DTA000F
6
CSSY KTCBQR

Type a line command and press Enter to process it 
Not all commands are available from every screen, however. To display the entire
command list for Abend-AID for CICS, type CMDLIST or HELP COMMANDS in the
COMMAND or OPTION field, and then press Enter. For a description of primary
commands, see Part 5, “Commands”. You can also display the description for any
command by typing HELP command-name and pressing Enter. For example, typing HELP
MAPD displays information describing the function and syntax of the MAPD command.
Line Commands
As shown in Figure 3-4, some data screens also display single character line commands that
you can execute against the entries listed. To execute a line command, tab the cursor to
the desired line command entry field, type the character assigned to the command, and
press Enter.
For general information about line commands, perform either of the following two
procedures:
• Type HELP in the Command field, position the cursor on any line command entry
field, and press Enter.
• Position the cursor on any line command entry field and press the HELP PF key. (PF1
is the default.)
For specific information about a single line command, perform one of the following
procedures:
• Type HELP in the Command field, position the cursor on the line command or its
name, and press Enter.
• Position the cursor on the line command or its name and press the HELP PF key.
• On the general help screen for line commands, position the cursor on the desired
line command and press the HELP PF key.
Screen Attribute Defaults
All fields and screen areas have assigned highlighting, color, and interactive defaults.
Abend-AID for CICS uses these defaults to differentiate the types of information it can
display. The Abend-AID for CICS default color for:
3-6
Abend-AID for CICS User’s Guide
• Non-emphasized field data is white.
• Non-emphasized field names is turquoise.
• User-input fields is red.
• Tab-selectable fields is green. These are the fields that support the cursor point-andshoot feature. See “Cursor Point-and-Shoot Feature” on page 3-7.
Note:
If you have changed your default ISPF colors, those changes override the AbendAID for CICS defaults when Abend-AID for CICS is accessed from ISPF.
You have the option to change field and screen area defaults to suit your own tastes. For
specifics, refer to “Screen Attributes” on page 19-3.
Screen Access
Abend-AID for CICS offers a variety of methods for navigating from screen to screen.
These methods include selecting screens directly from the menus, using the cursor pointand-shoot feature, or executing simple navigation commands. In addition, several PF key
defaults directly access specific screens. This flexibility provides both novice and expert
Abend-AID for CICS users with easy access to needed information.
Menu Selections
To select an option from a displayed menu, type the option’s alphanumeric selection
character or its mnemonic identifier in the OPTION field and press Enter. For example, to
select the Diagnostic Summary from the Primary Options menu (Figure 3-5), type 1 or
DIAG in the OPTION field and press Enter. Tabbing the cursor to the option’s mnemonic
identifier (DIAG) and pressing Enter accomplishes the same result.
Note:
If a menu option is not available for the transaction abend you have selected, an
asterisk (*) precedes the mnemonic identifier, and the identifier appears in a
different color than the available options.
Figure 3-5. Primary Options Menu for Transaction Abend Analysis
Menu
selection/
jump
command
character
Mnemonic
identifier/
fast-path
command
Abend-AID ------------------ Primary Options -------------------------------- 
OPTION ===>


1 DIAG
Diagnostic Summary
7 *FILE
File Request Summary


2 PROG
Program Information
8 *DB2
DB2 Information


3 TRACE
CICS Trace
9 L3270
Last 3270 Screen


4 TERM
Terminal Detail
10 *MQINFO WebSphere MQ Information


5 TASK
Task Detail
11 *CWI
CICS Web Interface


6 CB
Control Blocks/Storage
12 *LEINFO LE Information




D DIRECTRY Abend-AID Directory
R SRCDIR
Source Directory


S SUMMARY Fault Summary
U USER
User Control Facility


N NEWS
Product News
X EXIT
Exit


Abend-AID for CICS Interface
3-7
Cursor Point-and-Shoot Feature
The cursor point-and-shoot feature gives you direct access to specific locations in storage
and to detailed information about specific data elements.
To use this feature, execute one of the following procedures:
• In the COMMAND field, type the command you want to execute, for example,
DECODE, DISASM, HEXD, or WHERE. Then tab the cursor to the applicable storage
address or key data element field and press Enter.
Note:
By default, tab-selectable fields are green.
• Tab the cursor to the applicable storage address or key data element field, and then
press the PF key associated with the command you want to execute. Initial PF key
defaults are set for the following commands:
–
–
–
–
–
–
DISASM (PF17)
HEXD (PF18)
DSECT (PF19)
WHO (PF21) - Region dumps only
MATCH (PF22) - Region dumps only
ASSIST (PF24).
• Tab the cursor to a storage address or key data element field, and then press the Enter
key. The screen that Abend-AID for CICS displays depends on the content of the
selected field. If there is no default action, a window appears showing available
actions.
Using a Mouse with the Point-and-Shoot Feature
Depending on the emulator you’re using to access Abend-AID for CICS, you may be able
to use your mouse with the point-and-shoot feature. To enable point-and-shoot hotspots
with IBM’s Personal Communications for Windows, do the following:
1. From the Edit pull-down menu, select Preferences.
2. Select Hotspots Setup.
3. Under the Point-and-Select Commands section, check the box preceding ENTER at
cursor position.
4. Click OK.
You now have direct access to specific locations and to information about specific data
elements by double-clicking on the highlighted field. If you are using another emulator
to access Abend-AID for CICS, refer to its user documentation/help to determine if it
supports this feature and for the procedure to enable point-and-shoot hotspots.
ASSIST Function
The ASSIST command displays the commands that are available for the current screen or
field. Pressing the ASSIST PF key also executes this command (PF24 is the default). For
example, to list the commands available for the current screen, tab to the COMMAND
field and press the ASSIST PF key, or type ASSIST in the COMMAND field, and press
Enter. To list the commands available for a specific field, tab to the field and press the
ASSIST PF key, or type ASSIST in the COMMAND field, tab to the field, and press Enter. If
the current screen or field has no commands associated with it, a message appears
indicating that the ASSIST function is not available.
Navigation Commands
Most Abend-AID for CICS screens have a unique mnemonic identifier, such as DIAG for
the Diagnostic Summary or TASK for Task Detail. In addition, every screen listed as a menu
3-8
Abend-AID for CICS User’s Guide
option has an assigned alphanumeric selection character. For example, on the Primary
Options menu shown in Figure 1-4 on page 1-8, the Diagnostic Summary’s selection
character is 1 and the Task Detail selection character is 5.
Note: Some Abend-AID for CICS screens are not accessible directly from the menus, but
instead are accessible directly from other data screens.
Fast-Path Commands
A screen’s mnemonic identifier is also referred to as its fast-path command. Directly access a
screen simply by typing its fast-path command in the COMMAND or OPTION field on
any other screen and pressing Enter. For example, entering MAIN or MM on any AbendAID for CICS screen, returns you to the Primary Options menu.
To determine a command’s syntax, type HELP cmdname in the COMMAND (or OPTION)
field and press Enter. For example, HELP CORE displays a pop-up window describing the
CORE command’s syntax.
Part 5, “Commands” provides a complete list of theAbend-AID for CICS primary and fastpath commands in alphabetical order.
Jump Commands
Another method for accessing screens directly is to use jump commands. These commands
are ISPF-like selection strings that uniquely identify the screens accessible from the
menus.
For example, to access the Program Link Information screen for a transaction abend,
which is the first selection on the Program Information menu, type =2.1 or >2.1 in any
screen’s COMMAND (or OPTION) field and press Enter. The number 2 starts the
command string, because the Program Information menu is the second selection on the
Primary Options menu for transaction abends (Figure 1-4 on page 1-8).
You can include mnemonic identifiers/fast-path commands in jump command syntax.
For example, either of the following jump commands access the Task Summary screen for
a region dump:
=TASKS.1
>2.TASKSUM
By definition, a jump command is preceded by either an equal sign (=), or a greater-than
sign (>). Preceding a jump command with an equal sign routes a screen’s access through
the Primary Options menu. As a consequence, exiting the resultant screen with the END
command (PF3) displays the Primary Options menu, rather than the screen from which
you typed the jump command. In comparison, using the greater-than sign causes AbendAID for CICS to return to the screen from which you typed the command.
Primary Commands
Abend-AID for CICS primary commands perform specific functions such as screen
manipulation, cursor movement, and dump information access and display. Examples of
primary commands are ASSIST, FIND, HELP, PRINT, WHERE, and WHO. To execute a
primary command, type the command in the COMMAND (or OPTION) field and press
Enter.
To determine a particular command’s syntax while you are using Abend-AID for CICS,
type HELP cmdname in the COMMAND (or OPTION) field and press Enter. For example, 
HELP FIND displays a pop-up window describing the FIND command’s syntax.
Part 5, “Commands” provides a complete list of the Abend-AID for CICS primary and
fast-path commands in alphabetical order.
Abend-AID for CICS Interface
3-9
Command Availability
A subset of fast-path and primary commands is always available, even when you have not
selected a dump from the Abend-AID Directory. A few additional fast-path and primary
commands become available after you select a non-CICS entry from the directory. Most
commands, however, become available only after you select a CICS Transaction Server for
z/OS or OS/390 entry from the directory.
To determine which commands are available, type CMDLIST or HELP COMMANDS in
the COMMAND (or OPTION) field and press Enter. A scrollable display appears that lists
the available commands in alphabetical order.
ISPF/TSO Commands
If you are accessing the Abend-AID Viewer from ISPF/TSO, you can enter ISPF and/or TSO
commands without exiting from the Abend-AID Viewer by doing any one of the
following options:
• Split the screen and use a different panel.
• Define an ISPF/TSO command to a PF key and use it to execute the command. See
“Modifying PF Key Functions” on page 19-6 for more information.
• Type ISPF followed by the ISPF command on the command line and press Enter.
• Type ISPF followed by a semi-colon (;), and then TSO followed by the TSO command
on the command line and press Enter. For example:
ISPF;TSO LISTA
Return to the Abend-AID Viewer session by using the END command. The PF3 key is the
default.
3-10
Abend-AID for CICS User’s Guide
4-1
Chapter 4.
Working with Dumps
Chap 4
This chapter describes the following Abend-AID for CICS screens that enable you to select
and analyze Abend-AID for CICS entries and to display basic information about them:
• Fault Summary
• Abend-AID Directory
• Entry Information (for transaction or region entries)
• Duplicate History Log
• Contact Information.
Fault Summary
The Fault Summary is the first screen displayed when you access Abend-AID for CICS
from VTAM or ISPF. You can also use the AADFS transaction command to display the
Fault Summary from CICS. To bypass the Fault Summary as the first screen, set the
Automatically reselect last dump viewed user profile option to Y, as described in “User
Profile Screen” on page 19-1.
The Fault Summary summarizes the type and number of transaction and region entries
available for each CICS region or region group to which you have assigned a name. NonCICS entries are also listed.
Region groups are created during Abend-AID for CICS customization as part of the CICS
Region Configuration function. This function allows you to group CICS regions together
by name so that the Fault Summary reflects total counts for all regions in the group. If
you choose not to create region groups, individual CICS job names are used as region
descriptions on the Fault Summary. Refer to the Abend-AID Installation and Customization
Guide for information about configuring CICS regions.
As shown in Figure 4-1 on page 4-2, the Fault Summary lists entries by the region or
region group to which they belong. The list is in alphabetical order. If your site defined
them, region groups are alphabetized at the top of the list, followed by an alphabetized
list of regions. To select an entire region or region group, place the cursor on the
appropriate Region Descriptions name and press Enter. To select either a single entry type
or all entries from a region or region group, place the cursor on the appropriate numeric
value and press Enter. Abend-AID for CICS displays a directory tailored to your selection.
If your installer sets the EXTERNAL_SECURITY_ENABLED=YES and the
EXTERNAL_SECURITY_DATASET_CHECK=(REGION,TRAN) server parameters during
installation, you can only view and select entries from those datasets (transaction
databases, batch databases, and region dumps) for which you have READ authority
(granted from an external security product such as RACF or ACF2). If your access to the
Abend-AID Directory is restricted using these parameters, entries from migrated
transaction dump databases will not be included in the Abend-AID directory display. If
you select the DBLIST option on the Fault Summary or Abend-AID Directory screen, the
list of databases will include the datasets that are migrated. You can recall migrated
datasets using your installation’s procedure for recalling datasets.
Note:
Refer to the “Viewing Server Parameters” section of the Abend-AID Installation and
Customization Guide for information on setting these options.
4-2
Abend-AID for CICS User’s Guide
To view the Fault Summary for a specific region type, you can also use the cursor pointand-shoot feature and press Enter at the View field to display the Fault Summary View
Selection menu, as shown in Figure 4-2. This menu includes All, CICS Transactions, MVS
Batch, IMS/TM Transaction, and CICS Region/SVC types.
New with Release 11.2, your selection of a region type is saved when you exit the Fault
Summary and is redisplayed at your next access to this screen.
To display the standard Compuware copyright/trade secrets notice, press Enter at the
COPYRIGHT field.
Figure 4-1. Fault Summary
Compuware Abend-AID --------- Fault Summary ------------ Row 000001 of 000023
COMMAND ===>
SCROLL ===> PAGE
Shared Directory/Database... AC.SV.R0101.ALPHA.RPT.SHRDIR
For a list of databases, select DBLIST
To view the Fault Summary for a specific type, select View
Job Name or
CICS
MVS
IMS/TM
CICS
Other
Application Description Trans
Batch
Trans
SVC
SVC
TOTAL ENTRIES
24
111
5
2
20
User1 test region
9
5
0
0
0
User2 test region
6
0
0
0
0
*MASTER*
0
0
0
0
1
AA100DKS
0
1
0
0
0
AA101BJS
0
2
0
0
0
AA101CAS
0
1
0
0
0
AA101IVP
0
1
0
0
0
AA101S08
0
1
0
0
0
AA101XD9
0
2
0
0
0
AA101001
0
1
0
0
0
AA101642
0
1
0
0
0
AA101701
0
1
0
0
0
Online Technical Support available at: frontline.compuware.com
To display Copyright/Trade Secret notice select COPYRIGHT
Total
SVC
22
0
0
1
0
0
0
0
0
0
0
0
0





















Figure 4-2. Fault Summary View Selection Menufor
Compuware Abend-AID -- Fault Summary View Selection ------------------------- 
COMMAND ===>


A ALL
All


T TRAN
CICS Transactions


B BATCH
MVS Batch


I IMS
IMS/TM Transaction


S SVCDUMP CICS Region/SVC




To display the Fault Summary from any Abend-AID for CICS screen, enter SUMMARY as
a fast-path command. The Fault Summary is also available as a selection on the Primary
Options menu.
Working with Dumps
4-3
Abend-AID Directory
When you select a CICS region or region group from the Fault Summary, Abend-AID for
CICS automatically displays the Abend-AID Directory for CICS Transactions. With CICS
AADF access, the directory is the first screen displayed by default unless you enter an
alternate AADF transaction command as described in “Logging On to Abend-AID for
CICS” on page 2-1. As shown in Figure 4-3 on page 4-4, the Abend-AID Directory for
CICS Transactions provides information only pertaining to CICS Transaction entries. For
information about a CICS SVC dump, you will get a directory screen tailored to that
region. If you want to see the total entries for all dump types, you can select “Total
Entries” on the Fault Summary screen. The directory screens will provide access to
available line commands and information associated with the type of entry you are
analyzing. This information is presented on a maximum of four left/right scrollable
screens, depending on the width of the terminal.
To display the Abend-AID Directory from any other Abend-AID for CICS screen, enter
DIRECTRY as a fast-path command. Entering the command without any parameter
displays the directory entries based on your last selection for the current session made on
the Fault Summary. To display all the entries on the Abend-AID Directory, enter
DIRECTRY ALL as a fast-path command.
Automatically Restoring Mask and Sort Values
By default, Abend-AID for CICS does not automatically restore the mask and sort criteria
from your last session on the Abend-AID Directory. To enable this functionality, use the
User Profile screen, as described in “User Profile Screen” on page 19-1.
Note:
Even if you specify on the User Profile screen that your last mask and sort values
be automatically restored, tab-selecting a region or region group from the Fault
Summary, or entering the DIRECTRY ALL fast-path command resets the mask and
sort criteria. To avoid resetting the mask and sort values from your last session
when you access Abend-AID for CICS from ISPF or VTAM, use the DIRECTRY fastpath command without any parameters to display the Abend-AID Directory. If
you are accessing from CICS, execute the AADF transaction to display the
Abend-AID Directory with the mask and sort values from your previous session.
4-4
Abend-AID for CICS User’s Guide
Figure 4-3. Scrollable Screens (Left to Right) Comprising the Abend-AID Directory for CICS Transactions

Compuware Abend-AID - Directory - CICS Transactions ----Row 000001 of 001039 
COMMAND ===>
SCROLL ===> PAGE 
==>
Shared Directory/Database... PFHRHH0.H01AC118.SHRDIR
For a list of databases, select DBLIST 
M Menu
S Diag
Entry
*******
0110196
0077803
0077801
0077797
0077635
0077633
0077338

Job Name
********
H01AC089
H01AC151
H4GAC197
H01AC110
H01AC098
H01AC098
H01AC098
H Dup History
I Information
Abend
Code
********
ASRA
ASRA
PBAD
ASRA
ASRA
ASRA
GOPN
Tran
****
AADM
HLV1
WBIG
PJR1
AADM
AADM
MQTE
Term
****
0423
1933
0853
0446
1346
1346
1926
D Delete
P Print
Program
********
CCAADEMO
HLASM01
BIGSQLL8
PJRTEST4
CCAADEMO
CCAADEMO
MQTEST




Dups
****
0
0
0
0
0
0
0
N Contact Information
Offset
********
0000143C
00000208
0000559A
00000638
000010BE
000010BE
000036FE
Time
********
16:21:15
07:55:03
08:08:29
09:48:17
13:09:04
13:03:46
14 55 28
Date
*********
11DEC2012
12SEP2012
14JUN2012
13SEP2012
05MAR2012
05MAR2012
11OCT2011
Compuware Abend-AID - Directory - CICS Transactions ---- Row 000001 of 001039 
COMMAND ===>
SCROLL ===> PAGE 
<== ==>
Shared Directory/Database... PFHRHH0.H01AC118.SHRDIR
For a list of databases, select DBLIST 
M Menu
S Diag
Entry
*******
0110196
0077803
0077801
0077797
0077635
0077633
0077338

L Lock
U Unlock
L Lock
U Unlock
Job Name
********
H01AC089
H01AC151
H4GAC197
H01AC110
H01AC098
H01AC098
H01AC098
H Dup History
I Information
Abend
Code
********
ASRA
ASRA
PBAD
ASRA
ASRA
ASRA
GOPN
D Delete
P Print



N Contact Information

Userid
********
CICSUSER
PFHAMJ0
PFHEAB0
CICSUSER
CICSUSER
CICSUSER
CICSUSER
Release/Type
************
CICS620_TRAN
CICS640_TRAN
CICS630_TRAN
CICS640_TRAN
CICS620_TRAN
CICS620_TRAN
CICS620 TRAN
Status
*********
LOCKED
LOCKED
COMPLETE
COMPLETE
LOCKED
COMPLETE
COMPLETE
JESID
********
J0190420
J0609868
J0329314
J0620745
J0921081
J0921081
J0474237
Dataset Na
**********
PFHRHH0.CC
PFHRHH0.CC
PFHRHH0.CC
PFHRHH0.CC
PFHRHH0.CC
PFHRHH0.CC
PFHRHH0 CC
Compuware Abend-AID - Directory - CICS Transactions ---- Row 000001 of 000021 
COMMAND ===>
SCROLL ===> PAGE 
<== ==>
Shared Directory/Database... PFHRHH0.H01AC118.SHRDIR
For a list of databases, select DBLIST 
M Menu
S Diag
Entry
*******
0110196
0077803
0077801
0077797
0077635
0077633
L Lock
U Unlock
Job Name
********
H01AC089
H01AC151
H4GAC197
H01AC110
H01AC098
H01AC098
H Dup History
I Information
Abend
Code
********
ASRA
ASRA
PBAD
ASRA
ASRA
ASRA
D Delete
P Print
N Contact Information




Dataset Name
Commen
******************************************** ******
PFHRHH0.CCAA.TRANDB01
PFHRHH0.CCAA.TRANDB04
PFHRHH0.CCAA.TRANDB04
PFHRHH0.CCAA.TRANDB04
PFHRHH0.CCAA.TRANDB02
PFHRHH0.CCAA.TRANDB02
Working with Dumps

4-5
Compuware Abend-AID - Directory - CICS Transactions ---- Row 000001 of 001039 
COMMAND ===>
SCROLL ===> PAGE 
<== ==>
Shared Directory/Database... PFHRHH0.H01AC118.SHRDIR
For a list of databases, select DBLIST 
M Menu
S Diag
Entry
*******
0110196
0077803
0077801
0077797
0077635
0077633
L Lock
U Unlock
Job Name
********
H01AC089
H01AC151
H4GAC197
H01AC110
H01AC098
H01AC098
H Dup History
I Information
Abend
Code
********
ASRA
ASRA
PBAD
ASRA
ASRA
ASRA
D Delete
P Print
N Contact Information




Comments
SYSID
********************************************* *****
____________________________________________ BC00 
____________________________________________ SYSA
____________________________________________ MVSZ
____________________________________________ MVSZ
____________________________________________ MVSZ
____________________________________________ SYSA






M Menu
L Lock
H Dup History
D Delete
N Contact Information

S Diag
U Unlock
I Information
P Print


Abend
Latest
Latest

Entry
Job Name Code
Comments
SYSID Time
Date

******* ******** ******** ************************** ***** ******** *********
Compuware Abend-AID - Directory - CICS Transactions ---- Row 000001 of 001039
COMMAND ===>
SCROLL ===> PAGE
<==
Shared Directory/Database... PFHRHH0.H01AC118.SHRDIR
For a list of databases, select DBLIST
Information listed on the Abend-AID Directory includes the following:
• Entry: Abend-AID for CICS entry number. This number is assigned when the entry is
added to the shared directory.
• Job Name: MVS job name. For a transaction entry, this is the job name of the CICS
region in which the transaction was running when the abend occurred. For a region
entry, this is the name of the job for which the region dump (SVC, console, SLIP, etc.)
was issued.
• Abend Code: MVS or CICS abend code.
• Tran: Name of the controlling transaction that abended.
• Term: (Transaction entries only) Four-character identification number for the
terminal at which the abend occurred.
• Program: (Transaction entries and Batch dumps only) Name of the abending
program. See the online help for more details.
• Offset: (Transaction entries and Batch dumps only) The offset in the abending
program.
• Time: Time of the transaction abend or region dump.
• Date: Date of the transaction abend or region dump.
• Dups: (Transaction entries and Batch dumps only) Number of duplicate dump
suppressions. See the online help for more details.
• Userid: For transaction entries, this is the user ID of the user signed on at the time of
the abend. For region entries, this is the user ID of the last person to view the entry.
• Release/Type: For CICS transaction and region dumps, this is the CICS release level
and type of dump. For other dumps, this is the type of dump (such as BATCH, SVC,
SLIP, or SYSMDUMP).
• Status: Processing status, such as RUNNING, COMPLETE, or INCOMPLETE. See the
online help for a complete list of status types.
4-6
Abend-AID for CICS User’s Guide
• JESID: JESID or job number.
• Dataset Name: For region entries, this field contains the name of the dataset
containing the dump in SVC dump format. For transaction and batch entries, this is
the name of the database containing the report.
• Comments: User comments or symptom string (default for region dumps).
Information in this field may be overtyped or added to (up to a maximum length of
44 bytes).
• SYSID: For a transaction entry, this field is the system ID of the CICS region in which
the transaction was running when the abend occurred. For an SVC dump entry, this
is the system ID of the job for which the dump (SVC, console, SLIP, etc.) was issued.
• Latest Time: This field shows the most recent time for this report. If there are no
duplicates, then it is the time of the actual report. If there are duplicates, then it
shows the time of the most recent duplicate.
• Latest Date: This field shows the most recent date for this report. If there are no
duplicates, then it is the date of the actual report. If there are duplicates, then it
shows the date of the most recent duplicate.
Types of Directory Entries
Listed on the Abend-AID Directory are dump entries and information-only entries (region
dumps only). These two entry types affect the information that the directory displays
and the functions of its line commands. To determine an entry’s type, check its
Release/Type field. An INFO dump type indicates an information-only region entry. All
other values in the Release/Type field indicate a specific dump type, for example, SVC or
SLIP.
An information-only entry appears on the Abend-AID Directory when the listed dump is
not available to the server. Several conditions can be the cause. For example, the dump
copy may have failed or the dataset is not cataloged. A dump signature mismatch can
also be the cause. A mismatch occurs when the dataset containing the dump is
overwritten from outside Abend-AID for CICS with new data.
Deleting a region dump dataset from outside Abend-AID for CICS will also generate an
information-only entry. At initialization, the server checks whether each region dump
dataset in the Abend-AID Directory is available on DASD. If it finds a dataset has been
deleted, it changes the dump status for all address spaces in that dataset to INFO, and it
deletes all Abend-AID for CICS information about them except the directory entry.
Abend-AID for CICS also writes an error message to the System Messages field on the
Entry Information screen. For information about this screen, refer to “Region Entry
Information Screen” on page 4-10.
Line Commands
Use the Abend-AID Directory’s line commands to view or perform maintenance functions
on selected entries. The specific tasks performed by the line commands are as follows:
M
Selects the entry and displays the Primary Options menu. A system message on the
menu displays the dump’s entry number and job name and indicates that the dump
has been successfully selected. Once a dump is selected, identifying information
about the dump is displayed on the last line of the screen. If you use the BORDERS
OFF command to suppress the bottom border, however, this information does not
appear. For more information about the BORDERS command, refer to “BORDERS” on
page 21-9. The next time you display the Abend-AID Directory, it highlights the
currently selected entry.
Working with Dumps
4-7
Notes:
a. Select any entry for display that is not an INFO type, or whose Status field lists a
value other than NOT SEL. If the status is COMPLETE, all functions are available.
b. Placing the cursor on an entry and pressing Enter functions like the M line
command. The entry is selected and the Primary Options menu is displayed.
S
Selects the entry and displays the entry’s Diagnostic Summary, which is the logical
starting point for debugging the majority of CICS dumps. For this line command to
function, the entry must have a COMPLETE status in its Status field.
D
Deletes the entry. The D line command functions as follows:
– Transaction dump: Abend-AID for CICS deletes the entry from the directory and
information from the transaction database. Abend-AID for CICS displays a
confirmation window by default from which to confirm or cancel the delete
request. Tab to the Delete or Cancel field and press the Enter key, or press the
END PF key to cancel the request. (PF3 and PF15 are the defaults.)
– Region dump: If the region dump dataset has multiple address spaces, and if
more than one of them is not in DELETED status, the command deletes all
information from the Abend-AID for CICS files and changes the status of the
entry to DELETED. If only one address space is in the dump dataset, or if you are
deleting the last address space in the dump that does not have a status of
DELETED, the command deletes all information from the Abend-AID for CICS
files.
If the entry is for a region dump, you can delete the SDUMP dataset, migrate it, or
keep it on DASD. By default, Abend-AID for CICS displays a delete confirmation
window from which to confirm or cancel the request. Abend-AID for CICS requests
that you specify the disposition of the SDUMP dataset: delete, migrate, or keep.
If the entry’s Type field value is INFO, the command removes this information-only
entry from the Abend-AID Directory.
Note:
You can disable the delete confirmation window for either a transaction or
region dump by changing your user profile. If you specify in your user profile
not to display the delete confirmation window, Abend-AID for CICS uses the
SDUMP dataset disposition as specified on the User Profile screen. Refer to
“User Profile Screen” on page 19-1 for additional information.
L
Locks a transaction entry, protecting it from automatic deletion.
U
Unlocks a locked transaction entry, freeing it for automatic deletion.
G
Displays the Dump Analysis Message Log, which lists in chronological order the
Abend-AID for CICS programs that were executed to analyze the dump. (Functions
with region dumps only.) The Dump Analysis Message log displays any errors
processing the dump, as well as any exception conditions found within the dump.
To display a selected entry’s message log from any Abend-AID for CICS screen, enter
MLOG as a fast-path command. For MLOG to function, however, you must first
select a region entry from the Abend-AID Directory.
H
Displays the Duplicate History Log for a transaction entry. The Duplicate History Log
is a record of the duplicate dump suppression activity for the entry. For more
4-8
Abend-AID for CICS User’s Guide
information about the Duplicate History Log, refer to “Duplicate History Log” on
page 4-11.
I
Displays the Entry Information screen for any entry that is not an INFO (informationonly) type. The Entry Information screen lists the entry’s type, address space identifier
(ASID), status, date and time processed, dataset name, title, symptom string, date and
time imported, and system messages. For more information about this screen, refer to
“Transaction Entry Information Screen” on page 4-9 and “Region Entry Information
Screen” on page 4-10.
Another method for displaying the Entry Information screen for the current entry is
to use the INFO command. From any Abend-AID for CICS screen, enter INFO as a
fast-path command.
A
Schedules dump analysis on the region entry. The current status of dump analysis is
indicated in the entry’s Status field.
R
Recalls a region dump dataset that was migrated to archival storage via DFHSM or an
equivalent product that uses the interface provided by the DFHSM ARCGIVER
program. Once a dump is recalled, the status indicates SELECT, which means that
only limited functionality is available. The dump must be analyzed again for full
functionality. Use the A line command to analyze the dump again.
E
Migrates a region dump dataset to archival storage via DFHSM or an equivalent
product that uses the interface provided by the DFHSM ARCGIVER program, and
deletes the dump analysis records from the dump information file.
P
Prints the associated report for the selected entry to a temporary dataset. This dataset
is printed in its entirety when you issue the GO primary command on the Print
Options and Initiation screen or when you exit Abend-AID for CICS. For a
transaction entry, this command prints a complete report, including storage captured
by Abend-AID for CICS. For region dumps, it prints a summary report. Refer to “Print
Options and Initiation Screen” on page 7-1 and “Printing Abend-AID for CICSSupplied Reports” on page 7-5 for additional information.
T
Terminates the dump analysis that Abend-AID for CICS is running or is scheduled to
run on the region entry. For this line command to function, the entry must have a
RUNNING, NEXT, SCHEDULED, or IMPORT status in its Status field.
C
Changes the priority of the region entry to reschedule it as the next dump to have
dump analysis. If dump analysis is already running against another dump, AbendAID for CICS completes that processing before analyzing this entry.
N
Displays the Contact Information screen for entries that match criteria specified in
the action definitions created during installation customization. This screen lists
basic identifying information about the dump and about the person and an
alternate, back-up person that you can contact regarding the dump. For more
information about this screen, refer to “Contact Information Screen” on page 4-13.
Working with Dumps
4-9
Transaction Entry Information Screen
The Transaction Entry Information screen, shown in Figure 4-4, provides the following
information about a dump:
• Entry number and type
• Abend code or reason for the dump
• Transaction ID and task number
• Transaction report
• Date and time the entry was created and analyzed
• Number of users who have currently selected the entry
• User comments
• Abend-AID for CICS service level.
To display Entry Information from any Abend-AID for CICS screen, enter INFO as a fastpath command. The Entry Information screen is also available through the I
(Information) line command on the Abend-AID Directory.
If a number other than zero displays in the Nbr User field, tab to the field and press Enter
to display the Entry Users screen, which list of user IDs of those who have currently
selected the entry, as shown in Figure 4-6 on page 4-11.
Figure 4-4. Transaction Entry Information Screen

Compuware Abend-AID ------- Entry Information -------------------------------
COMMAND ===> 



Entry Number....... 0000471
Entry Type. TRAN
Entry Date.... 04MAR2016
Code............... DSNC
Status..... COMPLETE
Entry Time.... 15:55:01
Job Name........... H01AC197 CICS APPLID H01AC197
Nbr Users..... 1

Transaction ID..... SQLS
Terminal... B063
User ID....... CICSUSER
CICS Rel........... 7.0.0
Program.... DSCV04ES
Netname....... TFHB063 


Dataset Name....... CF.DEVL.DEFAULT.DB02
Symptom String..... SYMPTOMS= AB/UDSNC PIDS/566540301 FLDS/DFHPCLI
RIDS/DSCV04ES 

Comments........... 

AA/CICS Serv Level.
17.02.00-ABASE
-01/04/162@20.17 
Notes:
1. The CICS release for CICS Transaction Server for z/OS Version 5 Release 4 is displayed
as 7.1.0 on Abend-AID for CICS screens.
2. The AA/CICS Serv Level field does not display if you access the transaction Entry
Information screen using the I (Information) line command from the Abend-AID
Directory.
4-10
Abend-AID for CICS User’s Guide
Region Entry Information Screen
The Region Entry Information screen, which is shown in Figure 4-5, provides the
following information about a dump:
• Entry number and dump type
• Abend code or reason for the dump
• Address space identifier (ASID) of the region from which the dump was taken
• Original and current dump dataset names
• Date and time the dump was created, imported, and analyzed
• Number of users who have currently selected the entry
• User comments and system messages.
Figure 4-5. Region Entry Information Screen
Compuware Abend-AID ------- Entry Information ------------------------------- 
COMMAND ===>


Entry Number.... 0000660
Dump Type.. SVC
Date Processed. 21NOV2012

Code............ S0C4
ASID....... 0149
Time Processed. 10:46:10

CICS Release.... 7.1.0
Home ASID.. 0149
Last Viewed by. TSOUSER

Job Name........ PFHBXT0S Status..... MIGRATED
Nbr Users...... 001


Current Dump DSN.. SYS2.SAVEDUMP.DUMP00.G00924

Volume Serial..... MIGRAT

Original Dump DSN. SYS2.SAVEDUMP.DUMP00.G00924

Dump Title........ COMPUWARE SERVER DUMP: SERVER=SERVER1 CODE=S0C4

Symptom String.... S0C4


Dump Date......... 21JUN2017
Import Date......... 21JUN2017

Dump Time......... 10:40:57
Import Time......... 10:46:10

Addr Spaces in DS. 1
Date Added to IPCS.. NEVER ADDED

CPU Serial Number. 120270
Time Added to IPCS.. NEVER ADDED

Comment........... S0C4

System Messages... MFDFD1009E HSM migrated this dataset

Note:
The CICS release for CICS Transaction Server for z/OS Version 5 Release 4 is
displayed as 7.1.0 on Abend-AID for CICS screens.
To display Region Entry Information from any Abend-AID for CICS screen, enter INFO as
a fast-path command. The Region Entry Information screen is also available through the
I (Information) line command on the Abend-AID Directory.
If a number other than zero displays in the Nbr Users field, tab to the field and press
Enter to display the Entry Users screen, which list of user IDs of those who have currently
selected the entry, as shown in Figure 4-6 on page 4-11.
Entry Users Screen
The Entry Users screens displays a list of the users who currently have the transaction or
region entry selected. Further, this screen identifies the entry number and whether it is a
transaction or region entry.
Access this screen from the Entry Information screen. Place the cursor on the Nbr Users
field and press Enter.
Working with Dumps
4-11
Figure 4-6. Entry Users Screen
----- Entry Users ----------------- Row 000001 of 000001 
SCROLL ===> PAGE 

Entry Number...... 00000776
Dump Type...... TRAN


User ID

********

TSOUSER

****************************** BOTTOM OF DATA *********************************
Compuware Abend-AID
COMMAND ===>
Duplicate History Log
The Duplicate History Log provides a record of duplicate transaction dump suppression
activity. If duplicate suppression is enabled, for each dump, Abend-AID for CICS checks
for an existing entry with the same transaction ID, abend code (and interrupt code for
ASRA/ASRB abends), failing transaction and program name, and offset. You can also
include an APPLID, job name, terminal ID, and user ID as criteria by setting the
appropriate transaction dump global options. If Abend-AID for CICS finds a match, and
you have turned on dump suppression for the condition, Abend-AID for CICS suppresses
the dump and updates the Duplicate History Log with an additional log entry. Each time
a duplicate is suppressed, Abend-AID for CICS writes a message to the CSMT log. You can
disable this functionality by using a transaction dump global option, as described in the
Abend-AID Installation and Customization Guide.
Note: Abend-AID for CICS continues to suppress duplicates for a dump until you delete
the original dump, or it is automatically deleted by Abend-AID for CICS if the
transaction database is full, or the dump expires. Further, if you use the
DUPABLIMT transaction dump global option, duplicate dumps are suppressed
until the number of dumps being processed at one time falls below 50 percent of
the value specified for the ABLIMIT transaction dump global option.
Duplicate dump suppression is turned off by default. You can turn on/off duplicate dump
suppression using the Supp(ress) Dups field on the Permanent Tran Dump Profile screen
or using the DUPDMPS and/or DUPABLIMT transaction dump global options. Refer to
the Abend-AID Installation and Customization Guide for more information.
The Duplicate History Log tracks the frequency of a particular transaction failure without
having to store redundant entry information. This savings is especially useful in a
production environment where repetitive failures can fill a transaction database with
unwanted duplicate information.
As shown in Figure 4-7, the Duplicate History Log describes the original abend first,
followed by a scrollable list of log entries. The log displays these entries, which consist of
date, time, terminal ID, job name, APPLID, system ID, and user ID information, in
chronological order. The 100 most recent entries are saved in the log. If the number of
duplicates exceeds 100, the oldest entries are rolled off to make room for new entries.
When this occurs, a message is displayed indicating that more duplicates were suppressed
than are currently displayed.
4-12
Abend-AID for CICS User’s Guide
Figure 4-7. Duplicate History Log
Compuware Abend-AID ----- Duplicate History Log --------- Row 000001 of 000003
COMMAND ===>
SCROLL ===> PAGE

Original Dump Information for Dump 0044974:
Code.......... ASRA
APPLID.... H01AC089
SYSID... CW01
Job Name...... H01AC089
Program... CCAADEMS
Date.... 19JUL2012
Transaction... DEMS
Offset.... 000014D8
Time.... 09:49:26
Terminal...... 0567
User Id... CICSUSER 

Date
Time
Term
Job Name
APPLID
SYSID User Id
********
********
****
********
********
***** ********
19JUL2012 09:53:37
0567
H01AC089
H01AC089
CW01 CICSUSER
19JUL2012 09:53:42
0567
H01AC089
H01AC089
CW01 CICSUSER
19JUL2012 18:06:30
0567
H01AC089
H01AC089
CW01 CICSUSER
****************************** BOTTOM OF DATA ****************************** 
To display the Duplicate History Log from any Abend-AID for CICS screen, enter 
HISTORY as a fast-path command. This method requires you to have selected a
transaction entry from the Abend-AID Directory. You may also execute the H line
command against any transaction entry in the directory to display the Duplicate History
Log.
Note:
When abends occur for transactions running under Language Environment, if
you use the LESUPPORT transaction dump global option to discard subsequent
dumps, Abend-AID for CICS does not maintain any history information and it
does not increase duplicate abend counts. Refer to the Abend-AID Installation and
Customization Guide for more information.
Duplicate Dump Expiration Interval
Figure 4-9 indicates that this dump is a duplicate of an expired dump. The DUPEXPIR
and DUPUNITS parameters on the Transaction Dump Global Options screen are used to
control how much time is to elapse until duplicate dump suppression expires and a new
dump will be taken. In this example, the DUPEXPIR is 5, and DUPUNITS is MINUTES.
The duplicate expiration interval is calculated by multiplying the DUPEXPIR by the
DUPUNITS parameter which can be specified as CALENDAR (date), MINUTES, and DAYS
(24 hour intervals) from the time of the original dump. For example, if DUPEXPIR is 4
and DUPUNITS is CALENDAR, and the first dump occurred at 18:21 on 05APR2007, a
duplicate dump will be suppressed until 00:00 on 09APR2007. In other words a dump
will be suppressed until the CALENDAR (date) changes four times. Once a dump has
expired, a single new dump will be taken and the suppression interval is reset. Refer to
the Abend-AID Installation and Customization Guide for more information about the global
parameter for setting up the duplicate dump expiration interval.
Note:
Duplicate dumps are identified on the Abend-AID Directory with the Dups field.
This field indicates the number of duplicate dumps that were suppressed. If a
dump expires and a duplicate abend occurs, the dump is taken and the new entry
displays YES in the Dups field if there are no subsequent duplicates of this dump.
You can view the Duplicate History Log for this new entry that also includes
information about the previously expired dump.
Working with Dumps
4-13
Figure 4-8. Abend-AID Directory showing a duplicate of an expired dump

Compuware Abend-AID-------- Abend-AID Directory -------- Row 000001 of 000150 
COMMAND ===>
SCROLL ===> PAGE 
==>
Shared Directory/Database... CF.DEVL.CIMSPRJS.SHRDIR
For a list of databases, select DBLIST 
M Menu
S Diag
D Delete
_
h
_
_
L Lock
U Unlock
G Messages
H Dup History
I Information
A Analyze
R Recall
E Migrate
P Print





Dups Time Date

**** ***** ********
YES 11:30 10JUL201
2 11:24 10JUL201
1 11:15 10JUL201
5 09:34 10JUL201
BOTTOM OF DATA ****
T Terminate Analysis
C Change Priority
N Contact Information
Abend
Entry
Job Name Code
JESID
Tran Program Offset
******* ******** ******** ******** **** ******** ********
0044947 H01AC089 5MIN
J0236866 CECI DFHEIN01 000014A6
0044946 H01AC089 5MIN
J0236866 CECI DFHEIN01 000014A6
0044945 H01AC089 5MIN
J0236866 CECI DFHEIN01 000014A6
0044943 H01AC089 5MIN
J0236866 CECI DFHEIN01 000014A6
*********************************************************
Figure 4-9. Duplicate History Log for an Expired Dump



Compuware Abend-AID ------ Duplicate History Log ------- Row 000001 of 000002
COMMAND ===>
SCROLL ===> PAGE
Original Dump Information for Dump 0044946
Code.......... 5MIN
APPLID.... H01AC089
Job Name...... H01AC089
Program... DFHEIN01
Transaction... CECI
Offset.... 000014A6
Terminal...... 0260
User Id... CICSUSER

SYSID... CW01
Date.... 10JUL2012
Time.... 11:24:48
This dump (44946) is a duplicate of prior dump 44945 taken on 10JUL2007 at
11:15:58. Dump 44946 was not suppressed as the expiration interval for dump 
44945 elapsed. Suppressed duplicates for dump 44946 follow: 
Date
Time
Term
Job Name
*********
********
****
********
10JUL2012
11:28:00
0260
H01AC089
10JUL2012
11:29:03
0260
H01AC089
******************************* BOTTOM OF
APPLID
SYSID
User Id
********
*****
********
H01AC089
CW01
CICSUSER
H01AC089
CW01
CICSUSER
DATA ********************************
Duplicate Dump Suppression and Region Dumps
Abend-AID for CICS does not provide a facility to suppress duplicate region dumps.
Instead, Compuware recommends that you use either the CICS System Dump Table or
the MVS Dump Analysis and Elimination (DAE) facility to suppress or eliminate duplicate
CICS region dumps.
Contact Information Screen
If the selected entry matches all the criteria in an action definition created during AbendAID for CICS installation customization, then the Contact Information screen, shown in
Figure 4-10, provides the following information about the dump:
• Job name
• Abending transaction ID
• Application ID
• Abend code
• Program name
• MVS system ID
• Abend date and time
4-14
Abend-AID for CICS User’s Guide
• Information about the person to contact regarding the dump, such as name, phone
number, e-mail address, title, department, and location.
• Same types of information about a secondary, alternate person.
Figure 4-10. Contact Information Screen


Compuware Abend-AID ----------- Contact Information -------------------------
COMMAND ===> 
Jobname....... PFHAMJ12
Transaction... AADM
APPLID........ H01AC197
Contact Name............
Phone Number............
Email Address...........
Title...................
Department..............
Location................
Back-up Name............
Back-up Phone Number....
Back-up Email Address...
Special Instructions....
Abend Code... ASRA
Program...... CCAADEMO
MVS SYSID.... CW01 
Abend Date.... 11JUN2012
Abend Time.... 13:52:03
Jack Johnson
203-555-1234
jack_johnson@abc_corp.com
Systems Analyst
Technical Support
New York City Headquarters
Susan Miller
203-555-6789
susan_miller@abc_corp.com
Contact Jack or Susan before restarting this trans-
action.
______________________________________________________
______________________________________________________
______________________________________________________
To display the Contact Information screen, enter the N line command next to the
associated entry on the Abend-AID Directory.
5-1
Chapter 5.
Accessing Storage Information
Chap 5
This chapter describes the methods for accessing storage information. Topics presented in
this chapter include the following:
•
•
•
•
•
Displaying storage
Displaying control block information
Locating data in storage
Tracking storage navigation
Running control block chains.
Displaying Control Blocks and Storage Information
This section explains the following methods for accessing storage information:
• “CORE Command” on page 5-1
• “HEXD Command” on page 5-1
• “Control Blocks and Storage Screen” on page 5-1
CORE Command
Display storage from an Abend-AID for CICS screen with the CORE command. On the
Command line, type CORE, followed by a period, and an address, a symbol name, or a
table entry. For example, entering CORE.00012B90 displays the storage located at
hexadecimal address 00012B90. See “CORE” on page 21-16.
HEXD Command
The HEXD command displays storage directly from any data field listing a control block
address, a symbol, or a table entry.
To display the storage associated with a specific field, perform one of the following
procedures:
• Type HEXD on the Command line, position the cursor on the data field, and press
the Enter key.
• Position the cursor on the data field and press the HEXD PF key (PF18 is the default).
Note:
Use the DSECT command or the DSECT PF key (PF19 is the default) to display
storage in DSECT format. For specifics, see to“DSECT” on page 21-30.
Control Blocks and Storage Screen
The Control Blocks/Storage screen (Figure 5-1) lists all CICS control blocks and tables
that apply to the selected dump report and it provides access to storage information and
to the paperclip function which is used to track your navigation through storage. See
“Tracking Storage Navigation (Paperclip Function)” on page 5-5.
Access the Control Blocks/Storage screen by selecting the CB option on the Primary
Options menu or by issuing the CB fast-path command from any screen within the
selected report.
5-2
Abend-AID for CICS User’s Guide
Figure 5-1. Control Blocks/Storage for Transaction Dumps





SACLIP Saved Paperclip Table


Description

***************************************
CICS Common System Area

CICS System Transaction Control Area

CICS User Transaction Control Area

CICS Optional Features List

CICS Terminal Control Task Control Area
CICS Common Work Area

CICS Terminal Control Table Terminal En
LE Common Anchor Area

LE Enclave Data Block

LE Enclave Storage Management Block

LE "User" Heap Control Block (HPCB)

LE "User" Heap Anchor (HANC)

LE "Anywhere" Heap Control Block (HPCB)
LE "Anywhere" Heap Anchor (HANC)

LE "Below" Heap Control Block (HPCB) 
Compuware Abend-AID ----- Control Blocks/Storage ------- Row 000001 of 000115
COMMAND ===>
SCROLL ===> PAGE
==>
MEM
Display Memory at Address ===> __________________________________
PCLP
Name
********
CSA
STCA
UTCA
CSAOPFL
TCPTCA
CWA
TCTTE
CEECAA
CEEEDB
CEEENSM
CEEHPCBU
CEEHANCU
CEEHPCBA
CEEHANCA
CEEHPCBB
Note:
Current Paperclip Table
Address
********
000500C0
0005D180
0005D080
0004F948
373B9080
000C0000
37F654D0
00142638
00140478
00140940
00140958
3802FEB0
00140988
38027EB0
001409B8
Length
********
0000020C
00000208
00000100
000005D8
00000100
00000200
00000250
00000498
00000100
00000100
00000030
00000020
00000030
00000020
00000030
Resource
********
CEECAA
CEECAA
CEECAA
USERHEAP
USERHEAP
ANYHEAP
ANYHEAP
BELOHEAP
Figure 5-1 shows the Control Blocks/Storage screen for a transaction dump. The
format of the screen is slightly different for a region dump. Both screens,
however, function the same way.
To display specific storage areas from this menu:
1. In the Display Memory at Address field, type the table entry, symbol name, or
control block address whose storage you want to display:
– For region dumps only, precede the table entry name with the table type, for
example, PCTE CEMT. (PCTE is the table type, and CEMT is the table entry
name.)
– For region dumps only, precede the symbol name with S/, for example,
S/TCA0008.
– Type the address in hexadecimal format, for example, 0045FD34
2. Press Enter to display the Memory Display screen (Figure 5-2 on page 5-3) for the
storage specified.
To display dump information in interpreted, DSECT, or hexadecimal format, tab the
cursor to the desired table or control block name, and press Enter or the applicable PF key
(Default keys are PF18 for the HEXD and PF19 for the DSECT).
For single occurrence control blocks, such as the CSA or the domain anchor blocks,
Abend-AID for CICS displays the associated storage or DSECT. For tables and chains,
Abend-AID for CICS displays a list of individual entries in the table or chain.
Using the Memory Display Screen
Storage information is displayed in hexadecimal format on the Memory Display screen
(Figure 5-2). Access this screen with one of the methods described in “Displaying Control
Blocks and Storage Information” on page 5-1.
Accessing Storage Information
5-3
Figure 5-2. Memory Display for Transaction Entries
Compuware Abend-AID --------- Memory Display ---------------------------------
COMMAND ===>
SCROLL ===> PAGE


Clip Prev Next Lock
Start Addr: 00000000
Comment: 

Address
Offset
Word 1
Word 2
Word 3
Word 4
Storage
00000000 +00000000 040C0000 811384A0 00000000 00000000 *....a.d...... ...*
00000010 +00000010 00FD05A0 00000000 070E0000 00000000 *............. ...*
00000020 +00000020 070C0000 00C1BD0A 070C5000 8258736A *.....A....&.b ..|*
00000030 +00000030 00000000 00000000 070E0000 00000000 *............. ...*
00000040 +00000040 00000000 00000000 00000000 00FD05A0 *............. ...*
00000050 +00000050 00000000 00000000 040C0000 81090E28 *............a ...*
00000060 +00000060 040C0000 80FF2100 00080000 839B1398 *....".......c ..q*
00000070 +00000070 00080000 839B2200 040C0000 81091780 *....c.......a .."*
00000080 +00000080 00000000 00001004 00020001 00020011 *............. ...*
00000090 +00000090 00043001 00000000 00000000 00000000 *............. ...*
000000A0 +000000A0 0A000000 0121B688 00000000 00000000 *.......h..... ...*
000000B0 +000000B0 00000000 00000000 00010178 00F41F90 *............. 4..*
000000C0 +000000C0 00000000 00000000 00000000 00000000 *............. ...*
000000D0 +000000D0 00000000 00000000 00000000 00000000 *............. ...*
000000E0 +000000E0 00000000 00000000 00000000 00000000 *............. ...*
000000F0 +000000F0 00000000 00000000 00000000 00000000 *............. ...*
00000100 +00000100 00000000 00000000 00000000 00000000 *............. ...*
Press the UP (PF7) and DOWN (PF8) keys to scroll through the information on the screen.
The fields on this screen depend upon the type of terminal you are using. The following
table shows all of the possible fields:
Address
Address of the 16 bytes displayed on the line.
Note: Wider terminals such as IBM’s 3278 Model 5 display 32 bytes on
the line.
Word1
Bytes 0 – 3 of the 16 (or 32) bytes.
Word2
Bytes 4 – 7 of the 16 (or 32) bytes.
Word3
Bytes 8 – 11 of the 16 (or 32) bytes.
Word4
Bytes 12 – 15 of the 16 (or 32) bytes.
Word5
Bytes 16 – 19 of the 32 bytes. Applies to Model 5 and similar terminals
only.
Word6
Bytes 20 – 23 of the 32 bytes. Applies to Model 5 and similar terminals
only.
Word7
Bytes 24 – 27 of the 32 bytes. Applies to Model 5 and similar terminals
only.
Word8
Bytes 28 – 31 of the 32 bytes. Applies to Model 5 and similar terminals
only.
Interpreted
Character representation of the data contained in the 16 (or 32) bytes
displayed on the line. Non-display characters are represented by a
period (.).
In addition to scrolling the screen, you can search for data with the:
• “Offset Commands” on page 5-4
• “FIND Command” on page 5-4
You can also retrace your steps through storage that you have already navigated with
Prev, Next options located the upper right corner of the screen. See “Tracking Storage
Navigation (Paperclip Function)” on page 5-5 for more information.
5-4
Abend-AID for CICS User’s Guide
This screen supports a variety of primary and fast-path commands, such as DECODE
which disassembles the data in the selected field, or MODE which sets the navigation to
31-bit or 64-bit for the current session. Press the Help key for a complete list of the
commands available on this screen.
Offset Commands
To scroll the Memory Display forward or backward to a specified offset from the Start
Addr address, enter +offset or -offset in the COMMAND field, where offset is a numeric
value. See “+offset” and “-offset” on page 22-12 for more information.
Enter @offset to position the Memory Display at the address at the specified offset. The
address must be in allocated storage. See “@offset” on page 22-12 for more information.
Enter #offset to scroll the Memory Display forward to the specified offset relative to the
start address. See “#offset” on page 22-12 for additional information.
To reposition the display to offset zero, enter the RESET primary command. See “RESET”
on page 22-22 for additional information.
FIND Command
Use the FIND primary command to search for hexadecimal or character data that you
specify. On the Command line, type FIND, or F, followed by the data string and, if
applicable, a direction parameter. The following syntax diagram shows the required
syntax for each parameter.
Note:
All FIND command parameters are optional. If you issue the command without
parameters, the Find for Storage Display screen appears, which prompts you for
the command parameters. See “Find for Storage Display Screen” on page 5-5 for
more information.
NEXT
Find
C 'string 1'
X 'string 2'
T 'string 3'
PREV
FIRST
LAST
C'string 1'
Finds the character data identified as string 1.
X'string 2'
Finds the hexadecimal data identified as string 2.
T'string 3'
Finds the mixed-case character data identified as string 3.
NEXT
Finds the next occurrence of the string. Executing FIND without a directional
keyword (NEXT, PREV, FIRST, LAST) accomplishes the same result.
PREV
Finds the previous occurrence of the string.
FIRST
Finds the first occurrence of the string.
Accessing Storage Information
5-5
LAST
Finds the last occurrence of the string.
Example 1:
F C'DFH'
Example 1 finds the character string DFH.
Example 2:
F X'D010' PREV
Example 2 finds the previous occurrence of the hexadecimal string D010. PREV overrides
the default direction and updates the Find for Storage Display screen.
Find for Storage Display Screen
If you issue the FIND command without parameters on the on the Memory Display
screen, the Find for Storage Display screen (Figure 5-3) is presented. This screen prompts
you for FIND command parameters. It defaults the values from your last search.
Figure 5-3. Find for Storage Display









Compuware Abend-AID ------ Find for Storage Display ------------------------
COMMAND ===> 

Start Search at... 00000000
Operator.......... EQ
Search Argument...


Address........... 0:7FFFFFFF

Boundary.......... BDY(1)
Break............. NOBREAK
Direction......... NEXT



Data Space Name...___________
Fill in the fields and press Enter to execute the search. For field definitions, press the
Help key.
Tracking Storage Navigation (Paperclip Function)
The Paperclip facility tracks your navigation through the Memory Display. This facility
consists of two screens:
• “Current Paperclip Table” on page 5-5
• “Saved Paperclip List” on page 5-7
Current Paperclip Table
Abend-AID for CICS maintains a table called a Current Paperclip Table that tracks your
navigation through the storage of a selected dump for the current session. Abend-AID for
5-6
Abend-AID for CICS User’s Guide
CICS adds an entry to the bottom of the paperclip table each time the displacement
shown on the Memory Display equals zero. You may also add an entry to the paperclip
table by placing the cursor on any address in the Memory Display and pressing Enter.
The table hold up to 389 entries. Once there are 389 paperclip entries, the table overlays
the oldest entry with the newest. Entries are listed in chronological order from oldest to
newest.
To access the Current Paperclip Table (Figure 5-4):
• Issue the PCLP fast-path command from any screen within the selected dump report.
• Select the PCLP option on the Control Block/Storage screen (Figure 5-1 on page 5-2).
Figure 5-4. Current Paperclip Table
Abend-AID ---------- Current Paperclip Table ----------- Row 000001 of 000007
COMMAND ===>
SCROLL ===> PAGE

S Select Entry
D Delete Entry
L Lock Entry
U Unlock Entry 

Address
Status
Comment (Overtype to update)
******** ******** ************************************
_ 01E9E2C0
_ 01E99AC0
_ 01E8F0E0
_ 01E7B5F8
_ 01E7B0F8
_ 01E7B008
_ 00000000
******************************* BOTTOM OF DATA *****************************








Type a line command and press Enter to process it
On the line next to the entry of interest, enter any of the following line commands and
press enter:
S
Displays the Memory Display screen, positioned at the address of the selected
paperclip entry.
Note: Place the cursor on Prev or Next located in the upper right hand corner
of the Memory Display and press Enter to move forward or backward
through the paper clipped addresses. Lock prevents an address from
being automatically deleted from the paperclip table when it becomes
full.
D
Deletes the paperclip entry.
L
Prevents the system from automatically deleting the paperclip entry when the
table is full.
U
Frees the paperclip entry for automatic deletion when the table is full.
To save the current paperclip table, on the Command line, type SAVE followed by a oneto-eight character name and press Enter. For example, SAVE TABLE1 saves the current
paperclip table with the name TABLE1.
Accessing Storage Information
5-7
Note: If you exit Abend-AID for CICS without saving the current paperclip table, AbendAID for CICS saves it automatically, assigning it a name corresponding to your
user ID.
To resave the current paperclip table under its existing name, enter SAVE on the
Command line and press Enter. If the current paperclip table has no preexisting name,
the SAVE command uses your user ID.
Saved Paperclip List
The Saved Paperclip List (Figure 5-5) displays the paperclip tables that all users have
saved for the selected dump. Abend-AID for CICS maintains one saved paperclip list per
dump.
To access the Saved Paperclip List:
• Issue the SACLIP fast-path command from any screen within the selected dump.
• Select the SACLIP option on the Control Blocks/Storage screen (Figure 5-1 on page
5-2).
Figure 5-5. Saved Paperclip List

Compuware Abend-AID -------- Saved Paperclip List ------- Row 000001 of 000003
COMMAND ===>
SCROLL ===> PAGE


_
_
_
_
R Restore Paperclip Table
D Delete Paperclip Table

Name
Status
Date and Time Saved
*******
******** ********* **********
TSOUSER
03FEB2012 17:15:17
CFUSER2
07FEB2012 10:20:03
AACICS5
08FEB2012 12:20:48
AACICS8
08FEB2012 11:22:27
***************************** BOTTOM OF DATA *****************************








Type a line command and press Enter to process it

On the line next to the table of interest, enter either of the following line commands and
press Enter:
R
Restores the saved paperclip table as your current paperclip table.
D
Deletes the saved paperclip table.
Running Control Block Chains
The CHAIN primary command runs control block chains based on parameters specified
on the CHAIN Command Parameters screen (Figure 5-6). To access this screen, issue
CHAIN fast-path command from any screen within the selected dump report.
5-8
Abend-AID for CICS User’s Guide
Figure 5-6. CHAIN Command Parameters Screen






Compuware Abend-AID -------- Chain Command Parameters ----------------------
COMMAND ===> 
Chain Prefix Name.......... TQE

Run Chain From Address..... 00000000
Addressing Mode............ 31

(24/31)
Number of Entries to Run... 0099

Link Address Offset........ 0000


Chain Termination Value....
When you press the Enter key from the CHAIN Command Parameters screen, Abend-AID
for CICS runs the control block chain based on the current parameters, displays the
Memory Display screen, and positions the cursor on the first occurrence of a control
blocks in the chain. Entries are created in the current paperclip table for the other
occurrences of the control block in the chain. To move forward through the entries in the
paperclip table, enter CLIP NEXT on the Command line and press Enter. To move
backward, enter CLIP PREV on the Command line or position the cursor on the Prev or
Next fields on the Memory Display and press Enter.
Note:
The Current Paperclip Table screen lists a maximum of 389 entries. If the CHAIN
command generates more than 389 entries, the table wraps.
Abend-AID for CICS bypasses the CHAIN Command Parameters screen if you type the
CHAIN command with address and offset parameters. For information about these
parameters, refer to “CHAIN” on page 21-11.
6-1
Chapter 6.
Displaying DSECTs
Chap 6
This chapter describes how to display control block information in DSECT format. It also
lists the DSECT images that Abend-AID for CICS supplies for the following CICS releases:
CICS Transaction Server for z/OS 5.4, 5.3, 5.2, 5.1, 4.2, and 4.1. In addition, this chapter
lists the default MVS DSECT images that were created at installation time based on the
information specified in the installation dialog.
You can also define your own user DSECTs to the Abend-AID for CICS. User-defined
DSECT images are typically used to view application control blocks. For example, you can
define DSECTs for in-house or third-party vendor packages, and then use Abend-AID for
CICS to map storage into the DSECT maps you supply. Refer to the Abend-AID for CICS
Installation and Customization Guide for information about creating user-defined DSECTs.
Note:
You must use the MAPD primary command with the USER keyword to display
user-defined DSECTs. For information about this command, refer to “MAPD” on
page 22-1.
Displaying Control Blocks in DSECT Format
The DSECT Support screen (Figure 6-1) displays control blocks in DSECT format. The
screen includes address, offset, label, data type, data, and comment information. For
equate statements, the OFFSET field lists the equated value.
The DSECT Support screen is accessible from most of the Abend-AID for CICS screens
that display a symbol, a table entry, a control block address, or an actual control block
entry. (A DSECT display is not available for all control blocks.) Access the DSECT Support
screen in one of the following ways:
• Place the cursor on a control block field and press the DSECT PF key. (PF19 is the
default.)
• Type DSECT on the Command line, place the cursor on a control block field, and
press Enter.
• Use the MAPD primary command from any screen within the selected report. For
specifics about this command, refer to “MAPD” on page 22-1.
Note:
On the MAPD command, you can specify the symbol, table entry, or address
to be mapped or if you are viewing a screen that displays the symbol/table
entry/address, type MAPD on the Command line, place the cursor on the
appropriate field, and press Enter.
6-2
Abend-AID for CICS User’s Guide
Figure 6-1. DSECT Support Screen
Abend-AID -------------------- DSECT Support ----------- Row 000001 of 000057
COMMAND ===>
SCROLL ===>PAGE 

To display the DSECT without equates select EXCLUDE
==> 

DSECT Name.... CPE
CICS Release..... C650 

Address Offset Label
Type
Data
DSECT
Comment
LICENSED MATERIALS, (C) COPYRIGHT IBM CORPORATION 1987, 2011.
00000000 0000
CPE
DSECT
00000000 0000
CPE__DUM 0CL172
00000000 0000
CPE_PREF 0CL24
Standard prefix
00000000 0000
CPE_LENG FL2
040C
Control block length
00000002 0002
CPE_ARRO CL1
Control block eyecatcher
00000003 0003
CPE_DFH CL3
008118
00000006 0006
CPE_EYE_ 0CL10
00000006 0006
CPE_DOMA CL2
8B78
00000008 0008
CPE_BLOC CL8
00000010 0010
CPE_NEXT AL4
00FD2DC8
-> next CPE in chain
00000014 0014
CPE_PRIO AL4
00000000
-> previous CPE in chain
00000018 0018
CPE_PROG FL1
07
Status of the program
00000019 0019
CPE_LOCK FL1
0C
CPE lock field
0000001A 001A
CPE_RECO 0FL1
00000080
CPE_BUIL EQU
X’80’
CPE built during
If you are using an 80-character display, scroll to the right on the DSECT Support screen
to see the DSECT Label Expansion screen, which replaces the truncated LABEL field with
an expanded LABEL field and deletes the COMMENT field. The expanded LABEL field
lists the complete field names of the DSECT statements. Scrolling back to the left displays
the original DSECT Support screen with the truncated LABEL and the COMMENT fields.
The following commands function on the scrollable portion of the DSECT Support and
DSECT Label Expansion screens: UP, DOWN, LEFT, RIGHT, TOP, BOTTOM. For specifics
about the TOP and BOTTOM commands, see Part 5, “Commands”. For information about
the remaining commands, refer to “Default PF Key Definitions” on page 19-5.
To view the contents of an address field in hexadecimal, use one of these methods:
• Place the cursor on the address field and then press the HEXD PF key. (PF18 is the
default.)
• Type HEXD in the Command field, place the cursor on the address field, and then
press the Enter key.
For fields that are defined as an address type (A) or fullword (F), position the cursor on
the actual field contents and press the HEXD PF key to display the data at that address.
For Abend-AID for CICS-supplied, system DSECTs, not user-defined DSECTS, you can
automatically map the associated control block for an address of a control block for
which there is an available DSECT map. These addresses are highlighted for easy
identification. The default highlight color is yellow. Position the cursor on the
highlighted address in the scrollable area and press the DSECT PF key. (PF19 is the
default).
By default, the DSECT Support screen displays all fields in the requested DSECT,
including equate statements. To suppress the equate statements, tab to the EXCLUDE
field and press Enter. The screen is redisplayed without equates. To refresh the screen to
include the equates, tab to the INCLUDE field and press Enter.
Displaying DSECTs
6-3
Selecting the Appropriate DSECT Type
Abend-AID for CICS automatically maps some addresses into the appropriate DSECTs.
Depending upon the location from which you are accessing the address, you may have to
choose the appropriate DSECT to use. This section provides a complete list of the
following system DSECTs:
• “CICS Transaction Server DSECTs” on page 6-3
• “MVS DSECTs” on page 6-8
The following information is provided in the tables:
Actual DSECT
Name
This is the name on the first Assembler label in the DSECT. It is
displayed in the fixed portion of the DSECT Support screen.
DSECT Type
The name to use with the MAPD command.
Description
The use of the DSECT.
Note:
The System DSECT Table lists the DSECTs available for the currently selected
dump. To display the table, issue the MAPD fast-path command with no
parameters. For more information about the MAPD command, see “MAPD” on
page 22-1.
CICS Transaction Server DSECTs
Table 6-1 lists the DSECTs that Abend-AID for CICS supplies for CICS Transaction Server.
Note:
Some DSECTs do not support all versions of CTS. The Description column for
these DSECTs specifies which versions are supported.
Table 6-1.
Supplied CICS Transaction Server DSECTs
Actual DSECT Name
DSECT Type
Description
ACA
TSAUX
Temporary Storage Auxiliary Class Anchor
ANCHOR
DMANCH
Domain Manager Anchor
ANCHOR
DSANCH
Dispatcher Domain Anchor Block
ANCHOR
LMANCH
Lock Manager Anchor Block
ANCHOR
MEANCH
Message Domain Anchor Block
ANCHOR
STANCH
Statistics Domain Anchor Block
APE
APE
Loader Domain Active Program Element
BCA
BCA
Temporary Storage Buffer Control Area
BFB
BFB
Bridge Facility Block
BMH
TSBM
Temporary Storage Auxiliary Storage Byte Map
BRB
TSBRB
Temporary Storage Browse Block
BRPC
BRPC
Bridge Primary Client
BRSA
BRSA
Bridge State Area
BRTA
BRTA
Bridge Task Area
BRXA_COMMAND_COMMON
BRCOMMA
Bridge Exit Command Area
BRXA_HEADER
BRXA
Bridge Exit Header
BRXA_TRANSACTION_AREA
BRXTRANA
Bridge Exit Transaction Area
6-4
Abend-AID for CICS User’s Guide
Table 6-1.
Supplied CICS Transaction Server DSECTs
Actual DSECT Name
DSECT Type
Description
CCANCHORB
CCANCH
Catalog Domain Anchor Block
CHANGE_LIST_ELEMENT
CLE
Table Manager Change List Entry
CPE
CPE
Loader Domain Current Program Element
CSAOPFL
OPFL
Common System Area Optional Features List
DCR
DCR
Document Control Record
DCTSDSCI
SDSCI
DCT Dataset Control Information
DDA
DDANCH
Directory Manager Anchor Block
DFHAFCTE
AFCTE
Application File Control Table Entry
DFHAIDDS
AID
Automatic Initiate Descriptor
DFHAPDM_STATIC
APSTATIC
Application Domain Static Storage
DFHBRBSB
BSB
Bridge Facility Start Block
DFHCSADS
CSA
Common System Area
DFHDCTDS
DCTE
Destination Control Table Entry
DFHDGB
DGB
DBCTL Global Storage
DFHDLPDS
DLP
DL/I Parameter List
DFHDSB
DSB
DBCTL Scheduling Block
DFHDSNDS
DSNDS
Dataset Name Block
DFHEIBLK
EIB
Execute Interface Block
DFHEISDS
DFHEISDS
Execute Interface Structure
DFHEISTG
EIS
Execute Interface Storage
DFHEJAED
EJAE
Enterprise Java Elements
DFHEJANC
EJANCH
Enterprise Java Anchor Block
DFHEJAND
EJANCH
Enterprise Java Domain Anchor Block
DFHEJAOD
OSANCH
Enterprise Java Object Store Anchor Block
DFHEJBBD
EJBB
Bean Browsers
DFHEJBID
EJBI
Bean Elements
DFHEJCBD
EJCB
CorbaServer Browsers
DFHEJCID
EJCI
CorbaServer Elements
DFHEJDBD
EJDB
DJar Browsers
DFHEJDID
EJDI
DJar Elements
DFHFCTDS
FCTE
File Control Table Entry
DFHFCTSR
LSRPOOL
Local Shared Resources Control Block
DFHFIOA
FIOA
File I/O Area
DFHFLAB
FLAB
File Lasting Access Block
DFHFRAB
FRAB
File Request Anchor Block
DFHFRTE
FRTE
File Request Thread Element
DFHICEDS
ICE
Interval Control Element
DFHICP_STATIC
ICSTATIC
Interval Control Static Storage Area
DFHIIDCD
IIA
IIOP Domain Anchor Block
Displaying DSECTs
Table 6-1.
6-5
Supplied CICS Transaction Server DSECTs
Actual DSECT Name
DSECT Type
Description
DFHIIMDD
MDA
RequestModel Class Anchor Block
DFHKCB
KEANCH
Kernel Domain Anchor Block
DFHLLE
LLE
Load List Entry
DFHOTDMD
OTDM
Object Transaction Block
DFHPAA
PAANCH
Parameter Domain Anchor Block
DFHRZDMD
RZDM
RequestStream Domain Management Block
DFHSITDS
SIT
System Initialization Table
DFHSJDCD
SJANCH
JVM Domain Anchor Block
DFHSJJ8D
J8TCB
J8 TCB Block
DFHSRTDS
SRT
System Recovery Table
DFHSSADS
SSA
Static Storage Area
DFHSZSDS
SZSDS
FEPI Static Storage
DFHTCADS
TCA
User Task Control Area
DFHTCADY
STCA
System Task Control Area
DFHTCTFX
TCTFX
Terminal Control Table Prefix
DFHTCTSK
TCTN
Terminal Control Table Skeleton Entry
DFHTCTTE
TCTE
Terminal Control Table Entry
DFHTDST
TDST
Transient Data Static Storage
DFHTIA
TIANCH
Timer Domain Anchor Block
DFHTIEDS
TIE
Task Interface Element
DFHTIOA
TIOA
Terminal Input/Output Area Prefix
DFHTMDEL
ELEM
Table Manager Directory Entry
DFHTMSKT
SKT
Table Manager Scatter Table
DFHTMSSA
TMSTAT
Table Manager Static Storage Area
DFHTRA
TRANCH
Trace Domain Anchor Block
DFHTRBL
DFHTRBL
Trace Domain Trace Block Header
DFHTSTDS
TSTDS
Temporary Storage Table
DFHUETH
UETH
User Exit Table Header
DFHVSWA
VSWA
VSAM Work Area
DFHW2AND
W2ANCH
Web 2.0 Domain Anchor (CTS 4.1 and more
current only)
DFHXSSS
XSSS
Security Domain Supervisor Storage
DHA
DHANCH
Document Handler Anchor
DIRHEAD
DIRHEAD
Directory Header
DOA
DOA
Document Handler Document Anchor
DOMAIN_ENTRY
DOMTBL
Kernel Domain “Domain Table” Entry
DOMAIN_HEADER
KEDOH
Kernel Domain Header
DPA
DPANCH
Debugging Profile Domain Anchor
DS_TCB
DSTCB
DS Domain TCB Block, per mode
6-6
Abend-AID for CICS User’s Guide
Table 6-1.
Supplied CICS Transaction Server DSECTs
Actual DSECT Name
DSECT Type
Description
DUA
DUANCH
Dump Domain Anchor Block
GLOBAL
LDANCH
Loader Domain Anchor Block
HASHELEM
HASHELEM
Directory Manager Hash Table Element
HASHSTRUCT
HASHTBL
Directory Manager Hash Table
HTB
HTB
Handle Table Block
HTE
HTE
Handle Table Element
IIA
IIANCH
IIOP Domain Anchor Block
ISA
ISANCH
Intersystem Communication Domain Anchor
KCSTATIC
KCSTATIC
Task Control Static Storage
KERNSTCK
STACK
Kernel Stack Entry
KTCB_ENTRY
KTCB
Kernel TCB
LGA
LGA
Log Manager Anchor Block
LGBR_BROWSE_DATA
LGBR
Log Manager Browse Data
LGGD_GLOG_DATA
LGGD
Log Manager General Log Data
LGJI_JOURNAL_INFO
LGJI
Log Manager Journal Information
LGJMC_JOURNALMODEL
LGJMC
Log Manager Journal Model Content
LGSD_STREAM_DATA
LGSD
Log Manager Log Stream Data
LOCALWA
LOCALWA
DBCTL Local Work Area
LOCK_MANAGEMENT
LOCKMGRB
Lock Manager Management Block
LTE
LTE
Sockets Domain Listener Table
MAFPB
MAFPB
Monitor Domain Auth Facility Parameter Block
MET_MODULE_HEADER
MEMODHDR
Message Domain Module Header
MNA
MNA
Monitoring Domain Anchor Block
NQA
NQA
Enqueue Manager Anchor Block
NQEA
NQEA
Enqueue Queue Element Area
NQPL
NQPL
Enqueue Manager Enqueue Pool
OTDM
OTANCH
Object Transaction Anchor Block
PAPL
PAPL
DBCTL Architected Parameter List
PARM_SAVE_AREA
PASAVE
Parameter Domain Override Save Area
PCA
TSPCA
Temporary Storage Pool Control Area
PCTE
PCTE
Program Control Table Entry
PGANCHOR
PGANCH
Program Manager Anchor Block
PIA
PIANCH
Pipeline Domain Anchor
PLCB
PLCB
Program Level Control Block
PPA
PPA
Storage Domain Page Pool Area
PPTE
PPTE
Processing Program Table Entry
PTA
PTA
Program Transaction Area
PT_ANCHOR_BLOCK
PTANCH
Partner Domain Anchor Block
QUICKCELL_1_ELEMENT
QCCELL1
Lock Manager Quick Cell Block Descriptor
Displaying DSECTs
Table 6-1.
6-7
Supplied CICS Transaction Server DSECTs
Actual DSECT Name
DSECT Type
Description
QUICKCELL_2_ELEMENT
QCCELL2
Lock Manager Quick Cell Block Descriptor
QUICKCELL_3_ELEMENT
QCCELL3
Lock Manager Quick Cell Block Descriptor
QUIESCE_ENQUEUE_LIST
QEQ
Table Manager Enqueue List Entry
RCSTATIC
RCSTATIC
Recovery Control Static Storage
RMDM
RMDM
Recovery Manager Domain Anchor Block
RMUW
RMUW
Recovery Manager Unit of Work
RXDM
RXANCH
Recoverable Resource Manager
RZDM
RZANCH
Request Stream Manager Anchor Block
SCA
SCA
Subpool Control Area
SHA
TSSHARED
Temporary Storage Shared Storage Class
Anchor
SJA
SJANCH
JVM Domain Anchor Block
SMA
SMA
Storage Domain Anchor Block
SMX
SMX
Storage Manager Transaction Block
SOA
SOA
Sockets Domain Anchor Block
STE
STE
Sockets Domain Session Entry
STE
TSSTE
Temporary Storage Shared Storage Table Entry
STRING_BUFFER
CCBUFFER
Catalog Domain String Buffer
SUB_DISPATCHER
SUBDISP
Dispatcher Domain Sub-Dispatcher, per mode
TASK
DTA
Dispatcher Task Area
TASK_ENTRY
TAS
Kernel Task Entry
TBR
TBR
TCPIP Service Browse Block
TCTENIB
NIB
Node Initialization Block Descriptor
TDA
TDA
TCPIP Service Class Anchor
TDB
TDB
TCPIP Service Class Object
TIMER_REQUEST_ELEMENT
TRE
Timer Domain Request Element
TMA
TMA
Transaction Monitoring Area
TSA
TSANCH
Temporary Storage Domain Anchor
TSM_CLASS_ANCHOR
TSMAIN
Temporary Storage Main Storage Class Anchor
TSN_CLASS_ANCHOR
TSNAME
Temporary Storage Name Class Anchor
TSQ_CLASS_ANCHOR
TSQCLASS
Temporary Storage Queue Class Anchor
TSQUEUE
TSQUEUE
Temporary Storage Queue Control Block
TSR_CLASS_ANCHOR
TSRLOCK
Temporary Storage Read Lock Class Anchor
TSW_CLASS_ANCHOR
TSWAITQ
Temporary Storage Wait Queue Class Anchor
TXD_INSTANCE
PCTE
Program Control Table Entry
TXD_INSTANCE
TXDI
Transaction Definition Instance
TXD_STATIC
TXDS
Transaction Definition Static
USA
USANCH
User Domain Anchor
VCA
VCA
Temporary Storage String Control Area
6-8
Abend-AID for CICS User’s Guide
Table 6-1.
Supplied CICS Transaction Server DSECTs
Actual DSECT Name
DSECT Type
Description
WBA
WBANCH
Web Domain Anchor
WBAB_WEB_ANCHOR_BLOCK
WBANCH
Web 3270 Anchor
WBSTA_ANCHOR_BLOCK
WBSTA
Web State Anchor
WBSTH_STATE_BLOCK
WBSTH
Web State Block
WBSTU_STATE_DATA
WBSTU
Web State Data
WRA
WRA
Web Request Anchor
WRB
WRB
Web Request Block
WRBR
WRBR
Web Request Class Browse Block
XMANCHOR
XMANCH
Transaction Manager Anchor
XM_TCLASS
TCLASS
Transaction Class
XRH
TSXRH
Temporary Storage Auxiliary Storage Segment
Header
XSA
XSANCH
Security Domain Anchor Block
MVS DSECTs
Table 6-2 lists the MVS DSECT images that were created at installation based on the
information specified in the installation dialog. The following information is provided in
the table:
Actual DSECT
name
The name displayed in the fixed portion of the DSECT Support
screen.
DSECT type
The name to use with the MAPD command.
Description
The use of the DSECT.
Table 6-2.
Available MVS DSECTs
Actual DSECT Name
DSECT Type
Description
AQAT
IHAAQAT
Address Queue Anchor Table
ASCB
IHAASCB
Address Space Control Block
ASVT
IHAASVT
Address Space Vector Table
ASXB
IHAASXB
Address Space Extension Block
CAUB
IGVCAUB
Common Area User Block
CDENTRY
IHACDE
Contents Directory Entry
CEECAA
CEECAA
Language Environment Common
Anchor Area
CEECIB
CEECIB
Language Environment
Condition Information Block
CEEEDB
CEEEDB
Language Environment Enclave
Data Block
CEEMCH
CEEMCH
Language Environment Machine
State Descriptor
CEEPCB
CEEPCB
Language Environment Process
Information Block
Displaying DSECTs
Table 6-2.
6-9
Available MVS DSECTs
Actual DSECT Name
DSECT Type
Description
CEERCB
CEERCB
Language Environment Region
Information Block
CVT
CVT
Communications Vector Table
DFE
IHADFE
VSM Double Free Element
DQE
IHADQE
VSM Descriptor Queue Element
ECVT
IHAECVT
Extended Communications
Vector Table
EPIE
IHAEPIE
Extended Program Interruption
Element
FBQE
IHAFBQEVSM
Free Block Queue Element
FQE
IHAFQE
VSM Free Queue Element
GDA
IHAGDA
Global Data Area Block
JESCT
IEFJESCT
Job Entry Subsystem
Communication Table
LDA
IHALDA
VSM Local Data Area
LLE
IHALLE
Load List Element
PSA
IHAPSA
Prefixed Save Area
RBPRFX
IHARB
Request Blocks
RTCT
IHARTCT
Recovery/Termination Control
Table
SCVTSECT
IHASCVT
Secondary Communication
Vector Table
SDUMP
IHASDUMP
SDUMP Parameter List
SHDR
IHASHDR
SLIP Header
SMCABASE
IEESMCA
SMF Control Table
SPQA
IHASPQA
VSM Subpool Queue Anchor
SPQE
IHASPQX
VSM Subpool Queue Anchor
SPQX
IHASPQE
VSM Subpool Queue Element
SPT
IHASPT
VSM Subpool Table
TCBFIX
IKJTCB
Task Control Block
XTLST
IHAXTLST
Extent List
Note:
The System DSECT Table lists the DSECTs available for the currently selected
dump. To display this screen, enter the MAPD primary command with no
parameters. For more information about this command, refer to “MAPD” on page
22-1.
6-10
Abend-AID for CICS User’s Guide
7-1
Chapter 7.
Printing Abend-AID for CICS Information
Chap 7
This chapter describes how to print Abend-AID for CICS information for transaction
abends and region dumps. You can print screens and reports using the PRINT and LPRINT
primary commands and the Abend-AID Directory P (Print) line command. You can also
print directory information for Abend-AID for CICS shared directories and transaction
databases using the Compuware Shared Services (CSS) DIRECTORY, DIRX, and
DIRECTORY SEQUENTIAL commands with the CWDDALLU (formerly, CWFXSDUT)
batch file utility.
The following topics are described:
• Online printing overview
• Printing screen images
• Printing Abend-AID for CICS-supplied reports
• Printing directory information.
Online Printing Overview
Note:
ALL Abend-AID for CICS screen and report printing is done online. Refer to
“Printing Directory Information” on page 7-8 for information about the batch
printing of directory entry information from a shared directory or a transaction
database.
When you issue the Abend-AID Directory P (Print) line command or the PRINT or
LPRINT primary commands, Abend-AID for CICS writes the output from the print
functions to a temporary print dataset. The attributes and disposition of this dataset are
controlled by the Print Options and Initiation screen, which is shown in Figure 7-1 on
page 7-2.
Print Options and Initiation Screen
The Print Options and Initiation screen allows you to modify site-defined defaults for
print options and to submit print jobs. Options modified on this screen apply to the
current Abend-AID for CICS session and all subsequent sessions.
Physical and logical screen prints are written to a temporary dataset when you use the
PRINT and LPRINT primary commands, or the Abend-AID Directory P line command. Use
this screen to print the contents of the dataset, delete the dataset, or keep the dataset
without printing. If you have printed screens using the PRINT or LPRINT primary
commands or the Abend-AID Directory P line command and do not initiate the print,
delete, or keep of the temporary dataset, it is automatically printed, deleted, or kept
when you exit Abend-AID for CICS using the print output options information on this
screen.
Note:
If you use multiple Abend-AID for CICS viewing servers, you must modify your
print options profile on each viewing server.
7-2
Abend-AID for CICS User’s Guide
To modify print options, complete the following procedure:
1. Display the Print Options and Initiation screen, shown in Figure 7-1, using one of
the following methods:
– Tab to the LIST option on the User Controls menu, which is described in Chapter
19, “Setting User Controls”, and press Enter.
– Enter LIST as a fast-path command.
– Enter =U.2 as a jump command after you select a dump.
– Enter =USER.2 as a jump command if you have not selected a dump.
Figure 7-1. Print Options and Initiation
Compuware Abend-AID -- Print Options and Initiation --------------------------
COMMAND ===> 

Specify print information below, then type GO to submit the print job, or
SAVE to save your changes without printing, or CANCEL to cancel your changes. 

Print option........ KN
PD - Print dataset and delete
D - Delete dataset without printing
KN - Keep dataset and continue with new dataset 

Print Output Options:
SYSOUT Class.............. A
Page Width (Characters)... 132
Destination............... LOCAL
Page Length (Lines)....... 60
Print Uppercase Only...... N 

Jobcard Information:
1... //JOBNAME JOB (’ACCOUNTING.INFO’),’PROGRAMMER.NAME’,
2... //
CLASS=A,MSGCLASS=A
3... //*
4... //*
5... //*
6... //* 
Notes:
a. Everything that you print during a given Abend-AID for CICS session is written
to a single temporary print dataset until you print the contents of the dataset
from the Print Options and Initiation screen or log off Abend-AID for CICS. The
temporary print dataset is allocated using the information specified when
Abend-AID for CICS is installed. Refer to the Abend-AID for CICS Installation and
Customization Guide for information about the viewing server configuration
parameters for the temporary print dataset.
b. If you are accessing Abend-AID for CICS from VTAM or CICS, the temporary
dataset uses the ID with which you logged onto Abend-AID for CICS as the highlevel qualifier. You can change this qualifier using the VTAM/CICS print dataset
prefix user profile option, which is described in “User Profile Screen” on page
19-1. For ISPF access, the temporary dataset uses the TSO profile prefix as the
high-level qualifier.
c. The page width and length that are specified on the Print Options and Initiation
screen at the time you issue a print command take effect for that printing. To
reflect a change in page width/length in your printing, you must change these
values on the Print Options and Initiation screen before you issue the print
command.
d. Compuware recommends a page width of 132 (default) for all printing.
The Print Options and Initiation screen displays default print option values supplied
at installation. These values control both the initiation and disposition of a print job
and various options related to print output. If the defaults are acceptable to you, do
Printing Abend-AID for CICS Information
7-3
nothing, and Abend-AID for CICS will use this set of print options. To customize the
options to your individual preferences, proceed to step 2.
2. Overtype the default value of the print option you want to modify with the new
value. Press the HELP (PF1) key on any field for field help.
3. Do one of the following:
– To save the print options you modified, enter END (PF3) as a primary command.
– To discard any modifications you made and return to the previous Abend-AID for
CICS screen, enter CANCEL as a primary command.
Printing Screen Images
You can use the PRINT or LPRINT primary commands to print physical and logical screen
images. PRINT and LPRINT have the same syntax, but differ as follows:
• The Abend-AID for CICS PRINT command prints a physical image of a screen to a
sequential dataset. A physical image includes only the data currently displayed
(contrasted to a logical image, which includes all data associated with a screen). A
logical print is accomplished using the LPRINT command.
When used without an optional parameter, PRINT prints a physical image of the
screen currently displayed. When used with an optional parameter, PRINT prints a
logical image of the screen specified by the parameter.
• The Abend-AID for CICS LPRINT command prints a logical image of a screen to a
sequential dataset. Pressing the LPRINT PF key also executes this command. (PF23 is
the default). A logical image includes all data associated with a screen, regardless of
how much is currently displayed (contrasted to a physical image, which includes
only the data currently displayed). A physical print is accomplished using the PRINT
command.
When used without an optional parameter, LPRINT prints a logical image of the screen
currently displayed. When used with an optional parameter, LPRINT prints a logical
image of the screen specified by the parameter.
Certain exceptions apply. A physical image of a screen is always printed, even if a logical
print is requested, when the screen to be printed is one of the following:
• A nonscrollable screen
• A memory display screen
• A storage disassembly screen.
These exceptions apply both to currently displayed screens and to those specified by a
parameter.
Valid syntax for the PRINT and LPRINT commands is described below.
7-4
Abend-AID for CICS User’s Guide
fastpathcommand
The fast-path command of the screen to be printed.
#ALL
Valid for transaction entries only. Prints a complete transaction report. Refer to
“Complete Transaction Abend Report” on page 7-5 for a description of what is
contained in this report.
#DB2ALL
Valid for transaction entries only. Prints a complete transaction report, including DB2
information if available. Refer to “Complete DB2 Transaction Abend Report” on page
7-6 for a description of what is contained in this report.
#SUMMARY
Prints a summary report. Refer to “Transaction Abend Summary Report” on page 7-6
and “Region Dump Summary Report” on page 7-7 for a description of what is
contained in a summary report, by entry type.
#DB2SUMM
Valid for transaction entries only. Prints a summary report, including the DB2
information if available. Refer to “DB2 Transaction Abend Summary Report” on page
7-7.
$controlblockname
Specifies to print the DSECT format of the named control block. Only DSECTs of
single element control blocks (CSA or CSAOPFL, for example) can be printed this
way. For other types of control blocks (FCT, for example), you must first display the
control block’s DSECT screen and then use the LPRINT command. Refer to Chapter 5,
“Accessing Storage Information” for additional information about control blocks.
@symbolname ’storage comment’
Specifies to print the hexadecimal storage associated with the named symbol. The
symbol name is required but the storage comment is optional (limited to 66
characters) and, if specified, must be surrounded by single quotation marks. Refer to
Appendix D, “Symbols List” for a list of valid symbols. To display storage for other
types of control blocks, you must supply the storage address and length of the
control block (see next parameter).
@address.length ’storage comment’
Specifies to print the hexadecimal storage at the given address for the given length.
The address is required and must be in hexadecimal notation. The default length is
4096 and the maximum length allowed is 1,048,576 (1 megabyte). The storage
comment is optional (limited to 66 characters) and, if specified, must be surrounded
by single quotation marks.
Example 1:
PRINT SUMMARY
Example 1 prints the Fault Summary screen. Compare this example with Example 2.
Example 2:
PRINT #SUMMARY
Example 2 prints the summary report for the currently selected directory entry.
Example 3:
LPRINT #DB2ALL
Printing Abend-AID for CICS Information
7-5
Example 3 prints the complete transaction report including the DB2 information if
available for the currently selected transaction entry.
Example 4:
PRINT $CSA
Example 4 prints the DSECT of the CICS CSA control block.
Example 5:
LPRINT @CSA
Example 5 prints the hexadecimal storage associated with the CICS CSA control block.
Example 6:
PRINT @A000.8192
Example 6 prints the hexadecimal storage beginning at address 0000A000 for a length of
8192 bytes (through address 0000BFFF).
Printing Abend-AID for CICS-Supplied Reports
Abend-AID for CICS supplies several different reports that you can print, depending on
the type of entry you selected. You can use the PRINT and LPRINT primary commands, or
the Abend-AID Directory P (Print) line command.
The following reports are available. An index is provided at the end of each report. All
screen images printed in a summary report are logical (rather than physical) images.
Complete Transaction Abend Report
To print a complete transaction abend report, enter the Abend-AID Directory P (Print) line
command to the left of the Entry number field for the transaction entry, or select a
transaction entry and enter PRINT #ALL or LPRINT #ALL on the command line of any
Abend-AID for CICS screen.
A complete transaction abend report contains the following information:
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
Entry Information
Diagnostic Summary
PSW Information
Registers at abend
User Execute Interface Block
System Execute Interface Block
Program Link Information
Program Summary Information
Program Detail
Task Detail
Terminal Detail
Last 3270 Screen Image
Data Stream Analysis
File Information
DFHRPL Concatenation
Enqueues Held
Hogan Control Blocks
MSA Information
Control Blocks/Storage menu
Raw storage for all captured control blocks and areas
Abbreviated trace table.
7-6
Abend-AID for CICS User’s Guide
Transaction Abend Summary Report
To print a transaction abend summary report, select a transaction entry and enter 
PRINT #SUMMARY or LPRINT #SUMMARY on the command line of any Abend-AID for
CICS screen.
A transaction abend summary report contains the following information:
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
Entry Information
Diagnostic Summary
PSW Information
Registers at abend
User Execute Interface Block
System Execute Interface Block
Program Summary Information
Program Detail
Task Detail
Terminal Detail
Last 3270 Screen Image
Data Stream Analysis
File Information
DFHRPL Concatenation
Enqueues Held
Hogan Control Blocks
MSA Information.
Complete DB2 Transaction Abend Report
To print a complete DB2 transaction abend report, enter the Abend-AID Directory P (Print)
line command to the left of the desired DB2 entry, or select a DB2 entry and enter PRINT
#DB2ALL or LPRINT #DB2ALL on the command line of any Abend-AID for CICS screen.
The complete DB2 report contains the following information:
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
Entry Information
Diagnostic Summary
PSW Information
Registers at abend
User Execute Interface Block
System Execute Interface Block
Program Link Information
Program Summary Information
Program Detail
Task Detail
Terminal Detail
Last 3270 Screen Image
Data Stream Analysis
File Information
DFHRPL Concatenation
Enqueues Held
Hogan Control Blocks
MSA Information
DB2 Information menu
Host Variables
Bind Information
Precompile Information
Columns Referenced
RCT Detail
Package Dependencies
Control Blocks/Storage menu
Raw storage for all captured control blocks and areas
Abbreviated trace table.
Printing Abend-AID for CICS Information
7-7
DB2 Transaction Abend Summary Report
To print a DB2 transaction abend summary report, select a DB2 entry and enter 
PRINT #DB2SUMM or LPRINT #DB2SUMM on the command line of any Abend-AID for
CICS screen.
The DB2 summary report contains the following information:
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
Entry Information
Diagnostic Summary
PSW Information
Registers at abend
User Execute Interface Block
System Execute Interface Block
Program Link Information
Program Summary Information
Program Detail
Task Detail
Terminal Detail
File Information
DFHRPL Concatenation
Enqueues Held
Last 3270 Screen Image
Data Stream Analysis
Hogan Control Blocks
MSA Information
DB2 Information menu
Host Variables
Bind Information
Precompile Information
Columns Referenced
RCT Detail
Package Dependencies.
Region Dump Summary Report
To print a region dump summary report, enter the Abend-AID Directory P (Print) line
command to the left of the desired region entry, or select a region entry and enter PRINT
#SUMMARY or LPRINT #SUMMARY on the command line of any Abend-AID for CICS
screen.
The contents of a region dump summary report are determined by the type of dump you
select. Summary report contents, by dump type, are listed below.
For
•
•
•
•
Non-CICS Region Dumps:
Entry Information
JES2 Syslog Buffers
Storage Map.
MVS Environmental Summary.
For
•
•
•
•
•
•
•
•
•
•
•
CICS Transaction Server for z/OS:
Entry Information
JES2 Syslog Buffers
Diagnostic Summary
CICS Task Summary
Task/Wait Analysis
Global Enqueues
Kernel Task Summary
Kernel Domain Error Table
Dispatcher Domain Task Summary
Transaction Manager Summary
Program Change Summary
7-8
Abend-AID for CICS User’s Guide
•
•
•
•
•
•
•
DFHRPL Concatenation
SIT Interpretation
Storage Manager Suspend Queue
Loader Domain Program Storage Map
CICS Environmental Summary
MVS Environmental Summary
Dynamic Storage Area Summary.
Printing Directory Information
The DIRECTORY, DIRX, and DIRECTORY SEQUENTIAL commands are available through
the Compuware Shared Services (CSS) Batch File Utility CWDDALLU (formerly,
CWFXSDUT). These commands list entries from a shared directory or transaction
database to a sequential dataset that you can print. These commands do not allow you to
print Abend-AID for CICS screen contents.
The DIRECTORY command lists selected entries in a shared directory or transaction
database. The DIRX command functions similarly to the DIRECTORY command, but it
also displays the attribute and allocation information. When a DIRX is performed on a
shared directory, it displays the standard DIRX information for the shared directory and
all transaction database attached to that shared directory, in addition to the following:
• Release of DDIO used to format the shared directory
• Minimum release of DDIO
• Current release of DDIO
• Formatting information
–
–
–
–
Number of
Number of
Percentage
Number of
blocks
blocks used
of blocks in use
extents.
• Class information
Each catalog includes at least the following three classes of structures:
– CLASS
– SHRDIR
– DATABASE.
The class information in the DIRX report provides:
–
–
–
–
–
–
–
–
–
Class name
Class instance name
Class anchor RBN
Number of entries of each class
Current put number
Current transaction number
Key length
Key offset
Maximum element length.
• The status of the transaction files attached to the shared directory.
The DIRECTORY SEQUENTIAL command lists selected shared directory entries in a
sequential file produced by the CSS EXPORT command.
Refer to chapter regarding the CWDDALLU utility in the Compuware Shared Services User
Reference Guide for the valid syntax for the DIRECTORY, DIRX, and DIRECTORY
SEQUENTIAL commands and for additional information about them.
Part 2.
2
Transaction Abend Processing
Part 2 of this guide describes the following procedures unique to transaction abend
processing:
• Analyzing transaction abends
• Displaying additional transaction entry information
• Managing source files
• Using Abend-AID for CICS with Language Environment
• Analyzing data exceptions
Note: Application programmers should read this part of the guide in its entirety. System
programmers may refer to this part of the guide on an as-needed basis.
The following chapters are in Part 2:
Chapter 8, “Analyzing Transaction Abends”
Chapter 8 describes how to analyze transaction abends using the Diagnostic
Summary. This screen presents diagnostic information for abended
transactions including reasons for their occurrence and it recommends
possible solutions.
Chapter 9, “Displaying Additional Transaction Abend Information”
Chapter 9 describes how to display additional program and file information
for transaction abends.
Chapter 10, “Managing Source Files”
Chapter 10 describes techniques for managing source files when source
support for selected reports is available.
Chapter 11, “Using Abend-AID for CICS with Language Environment”
Chapter 11 describes the considerations for using Abend-AID for CICS with
transactions running under Language Environment.
Chapter 12, “Analyzing Data Exceptions”
Chapter 12 describes a possible approach to solving a sample S0C7 data
exception abend, using Abend-AID for CICS.
Abend-AID for CICS User’s Guide
8-1
Chapter 8.
Analyzing Transaction Abends
Chap 8
This chapter describes the screens used to analyze transaction abends that occur in the
CICS environment. Begin analysis with the Diagnostic Summary screen. It provides a
probable reason for the abend and usually suggests a resolution. From the Diagnostic
Summary, access detailed information relevant to the abend. The screens that are
accessible from the Diagnostic Summary depend upon the type of transaction that you
select. Scan the following list to find the information you need.
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
“Diagnostic Summary” on page 8-1
“Program Detail Screen” on page 8-6
“Task Detail Screen” on page 8-7
“Terminal Detail Screen” on page 8-9
“Call Detail Screen” on page 8-10
“Program Listing Screen” on page 8-11
“Impact Analysis Menu” on page 8-13
“3270 Bridge Information Screen” on page 8-20
“Expanded Data Field Screen” on page 8-21
“DFHRPL Concatenation Screen” on page 8-21
“User Execute Interface Block Screen” on page 8-22
“Last 3270 Screen Image” on page 8-23
“Data Stream Analysis Screen” on page 8-23
“Program Call Trace Summary Screen” on page 8-24
“PSW Information Screen” on page 8-25
“PSW Analysis Screen” on page 8-26
“Registers Screen” on page 8-26
“Transaction Abend Control Blocks Screen” on page 8-28
“DB2 Information Screens” on page 8-29
“WebSphere MQ Information Screens” on page 8-34
“Hogan Information Screens” on page 8-47
“DL/I Information Screen” on page 8-49
“MSA Information Screens” on page 8-50
Before beginning your analysis of the error using the Diagnostic Summary, read Chapter
3, “Abend-AID for CICS Interface” to familiarize yourself with the Abend-AID for CICS
screen layout and text display defaults. Note how to enter fast-path and line commands.
In particular, review “Cursor Point-and-Shoot Feature” on page 3-7 for an explanation of
the alternative methods for accessing program storage and detailed information about
specific data elements. Online help is available for any Abend-AID for CICS screen, field,
system message, or command.
For information about using the Diagnostic Summary for region dump analysis, refer to
Chapter 14, “Analyzing CICS Region Dumps”.
Diagnostic Summary
The Diagnostic Summary, shown in Figure 8-1 on page 8-2 through Figure 8-4 on page
8-3, provides the information necessary for diagnosing a transaction abend. The
summary provides a probable reason for the abend, and usually suggests a resolution. For
COBOL, PL/I, and Assembler programs compiled or assembled with source support, the
actual statement number and source code of the statement in error are shown. The
Diagnostic Summary consists of two or more pages and contains the following sections:
8-2
Abend-AID for CICS User’s Guide
•
•
•
•
•
•
•
•
•
•
•
Analysis of error
Root Cause Analysis
Fields
SQL Return Code (DB2 only)
Host Variables (DB2 only)
SQL Statement (DB2 only)
COBOL Information, if applicable
Next Sequential Instruction
Last CALL or EXEC CICS
Program Link Summary
Supporting Information.
Figure 8-1. Diagnostic Summary, Page 1
Compuware Abend-AID ------- Diagnostic Summary --------- Row 000001 of 000073
COMMAND ===>
SCROLL ===> PAGE

An ASRA abend occurred in program CCAADEMO. The abending transaction was
AADM running at terminal D492 for user ID CICSUSER. 

Analysis of error 

A Data Exception is caused when a decimal instruction is attempted on a
field that does not contain valid packed data, eg. contains an invalid digit
(not 0-9), or its last byte contains an invalid sign (Not A, B, C, D, E or F).


The data exception occurred in the following statement: 

000413
COMPUTE CURR-PAY
EQUAL WA-HOURS * WA-RATE 

This statement is contained in paragraph "300-EMPLOYEE-PAY-RTN" in program
CCAADEMO. 

COBOL Information 
Figure 8-2. Diagnostic Summary, Page 2


Compuware Abend-AID ------- Diagnostic Summary --------- Row 000020 of 000073
COMMAND ===>
SCROLL ===> PAGE
COBOL Information 


Current values of fields on this statement: 

Level/Field Name
Picture/Type
Value
77 CURR-PAY
9(5)V99
0000000
02 WA-HOURS
# 999
***
02 WA-RATE
9(3)V99
00950 

’#’ - Indicates field contains invalid data that does not match the 
field description in the program. Note that even valid data
could cause an error (for example, a zero divide).
Next Sequential Instruction 

The next statement is: 

000414
COMPUTE CURR-TAXES EQUAL CURR-PAY * WA-TAX-RATE 

This statement is contained in paragraph "300-EMPLOYEE-PAY-RTN" in program
CCAADEMO. 
Analyzing Transaction Abends
8-3
Figure 8-3. Diagnostic Summary, Page 3




Compuware Abend-AID ------- Diagnostic Summary --------- Row 000047 of 000073
COMMAND ===>
SCROLL ===> PAGE 

Next Sequential Instruction 


The program was compiled on 14JAN2004 at 8:09:26 and is 0018A0 bytes long.
It is part of load module CCAADEMO which was loaded from CW.CC.DEMO.PGMLOAD.
It was link edited on 14APR2002 and is 001D30 bytes long.
The program AMODE was 31 and program RMODE was 24 .

The execution key for this program was USER_KEY. 

Last Call or EXEC CICS Request 
The last call or ’EXEC CICS’ command was: 

000381
*EXEC CICS RECEIVE
000382
*
INTO
(DUMMY-EMP)
000383
*
LENGTH (DUMMY-LEN)
000384
*END-EXEC.
000385
MOVE ’..{ .
.
00288
000386
CALL ’DFHEI1’ USING DFHEIV0

’ TO DFHEIV0
DUMMY-EMP DUMMY-LEN.

Figure 8-4. Diagnostic Summary, Page 4

Note:
Compuware Abend-AID ------- Diagnostic Summary --------- Row 000056 of 000070 
COMMAND ===>
SCROLL ===> PAGE 

Last Call or EXEC CICS Request


This statement is contained in paragraph "MAIN@310" of program CCAADEMA.



Program Link Summary


Called
Called
------- Status ------- Calling
Calling
Return

Load Mod Program
Load Mod Program
Offset

CCAADEMA CCAADEMA Linked By
System
000000



Supporting Information:

SCREEN
- Last 3270 Screen

EIB
- User Execute Interface Block

DATASTRM - Data Stream Analysis

FILE
- File Request Summary

CALTRACE - CICS Program Call Trace Summary

PSW
- Program Status Word

REGS
- Registers

TACB
- Transaction Abend Control Blocks 
ESRCH
- Extended search
The Supporting Information lists the information that is relevant to selected
dump. The fields presented in this section vary.
Access the Diagnostic Summary by doing one of the following:
• Enter S as a line command on the Abend-AID Directory next to the entry for the
transaction abend you want to analyze.
• If you have already selected the transaction abend, do one of the following:
– Directly access the Diagnostic Summary from the Abend-AID for CICS Primary
Options menu.
8-4
Abend-AID for CICS User’s Guide
– Enter DIAG as a fast-path command or =1 as a jump command on any AbendAID for CICS screen.
• Enter the AADFT or AADFX AADF transaction command (CICS access only).
To analyze the selected transaction abend, do the following:
1. Obtain from the first two sentences of the summary the abend type, the program
name, the transaction ID, and the terminal ID associated with the abending
transaction. Use the cursor point-and-shoot feature and press Enter to access the IBM
message text for the abend code, and program, task, and terminal details related to
the abend. Refer to “Program Detail Screen” on page 8-6, “Task Detail Screen” on
page 8-7, and “Terminal Detail Screen” on page 8-9 for a description of these screens.
2. Review the Analysis of error section for a description of the abend and an
explanation of the probable cause. For programs compiled with source support,
Abend-AID for CICS displays the abending statement. Use the cursor point-and-shoot
feature and press Enter at the statement number field to access the Program Listing
screen, which is explained in “Program Listing Screen” on page 8-11.
3. Review the Root Cause Analysis section under the Analysis of error heading
(Figure 8-5), which provides a brief analysis of the results of a call to CSS for a list of
fields and their values. The report helps to identify invalid items either because the
data does not match the definition, or they are zero and should not be zero, or the
data is not available.
Figure 8-5. Root Cause Analysis


Compuware Abend-AID ------- Diagnostic Summary --------- Row 000001 of 000073
COMMAND ===>
SCROLL ===> PAGE

An ASRA abend occurred in program PJRTEST4. The abending transaction was
PJR4 running at terminal 0805 for user ID CICSUSER. 

Analysis of error 
Root cause analysis is available for this abend.

The data exception occurred in the following statement: 

000250
012600
COMPUTE 
000251
012700
H-EMP-COMPENSATION = H-0T-AMOUNT +
000252
012800
( H-EMP-HOURS * H-EMP-RATE )
000253
012900
END-COMPUTE.

This statement is contained in paragraph 0000-CONTINUE in program PJRTEST4.
After selecting analysis using the cursor point-and-shoot feature, the Root Cause
Analysis Menu is displayed with fields selectable for analysis.
4. For COBOL programs, identify the field(s) in error by reviewing the COBOL
Information section. Use the cursor point-and-shoot feature and press Enter at any
entry in the Level/Field Name field to display the Program Listing screen for working
storage, which is explained in “Working Storage” on page 9-13. Press Enter at any
entry in the Value field to display the Expanded Data Field screen, which is explained
in “Expanded Data Field Screen” on page 8-21.
5. From the Next Sequential Instruction section, determine where the program was
executing when it abended, and obtain the following information about the
abending program:
– Program’s compile date
– Program’s link-edit date
– Program name and module lengths
Analyzing Transaction Abends
8-5
– Load module name and the load library name
– Next statement to be executed after the abending statement.
Use the cursor point-and-shoot feature to access additional information about data
displayed in the Next Sequential Instruction section as follows:
– Press Enter at the statement number field to access the Program Listing screen,
which is explained in “Program Listing Screen” on page 8-11.
– If the program is not COBOL, PL/I, or Assembler or it was not compiled with
source support, Abend-AID for CICS displays the displacement of the next
sequential instruction. Press Enter at the displacement to disassemble the
program and display the Storage Disassembly screen, which is explained in
“Storage Disassembly Screen” on page 9-21.
– Press Enter at the program name field to access the Program Detail screen, which
is explained in “Program Detail Screen” on page 8-6.
– Press Enter at the load library name field to access the DFHRPL Concatenation
screen, which is explained in “DFHRPL Concatenation Screen” on page 8-21.
6. Note the last call or EXEC CICS command and its location in the abending program.
Use the cursor point-and-shoot feature and press Enter at the statement number field
to access the Program Listing screen, which is explained in “Program Listing Screen”
on page 8-11. If the program is not COBOL or was not compiled with source support,
Abend-AID for CICS displays the displacement of the last call or EXEC CICS request.
Press Enter at the displacement to disassemble the program.
7. Review the Program Link Summary section for a summary of the program execution
sequence for every module used by a transaction up to the abending module. Use the
cursor point-and-shoot feature to access additional information about called and
calling programs as follows:
– Press the HEXD PF key at a Called or Calling field to access the PPT in
hexadecimal format. Abend-AID for CICS displays the Memory Display screen,
which is explained in “Using the Memory Display Screen” on page 5-2.
– Press the DSECT PF key at a Called or Calling field to access the PPT in DSECT
format, when available. Abend-AID for CICS displays the DSECT Support screen,
which is explained in “Displaying Control Blocks in DSECT Format” on page 6-1.
– The Return Offset value in the Program Link Summary information takes you to
the Call Detail screen, which is explained in “Call Detail Screen” on page 8-10.
8. Review the Supporting Information section, which gives you a dynamic menu
allowing direct access to areas related to the abending task that may help in your
analysis. Use the cursor point-and-shoot feature and press Enter to access the
following additional screens when available:
–
–
–
–
–
–
–
–
–
–
“Last 3270 Screen Image” on page 8-23
“User Execute Interface Block Screen” on page 8-22
“Data Stream Analysis Screen” on page 8-23
“File Request Summary” on page 9-24
“Program Call Trace Summary Screen” on page 8-24
“PSW Information Screen” on page 8-25
“Registers Screen” on page 8-26
“Transaction Abend Control Blocks Screen” on page 8-28
“Extended Search Listing Screen” on page 9-6
“Optional z/Architecture Features Screen” on page 9-11.
Note:
You may have to scroll forward to see all of the available fields. Press the
DOWN PF key (PF8 is the default).
You can also use the cursor point-and-shoot feature and press the HEXD PF key at the
EIB, REGS, and PSW fields to display the MEMORY Display screen, which is described
in “Using the Memory Display Screen” on page 5-2. In addition, press the DSECT PF
8-6
Abend-AID for CICS User’s Guide
key at the EIB field to display the DSECT screen, which is described in “Displaying
Control Blocks in DSECT Format” on page 6-1.
Program Detail Screen
The Program Detail screen, shown in Figure 8-6 on page 8-6, provides detailed
information about the selected program.
Note:
All references to program on Abend-AID for CICS displays refer to the program
CSECT, and not the load module.
Access the Program Detail screen in one of the following ways:
• Use the cursor point-and-shoot feature and press Enter at the program name field on
the Diagnostic Summary or Task Detail screen.
• Use the cursor point-and-shoot feature and press Enter at the program name field on
the Program Link Information or Program Summary Information screen.
• Enter the D line command on the Program Link Information or Program Summary
Information screen.
• Enter PGMDET program-name as a fast-path command on any Abend-AID for CICS
screen.
Figure 8-6. Program Detail Screen
Compuware Abend-AID --------- Program Detail ------------------------------
COMMAND ===> 

Program CCAADEMO is part of load module CCAADEMO which was loaded from
CW.CC.DEMO.PGMLOAD
Source was loaded from dataset MP.BETA.DEMO.LISTFILE
To display the source listing for this program, select Listing
To display Cobol storage areas for this program, select Storage Areas 

Program Information
Program-Related Areas
Compile Date............. 14JAN2004
PPT Entry................ 082C16C8
Compile Time............. 08:09:26
Commarea................. 08308018
Link Date................ 14JAN2004
Entry Point Address...... 08A2F048
Source Compile Date...... 14JAN2004
Savearea................. 08A32030
Source Compile Time...... 08:09:26
BREXIT................... Y
Program Size............. 000018A0
Program Rmode............ 24
Program Amode............ 31 

Language Information
CICS Type................ COMMAND
EXECkey.................. USER
Language................. COBOL/MVS
Data above 16meg?........ Y
LE/370 Enabled?.......... Y 
To obtain additional information about the abending program, do the following:
1. Note general information about the abending program, such as compile date and
time, program size, and language.
2. Use the cursor point-and-shoot feature and press Enter at the load library name field
to access the DFHRPL Concatenation screen, which is explained in “DFHRPL
Concatenation Screen” on page 8-21.
3. Use the cursor point-and-shoot feature and press Enter at the Listing field to access
the Program Listing screen, which is explained in “Program Listing Screen” on page
8-11.
Analyzing Transaction Abends
Note:
8-7
The Program Listing screen is only available for COBOL, PL/I and Assembler
programs compiled with the Compuware COBOL language processor,
Compuware PL/I language processor, or Compuware Assembler language
processor.
4. Use the cursor point-and-shoot feature and press Enter at the Storage Areas field to
display:
– Working storage, linkage section, external cells, and task global table (TGT) for
COBOL programs.
– Formatted storage for PL/I programs with source support.
– Automatic, static, controlled, and external storage areas in hexadecimal format
for PL/I programs.
– Formatted storage for Assembler programs with source support.
5. Access the specific storage information in hexadecimal format for the processing
program table (PPT) entry, the commarea, the entry point address, and the savearea
by using the cursor point-and-shoot feature and pressing the HEXD PF key to display
the Memory Display screen, which is explained in “Using the Memory Display
Screen” on page 5-2.
6. Access the specific storage information in DSECT format for the PPT entry by using
the cursor point-and-shoot feature and pressing the DSECT PF key to display the
DSECT Support screen, which is explained in “Displaying Control Blocks in DSECT
Format” on page 6-1.
Task Detail Screen
The Task Detail screen, shown in Figure 8-7, provides detailed information about the
status of the transaction at the time of the abend. Use the cursor point-and-shoot feature
to access information about the resources being used, such as the program control table
(PCT) entry, the task control area (TCA), the execute interface block (EIB), and the
currently held enqueues.
Access the Task Detail screen in one of the following ways:
• Use the cursor point-and-shoot feature and press Enter on the abending transaction
field located at the top of the Diagnostic Summary.
• Select the TASK option from the Abend-AID for CICS Primary Options menu.
• Use the TASK fast-path command.
8-8
Abend-AID for CICS User’s Guide
Figure 8-7. Task Detail Screen
Compuware Abend-AID ------ Task Detail ----------------- Row 000001 of 000004
COMMAND ===>
SCROLL ===> PAGE

Transaction ID........... AADM
Abending Program............... CCAADEMO 
To display Bridge information, select Bridge 
Transaction Information
Transaction Statistics
Initial Program.......... CCAADEMO Number of Storage Violations... 0
Terminal ID.............. D492

Task Number.............. 00038
User ID.................. CICSUSER
Operator ID..............
Task-Related Areas
Priority................. 001
TCA (System)................... 00063100
Primed Size.............. 0000
TCA (User)..................... 00063000
Transaction Class........
TWA............................ 00000000
Original Abend........... ASRA
PCT Entry...................... 082C3180
Current Abend............ ASRA 

Supporting Information
DATASTR - Data Stream Analysis
EIB
- User Execute Interface Block
PSW
- Program Status Word
REGS
- Registers
SCREEN
- Last 3270 Screen
TRACE
- CICS Trace
Note:
The Supporting Information presents information that is relevant to the selected
dump. The fields in this section vary.
To obtain additional information about the abending task, do the following:
1. Note general information about the abending task, such as program name, task
number, and number of storage violations.
2. Access the specific storage information in hexadecimal format for the system and
user TCA, the TWA, and the PCT entry using the cursor point-and-shoot feature and
pressing the HEXD PF key to display the Memory Display screen, which is explained
in “Using the Memory Display Screen” on page 5-2.
3. Access the specific storage information in DSECT format for the system and user
TCA, and the PCT entry by using the cursor point-and-shoot feature and pressing the
DSECT PF key to display the DSECT Support screen, which is explained in
“Displaying Control Blocks in DSECT Format” on page 6-1.
4. Access other task-related information by using the cursor point-and-shoot feature
and pressing Enter on the following fields:
– BRIDGE: To display the “3270 Bridge Information Screen” on page 8-20.
– DATASTR: To display the “Data Stream Analysis Screen” on page 8-23.
– EIB: To display the “User Execute Interface Block Screen” on page 8-22.
– FILE: To display the “File Request Summary” on page 9-24.
– PSW: To display the “PSW Information Screen” on page 8-25.
– SCREEN: To display the “Last 3270 Screen Image” on page 8-23.
– TRACE: To display the “Trace Listing Screen” on page 14-11.
Note:
You may have to scroll forward to see all of the available fields. Press the
DOWN PF key (PF8 is the default).
Use the cursor point-and-shoot feature and press the HEXD PF key at the EIB, REGS,
and PSW fields to display the Memory Display screen, which is described in “Using
the Memory Display Screen” on page 5-2. In addition, press the DSECT PF key at the
EIB field to display the DSECT screen, which is described in “Displaying Control
Blocks in DSECT Format” on page 6-1.
Analyzing Transaction Abends
8-9
Terminal Detail Screen
The Terminal Detail screen, shown in Figure 8-8 on page 8-10, provides detailed
information about the terminal associated with the abending transaction. Use the cursor
point-and-shoot feature to access specific information about the terminal and terminalrelated storage, such as the last 3270 image and the data stream analysis.
Note:
The Last 3270 Screen Image and Data Stream Analysis screens are not available if
the abending transaction is a bridge transaction.
Access the Terminal Detail screen in one of the following ways:
• Use the cursor point-and-shoot feature and press Enter on the terminal field on the
Diagnostic Summary or the Task Detail screen.
• Select the Terminal Detail option from the Primary Options menu.
• Use the TERM fast-path command.
To obtain additional information about the terminal associated with the abending task,
do the following:
1. Note general information about the terminal, such as the terminal ID, terminal type
and model, and status. New with Release 11.2, Unicode support displays in the Code
Page Used field the code page used by the abending transaction.
2. Access the specific storage information in hexadecimal format for the terminal
control table user area (TCTUA), the terminal control table terminal entry (TCTTE),
and the terminal input/output area (TIOA) by using the cursor point-and-shoot
feature and pressing the HEXD PF key to display the Memory Display screen, which is
explained in “Using the Memory Display Screen” on page 5-2.
3. Access the specific storage information in DSECT format for the TCTTE by using the
cursor point-and-shoot feature and pressing the DSECT PF key to display the DSECT
Support screen, which is explained in “Displaying Control Blocks in DSECT Format”
on page 6-1.
4. Access other terminal-related information by using the cursor point-and-shoot
feature and pressing Enter to display the following screens:
– “Last 3270 Screen Image” on page 8-23
– “Data Stream Analysis Screen” on page 8-23
8-10
Abend-AID for CICS User’s Guide
Figure 8-8. Terminal Detail Screen
Compuware Abend-AID -------- Terminal Detail -------------------------------- 
COMMAND ===>


Terminal ID.............. 0835
Display Last 3270 Image

Netname.................. TCW00835
Display Data Stream Analysis


Terminal Information
Terminal Status

Type..................... 3277R
In Service?..................... Y

Model.................... 2
Attended?....................... N

Operator ID..............
Extended Attributes?............ Y

User ID.................. CICSUSR
Extended Color?................. Y

Default Screen Size...... 24X80
Light Pen?...................... N

Alternate Size........... 27X132
Uppercase/Dual?................. U

Alternate in Use?........ N

Map Name.................

Attention Identifier..... <ENTER>

Code Page Used........... 37

Terminal Statistics
Terminal-Related Areas

Number of Transactions... 6
TCTUA.................... 00000000

Number of Tran Errors.... 0
TCTTE.................... 3863C280

Number of Inputs......... 10
TIOA..................... 385EB000

Number of Outputs........ 11


Call Detail Screen
The Call Detail screen, shown in Figure 8-9, provides detailed information about the
CALL statement, and argument definitions and values. The Call Detail screen is available
only when the corresponding source listing program(s) are available.
Access the Call Detail screen by using the cursor point-and-shoot feature on the Return
Offset value in the Program Link Summary.
Figure 8-9. Call Detail Screen
Compuware Abend-AID ------- Call Detail --------- Row 000001 of 000007 
COMMAND ===>
SCROLL ===> PAGE 

Source Program Name... CC5CAL12

Program Compile Date.. 08DEC2006
Source Listing Date... 08DEC2006 
Program Compile Time.. 14:35:00
Source Listing Time... 14:35:00



CALL Statement


000214
CALL 'DFHEI1'USING DFHEIV0 CALL-PGMS COMM-AREA

000215
DFHB0020


Argument Definitions and Values


01 DFHEIV0
X(77)
X'0E02E0000700000100F0F0F0F9F640
02 CALL-PGMZ
X(8)
CC5HNDLR
01 COMM-AREA
01 DFHB0020
S9(4) COMP
+34
Analyzing Transaction Abends
8-11
Program Listing Screen
The Program Listing screens, shown in Figure 8-10 on page 8-11 through Figure 8-12 on
page 8-12, displays the source listing statements of the selected program. The active
statement (abending offset, program call, EXEC link, and so forth) is highlighted.
• For COBOL programs, Abend-AID for CICS displays the Working-Storage Section, the
Linkage Section, and the Procedure Division of the selected program. You can use the
PF keys to scroll through the sections.
• For PL/I and Assembler programs, Abend-AID for CICS displays the entire source
listing.
After scrolling through the listings, reposition the display to the active statement by
placing the cursor on the RESET field at the top of the screen and pressing Enter. To
reposition the display to the statement at the point of entry, use the cursor point-andshoot feature on the ENTRY field.
Access the Program Listing screen in one of the following ways:
• Use the cursor point-and-shoot feature and press Enter on any of the Stmt fields on
the Diagnostic Summary.
• Use the cursor point-and-shoot feature and press Enter on the Listing field on the
Program Detail screen.
• For programs compiled with the Compuware COBOL language processor, the
Compuware PL/I language processor, or assembled with the Compuware Assembler
language processor, enter the L line command on the Program Link Information
screen or the Program Summary Information screen.
• Use PLIST program-name as a fast-path command.
Figure 8-10. Program Listing Screen for COBOL
Compuware Abend-AID -------- Program Listing ---------- Row 000346 of 001018 
COMMAND ===>
SCROLL ===> CSR 

Program............... CCAADEMO

Program Compile Date.. 01AUG2006
Source Listing Date... 01AUG2006

Program Compile Time.. 12:24:03
Source Listing Time... 12:24:03

==> 
To reset display to the abending/last executed statement, select RESET

To reset display to the point of entry into this listing, select ENTRY


Source Line

**************************************************************************** 
000430
COMPUTE CURR-PAY
EQUAL WA-HOURS * WA-RATE

000431
COMPUTE CURR-TAXES EQUAL CURR-PAY * WA-TAX-RAT

000432
ADD CURR-PAY
TO WA-YTD-GRS

000433
ADD CURR-TAXES TO WA-YTD-TAX.

000434

000435
IF PAYEMP1 EQUAL '00001'

000436
MOVE WORK-AREA TO PAYROLL-DATA-EMP001.

000437

000438
IF PAYEMP1 EQUAL '00999'

000439
MOVE WORK-AREA TO PAYROLL-DATA-EMP999.

000440

8-12
Abend-AID for CICS User’s Guide
Figure 8-11. Program Listing Screen for a PL/I Program











Source Line

**************************************************************************** 
001284
$B = $Z/$Y;

001285
$111 = $222;

001286
$Y = 1;

001287
$Z = 4321;

001288
END PROGRAM_DO_FAIL;

001289
/*--*/

001290
END PL6PGM49_MAIN_RATHER_LONG_EXTERNAL_NAME;

***************************** BOTTOM OF DATA ******************************* 
Compuware Abend-AID ------- Program Listing ---------- Row 000346 of 001018
COMMAND ===>
SCROLL ===> CSR
MFDFD5402E Source request made for CEECSDMP. No source info in the dump.
Program............... PL6PAME1
PL/I Procedure Name... PL6PGM49_MAIN_RATHER_LONG_EXTER
Program Compile Date.. 22JAN2007
Source Listing Date... 22JAN2007
Program Compile Time.. 14:05:02
Source Listing Time... 14:05:02
==>
To reset display to the abending/last executed statement, select RESET
To reset display to the point of entry into this listing, select ENTRY
Figure 8-12. Program Listing Screen for an Assembler Program
Compuware Abend-AID -------- Program Listing ---------- Row 000346 of 001018
COMMAND ===>
SCROLL ===> PAGE
==>
Program Compile Date.. 07JUN2007


Program............... ASMHL1#1
Source Listing Date... 07JUN2007

Source Listing Time... 11:24


To reset display to the abending/last executed statement, select RESET

To reset display to the point of entry into this listing, select ENTRY



Source Line
**************************************************************************** 
576
000214 F233 D1B0 D25C
PACK
$C_TRATE,$P_TRATE
PACK T 
577
00021A F877 D1A8 D198
ZAP
$C_TAX,$C_PAY
CALC T 
578
000220 FC73 D1A8 D1B0
MP
$C_TAX,$C_TRATE
AMOU 
580
000226 FA77 D1B4 D198
AP
$C_YTD_G,$C_PAY
ACUMUL 
581
00022C FA77 D1BC D1A8
AP
$C_YTD_T,$C_TAX
ACUMUL 
582
*
* ----------------------------- 
583
*
* PRIOR TO THIS POINT WE SHOULD 
584
*
* ABENDED WITH AN 'ASRA' ABEND. 
585
*
* ----------------------------- 
586
000232 D22B D28B 38B4
MVC
$MESSAGE,#MSG7
SET 'A 
587
000238 D203 D29F 379C
MVC
$MESSAGE+20(4),#ASRA
ECHO T 
Accessing Storage for a Variable
For COBOL programs only, access related storage for a variable from the Program Listing
screen. Tab to the corresponding statement number for the variable and do one of the
following:
• Press Enter.
• Enter the P or P1 (Peek) line command to display program storage for the first
variable on the statement. To position the program storage display at other than the
first variable, enter Pn, where n is the relative number of the variable on the
statement. For example, enter P3 to access program storage positioned at the storage
Analyzing Transaction Abends
8-13
for the third variable on the statement. The Program Listing screen for working
storage is described in “Working Storage” on page 9-13.
Note:
Ensure that you begin typing the P (Peek) line command in the first position
of the statement number.
After using either of these methods for accessing program storage, press the END key
(PF3) to reposition the display to the statement for the variable in the Procedure Division
as the first line.
Impact Analysis Menu
The Impact Analysis Menu, shown in Figure 8-13 on page 8-13, displays program data
items that you can select for DevEnterprise impact analysis. Your site must have
DevEnterprise installed for integration with Abend-AID for CICS, and you must be using
source support for the abending program. The server is the server where DevEnterprise
Metadata Analyzer is executing and where the impact analysis is performed. Access this
screen from the Diagnostic Summary by using the cursor point-and-shoot feature and
pressing Enter at the Impact Analysis field.
Figure 8-13. Impact Analysis Menu
Compuware Abend-AID ------ Impact Analysis Menu -------- Row 000001 of 000004 
COMMAND ===>
SCROLL ===> PAGE 

Program Name. CWAADATE

Server....... deventerprise.clients.your.site


Select a field for Impact Analysis.


DECADE-ANN


RUN-YEAR


ANN-YEARS


NON-ANN-YEARS


****************************** BOTTOM OF DATA *********************************






Use the cursor point-and-shoot feature to position the cursor at the program name or at
any of the displayed fields for analysis and press Enter. The Impact Analysis Results
screen is displayed, as shown in Figure 8-14 on page 8-14.
Impact Analysis Results Screen
The Impact Analysis Results screen, as shown in Figure 8-14 on page 8-14, displays the
results of an impact analysis. The name and type of the source entity that impact analysis
was performed on are displayed at the top screen. The table contains the target entities
that either impact the source entity or are impacted by the source entity, or both.
Access this screen by using the cursor point-and-shoot feature to position the cursor at
the program name or at a field of interest on the Impact Analysis Menu (Figure 8-13) and
8-14
Abend-AID for CICS User’s Guide
pressing Enter. Alternatively, access this screen from the Impact Analysis Listing (Figure
8-21 on page 8-20) by entering the I line command next to a source line.
Figure 8-14. Impact Analysis Results Screen
Compuware Abend-AID ---- Impact Analysis Results ------- Row 000001 of 000003 
COMMAND ===>
SCROLL ===> PAGE 

Impact Analysis results for the Data Item

DECADE-ANN


Target Type
Impacts
Impacted By

******************** *********** ***********

Data Item
16
12

Program
1
1

Virtual DD
1
0

****************************** BOTTOM OF DATA *********************************










The above information was provided by the DevEnterprise Metadata Analyzer

Use the cursor point-and-shoot feature and press Enter at the number displayed in the
Impacts or Impacted By field to display the following screens:
• Impacts - Programs screen (Figure 8-15 on page 8-15)
• Impacted by - Program screen (Figure 8-16 on page 8-16)
• Impacts - Data Items screen (Figure 8-17 on page 8-17)
• Impacted By - Data Items screen (Figure 8-18 on page 8-18).
Impacts - Programs
The Impacts - Programs screen, shown in Figure 8-15 on page 8-15, displays impact
analysis information for programs that the selected target program or data item impacts.
Note that the information shown is obtained from the DevEnterprise Metadata Analyzer.
Analyzing Transaction Abends
8-15
Figure 8-15. Impacts - Programs Screen





D Details
I Impact Analysis


End

Program Name
Distance Point Language
Member
Source Library 
******************** ******** ***** ********** ******** ****************
CWAAHOUR
1
YES
COBOL
CWAAHOUR AACICS.TEST.DEVE
***************************** BOTTOM OF DATA ********************************










The above information was provided by the DevEnterprise Metadata Analyzer

Compuware_Abend-AID ------- Impacts - Programs --------- Row 000001 of 000001
COMMAND ===>
SCROLL ===> PAGE
==>
Program CWAADATE impacts the following programs
Access this screen from the Impact Analysis Results screen (Figure 8-14 on page 8-14) by
using the cursor point-and-shoot feature to position the cursor at the number displayed
in the Impacts field for the selected program and pressing Enter. You can use the
following line commands on this screen:
• D: Displays the Program Details screen, as described in “Program Details Screen” on
page 8-18.
• I: Displays the Impact Analysis Results screen, as described in “Impact Analysis
Results Screen” on page 8-13.
Impacted By - Programs Screen
The Impacted By - Programs screen, shown in Figure 8-16 on page 8-16, displays impact
analysis information for programs that the selected target program or data item is
impacted by. Note that the information shown is obtained from the DevEnterprise
Metadata Analyzer.
8-16
Abend-AID for CICS User’s Guide
Figure 8-16. Impacted By - Programs Screen





D Details
I Impact Analysis


End

Program Name
Distance Point Language
Member
Source Library 
******************** ******** ***** ********** ******** ****************
CWAACOB
1
YES
COBOL
CWAACOB
AACICS.TEST.DEVE
***************************** BOTTOM OF DATA ********************************










The above information was provided by the DevEnterprise Metadata Analyzer

Abend-AID --------------- Impacted By - Programs ------- Row 000001 of 000001
COMMAND ===>
SCROLL ===> PAGE
==>
Program CWAAHOUR is impacted by the following programs
Access this screen from the Impact Analysis Results screen (Figure 8-14 on page 8-14) by
using the cursor point-and-shoot feature and pressing Enter at the number displayed in
the Impacted By field for the target program. You can use the following line commands
on this screen:
• D: Displays the Program Details screen, as described in “Program Details Screen” on
page 8-18.
• I: Displays the Impact Analysis Results screen, as described in “Impact Analysis
Results Screen” on page 8-13.
Impacts - Data Items Screen
The Impacts - Data Items screen, shown in Figure 8-17 on page 8-17, displays impact
analysis information for data items. It shows those data items that either impact or are
impacted by the selected field. Note that the information shown is obtained from the
DevEnterprise Metadata Analyzer.
Analyzing Transaction Abends
8-17
Figure 8-17. Impacts - Data Items Screen





Storage


End
Picture

Point Clause
Data Type

***** ********** ****************
Group Item

X(80)

YES
Group Item

Group Item

99

YES
Group Item

9(2)

9(2)

X(6)

X(6)

Group Item

YES
9(2)

YES
Group Item

DevEnterprise Metadata Analyzer 
Abend-AID ---------------- Impacts - Data Items -------- Row 000001 of 000016
COMMAND ===>
SCROLL ===> PAGE
==>
Data Item DATE-TABLE impacts the following data items
D Details
I Impact Analysis
S Program
Data Item
Distance
****************************** ********
EMPLOYEE-HDR1
0
REPORT-RECORD
1
DATE-TABLE-REDEFINED
0
REPORT-FILE
2
REG-RUN-DAY
1
DATE-FIELDS
0
DATE-DAY
0
DATE-DAYS
0
TODAYS-DATE
0
H-TODAYS-DATE
0
RUN-DATE
0
DATE-MONTH
0
DATE-FIELDS
0
The above information was provided by the
Access this screen from the Impact Analysis Results screen (Figure 8-14 on page 8-14) by
using the cursor point-and-shoot feature and pressing Enter at the number displayed in
the Impacts field. You can use the following line commands on this screen:
• D: Displays the Data Item Details screen, as described in “Data Item Details Screen”
on page 8-19.
• I: Displays the Impact Analysis Results screen, as described in “Impact Analysis
Results Screen” on page 8-13.
• S: Displays the list of data items for which you can obtain impact analysis, as
described in “Impact Analysis Listing” on page 8-20.
Impacted By - Data Items Screen
The Impacted - Data Items screen, shown in Figure 8-18 on page 8-18, displays impact
analysis information for data items. It shows those data items that either impact or are
impacted by the selected field. Note that the information shown is obtained from the
DevEnterprise Metadata Analyzer.
8-18
Abend-AID for CICS User’s Guide
Figure 8-18. Impacted By - Data Items Screen





D Details
I Impact Analysis S Program Storage


End
Picture

Data Item
Distance Point Clause
Data Type

****************************** ******** ***** ********** ****************
WORK-AREAS
0
YES
Group Item

DATE-YEAR
0
9(2)

RUN-YEAR
1
9(2)

DECADE-ANN
1
9(4)

TODAYS-DATE
0
X(6)

H-TODAYS-DATE
0
X(6)

RUN-DATE
0
Group Item

00
1
Literal
Numeric

DATE-FIELDS
0
YES
Group Item

DATE
1
Literal

***************************** BOTTOM OF DATA ********************************


The above information was provided by the DevEnterprise Metadata Analyzer
Abend-AID -------------- Impacted By - Data Items ------ Row 000001 of 000010
COMMAND ===>
SCROLL ===> PAGE
==>
Data Item ANN-YEARS is impacted by the following data items
Access this screen from the Impact Analysis Results screen (Figure 8-14 on page 8-14) by
using the cursor point-and-shoot feature and pressing Enter at the number displayed in
the Impacted By field. You can use the following line commands on this screen:
• D: Displays the Data Item Details screen, as described in “Data Item Details Screen”
on page 8-19.
• I: Displays the Impact Analysis Results screen, as described in “Impact Analysis
Results Screen” on page 8-13.
• S: Displays the list of data items for which you can obtain impact analysis, as
described in “Impact Analysis Listing” on page 8-20.
Program Details Screen
The Program Details screen, shown in Figure 8-19 on page 8-19, provides detailed
information for a selected target program. Note that the information shown is obtained
from DevEnterprise Metadata Analyzer. The modified date and time are the last
modification for this entity in DevEnterprise. Access this screen by entering the D line
command next to a program on the Impacts - Programs screen (Figure 8-17 on page 8-17)
or the Impacted By - Programs screen (Figure 8-16 on page 8-16).
Analyzing Transaction Abends
8-19
Figure 8-19. Program Details Screen
Abend-AID ------------------ Program Details -------------------------------- 
COMMAND ===>


Program............... CWAAHOUR

Language.............. COBOL


Member................ CWAAHOUR

Source Lib............ AACICS.TEST.DEVENT.DATA

Source Timestamp......


Load Lib..............


DevEnterprise Information

ID..................... 5461

Distance............... 1

End Point.............. YES

Collected Timestamp.... 2009-02-09 11:26:38

Learn Status........... Complete

Learn Timestamp........ 2009-02-09 11:27:00



The above information was provided by the DevEnterprise Metadata Analyzer


Data Item Details Screen
The Data Item Details screen, shown in Figure 8-20, provides detailed information for a
selected data item. Note that the information shown is obtained from DevEnterprise
Metadata Analyzer. The modified date and time are the last modification for this entity
in DevEnterprise. Access this screen by entering the D line command next to a data item
on the Impacts - Data Items screen (Figure 8-17 on page 8-17) or the Impacted By - Data
Items screen (Figure 8-18 on page 8-18).
Figure 8-20. Data Item Details Screen
Abend-AID ----------------- Data Item Details ------------------------------- 
COMMAND ===>


Data Item.... EMPLOYEE-HDR1


Field Information

Picture Clause........ Group Item
Logical Length........

Data Type.............
Length................ 80

Initial Value.........


Source Information

Program............... CWAACOB
Occurs................

Include...............
Literal............... NO

File Line............. 210
Linkage Section....... NO

Source Line........... 210
Level Number.......... 1



DevEnterprise Information

ID................ 5575
Modified Date..... 2008-12-05

Distance.......... 0
Modified Time..... 08:56:58

End Point.........


8-20
Abend-AID for CICS User’s Guide
Impact Analysis Listing
The Impact Analysis Listing, shown in Figure 8-21, displays a list of all fields available for
DevEnterprise impact analysis. Access this screen by any of the following methods:
• Enter the S (Program Storage) line command next to a data item on the Impacts Data items screen, as described in “Impacts - Data Items Screen” on page 8-16
• Enter the S (Program Storage) line command next to a data item on the Impacted By
- Data items screen, as described in “Impacted By - Data Items Screen” on page 8-17.
• Enter the I (Impact Analysis) line command next to a program on the Program
Summary Information screen, as described in “Program Summary Information
Screen” on page 9-4.
Figure 8-21. Impact Analysis Listing
Abend-AID -------------- Impact Analysis Listing ------- Row 000001 of 000072
COMMAND ===>
SCROLL ===> PAGE
==>
Program..... CWAADATE
Server...... deventerprise.clients.your.site

I Impact Analysis
Source Line
DATA DIVISION.
WORKING-STORAGE SECTION.
01 DATE-TABLE
02 FILLER
02 FILLER
02 FILLER
02 FILLER
02 FILLER
02 FILLER
02 FILLER
02 FILLER
02 FILLER
02 FILLER
02 FILLER
02 FILLER
9(4)
9(4)
9(4)
9(4)
9(4)
9(4)
9(4)
9(4)
9(4)
9(4)
9(4)
9(4)
0131
0228
0331
0430
0531
0630
0731
0831
0930
1031
1130
1231 






















Enter the I (Impact Analysis) line command next to any field to view further analysis for
that field on the Impact Analysis Results screen, as described in “Impact Analysis Results
Screen” on page 8-13.
3270 Bridge Information Screen
The 3270 Bridge Information screen, shown in Figure 8-22, provides 3270 Bridge related
information about the abending task. Use the cursor point-and-shoot feature at the
highlighted fields to access specific storage information in hexadecimal or DSECT
formats.
Access the 3270 Bridge Information screen by using the cursor point-and-shoot feature
and pressing Enter at the Bridge field on the Task Detail screen for abending bridge
transactions.
Analyzing Transaction Abends
8-21
Figure 8-22. 3270 Bridge Information Screen
Abend-AID ---------------- 3270 Bridge
COMMAND ===> 


Original Transaction ID.. BRG2
Bridge Transaction ID.... BRG2
Bridge Program........... DFH0CBRE
TXN_CS Extension......... 0DA68030
BRXA Header.............. 0DA68090
BRXA Transaction Area.... 0DA680B8
BRXA Command Area........ 0DA68134
BRXA User Area........... 0DB00008
Calling Program..........
User ID.................. SPIKEER
User Abend Code.......... AEIL
Information ------------------------
Start Code...............
Trace Flag...............
Facilitylike Name........
Facilitylike Keep Time...
Facilitylike Type........
Screen Height............
Screen Width.............
Alternate Screen Height..
Alternate Screen Width...
Function Code............
Command Code.............
N
CBRF
}AAA
00
00
00
00
00
06 
Expanded Data Field Screen
The Expanded Data Field screen, shown in Figure 8-23, displays in vertical-hexadecimal
format the value in the selected field. Use the cursor point-and-shoot feature at the
address field to display the Memory Display screen, which is explained in “Using the
Memory Display Screen” on page 5-2.
Access the Expanded Data Field screen from the Diagnostic Summary by using the cursor
point-and-shoot feature and pressing Enter at any entry in the Value field of the COBOL
Information section or the Analysis of error section for PL/I programs. For a transaction
abend with DB2 information, use the cursor point-and-shoot feature and press Enter at
any entry in the Data field on the Host Variables screen. New with Release 11.2, Unicode
support displays the Program Code Page and the Terminal Code Page for the value in the
selected field.
Note:
The Storage Type field appears only for COBOL value fields, not PL/1 or
Assembler.
Figure 8-23. Expanded Data Field Screen
Abend-AID ---------------- Expanded Data Field --------- Row 000001 of 000004 
COMMAND ===>
SCROLL ===> PAGE 

Field Name... U2
9(7)
NAT

Storage Type. Working Storage
Program Code Page.. 1140

Program Name. CB6PGM07
Terminal Code Page. 37


3873CFDE Char
0 0 0 9 8 7 6

Hex
03030303030303

UTF-16 00000009080706

1...+...10....


DFHRPL Concatenation Screen
The DFHRPL Concatenation screen, shown in Figure 8-24 on page 8-22, displays the
datasets and their associated volsers for the DFHRPL statement defined to the CICS JCL at
the time of this transaction abend. Besides accessing the DFHRPL Concatenation screen
using the cursor point-and-shoot feature and pressing Enter on the Program Detail
screen, you can access this screen by entering DFHRPL as a fast-path command on any
Abend-AID for CICS screen.
8-22
Abend-AID for CICS User’s Guide
Figure 8-24. DFHRPL Concatenation Screen
Abend-AID ------------- DFHRPL Concatenation ----------- Row 000001 of 000026
COMMAND ===>
SCROLL ===> PAGE

Sequence Dataset Name
Volser
******** ******************************************** ******
0 EFHRHK0.R330.TABLIB
PRD915
1 CW.CC.IMS310.TABLIB
PRD907
2 SYS2.TMONCICS.V10ESA.LOADLIB
CICR1B
3 CICS330.SDFHAUTH
CICR1D
4 CICS330.SDFHLOAD
CICR1D
5 EFHRHK0.LOADRHK
PRD906
6 MP.BETA.FX.LOAD.FIX
PRD930
7 MP.BETA.FX.LOAD2
PRD929
8 MP.BETA.CX.LOAD
PRD927
9 SYS2.TD.LOAD
NCPR1A
10 SYS2.XPEDCICS.R650.CICS330.LOAD
CICR1A
11 SYS2.XPEDCICS.R650.HELP.LOAD
CICR1A
12 EFHKAT0.TEST.PGMLOAD
PRD915
13 CW.CC.TEST.PGMLOAD
PRD906
14 CW.CC.DEMO.PGMLOAD
PRD906
15 CW.CC.TESTLIB
PRD906
16 EFHJNW0.TEST.PGMLOAD
PRD905
17 PLI.V2R3M0.PLILINK
MVSR1B
18 PLI.V2R3M0.PLIBASE
MVSR1B
User Execute Interface Block Screen
The User Execute Interface Block screen, shown in Figure 8-25, provides the interpreted
value of the EXEC interface block fields.
Access the User Execute Interface Block screen by using the cursor point-and-shoot
feature and pressing Enter on the EIB field on the Diagnostic Summary or Task Detail
screen, or by entering EIBU as a fast-path command on any Abend-AID for CICS screen.
Figure 8-25. User Execute Interface Block Screen
Abend-AID --------- User Execute Interface Block --------- Row 000001 of 000031
COMMAND ===>
SCROLL ===> PAGE
==>
To display System EIB, select System 

Address of displayed User EIB.. 001010D0 

Name
Value
Interpretation
Description
************ ************ *************** *********************************
EIB TIME.... 07:03:21
TASK START TIME
EIB DATE.... 02FEB2002
TASK START DATE
EIB TRNID... AADM
TRANSACTION IDENTIFIER
EIB TASKN... 00038
TASK NUMBER
EIB TRMID... D492
TERMINAL IDENTIFIER
EIB RSVD1... 00
RESERVED
EIB CPOSN... 0006
CURSOR ADDRESS
EIB CALEN... 00000001
COMMUNICATION AREA LENGTH
EIB AID..... 7D
ENTER
ATTENTION IDENTIFIER
EIB FN...... 0402
RECEIVE
CODE OF THE LAST CICS EXEC
EIB RCODE... 00200000
RESPONSE CODE FROM LAST CICS EXEC
EIB DS......
LAST FILE REQUEST
EIB REQID... 00
REQUEST IDENTIFIER FOR INTERVAL CON
EIB RSRCE... D492
RESOURCE ACCESSED BY LAST CICS EXEC
EIB SYNC.... 00
X’FF’ SYNCPOINT REQUESTED
Use the cursor point-and-shoot feature on the User Execute Interface Block screen to do
the following:
• Press Enter at the System field to toggle between the User Execute Interface Block
screen and the System Execute Interface Block screen.
Analyzing Transaction Abends
8-23
• Press the HEXD PF key at the user EIB address field to display the control block in
hexadecimal format.
• Press the DSECT PF key at the user EIB address field to display the control block in
DSECT format.
Last 3270 Screen Image
The Last 3270 Screen Image, shown in Figure 8-26, displays the last screen image for the
abending transaction. Besides accessing the Last 3270 Screen Image using the cursor
point-and-shoot feature and pressing Enter on the Diagnostic Summary, Task Detail, or
Terminal Detail screens, you can access this screen directly from the Last 3270 Menu or
by entering SCREEN as a fast-path command on any Abend-AID for CICS screen.
Figure 8-26. Last 3270 Screen Image
AADM 00001 - ENTER EMPLOYEE NUMBER

*** COMPUWARE CORPORATION ***
DEMONSTRATION TRANSACTION 

ENTER DESIRED EMPLOYEE ABOVE:
00001 - CAUSES ASRA ABEND
00002 - CAUSES AEIM
00003 - CAUSES AEIP
00004 - CEE OUT-OF-STORAGE
00005 - ##################
00999 - ENDS NORMALLY 
Note:

If the L3270 mnemonic identifier for the Last 3270 Screen is displayed in a
different color than the other menu options and is preceded by an asterisk (*) on
the Primary Options menu, the last 3270 screen was not captured. Entering
SCREEN as a fast-path command displays a message that explains why the last
3270 screen is not available.
Data Stream Analysis Screen
The Data Stream Analysis screen, shown in Figure 8-27, displays the last 3270 screen
fields for the abending transaction, showing the order of each field and data stream in
the buffer. In addition, this screen displays the I/O command and the write control
character, if available, and identifies any errors in the data stream. Besides accessing the
Data Stream Analysis screen using the cursor point-and-shoot feature and pressing Enter
on the Diagnostic Summary or Terminal Detail screens, you can access this screen
directly from the Last 3270 Menu or by entering DATASTRM as a fast-path command on
any Abend-AID for CICS screen.
8-24
Abend-AID for CICS User’s Guide
Figure 8-27. Data Stream Analysis Screen
Abend-AID ------------- Data Stream Analysis ------------- Row 000001 of 000055
COMMAND ===>
SCROLL ===> PAGE
==>
Screen Size............... 24 x 80
Cursor Position... Row 01 Column 07
Last 3270 Buffer Address... 08A891AF
To display the Last 3270 screen image, select Image 

Row Column Length Control Orders/Attributes
Data
01 01
05
Start Field Extended PROT
AADM
Numeric 

01 06
06
Start Field Extended UNPROT
00001
Numeric 

01 12
69
Start Field Extended PROT
- ENTER EMPLOYEE NUMBER
Numeric 

02 01
80 

03 01
80
*** COMPUWARE CORPOR 

04 01
80
DEMONSTRATION TRAN 
Program Call Trace Summary Screen
The Program Call Trace Summary screen, shown in Figure 8-28 on page 8-25, displays the
information for every known call that we identify for CICS Transaction Dumps,
including EXEC CICS, MVS CALL, and assembler calls that use standard MVS linkage,
including to/from IBM modules, and internal calls for Assembler, COBOL, and PL/I
procedures. The sequence is in calling order. In addition, each entry includes the calling
load module and program or procedure name, return type and value (displacement and
value, statement number and value), the call type (links to calls, and EXEC CICS LINK),
and the called load module and program or procedure name. An asterisk will mark the
abending program.
Note:
Because the calling program and called program fields are limited to 12 bytes,
names longer than that will be truncated to 11 bytes with trailing plus sign (+).
To get the long PL/I procedure name in full, you can tab to PROGRAM_PAR+, and
press Enter on the value. Or you can configure your session parameters to use a
132-column display to view the columns in full.
Besides accessing the Program Call Trace Summary screen using the cursor point-andshoot feature and pressing Enter on the Diagnostic Summary screen, you can access this
screen directly by entering CALLTRAC as a fast-path command on any Abend-AID for
CICS screen, or by selecting option 3, CALLTRAC from the Program Information menu.
From the calling program or called program fields you will be able to navigate to the
existing Program Detail screen. The Program Detail screen includes the long name if
known. If the return type is a client program, you can select the value which takes you to
that statement in the program listing.
Analyzing Transaction Abends
8-25
Figure 8-28. Program Call Trace Summary Screen
Abend-AID ------------- Program Call Trace Summary ---- Row 000055 of 000069
COMMAND ===>
SCROLL ===> CSR 

*******Calling******* ****Return****
*******Called******** Error
Load-Mod Program
Type
Value
Program
Load-Mod pgm
PL6PGM49 PROGRAM_PAR+ Line 000155
Calls
PROGRAM_PAR+ PL6PGM49
PL6PGM49 PROGRAM_PAR+ Line 000169
Calls
PROGRAM_PAR+ PL6PGM49
PL6PGM49 PROGRAM_PAR+ Line 000183
Calls
PROGRAM_PAR+ PL6PGM49
PL6PGM49 PROGRAM_PAR+ Line 000199
Calls
PROGRAM_PAR+ PL6PGM49
PL6PGM49 PROGRAM_PAR+ Line 000141
Calls
PROGRAM_PAR+ PL6PGM49
PL6PGM49 PROGRAM_PAR+ Line 000155
Calls
PROGRAM_PAR+ PL6PGM49
PL6PGM49 PROGRAM_PAR+ Line 000169
Calls
PROGRAM_PAR+ PL6PGM49
PL6PGM49 PROGRAM_PAR+ Line 000183
Calls
PROGRAM_PAR+ PL6PGM49
PL6PGM49 PROGRAM_PAR+ Line 000200
Calls
PROGRAM_PAR+ PL6PGM49
PL6PGM49 PROGRAM_PAR+ Line 001269
Calls
PROGRAM_DO_+ PL6PGM49
PL6PGM49 PROGRAM_DO_+ Line 001284
Calls
PROGRAM_DO_+ PL6PGM49 ***
CEEPLPKA CEEBPRTO
Disp 0000104C Calls
CEEHPCQD
CEEPLPKA
CEEPLPKA CEEHPCQD
Disp 00000FC6 Calls
CEEOEXRO
CEEPLPKA
CEEPLPKA CEEOEXRO
Disp 00004A02 Calls
CEEMQFBC
CEEPLPKA
CEEPLPKA CEEMQFBC
Disp 00000104 Calls
N/A
***************************** BOTTOM OF DATA *******************************




















PSW Information Screen
The PSW Information screen, shown in Figure 8-29, provides information about the
program status word (PSW) and the next sequential instruction. Besides accessing the
PSW Information screen using the cursor point-and-shoot feature and pressing Enter on
the Diagnostic Summary or Task Detail screens, you can access this screen by entering
PSW as a fast-path command on any Abend-AID for CICS screen.
Figure 8-29. PSW Information Screen

Abend-AID --------------- PSW Information ------------ Row 000001 of 000018
COMMAND ===>
SCROLL ===> PAGE 

To display Registers at abend, select REGS 

Program Status Word at Time of Abend
Program Information 

PSW................. 078D1000 88A2FE0C
Instruction Length.. 0006
Program..CCAADEMO
Interrupt Code...... 0007
Offset...00000D78
BEAR ............... 00000000_00083A68

Description......... Multiply Decimal 
Address
Instruction
Opcode D1(L1,B1),D2(L2,B2)
08A2FE06 FC42 D1C8 D1D0
MP
456(5,13),464(3,13) 

The first operand was located at address 08A321F8 and contained - 

000000CC CF
*
..
* 

The second operand was located at address 08A32200 and contained - 

00950F
* n. * 
Use the cursor point-and-shoot feature to do the following:
• Press Enter at the first word of the PSW to display the PSW Analysis screen, which is
explained in “PSW Analysis Screen” on page 8-26.
8-26
Abend-AID for CICS User’s Guide
• Press Enter at the second word of the PSW, at the program offset, and at the address
of the abending instruction to display the Storage Disassembly screen for these field,
which is explained in “Storage Disassembly Screen” on page 9-21.
• Press Enter at the Breaking Event Address Register (BEAR) field to display the address
of the last branch taken by this task prior to the abend in hexadecimal format on the
Memory Display, which is explained in “Using the Memory Display Screen” on page
5-2.
• Press Enter at the Program field to display the Program Detail screen, which is
explained in “Program Detail Screen” on page 8-6.
• Press the HEXD PF key at any address field to display the Memory Display screen,
which is explained in “Using the Memory Display Screen” on page 5-2.
• Press Enter at the REGS field to access the registers at the time of the abend.
PSW Analysis Screen
The PSW Analysis screen, shown in Figure 8-30, provides additional information about
the program status word (PSW). Access the PSW Analysis screen by using the cursor
point-and-shoot feature and pressing Enter at the first word of the PSW on the PSW
Information screen.
Figure 8-30. PSW Analysis Screen
Abend-AID ----------------------- PSW Analysis -----------------------------
COMMAND ===> 

PSW................... 078D1000 88A2FE0C Addressing Mode............ 31-BIT
Instruction Address... 08A2FE0C 

Program-Event Recording Mask..... OFF
Program Masks:
Dynamic Address Translation Mode. ON
Fixed-Point Overflow....... OFF
Input/Output Mask................ ON
Decimal Overflow........... OFF
External Mask.................... ON
Exponent Underflow......... OFF
PSW Key.......................... 8
Significance............... OFF
Machine Check Mask............... ON
Wait State....................... OFF
Condition Code................... 1
Address Space Control............ PRIMARY-SPACE
State............................ PROBLEM 
At the Instruction Address field, use the cursor point-and-shoot feature and:
• Press the HEXD PF key to display the Memory Display screen, which is explained in
“Using the Memory Display Screen” on page 5-2.
• Press Enter to display the Storage Disassembly screen, which is explained in “Storage
Disassembly Screen” on page 9-21.
Registers Screen
The Registers screen, shown in Figure 8-31 on page 8-27, provides the values of the
registers for the abending transaction.
Besides accessing the Registers screen using the cursor point-and-shoot feature and
pressing Enter on the Diagnostic Summary or Task Detail screens, you can access this
screen by entering REGS as a fast-path command on any Abend-AID for CICS screen.
Analyzing Transaction Abends
8-27
Figure 8-31. Registers Screen
Compuware Abend-AID ----------- Registers --------------------------------
COMMAND ===> 

To display the PSW at abend, select PSW For Floating Pt Regs, select FLOAT

Registers at abend: 

R00 08A32184 is within a CICS31 storage area
at offset 00000184
R01 08A321F8 is within a CICS31 storage area
at offset 000001F8
R02 30A322B0
R03 08A2FB92 is within module CCAADEMO
at offset 00000B4A
R04 08A2F09C is within module CCAADEMO
at offset 00000054
R05 00000000
R06 0000000C
R07 08308018
R08 0013C0C4 is within a USER24 storage area
at offset 000000C4
R09 08A2F100 is within module CCAADEMO
at offset 000000B8
R10 08A32250 is within a CICS31 storage area
at offset 00000250
R11 08A2F7C8 is within module CCAADEMO
at offset 00000780
R12 08A2F0C8 is within module CCAADEMO
at offset 00000080
R13 08A32030 is within a CICS31 storage area
at offset 00000030
R14 88A2FD0E is within module CCAADEMO
at offset 00000CC6
R15 00000000
Use the cursor point-and-shoot feature and press the HEXD PF key at any register address
to display the value in hexadecimal format on the Memory Display screen, which is
explained in “Using the Memory Display Screen” on page 5-2.
To display the PSW at the time of the abend, use the cursor point-and-shoot feature and
press Enter at the PSW field to access the PSW Information screen (Figure 8-29 on page
8-25). To display the Floating-Point Registers, use the cursor point-and-shoot feature and
press Enter at the FLOAT field to access the Floating-Point Registers screen (Figure 8-32).
Floating-Point Registers Screen
The Floating-Point Registers screen, shown in Figure 8-32, provides the values of the
floating-point registers for the transaction at the time of the abend. To access this screen,
enter the FLOAT fast-path command from any Abend-AID for CICS transaction report
screen.
Figure 8-32. Floating-Point Registers Screen
Compuware Abend-AID ---- Floating-Point Registers --------------------------- 
COMMAND ===>


To display Registers at abend, select REGS

To display Interpreted Floating-Point Registers, select Interpretation


Floating-Point Registers at abend:

FPR 0 00000000_00000000

FPR 1 41100000_00000000

FPR 2 71FFFFFF_FFFFFFFF

FPR 3 44303900_00000000

FPR 4 C4303900_00000000

FPR 5 483ADE68_9C000000

FPR 6 C83ADE68_9C000000

FPR 7 45A2C2A9_99999999

FPR 8 7FFFFFFF_FFFFFFFF

FPR 9 00000000_00000000

FPR10 7FFFFFFF_FFFFFFFF

FPR11 00000000_00000000

FPR12 7FFFFFFF_FFFFFFFF

FPR13 00000000_00000000

FPR14 7FFFFFFF_FFFFFFFF

FPR15 7FFFFFFF_FFFFFFFF
8-28
Abend-AID for CICS User’s Guide
To display Registers at the time of the abend, use the cursor point-and-shoot feature and
press Enter at the REGS field to access the Registers screen (Figure 8-31 on page 8-27). To
display Interpreted Floating-Point Registers, use the cursor point-and-shoot feature and
press Enter at the Interpretation field to access the Floating Point Interpretation screen
(Figure 8-31 on page 8-27).
Floating Point Interpretation Screen
The Floating Point Interpretation screen, shown in Figure 8-33, displays the content of
the 16 floating point registers, along with the value they represent. This screen shows the
interpretation based on one of the following types and formats:
• Decimal Floating Point long format
• Binary Floating Point long format
• Hexadecimal Floating Point long format
Figure 8-33. Floating Point Interpretation Screen
Compuware Abend-AID - Floating Point Interpretation ---- Row 000001 of 000008 
COMMAND ===>
SCROLL ===> PAGE 

Interpretation based on Long Decimal Floating-Point

Change to Decimal
Short
Long
Extended

Change to Binary
Short
Long
Extended

Change to Hexadecimal Short
Long
Extended


FPR 0 content: 00000000_00000000
FPR 8: 7FFFFFFF_FFFFFFFF

value:
ZERO
SNAN


FPR 1 content: 41100000_00000000
FPR 9: 00000000_00000000

value:
ZERO
ZERO


FPR 2 content: 71FFFFFF_FFFFFFFF
FPR10: 7FFFFFFF_FFFFFFFF

value: +8.999999999999999x10~255
SNAN


FPR 3 content: 44303900_00000000
FPR11: 00000000_00000000

value: +1.039x10~140
ZERO


FPR 4 content: C4303900_00000000
FPR12: 7FFFFFFF_FFFFFFFF

value: -1.039x10~140
SNAN


In the long format the entire 64 bits of the register represent a floating point number.
Use the cursor point-and-shoot feature and press Enter at the Short, Long, or Extended
fields to display the alternate types and formats. An attempt is made to interpret the
content of all floating point registers based on the requested combination of type (DFP,
BFP, HFP) and format (short, long, extended), but the result is accurate only if the
floating point register was being used in that manner. For example, if a floating point
register is being used in the extended mode, then the wrong interpretation will be shown
if it is displayed in short or long. Similarly, if a floating point register is being used as a
decimal FP, then a binary or Hexadecimal interpretation will not yield the correct result.
It is not possible to determine the type or format by examining the content as most
content is valid for all combinations but just represents a different value in each
combination.
Transaction Abend Control Blocks Screen
The Transaction Abend Control Blocks screen (Figure 8-34) presents control block
information associated with the abending transaction.
Analyzing Transaction Abends
8-29
Access this screen in one of the following ways:
• Use the cursor point-and-shoot feature and press Enter on the TACB field located at
the bottom of the Diagnostic Summary or the Task Detail screen.
• Use the TACB fast-path command.
Figure 8-34. Transaction Abend Control Blocks Screen
Abend-AID ---------- Transaction Abend Control Blocks -- Row 000001 of 000001 
COMMAND ===>
SCROLL ===> PAGE 

R Registers


TACB
Abend

TACB
Address
Code
Program
PSW
BEAR

****** ******** ****** ******** ******** ******** ***************** 
TACB01 37ED1008 ASRA
CCAADEMA 078D2000 B8F00236 00000000_00083A68

***************************** BOTTOM OF DATA ********************************
To access the values of the registers at the time of the abend, type the R (Registers) line
command next to the TACB of interest and press Enter. See “Registers Screen” on page
8-26.
Use the cursor point-and-shoot feature and press Enter on the:
• TACB Address field to access the Memory Display screen or the DSECT Support
screen. See “Using the Memory Display Screen” on page 5-2 or “Displaying Control
Blocks in DSECT Format” on page 6-1.
• Abend Code field to access the IBM Message Text screen that explains the abend code
and provides information to help you resolve the issue.
• Program field to access the Program Detail screen. See “Program Detail Screen” on
page 8-6.
• PSW fields to access the PSW Analysis screen or the Storage Disassembly screen. See
“PSW Analysis Screen” on page 8-26 or “Storage Disassembly Screen” on page 9-21.
• Breaking Event Address Register (BEAR) field to display the address of the last branch
taken by this task prior to the abend in hexadecimal format on the Memory Display,
which is explained in “Using the Memory Display Screen” on page 5-2.
DB2 Information Screens
This section describes the following DB2 information screens:
•
•
•
•
•
•
•
•
“DB2 Information Menu” on page 8-29
“Host Variables Screen” on page 8-30
“Bind Information Screen” on page 8-31
“Precompile Information Screen” on page 8-32
“Columns Referenced Screen” on page 8-32
“Package Dependencies Screen” on page 8-32
“SQL Communications Area” on page 8-33
“RCT Detail Screen” on page 8-33
DB2 Information Menu
The DB2 Information menu, shown in Figure 8-35, lets you display additional DB2
information about the abending transaction if your site is licensed for, and has installed,
the Abend-AID for CICS DB2 extra-cost option. After you select a transaction abend with
DB2 information, you can access this screen from the Diagnostic Summary, or any
Abend-AID for CICS screen, by entering DB2 as a fast-path command.
8-30
Abend-AID for CICS User’s Guide
If you are using an ISPF environment, you can link to File-AID for DB2 by selecting
Option 9, File-AID DB2 (ISPF Only) from the Abend-AID for CICS DB2 Information
menu.
Additional information and/or warning messages may appear at the top of the DB2
Information Menu screen, just below the Command line. This is to provide additional
information or warning messages regarding problems that may have occurred during
dump capture. To access this information from the DB2 Information screen, tab to the
item and press PF1. This will provide a pop-up window displaying the information.
Figure 8-35. DB2 Information Menu
Abend-AID ------------------ DB2 Information -------------------------------
COMMAND ===> 
DB2DC0052I No plan information found in the DB2 catalog
DB2 Release....... 8.1.0
Subsystem ID..... D849 
Authorization ID.. CICSUSER
Attach Mode...... CICS 



1 DIAG
Diagnostic Summary
5 COLSREF Columns Referenced 

2 HOSTVAR Host Variables
6 DEPN
Dependencies 

3 BIND
Bind Information
7 SQLCA
SQL Communications Area 

4 PRECOMP Precompile Information
8 RCT
RCT Detail 

9 FDB2
File-AID DB2 (ISPF Only)
After you select Option 9, File-AID DB2 (ISPF Only), you are provided access to the FileAID DB2 Information screen via the File-AID DB2 product interface. You can select Edit
or Browse for the list of items shown by placing your cursor next to the item, typing E or
B, and pressing Enter. Press PF3 (End) to return to the File-AID DB2 Information screen.
Figure 8-36. File-AID DB2 Information Screen
Abend-AID --------------- File-AID DB2 Information -------Row 000001 of 000001
COMMAND ===> 

SSID....... D801


B Browse
E Edit 

Creator ID Table/View Name
Location
********** ****************** *************
QADBA
TEMPL
**************************** BOTTOM OF DATA ********************************
Host Variables Screen
The Host Variables screen, shown in Figure 8-37, displays information about the host
variable(s) referenced in the SQL statement for the abending transaction. Press the
RIGHT PF key to scroll to the right side of the report.
After selecting a transaction abend with DB2 information, you can access the Host
Variables screen from the DB2 Information menu or by entering HOSTVAR as a fast-path
command.
Analyzing Transaction Abends
8-31
Figure 8-37. Host Variables Screen





Host Variable Name
Type
Data

******************************** *************************** ****************
:WS-FIELDS.WS-SSN
DECIMAL(009,000)
111,111,111

:WS-FIELDS.WS-NAME
CHAR(024)
RON RAY GUNN

:WS-FIELDS.WS-ACCOUNT
DECIMAL(005,000)
0

:WS-FIELDS.WS-DATE
CHAR(010)
A/EN/196

:WS-FIELDS.WS-HOUR
DECIMAL(003,001)
0

:WS-FIELDS.WS-PRODUCT
CHAR(024)
SPACES

:WS-FIELDS.WS-ACTION
CHAR(024)
SPACES

****************************** BOTTOM OF DATA *********************************








To display hex AND character, tab to variable data and press Enter
Abend-AID ------------------- Host Variables ----------- Row 000001 of 000007
COMMAND ===>
SCROLL ===> PAGE
==>
Host variables referenced:
Use the cursor point-and-shoot feature and press Enter at any entry in the Data field to
access the record key and record data in vertical-hexadecimal format. Abend-AID for
CICS displays the Expanded Data Field screen, which is described in “Expanded Data
Field Screen” on page 8-21.
Bind Information Screen
The Bind Information screen, shown in Figure 8-38, displays the package and plan bind
information for the abending program. After you select a transaction abend with DB2
information, you can access the Bind Information screen from the DB2 Information
menu or by entering BIND as a fast-path command on any Abend-AID for CICS screen.
Figure 8-38. Bind Information Variables Screen

Abend-AID --------------------- Bind Information -----------------------------
COMMAND ===> 

Package Bind Information
Plan Bind Information 
Location.......
Collection ID..
Name...........
Qualifier......
Owner..........
Creator........
Create Date....
Create Time....
Pkg Bind Date..
Pkg Bind Time..
Pkg Isolation..
Pkg Validate...
Pkg Release....
SQL Error......
Valid Package..
Operative......
Current Data...
DEFAULT
AACVCOL
DSCV6100
CWXAAD2
CWXAAD2
CWXAAD2
13FEB2006
11:07:58.32
13FEB2006
11:36:37.41
CURSOR STABILITY
BIND
COMMIT
NOPACKAGE
YES
YES
NO 
Application Plan Name..
Plan Bind Date.........
Plan Bind Time.........
Valid Plan.............
Plan Isolation Level...
Plan Acquire...........
Plan Release...........
Plan Validate..........
DSC6100P
13FEB2006
11:36:39.66 
YES
CURSOR STABILITY
USE
COMMIT
BIND
8-32
Abend-AID for CICS User’s Guide
Precompile Information Screen
The Precompile Information screen, shown in Figure 8-39, displays information related
to the options specified at the precompile for the abending program. After you select a
transaction abend with DB2 information, you can access the Precompile Information
screen from the DB2 Information menu or by entering PRECOMP as a fast-path
command.
Figure 8-39. Precompile Information Screen

Abend-AID ----------------- Precompile Information: --------------------------
COMMAND ===> 

DBRM Name.............. DSCVSELS
Date................... 13FEB2009
Time................... 11:35:37.65
Version................ N/A
Release................ 8.1.0 
Host Language..........
DEC31..................
SQL Escape.............
SQL Decimal............
Mixed Data.............
Katakana...............

Library Name...........
COBOL FOR Z/OS 3.2
NO
’ (APOSTSQL)
. (PERIOD)
NO
NO 
CW.D2.SAMPLES.V8R1M0.DBRM

Columns Referenced Screen
The Columns Referenced Screen, shown in Figure 8-40, displays information about the
columns referenced in the DB2 request for the abending transaction. After you select a
transaction abend with DB2 information, you can access the Columns Referenced screen
from the DB2 Information menu or by entering COLSREF as a fast-path command.
Figure 8-40. Columns Referenced Screen
Abend-AID -------------- Columns Referenced ------------- Row 000001 of 000002
COMMAND ===>
SCROLL ===> CSR 

Column Name
Table Name
Type
****************** ****************** **************************
EMP_SSN
EMP
DECIMAL(009,000)
EMP_NAME
EMP
VARCHAR(00025)
******************************* BOTTOM OF DATA ********************************

Package Dependencies Screen
The Package Dependencies screen, shown in Figure 8-41 on page 8-33, displays
information about the plan or package dependencies for the abending transaction. After
you select a transaction abend with DB2 information, you can access the Package
Dependencies screen from the DB2 Information menu or by entering DEPN as a fast-path
command.
Analyzing Transaction Abends
8-33
Figure 8-41. Package Dependencies Screen
Abend-AID ------------- Package Dependencies ------------ Row 000001 of 000008
COMMAND ===>
SCROLL ===> CSR 

Object Qualifier
Object Name
Object Type
******************
********************
***************
CWXAAD2
VTIME
VIEW
CWXAAD2
TIME
TABLE
CWAD2V2G
CWAAD2TS
TABLE SPACE
CWXAAD2
EMP
TABLE
CWXAAD2
DESC
TABLE
CWXAAD2
XTIME
INDEX
CWX0070
XEMP
INDEX
CWXAAD2
XDESC
INDEX
******************************* BOTTOM OF DATA ********************************
SQL Communications Area
The SQL Communications Area screen, shown in Figure 8-42, displays SQL error
information for the abending transaction.
Access this screen from the DB2 Information menu or by issuing the SQLCA fast-path
command.
Figure 8-42. SQL Communications Area Screen
Abend-AID -------------- SQL Communications Area ---- Row 000001 of 000024
COMMAND ===>
SCROLL ===> PAGE

Address of displayed DB2 SQL Communication Area... 363862A0


Name
Value
Description

******** ************************* **************************************
SQLCAID
SQLCA
Eye Catcher

SQLCABC
136
X'00000088'
Length

SQLCODE
-501
X'FFFFFE0B'
SQL Code

SQLERRML 0
X'0000'
Error Message Length

SQLERRMC
Error Message Token(s)

SQLERRP
DSNXERT
Module Detecting Error

SQLERRD1 -240
X'FFFFFF10'
Rows in Result or Internal Code

SQLERRD2 0
X'00000000'
Rows Processed or Internal Code

SQLERRD3 0
X'00000000'
Rows Affected by INSERT/UPDATE

SQLERRD4 -1
X'FFFFFFFF'
Resource Requirement Estimate

SQLERRD5 0
X'00000000'
Position of Syntax Error

SQLERRD6 0
X'00000000'
Internal Error Code

SQLWARN0
X'40'
Warning Summary Flag

SQLWARN1
X'40'
Char Data Truncation/Cursor Scrolling
SQLWARN2
X'40'
Null Values Eliminated

SQLWARN3
X'40'
Mismatched Host Variable Number

SQLWARN4
X'40'
Missing WHERE/Cursor Sensitivity

Use the cursor point-and-shoot feature and press Enter at the Error Message Address field
to display the storage information in hexadecimal format. Abend-AID for CICS displays
the Memory Display screen, which is explained in “Using the Memory Display Screen”
on page 5-2.
RCT Detail Screen
The RCT Detail screen, shown in Figure 8-43, displays the Resource Control Table (RCT)
information for the abending transaction. Use the cursor point-and-shoot feature and
press Enter at the Transaction ID field to display the Task Detail screen, which is
explained in “Task Detail Screen” on page 8-70. Use the cursor point-and-shoot feature
and press the HEXD PF key at the RCT Table Address and RCT Entry Address fields to
display storage information in hexadecimal format. Abend-AID for CICS displays the
8-34
Abend-AID for CICS User’s Guide
Memory Display screen, which is explained in “Using the Memory Display Screen” on
page 5-2. After you select a transaction abend with DB2 information, you can access the
RCT Detail screen from the DB2 Information menu or by entering RCTD as a fast-path
command on any Abend-AID for CICS screen.
Figure 8-43. RCT Detail Screen
Abend-AID ------------------------ RCT Detail --------------------------------
COMMAND ===> 

Resource Control Table
RCT Suffix........... N
RCT Table Address........ 00544840
Transaction ID....... X302
RCT Entry Address........ 00545970
Plan Name............ DSC5100P
Authorization ID..... CWXAAD2
Authorization(1).....
Authorization(2).....
Authorization(3)..... 

Thread Counts
Maximum Number of Threads.... 0001
Number of Active Threads..... 0000
Number of Authorizations..... 00000
Number of Calls.............. 2
Number of Commits............ 0
Number of Aborts............. 0
Number of Thread Waits....... 1
Highest Number of Threads.... 0001
Current Number of Threads.... 0001
Thread ID.................... PT00 
WebSphere MQ Information Screens
If your site is licensed to use the Abend-AID for WebSphere MQ option, you can access
detailed WebSphere MQ information related to the MQ CICS transaction that caused the
dump.
Note:
A dump occurs automatically if the CICS transaction abends. However, if the
WebSphere MQ transaction returns a non-zero return or reason code, but the
CICS transaction does not abend, Abend-AID for CICS does not generate a dump
and processing continues. You can add EXEC CICS statements to your program
to generate a dump for non-zero return or reason codes. See Appendix B, “NonError Condition Transaction Dumps”for more information.
This section describes the following MQ Information screens:
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
“WebSphere MQ Information Menu” on page 8-35
“WebSphere MQ Reason Code Screen” on page 8-35
“Last WebSphere MQ Call Information Screen” on page 8-36
“Handle Information Screen” on page 8-37
“Message Descriptor Screens” on page 8-38
“PMO Detail Screen” on page 8-39
“Message Buffer Area Screen” on page 8-40
“Local Queue Definition Screens” on page 8-40
“Open Options Screen” on page 8-41
“PMO Options Screen” on page 8-42
“Report Options Screen” on page 8-43
“Report Options Screen” on page 8-43
“Match Options Screen” on page 8-44
“Alias Queue Definition Screen” on page 8-44
“GMO Options Screen” on page 8-45
“Opened Queues at Dump Time Screen” on page 8-46
“WebSphere MQ System Information Screen” on page 8-46
Analyzing Transaction Abends
8-35
Abend-AID for CICS also provides information to help you diagnose WebSphere MQ
queue manager region abends. See Chapter 18, “Analyzing WebSphere MQ Queue
Manager Dumps”.
WebSphere MQ Information Menu
Access WebSphere MQ information relevant to the abended transaction through the
WebSphere MQ Information Menu (Figure 8-44). Display the menu in one of the
following ways:
• From the Abend-AID Directory, enter the M line command next to the report of
interest. Then select the MQINFO option from the Primary Options menu.
• From the Diagnostic Summary, use the cursor point-and-shoot feature and press
Enter on the MQINFO field, which is located under the Supporting Information
section.
• Use the MQINFO fast-path command from any screen within the selected report.
Figure 8-44. WebSphere MQ Information Menu
Abend-AID -------------- WebSphere MQ Information --------------------------- 
COMMAND ===>


QMgr Name...... M600
Authorization ID.... CICSUSR _ 
QMgr Release... 6.0.0
Connection Type..... CICS


1 MQDIAG WebSphere MQ Diagnostic Information

2 MQCALL Last WebSphere MQ Call Information


3 MQOPEN Task's Opened Queues at Dump Time


4 MQSYS WebSphere MQ System Information

On the Command line, enter one of the following option numbers or use the cursor
point-and-shoot feature and press Enter at the associated mneumonic:
• 1 MQDIAG: Displays diagnostic information for the WebSphere MQ reason code. See
“WebSphere MQ Reason Code Screen” on page 8-35.
• 2 MQCALL: Displays detailed information about the last WebSphere MQ call issued
by the CICS transaction. See “Last WebSphere MQ Call Information Screen” on page
8-36.
• 3 MQOPEN: Displays all WebSphere queues that were open to the CICS transaction
at the time of transaction abend or dump. See “Opened Queues at Dump Time
Screen” on page 8-46.
• 4 MQSYS: Displays WebSphere MQ system-related information. See “WebSphere MQ
System Information Screen” on page 8-46.
WebSphere MQ Reason Code Screen
The WebSphere MQ Reason Code screen, shown in Figure 8-45 and Figure 8-46 on page
8-36, displays diagnostic information for the WebSphere MQ API reason codes. Access
this screen from the WebSphere MQ Information menu (Figure 8-44) or from the Reason
field on the Last WebSphere MQ Call Info screen (Figure 8-47 on page 8-37).
8-36
Abend-AID for CICS User’s Guide
Figure 8-45. WebSphere MQ 2003 Reason Code Screen, Page 1
Abend-AID ----------- WebSphere MQ 2033 Reason Code ---- Row 000001 of 000036 
COMMAND ===>
SCROLL ===> PAGE 

MQ Reason Code 2033 Diagnostic:


The MQGET call resulted in completion code 2 and reason code 2033

(MQRC_NO_MSG_AVAILABLE). The queue manager was unable to find a message in

the queue to satisfy the MQGET request.


The number of messages in the FX.QALIAS.A01 queue was 1, as obtained from

the Current Queue Depth attribute of the queue.


No message in the queue meets the selection criteria specified for the MQGET

call. The following match option conditions must be met for the MQGET

request to retrieve a message from the queue:

Field
Value

MQGMO_MSGTOKEN
1234


Other items to consider:


- The condition may be expected (i.e. the end of the queue has been

reached).

- An application may not have successfully added (PUT) a message in the

queue. 
Figure 8-46. WebSphere MQ 2033 Reason Code Screen, Page 2
Abend-AID ----------- WebSphere MQ 2033 Reason Code ---- Row 000022 of 000036 
COMMAND ===>
SCROLL ===> PAGE 

- Another application may have already retrieved the message.

- The application adding messages to the queue may not have committed them.

- The desired message may have passed its expiry time.

- The message may have been defined as non-persistent and the queue manager

has been restarted.

- On busy systems, it's possible the first message can be retrieved but

subsequent messages are delayed.


Note:


The value of current queue depth changes as the queue manager updates the

queue. Its value at the time of the 2033 occurrence may have changed prior

to Abend_AID being invoked to gather the Websphere MQ information. Even

though the current queue depth is greater than zero, it may have been zero

at the time of the MQGET call.




Last WebSphere MQ Call Information Screen
The Last WebSphere MQ Call Info screen presents information from the last WebSphere
MQ API call issued by the CICS application. The fields presented on this screen depend
upon the type of call being reported. Figure 8-47 on page 8-37 shows the fields that are
displayed for an MQPUT.
To access this screen, select option 2 MQCALL from the WebSphere MQ Information
Menu (Figure 8-44) or use the MQCALL fast-path command from any screen within the
selected report.
Analyzing Transaction Abends
8-37
Figure 8-47. Last WebSphere MQ Call Info Screen
Abend-AID ------------ Last WebSphere MQ Call Info -------------------------- 
COMMAND ===>


CALL 'MQPUT' USING

Hconn............ 00000000

Hobj............. 00000001

MsgDesc.......... 37F191D0

PutMsgOpts....... 37F193A8

BufferLength..... 0001869F
Decimal... 99,999

Buffer........... 37F1AAF0

CompCode......... 2
MQCC_FAILED

Reason........... 2030
MQRC_MSG_TOO_BIG_FOR_Q




Expanded Call Information


QMgr Name.............. M600

Queue Used in Call..... CF.TEST.M210.QUEUE01.RCV

Open Options........... 00000010

Put Options............ 00000000

Use the cursor point-and-shoot feature and press Enter to access additional information
for the selectable fields. For an MQPUT, the following fields are selectable:
• Hobj: Presents the Handle Information screen, as described on page 8-37.
• MsgDesc: Presents the Message Description screens, as described on page 8-38.
• PutMsgOpts: Presents the PMO Detail screen, as described on page 8-39. When
you’re looking at an MQGET, this field’s label is GetMsgOpts, which presents the
GMO Detail screen, as described on page 8-43.
• Buffer: Presents the Message Buffer Area screen, as described on page 8-40.
• Reason: Presents the WebSphere MQ Reason Code Text screen, as described on page
8-35.
• Queue Used in Call: Presents the Local Queue Definition screens, as described on
page 8-40, or the Alias Queue Definition screen, as described on page 8-44.
• Open Options: Presents the Open Options screen, as described on page 8-41.
• Put Options: Presents the PMO Options screen, as described on page 8-42. When
you’re looking at an MQGET, this field’s label is Get Options, which presents the
GMO Options screen, as described on page 8-45.
Handle Information Screen
The Handle Information screen (Figure 8-48 on page 8-38) displays object handle
information for the selected queue.
Access this screen in one of the following ways:
• Use the cursor point-and-shoot feature and press Enter on the Hobj field on the Last
WebSphere MQ Call Info screen (Figure 8-47 on page 8-37). This displays the handle
information from the queue used in the last MQ call prior to the dump.
• Enter the H line command next to the desired handle on the Opened Queues at
Dump Time screen (Figure 8-62 on page 8-46). This displays the attributes of the
selected queue.
8-38
Abend-AID for CICS User’s Guide
Figure 8-48. Handle Information Screen
Abend-AID ----------------- Handle Information ------------------------------ 
COMMAND ===>


Object Handle.............. 00000001

Queue Type................. QLOCAL

Open Options............... 00000010

Queue Name................. CF.TEST.M210.QUEUE01.RCV

Base Queue Name (if alias).

Target Queue Name.......... CF.TEST.M210.QUEUE01.RCV

Target QMgr Name........... M600

Transmission Queue Name....


Reply-to Queue Name........

Reply-to QMgr Name.........

Alternate Userid from OD...

MSG ID from MQGET call.....

CORREL ID from MQGET call..


Temp Dynamic Queue Created............ NO

Perm Dynamic Queue Created............ NO

Transmission Queue Opened............. NO

Default Transmission Queue Opened..... NO

Fully Qualified Remote Queue in OD.... NO

Use the cursor point-and-shoot feature and press Enter on the Open Options fields to see
information about the MQOPEN call associated with the given transaction. See “Open
Options Screen” on page 8-41for more information.
Press End to return to the previous screen.
Message Descriptor Screens
The Message Descriptor screens (Figure 8-49 and Figure 8-50 on page 8-39) display
information from the WebSphere MQ message descriptor (MQMD) of the transaction
being reported.
Access the first page of the Message Descriptor screen from the MsgDesc field on the Last
WebSphere MQ Call Info screen (Figure 8-47 on page 8-37).
Figure 8-49. Message Descriptor Page 1 Screen
Abend-AID ------------- Message Descriptor Page 1 --------------------------- 
COMMAND ===>

==> 
MD Address............. 37F191D0


Structure ID........... MD

Version................ 00000001

Report Options......... 00000000

Message Type........... 00000008
MQMT_DATAGRAM

Expiry................. FFFFFFFF
UNLIMITED

Feedback Value......... 0
MQFB_NONE

Encoding............... 785
MQENC_NATIVE

Coded Character Set.... 0
MQCCSI_Q_MGR

Format.................
MQFMT_NONE

Priority............... 1
MQPRI_PRIORITY_AS_Q_DEF

Persistence............ 0
MQPER_NOT_PERSISTENT

Message ID (Char)......

Correlation ID (Char)..

Backout Count.......... 0

Reply-to Queue.........

Reply-to QMGR..........

User ID................


Analyzing Transaction Abends
8-39
Use the cursor point-and-shoot feature and press Enter on the Report Options fields to
see the WebSphere MQ reporting options associated with the given transaction. See
“Report Options Screen” on page 8-43 for more information.
Press the RIGHT PF key (PF11) to access Page 2 of the Message Descriptor information
(Figure 8-50).
Figure 8-50. Message Descriptor Page 2 Screen
Abend-AID ------------- Message Descriptor Page 2 --------------------------- 
COMMAND ===>

<==

MD Address............. 37F191D0


Account Token (Char)...

Application Data.......

Put Application Type... 00000000
MQAT_NO_CONTEXT

Put Appl Name..........

Put Date...............

Put Time...............

Appl. Origin Data......

Use the cursor point-and-shoot feature and press Enter on the MD Address fields to see
the storage information for the Message Descriptor address space.
Press the LEFT PF key (PF10) to return to Page 1.
PMO Detail Screen
The PMO Detail screen (Figure 8-51) displays information about the MQPUT message
being reported. The fields it presents depend upon the version of WebSphere MQ.
Access this screen from the PutMsgOpts field on the Last WebSphere MQ Call Info screen
(Figure 8-47 on page 8-37).
Figure 8-51. PMO Detail Screen
Abend-AID --------------------- PMO Detail ---------------------------------- 
COMMAND ===>



PMO Address............ 37F193A8


Structure ID........... PMO

Version................ 00000001

Options................ 00000000

Timeout................ N/A

Context................ 00000000

Resolved Queue Name....

Resolved QMGR Name.....


Use the cursor point-and-shoot feature and press Enter to access additional information
for the selectable fields. For a WebSphere MQ version 1 transaction, the following fields
are selectable:
Use the cursor point-and-shoot feature and press Enter on the following fields:
• PMO Address field to see the storage information for the MQPUT message options
address space.
• Options field to see the message options for the given MQPUT. See “PMO Options
Screen” on page 8-42 for more information.
8-40
Abend-AID for CICS User’s Guide
Press End to return to the previous screen.
Message Buffer Area Screen
The Message Buffer Area screen (Figure 8-52) displays the message buffer area in vertical
hexadecimal format.
Access this screen from the Buffer field on the Last WebSphere MQ Call Info screen
(Figure 8-47 on page 8-37).
Figure 8-52. Message Buffer Area Screen
Abend-AID ---------------- Message Buffer Area --------- Row 000001 of 002461 
COMMAND ===>
SCROLL ===> PAGE 

Message Buffer Length: 24,576


37F1AAF0
Char THIS IS A TEST MESSAGE

Zone ECCE4CE4C4ECEE4DCEECCC4444444444444444444444444444

Digit 38920920103523045221750000000000000000000000000000

1...+...10....+...20....+...30....+...40....+...50


37F1AB22
Char

Zone 44444444444444444444444444444444444444444444440001

Digit 0000000000000000000000000000000000000000000000000C

51...+...60....+...70....+...80....+...90....+..100


37F1AB54
Char
THIS IS A TEST MESSAGE FOR QUE

Zone 00000002000000030000ECCE4CE4C4ECEE4DCEECCC4CDD4DEC

Digit 0000000C0000000C0000389209201035230452217506690845

101...+..110....+..120....+..130....+..140....+..150


37F1AB86
Char UE 2

Zone EC4F4444444444444444444444444444444444444444444444

Digit 45020000000000000000000000000000000000000000000000

151...+..160....+..170....+..180....+..190....+..200 
To see the storage information for given field, use the cursor point-and-shoot feature and
press Enter on the field’s virtual address (left column). Press the END PF key to return to
the previous screen.
Local Queue Definition Screens
The Local Queue Definition screens (Figure 8-53 and Figure 8-54 on page 8-41) display
the attributes of the selected queue.
Access these screens in one of the following ways:
• Use the cursor point-and-shoot feature and press Enter on the Queue Used in Call
field on the Last WebSphere MQ Call Info screen (Figure 8-47 on page 8-37). This
displays the attributes of the queue used in the last MQ call prior to the dump.
• Enter the D line command next to a handle on the Opened Queues at Dump Time
screen (Figure 8-62 on page 8-46). This displays the attributes of the selected queue.
Analyzing Transaction Abends
8-41
Figure 8-53. Local Queue Definition Page 1 Screen
Page 1 ------------------------ 

==> 
QMgr Name : M600

Queue Name : CF.TEST.M210.QUEUE01.RCV

Description: TEST MQ QUEUE


Queue Type................ QLOCAL
Current Queue Depth....... 0

Usage..................... NORMAL
Maximum Queue Depth....... 1,024

Put Enabled............... YES
Maximum Message Length.... 4,096

Default Persistance....... NO
Message Delivery Sequence. PRIORITY

Default Priority.......... 9
Permit Shared Access...... NOSHARE

Get Enabled............... YES
Default Share Option...... EXCLUSIVE

Storage Class............. DEFAULT
Index Type................ NONE

Creation Method........... PREDEFINED


Trigger Definition:

Trigger Type............. FIRST
Trigger Msg Priority...... 0

Trigger Set.............. NO
Trigger Depth............. 1

Trig. Data:

Process Name.............

Initiation Queue.........


Abend-AID ----------- Local Queue Definition
COMMAND ===>
Press the RIGHT PF key to see page 2.
Figure 8-54. Local Queue Definition Page 2 Screen
Page 2 ------------------------ 

<==

QMgr Name : M600

Queue Name : CF.TEST.M210.QUEUE01.RCV


Event Control:

Queue Full............... ENABLED
Queue Depth Low........... DISABLED

Threshold................. 40

Service Interval......... NONE
Queue Depth High.......... DISABLED

Interval................. 999,999,999 Threshold................. 80


Backout Reporting:

Backout Threshold........ 0
Harden Backout Counter.... NO

Backout Requeue Name.....


Retention Interval......... 999,999,999

Creation Date/Time......... 19SEP2006
13:52:27

Last Alteration Date/Time.. 19SEP2006
13:52:49


Cluster Name...............

Cluster Namelist Name......

Default Bind............... OPEN

Abend-AID ----------- Local Queue Definition
COMMAND ===>
From either page, press End to return to the previous screen.
Open Options Screen
The Open Options screen (Figure 8-55 on page 8-42) displays information from the
MQOPEN call that is associated with the transaction being reported. This information
comes from the Open Options field on the Last WebSphere MQ CAll Info screen (Figure
8-47 on page 8-37).
8-42
Abend-AID for CICS User’s Guide
Access this screen from the Open Options field on the Last WebSphere MQ Call Info
screen (Figure 8-47 on page 8-37) or the Handle Information screen (Figure 8-48 on page
8-38).
Figure 8-55. Open Options Screen
Abend-AID -------------------- Open Options --------------------------------- 
COMMAND ===>



Open Options...................... 00000010


MQOO_INPUT_AS_Q_DEF............... NO

MQOO_INPUT_SHARED................. NO

MQOO_INPUT_EXCLUSIVE.............. NO

MQOO_BROWSE....................... NO

MQOO_OUTPUT....................... YES

MQOO_INQUIRE...................... NO

MQOO_SET.......................... NO

MQOO_BIND_ON_OPEN................. NO

MQOO_BIND_NOT_FIXED............... NO

MQOO_BIND_AS_Q_DEF................ YES

MQOO_SAVE_ALL_CONTEXT............. NO

MQOO_PASS_IDENTITY_CONTEXT........ NO

MQOO_PASS_ALL_CONTEXT............. NO

MQOO_SET_IDENTITY_CONTEXT......... NO

MQOO_SET_ALL_CONTEXT.............. NO

MQOO_ALTERNATE_USER_AUTHORITY..... NO

MQOO_FAIL_IF_QUIESCING............ NO

Press the END PF key to return to the previous screen.
PMO Options Screen
The PMO Options screen (Figure 8-56) displays information from the MQPUT call being
reported. This information comes from the MQPMO_OPTIONS field.
Access this screen from the Put Options field on the Last WebSphere MQ Call Info screen
(Figure 8-47 on page 8-37) or the Options field on the PMO Detail screen (Figure 8-51 on
page 8-39).
Figure 8-56. PMO Options Screen
Abend-AID -------------------- PMO Options ---------------------------------- 
COMMAND ===>


SPECIFIED

IN PROGRAM


PMO Options....................... 00000000


MQPMO_SYNCPOINT................... NO

MQPMO_NO_SYNCPOINT................ NO

MQPMO_NO_CONTEXT.................. NO

MQPMO_DEFAULT_CONTEXT............. NO

MQPMO_PASS_IDENTITY_CONTEXT....... NO

MQPMO_PASS_ALL_CONTEXT............ NO

MQPMO_SET_IDENTITY_CONTEXT........ NO

MQPMO_SET_ALL_CONTEXT............. NO

MQPMO_ALTERNATE_USER_AUTHORITY.... NO

MQPMO_FAIL_IF_QUIESCING........... NO


Press End to return to the previous screen.
Analyzing Transaction Abends
8-43
Report Options Screen
The Report Options screen (Figure 8-57) displays information from the MQRO_OPTIONS
field in the message descriptor.
Access this screen from the Report Options field on page 1 of the Message Descriptor
screen (Figure 8-49 on page 8-38).
Figure 8-57. Report Options Screen
Abend-AID ------------------- Report Options -------------------------------- 
COMMAND ===>


Report Options.................. 00000000


MQRO_EXCEPTION.................. NO
Message and Correlation ID Options:

MQRO_EXCEPTION_WITH_DATA........ NO
MQRO_NEW_MSG_ID................ NO

MQRO_EXCEPTION_WITH_FULL_DATA... NO
MQRO_PASS_MSG_ID............... NO

MQRO_EXPIRATION................. NO
MQRO_COPY_MSG_ID_TO_CORREL_ID.. NO

MQRO_EXPIRATION_WITH_DATA....... NO
MQRO_PASS_CORREL_ID............ NO

MQRO_EXPIRATION_WITH_FULL_DATA.. NO

MQRO_COA........................ NO
Disposition Options:

MQRO_COA_WITH_DATA.............. NO
MQRO_DEAD_LETTER_Q............. NO

MQRO_COA_WITH_FULL_DATA......... NO
MQRO_DISCARD_MSG............... NO

MQRO_COD........................ NO

MQRO_COD_WITH_DATA.............. NO

MQRO_COD_WITH_FULL_DATA......... NO

MQRO_PAN........................ NO

MQRO_NAN........................ NO


Press End to return to the previous screen.
GMO Detail Screen
The GMO Detail screen (Figure 8-58) displays information about the MQGET message
being reported. The fields it presents depend upon the version of WebSphere MQ.
Access this screen from the GetMsgOpts field on the Last WebSphere MQ Call Info screen
(Figure 8-47 on page 8-37).
Figure 8-58. GMO Detail Screen
Abend-AID --------------------- GMO Detail ---------------------------------- 
COMMAND ===>



GMO Address............ 15018610


Structure ID........... GMO

Version................ 00000003

Options................ 00000040

Wait Interval.......... 0

Signal1................ 00000000

Signal2................ N/A

Resolved Queue Name.... CF.EB20.QLOCAL.Q01


Match Options.......... 00000000

Group Status........... N/A

Segment Status......... N/A

Segmentation........... N/A


Reserved1.............. N/A

Message Token..........

Returned Length........ N/A

Use the cursor point-and-shoot feature and press Enter to access additional information
for the selectable fields. The following fields are selectable:
8-44
Abend-AID for CICS User’s Guide
• GMO Address: Displays the storage information for the MQGET message options
address space.
• Option: Displays the message options for the MQGET being reported. See “GMO
Options Screen” on page 8-45 for more information.
• Signal1: Displays the storage for the signal1 address spaces which is used internally
by WebSphere MQ.
• Match Options: Displays the WebSphere MQ match options associated with the
MQGET being reported.
Press End to return to the previous screen.
Match Options Screen
The Match Options screen (Figure 8-59) displays the WebSphere MQ match options
associated with the MQGET call being reported.
Access this screen from the Match Options field on the GMO Detail screen (Figure 8-58
on page 8-43).
Figure 8-59. Match Options Screen
Abend-AID ------------------- Match Options --------------------------------- 
COMMAND ===>


Match Options..................... 00000000


MQMO_MATCH_MSG_ID................. NO

MQMO_MATCH_CORREL_ID.............. NO

MQMO_MATCH_MSG_TOKEN.............. NO


Press End to return to the previous screen.
Alias Queue Definition Screen
The Alias Queue Definition screen (Figure 8-60 on page 8-45) displays the attributes of
the selected alias queue definition.
Access this screen in one of the following ways:
• Use the cursor point-and-shoot feature and press Enter on the Queue Used in Call
field on the Last WebSphere MQ Call Info screen (Figure 8-47 on page 8-37). Doing so
displays the attributes of the queue used in the last MQ call prior to the dump.
• Enter the D line command next to a handle on the Opened Queues at Dump Time
screen (Figure 8-62 on page 8-46). Doing so displays the attributes of the selected
queue.
Analyzing Transaction Abends
8-45
Figure 8-60. Alias Queue Definition
Abend-AID --------------- Alias Queue Definition ---------------------------- 
COMMAND ===>


QMgr Name : M600

Queue Name : CF.TEST.QALIAS

Description: BASIC ALIAS DEFINITION


Queue Type................. QALIAS

Put Enabled................ YES

Default Persistance........ NO

Default Priority........... 9

Get Enabled................ YES

Target Queue............... CF.TEST.QLOCAL


Last Alteration Date/Time.. 18JAN2006
11:25:53


Cluster Name...............

Cluster Namelist Name......

Default Bind............... OPEN


Use the cursor point-and-shoot feature and press Enter on the Target Queue field to see
the Local Queue Definition, see page 8-40.
GMO Options Screen
The GMO Options screen (Figure 8-61) displays information from the MQGET call being
reported. This information comes from the MQGMO_OPTIONS field.
Access this screen from the Get Options field on the Last WebSphere MQ Call Info screen
(Figure 8-47 on page 8-37) or the Options field on the GMO Detail screen (Figure 8-58 on
page 8-43).
Figure 8-61. GMO Options Screen
Abend-AID -------------------- GMO Options ---------------------------------COMMAND ===>
SPECIFIED
IN PROGRAM
GMO Options....................... 00002044
MQGMO_WAIT........................
MQGMO_NO_WAIT.....................
MQGMO_SYNCPOINT...................
MQGMO_SYNCPOINT_IF_PERSISTENT.....
MQGMO_NO_SYNCPOINT................
MQGMO_MARK_SKIP_BACKOUT...........
MQGMO_BROWSE_FIRST................
MQGMO_BROWSE_NEXT.................
MQGMO_MSG_UNDER_CURSOR............
MQGMO_ACCEPT_TRUNCATED_MSG........
MQGMO_SET_SIGNAL..................
MQGMO_FAIL_IF_QUIESCING...........
MQGMO_CONVERT.....................
MQGMO_ALL_MSGS_AVAILABLE..........
MQGMO_ALL_SEGMENTS_AVAILABLE......
MQGMO_BROWSE_MSG_UNDER_CURSOR.....
MQGMO_COMPLETE_MSG................
NO
YES
NO
NO
YES
NO
NO
NO
NO
YES
NO
YES
YES
NO
NO
NO
NO
























8-46
Abend-AID for CICS User’s Guide
Opened Queues at Dump Time Screen
The Opened Queues at Dump Time screen (Figure 8-62 on page 8-46) displays a list of the
queues that were opened by the transaction and were still open when the dump occurred.
To access this screen, select option 3 MQOPEN from the WebSphere MQ Information
Menu (Figure 8-44 on page 8-35) or enter the MQOPEN fast-path command from any
screen within the selected report.
Figure 8-62. Opened Queues at Dump Time Screen







H Handle Information


Put

Options Queue Name

******** *******************************
00000002 CF.TEST.M210.QUEUE01.RCV

OF DATA ********************************









process it
Abend-AID ------------- Opened Queues at Dump Time ----- Row 000001 of 000001
COMMAND ===>
SCROLL ===> PAGE
==>
QMgr Name.................... M600 CICS Transaction..... MQD2
Number of API Calls.......... 2
CICS Abend Code...... MQDP
Number of Opened Queues...... 1
Abend Date and Time.. 05OCT2006 08:24:12
D Queue Definition
Queue
Open
Get
Handle
Type
Options Options
******** ******** ******** ********
00000001 QLOCAL
00000010 00000000
***************************** BOTTOM
Type a line command and press Enter to
Enter the following line commands next to the queue(s) of interest:
• D: Displays the Local Queue Definition screens (Figure 8-53 and Figure 8-54 on page
8-41) for the selected queue.
• H: Displays the Handle Information screen (Figure 8-48 on page 8-38) for the selected
queue.
Pressing End displays information for the next selected queue, if any, or returns you to
the Opened Queues at Dump Time screen.
WebSphere MQ System Information Screen
The WebSphere MQ System Information screen (Figure 8-63 on page 8-47) displays
system and task related information.
To access this screen, select option 4 MQSYS from the WebSphere MQ Information Menu
(Figure 8-44 on page 8-35) or enter the MQSYS fast-path command from any screen
within the selected report.
Analyzing Transaction Abends
8-47
Figure 8-63. WebSphere MQ System Information Screen
Abend-AID ---------- WebSphere MQ System Information ------------------------ 
COMMAND ===>


System Information

QMgr Name................... M600

QMgr Release................ 6.0.0

Status...................... CONNECTED

CICS Tracing................ ON

Trace Point ID.............. AP0000

API Exit.................... OFF

CLOA Address................ 00049044

CLOC Address................ 37E66140


Task Related Information

Number of API Calls......... 2

Number of Opened Queues..... 1

Thread ID................... 380FF2E0

Thread Status............... BETWEEN CALLS

TIE Address................. 380FF260

CLOT Address................ 380FF2E0

CTHD Address................ 380FF328

QRPL Address................ 37F20D60


Use the cursor point-and-shoot feature and press Enter to access additional information
for the selectable fields. The following fields are selectable:
• Trace Point ID: Displays the Abbreviated Trace Listing screen. This screen is
described in Chapter 16, “Analyzing Storage Violations”.
• CLOA Address: Displays the storage for the CLOA address.
• CLOC Address: Displays the storage for the CLOC address.
• TIE Address: Displays the storage for the TIE address.
• CLOT Address: Displays the storage for the CLOT address.
• CTHD Address: Displays the storage for the CTHD address.
• QRPL Address: Displays the storage for the QRPL address.
Hogan Information Screens
The Hogan Information menu, shown in Figure 8-64 on page 8-48, lets you display an
interpretation of the following Hogan control blocks included in the abending
transaction:
• Hogan internal task control block as shown in Figure 8-65 on page 8-48
• Hogan user task control block as shown in Figure 8-66 on page 8-48
• Hogan user program control block as shown in Figure 8-67 on page 8-49.
After you select a transaction abend with Hogan information, you can access the Hogan
Information menu by using the cursor point-and-shoot feature and pressing Enter on the
Diagnostic Summary screen or by entering HOGAN as a fast-path command on any
Abend-AID for CICS screen.
8-48
Abend-AID for CICS User’s Guide
Figure 8-64. Hogan Information Menu
Abend-AID ------------------- Hogan Information -----------------------------
OPTION ===> 

1 ITCB
Internal Task Control Block 

2 UTCB
User Task Control Block 

3 UPCB
User Program Control Block 
Figure 8-65. Hogan ITCB Screen
Abend-AID ----------------------- Hogan ITCB --------------------------------
COMMAND ===> 

Hogan ITCB Address....... 00168914 

TCB@NBR.................. 362
CDM@ACTN... 0006
TCB@CO................... 654
CDM@RSLT... 0000
TCB@APPL................. 64
CDM@FMT.... 0000DD1D
TCB@FUNC................. 102
CDM@COID... FFFF
TCB@TYPE................. 3
CDM@EFF.... 01FEB2003
TCB@TIME................. 13:28:24
CDM@ALTK... 00
TCB@DATE................. 19JAN2004
CDM@FLG1... 00
TCB@SRCE................. 6W0A
CDM@UDGA... 0024DCA0
TCB@OPER.................
CDM@UDGL... 005F
TCB@ALST................. 0841192C
CDM@FLG2... C0
TCB@ACTR................. 0001
TCB@IND.................. 20
TCB@IND2................. 00 
Figure 8-66. Hogan UTCB Screen
Abend-AID ---------------------- Hogan UTCB --------------------------------- 
COMMAND ===>


Hogan UTCB Address....... 000C39F4


TCB$NBR.................. 362
CDMFACTN... 0005

TCB$CO................... 654
CDMFRSLT... 0000

TCB$APPL................. 22
CDMFFMT.... 56,605

TCB$FUNC................. 2
CDMFCOID... 654

TCB$TYPE................. 3
CDMFEFF....

TCB$ACT.................. 24344
CDMFCCNO... 00000000

TCB$RSLT................. 0000
CDMFSKID...

TCB$DGID................. 63510

TCB$TIME................. 13:28:24

TCB$DATE................. 19JAN2004

TCB$SRCE................. 6W0A

TCB$OPER.................

TCB$DEST.................

TCB$XACT................. 24344

TCB$XDG.................. 63510

Analyzing Transaction Abends
8-49
Figure 8-67. Hogan UPCB Screen
Abend-AID ---------------------- Hogan UPCB --------------------------------
COMMAND ===> 

Hogan UPCB Address....... 001692A0 

UPCBPREV................. 00000000
UPCBNEXT................. 00000000
UPCBFACT................. 00000000
UPCBHACT................. 0000
UPCBPDEF................. 084040DC
UPCBBLL2................. 00000000
UPCBNTGT................. 00000000
UPCBPGMA................. 001C0000
UPCBLACT................. 8019A90C
UPCBACTT................. 00000000 
After you select one of these screens, access specific storage for the control block in
hexadecimal format by using the cursor point-and-shoot feature and pressing the HEXD
PF key at the Hogan control block address field. Abend-AID for CICS displays the
Memory Display screen, which is explained in “Using the Memory Display Screen” on
page 5-2.
DL/I Information Screen
The DL/I Information screen, shown in Figure 8-68, displays DL/I information associated
with the task at the time of the abend. After you select a transaction abend with DL/I
information, you can access the DL/I Information screen by using the cursor point-andshoot feature and pressing Enter on the Diagnostic Summary or by entering DLI as a fastpath.
Figure 8-68. DL/I Information Screen
Abend-AID --------------- DL/I Information --------------Row 000001 of 000018
COMMAND ===>
SCROLL ===> PAGE
==>
The last DL/I call parameter list at address 0033AA00 was: 

00339EE8 001BC214 00339F04 8033A4EC 00000000 * ..Y .B. ...".u.
* 

Name
Address
Length
Resource Description
******** ******** ******** ******** ***************************************
ISB
000092BC 000000E4
CICS DL/I Interface Scheduling Block
UIB
00339E78 00000010
CICS DL/I User Interface Block
PCB
001BC150 00000030 EMPLYDB
CICS DL/I Pgm Communications Block
JCB
001BC3A4 00000040 EMPLYDB
CICS DL/I Job Control Block
PCB
001BC1B4 0000002C EMPLSI2
CICS DL/I Pgm Communications Block
JCB
001BC91C 00000040 EMPLSI2
CICS DL/I Job Control Block
PCB
001BC214 0000005E EMPLYDB
CICS DL/I Pgm Communications Block
JCB
001BCC34 00000040 EMPLYDB
CICS DL/I Job Control Block
PCB
001BC2A8 00000030 EMPLYDB
CICS DL/I Pgm Communications Block
JCB
001BD2D4 00000040 EMPLYDB
CICS DL/I Job Control Block
SCD
00356030 00000040
CICS DL/I System Contents Directory
PST
003BE050 00000B50
CICS DL/I Partition Specification Table
DLP
00133DB0 0000034C
CICS DL/I Interface Parameters
DLILIST
0033AA00 00000010
CICS DL/I Parameter List From Last DL/I
To obtain additional DL/I information associated with the transaction at the time of the
abend, do the following:
1. Access the address for the DL/I parameter list in hexadecimal format by using the
cursor point-and-shoot feature and pressing the HEXD PF key at the address field for
8-50
Abend-AID for CICS User’s Guide
the DL/I parameter list. Abend-AID for CICS displays the Memory Display screen,
which is explained in “Using the Memory Display Screen” on page 5-2.
2. Access a DL/I control block in hexadecimal format by using the cursor point-andshoot feature and pressing the HEXD PF key at the Name field or the Address field to
display the Memory Display screen, which is explained in “Using the Memory
Display Screen” on page 5-2.
3. Access a DL/I control block in DSECT format, if available, by using the cursor pointand-shoot feature and pressing the DSECT PF key at the Name field or the Address
field. Abend-AID for CICS displays the DSECT Support screen, which is explained in
“Displaying Control Blocks in DSECT Format” on page 6-1.
MSA Information Screens
This section describes the following MSA Information screens:
• “MSA Information Screen”
• “DCI and Application DMCBS Screen” on page 8-51
• “DCI Trace Screen” on page 8-51
MSA Information Screen
The MSA Information screen, shown in Figure 8-69, displays MSA information associated
with the task at the time of the abend. After you select a transaction abend with MSA
information, you can access the MSA Information screen by using the cursor point-andshoot feature and pressing Enter on the Diagnostic Summary or by entering MSA as a
fast-path command on any Abend-AID for CICS screen.
Figure 8-69. MSA Information Screen
Abend-AID -------------- MSA Information --------------- Row 000001 of 000003
COMMAND ===>
SCROLL ===> PAGE

The MSA Data Communications Interface (DCI) release 90.01.00 nucleus
(LPCZZNUC) was present at the time of the abend. 


MSA Related Areas 

DCIAREA
- Data Communications Interface Area 

DCIDMCBS - Formatted DCI and Application DMCBS 

DCITRACE - Formatted DCI Trace 


The last DCI call parameter list was not found. 
To obtain additional MSA information about the abending transaction, do the following:
1. Use the cursor point-and-shoot feature and press Enter at the DCIAREA (Data
Communications Interface Area) field to display the Memory Display screen, which
is explained in “Using the Memory Display Screen” on page 5-2.
2. Use the cursor point-and-shoot feature and press Enter at the DCIDMCBS field to
display the DCI and Application DMCBS screen, which is explained in “DCI and
Application DMCBS Screen” on page 8-51.
3. Use the cursor point-and-shoot feature and press Enter at the DCITRACE field to
display the DCI Trace screen, which is explained in “DCI Trace Screen” on page 8-51.
Analyzing Transaction Abends
8-51
4. Use the cursor point-and-shoot feature and press the HEXD PF key at the address
field for the DCI parameter list to display the Memory Display screen, which is
explained in “Using the Memory Display Screen” on page 5-2.
DCI and Application DMCBS Screen
The DCI and Application DMCBS screen, shown in Figure 8-70, displays information
related to the MSA files. After you select a transaction abend with MSA information, you
can access the DCI and Application DMCBS screen by using the cursor point-and-shoot
feature and pressing Enter on the MSA Information screen or by entering DCIDMCBS as
a fast-path command on any Abend-AID for CICS screen.
Figure 8-70. DCI and Application DMCBS Screen
Abend-AID ---------- DCI and Application DMCBS ---------- Row 000001 of 000002
COMMAND ===>
SCROLL ===> PAGE

File
File Previous
Key
Record Process
Record
I/O Area
Name
Type DCI Function
Length Length Indicator Format
Address
******** **** **************** ****** ******* ********* ******* ********
LKTWAD
KSDS GET
4 6,662
FIXED
00000000
LKSCRN
KSDS GET
4 3,938
FIXED
00000000
******************************* BOTTOM OF DATA ********************************
To obtain additional information about the MSA files, do the following:
1. Note the file information displayed on the DCI and Application DMCBS screen.
2. Access specific MSA file information by using the cursor point-and-shoot feature and
pressing Enter at the File Name field. Abend-AID for CICS displays the File Detail
screen, if available.
3. Access specific storage information for the MSA file by using the cursor point-andshoot feature and pressing the HEXD PF key at the I/O Area Address field. Abend-AID
for CICS displays the Memory Display screen, which is explained in “Using the
Memory Display Screen” on page 5-2.
DCI Trace Screen
The DCI Trace screen, shown in Figure 8-71 on page 8-52, displays the MSA trace
interpretations. After you select a transaction abend with MSA information, you can
access the DCI Trace screen by using the cursor point-and-shoot feature and pressing
Enter on the MSA Information screen or by entering DCITRACE as a fast-path command
on any Abend-AID for CICS screen.
8-52
Abend-AID for CICS User’s Guide
Figure 8-71. DCI Trace Screen
Abend-AID ------------------ DCI Trace ------------------ Row 000001 of 000110
COMMAND ===>
SCROLL ===> PAGE

Program Program Return
Func Return
Level
Name
Address Code Code
Description
******* ******** ******** **** ****** ***************************************
LPCCZTPA 5054207E 28
00
ABEND
3170
LPCCZTPA 5054207E 31
70
LOAD program GPO093
LPCCZTPA 50542138 29
00
DELETE GPDCC1
LPCCZTPA 50542138 29
00
DELETE GPOSERV1
2
LPCZZAIT 004A1408 00
00
LINK to program LPCZZFRE
2
LPCZZAIT 004A1408 00
00
LINK to program LPCZZFRE
2
LPCZZAIT 004A1408 00
00
LINK to program LPCZZFRE
2
LPCZZAIT 004A1408 00
00
LINK to program LPCZZFRE
LPCCZTPA 50541F9E 34
00
FREEMAIN
2
LPCZZAIT 004A1408 00
00
LINK to program LPCZZTPA
LPCCVANL 4054275E 00
00
CLOSE
2
LPCZZAIT 004A1408 00
00
LINK to program LPCCVANL
2
LPCZZAIT 004A2F44 00
00
LINK to program LPCZZSVR
2
LPCZZAIT 00496408 00
00
LINK to program LPCZZFRE
2
LPCZZAIT 00496408 00
00
LINK to program LPCZZFRE
2
LPCZZAIT 00496408 00
00
LINK to program LPCZZFRE
2
LPCZZAIT 00496408 00
00
LINK to program LPCZZFRE
LPCCZTPA 50541F9E 34
00
FREEMAIN
To obtain additional information about the MSA trace, do the following:
1. Note the trace information displayed on the DCI Trace screen.
2. Access specific information about the program(s) by using the cursor point-andshoot feature and pressing Enter at the Program Name field to display the Program
Detail screen, which is described in “Program Detail Screen” on page 8-6.
3. Access specific storage information in hexadecimal format by using the cursor pointand-shoot feature and pressing the HEXD PF key at the Return Address field to
display the Memory Display screen, which is explained in “Using the Memory
Display Screen” on page 5-2.
9-1
Chapter 9.
Displaying Additional Transaction Abend Information
Chap 9
This chapter explains how to access additional program and file information related to
the transaction abend. The following screens are described:
• Program Information
–
–
–
–
Program
Program
Program
Program
Link Information
Summary Information
Call Trace Summary
Levels
• COBOL Storage Areas
–
–
–
–
–
–
Working Storage
Linkage Section
External Cells
Task Global Table
Local Storage
DSA
• PL/I Storage Selection List
• PL/I Storage Display
• PL/I Storage Areas
–
–
–
–
Automatic Storage Areas
Static Storage Area
Controlled Storage Area
External Storage Areas
• Assembler Storage Menu
• Assembler Storage Area
• Storage Disassembly
• Data Locator Search Criteria
• Data Locator Results
• File Request Summary
–
–
–
–
File Detail
Record Image
File Related Areas
File Recovery
• Web Information Summary
• LE Information Menu
– LE Options Control Block.
– LE Information Summary
Program Information Menu
The Program Information menu, shown in Figure 9-1, lets you access four screens that
display program-related information: the Program Link Information screen as described
9-2
Abend-AID for CICS User’s Guide
in “Program Link Information Screen”, the Program Summary Information screen, as
described in “Program Summary Information Screen” on page 9-4, the Program Call Trace
Summary, as described in “Program Call Trace Summary Screen” on page 8-24, and the
Program Level Screen, as described in “Program Levels Screen” on page 9-9. Access the
Program Information menu from the Primary Options menu or by entering PROG as a
fast-path command on any Abend-AID for CICS screen.
Figure 9-1. Program Information Menu
Abend-AID ---------------- Program Information ------------------------------ 
OPTION ===>


1 PGMLINK Program Link Information


2 PGMSUMM Program Summary Information


3 CALLTRAC Program Call Trace Summary


4 LEVELS
Program Levels, COMMAREAs, Channels












Program Link Information Screen
The Program Link Information screen, shown in Figure 9-2 on page 9-3, summarizes the
program execution sequence for every module used by a transaction up to the abending
module. Information displayed includes the load modules and programs called, their
status (linked, dynamic, or static), and the load modules and programs that originated
the calls. A return offset is provided for each program link.
Notes:
1. The Return Offset field is selectable using the cursor point-and-shoot feature, and
displays a Call Detail screen as shown in the “Call Detail Screen” on page 8-10.
2. Because they are not calls, transfers of program control via XCTL commands are not
shown on the Program Link Information screen.
Access the Program Link Information screen from the Program Information menu or by
entering PGMLINK as a fast-path command on any Abend-AID for CICS screen.
Displaying Additional Transaction Abend Information
9-3
Figure 9-2. Program Link Information Screen




Abend-AID ---------- Program Link Information ----------- Row 000001 of 000006
COMMAND ===>
SCROLL ===> PAGE
==> 
To display the current Data Locator search criteria, select FINDDATA 

D Program Detail
L Program Listing
S Program Storage
P PPT Entry
A Program Disassembly
R Data Locator 

Called
Called
Calling Calling Return 
Load Mod Program ------- Status ------- Load Mod Program Offset 
******** ******** ********************** ******** ******** ****** 
_ M370COM8 M370COM8 Linked By
M370COM7 M370COM7 0004AC 
_ M370COM7 M370COM7 Linked By
M370COM6 M370COM6 0004AC 
_ M370COM6 M370COM6 Linked By
M370COM5 M370COM5 0004AC 
_ M370COM5 M370COM5 Linked By
M370COM4 M370COM4 000506 
_ M370COM4 M370COM4 Linked By
M370COM3 M370COM3 0004E8 
_ M370COM3 M370COM3 Linked By
SYSTEM

****************************** BOTTOM OF DATA *******************************

Type a line command and press Enter to process it. 
You can access the current search criteria used by the Data Locator facility by tabbing to
the FINDDATA field and pressing Enter. The Data Locator Search Criteria screen displays
as described in “Data Locator Search Criteria Screen” on page 9-22.
Enter the following line commands next to the program name in the Called Load Mod
field to display additional information about each program:
• D: Displays the Program Detail screen, which is described in “Program Detail Screen”
on page 8-6.
• P: Displays in DSECT format the processing program table (PPT) for the selected
module. See “Displaying Control Blocks in DSECT Format” on page 6-1 for additional
information.
• L: Displays the Program Listing screen, which is described in “Program Listing
Screen” on page 8-11. The Program Listing line command is available only for
COBOL, PL/I, and Assembler programs compiled with the Compuware COBOL
language processor, Compuware PL/I language processor, or Compuware Assembler
language processor which provide source support.
• A: Displays the selected program in disassembled format as described in “Storage
Disassembly Screen” on page 9-21.
• S: Displays all user storage associated with the selected program and all programs still
on the active link chain.
– For COBOL programs, this command displays the COBOL Storage Areas menu, as
described in “COBOL Storage Areas Menu” on page 9-12.
– For Assembler programs, this command displays the Assembler Storage Menu, as
described in “Assembler Storage Menu” on page 9-19.
– For PL/I programs with source support, this command displays the PL/I Storage
Selection List, showing the internal procedures active at the time of the abend, as
described in “PL/I Storage Selection List” on page 9-15. For PL/I programs
without source support, it displays the PL/I Storage Areas menu, as described in
“PL/I Storage Areas Menu” on page 9-17.
• R: Displays the Data Locator Results screen, which is described in “Data Locator
Results Screen” on page 9-23. Data Locator is only available for COBOL programs.
9-4
Abend-AID for CICS User’s Guide
Program Summary Information Screen
The Program Summary Information screen, shown in Figure 9-3, identifies all active
modules involved in an abending transaction. Key identification data is summarized for
each module used by a transaction up to the abending module. Use this screen to quickly
verify that the correct version of a module is in use.
Access the Program Summary Information screen from the Program Information menu or
by entering PGMSUMM as a fast-path command on any Abend-AID for CICS screen.
Figure 9-3. Program Summary Information Screen

Abend-AID ------------ Program Summary Information ----- Row 000001 of 000007
COMMAND ===>
SCROLL ===> PAGE
==> 
To display the current Data Locator search criteria, select FINDDATA 

D Program Detail
L Program Listing
S Program Storage
C Compile Options
A Program Disassembly
R Data Locator
P PPT Entry
I Impact Analysis
X Extended Search 
W COBOL PERFORM FLOW 
_
_
_
_
_
_
_
Load
Link
Compile
Module
Program Date
Date
******** ******** ********* *********
M370COM8 M370COM8 06FEB2011 06FEB2011
M370COM7 M370COM7 16JAN2011 16JAN2011
M370COM6 M370COM6 16JAN2011 16JAN2011
M370COM5 M370COM5 16JAN2011 16JAN2011
M370COM4 M370COM4 16JAN2011 16JAN2011
M370COM3 M370COM3 16JAN2011 16JAN2011
IGZCMGEN IGZCMGEN 24OCT2010 24OCT2010
****************************** BOTTOM
Entry
EXEC 
Point
Length Language Type
Key 
******** ****** ******** ******* **** 
09E06828 000778 COB/MVS LE/370 USER 
09E05428 000770 COB/MVS LE/370 USER 
09E04028 000770 COB/MVS LE/370 USER 
09E02C28 000770 COB/MVS LE/370 USER 
09E01828 0007C8 COB/MVS LE/370 USER 
09E00428 0007A8 COB/MVS LE/370 USER 
0A3DD800 0040D0 ASM
COMMAND USER 
OF DATA *******************************
You can access the current search criteria used by the Data Locator facility by tabbing to
the FINDDATA field and pressing Enter. The Data Locator Search Criteria screen displays
as described in “Data Locator Search Criteria Screen” on page 9-22.
Enter the following line commands next to the program name in the Load Module field
to display additional information about each program:
• D: Displays the Program Detail screen, which is described in “Program Detail Screen”
on page 8-6.
• C: Displays the program compiler options found in the program information bytes.
With source support, all compiler options are available in the listing. Refer to
“Compiler Options Screen” for more information.
• P: Displays in DSECT format the processing program table (PPT) for the selected
module. Refer to “Displaying Control Blocks in DSECT Format” on page 6-1 for
additional information.
• L: Displays the Program Listing screen, which is described in “Program Listing
Screen” on page 8-11. The Program Listing line command is available only for
COBOL, PL/I, and Assembler programs compiled with the Compuware COBOL
language processor, Compuware PL/I language processor, or Compuware Assembler
language processor which provide source support.
• A: Displays the selected program in disassembled format as described in “Storage
Disassembly Screen” on page 9-21.
• S: Displays all user storage associated with the selected program and all programs still
on the active link chain.
– For COBOL programs, this command displays the COBOL Storage Areas menu, as
described in “COBOL Storage Areas Menu” on page 9-12.
Displaying Additional Transaction Abend Information
9-5
– For Assembler programs, this command displays the Assembler Storage Menu, as
described in “Assembler Storage Menu” on page 9-19.
– For PL/I programs with source support, this command displays the PL/I Storage
Selection List, showing the internal procedures active at the time of the abend, as
described in “PL/I Storage Selection List” on page 9-15. For PL/I programs
without source support, it displays the PL/I Storage Areas menu, as described in
“PL/I Storage Areas Menu” on page 9-17.
• R: Displays the Data Locator Results screen, which is described in“Data Locator
Results Screen” on page 9-23.
• I: Displays the Impact Analysis Listing if your site is using source support and has
DevEnterprise installed for integration with Abend-AID for CICS, as described in
“Impact Analysis Listing” on page 8-20.
• X: Displays the Extended Search Listing for COBOL programs if your site is using
source support, as described in“Extended Search Listing Screen” on page 9-6. This
screen displays all fields available for extended search.
• W: Displays the COBOL Perform Flow screen for Enterprise COBOL programs only if
your site is using source support, as described in “COBOL Perform Flow Screen” on
page 9-8.
Compiler Options Screen
The Compiler Options screen is displayed when the C line command is issued on the
Program Summary Information screen (Figure 9-3). This screen displays the program
compiler options found in the program information bytes.
Note: New headings are used to identify information such as the type of option, if LP is
used, and provide description data. Depending on the version of the
programming language in use, you may only see the “Option” column and not
Type, LP Type, and Description.
Figure 9-4. Compiler Options Screen











Description

********************************** 
Add print control bytes

Specifies apostrophe as delimiter 
Sets maximum decimal digits

Activates APPLY WRITE-ONLY proces 
Enables the integrated CICS trans 
Specifies code page used

Defines the default currency symb 
Specifies data area location

Enables millennium language exten 
Recognize DBCS shift-in/shift-out 
Abend-AID ------------------ Compiler Options ---------- Row 000001 of 000046
COMMAND ===>
SCROLL ===> PAGE
===>
Compile Options for CSECT.. CCAADEMO
Compile date............... 05MAR2007
Compile time............... 13:05:42
Language COBOL for z/OS
**
NO
NO
NO
NO
NO
NO
Option
**********************
ADV
APOST
ARITH(COMPAT)
AWO
CICS
CODEPAGE(1140)
CURRENCY
DATA(31)
DATEPROC
DBCS
V3R4M1
Type
*********
Execution
Listing
Execution
Execution
Execution
Execution
Execution
Execution
Execution
Execution
LP
TYPE
*
This screen provides the name of the CSECT, the compile date and time, the language in
which the program was written, and the version of the compiler.
9-6
Abend-AID for CICS User’s Guide
Extended Search Listing Screen
The Extended Search Listing screen, shown in Figure 9-5, is available only for COBOL
programs with source support enabled. This screen displays all fields available for
extended search. Access this screen by using the cursor point-and-shoot feature from the
Supporting Information section of the Diagnostic Summary or by entering the ESRCH
(Extended Search) fast-path command from any relevant screen for the abending
program. You can also access this screen by using the X (Extended Search) line command
on the Program Summary information screen.
Figure 9-5. Extended Search Listing Screen
Abend-AID -------------- Extended Search Listing ------- Row 000001 of 000304 
COMMAND ===>
SCROLL ===> PAGE 
==> 
Program..... CFQCZ000


F Field Usage Summary
O Other Fields with same value


Source Line

DATA DIVISION.

WORKING-STORAGE SECTION.

01 WS-HEADER

02 FILLER
X(16)
CFQCZ000

02 FILLER
X(16)
03 APRIL 2006

01 ABEND-CODE
X(4)
Z000

01 TRAN-CODE
X(9)
Q644S0C9

01 TC
REDEFINES TRAN-CODE

02 TC-1
X
Q

02 TC-3
999
644

02 TC-5
X(5)
S0C9

01 WS-CNT
S9(7)
+0000041

01 WS-CNT-1
S9(7)
+0000000

01 WS-TEN
S9(7)
+0000000

01 WS01
X(32768)
LOW-VALUES

01 WS04
X(8)
THE END 
Enter the following line commands next to a field for other extended search information:
• F: Displays the Field Usage Summary, which is described in “Field Usage Summary”.
• O: Displays the Other Fields screen, which is describe in “Other Fields Screen” on
page 9-7 .
Note:
Some requests to show other fields containing the same value may require
additional time to process. Certain search values or programs that contain large
amounts of program storage can cause the search to take longer. If this condition
is detected, a warning pop-up window is displayed, as shown in Figure 9-6 on
page 9-7. You can continue to process the search request or cancel it from this
display.
Displaying Additional Transaction Abend Information
9-7
Figure 9-6. Extended Search Warning Pop-Up Window
Abend-AID -------------- Extended Search Listing ------- Row 000001 of 000080
COMMAND ===>
SCROLL ===> PAGE
==>
Program..... CCFQCZ00
F Field Usage Summary
O Other Fields with same value
Source Line
WORKING-STORAGE SECTION.
+-------------------------------------------+
| Due to value of this field and/or the
|
| large amount of storage associated with
|
| this program, your request to show other |
| fields in the same program with the same |
| value could take a considerable amount
|
| of time to complete.
|
|
|
| Press Enter to process this request.
|
| Enter END (PF03) or RETURN to cancel.
|
| CFSRVR17
End=PF03
|
+-------------------------------------------+
02 GROSS-PAY
# 9(5)V99
02 TOTAL-TAXES
# 9(4)V99
02 FILLER
X(25)
OMP-3
+0
LL) - FIELD NOT REFERENCED <<
00000000
OMP-3
LOW-VALUES
OMP-3
+0
OMP-3
+0
OMP-3
+56
LL) - FIELD NOT REFERENCED <<
LOW-VALUES
LOW-VALUES
LOW-VALUES
LOW-VALUES
LOW-VALUES
LOW-VALUES 























Field Usage Summary
The Field Usage Summary, shown in Figure 9-7, displays program statements that directly
or indirectly modify the selected field. In addition, it shows data definitions that directly
or indirectly reference the selected field.
Figure 9-7. Field Usage Summary Screen
Abend-AID ---------------- Field Usage Summary --------- Row 000001 of 000022 
COMMAND ===>
SCROLL ===> PAGE 


References to the field WS-HEADER in program CFQCZ000.


Modifying Statements - Direct



No Modifying Statements found.


Data Definitions, either directly or indirectly


Redefines or group clause referencing the field WS-HEADER in program

CFQCZ000.


... 9 LINES EXCLUDED ...

01 WS-HEADER

02 FILLER
X(16)
CFQCZ000

... 1 LINE EXCLUDED ...

02 FILLER
X(16)
03 APRIL
2006


Remaining lines excluded

Other Fields Screen
The Other Fields screen, shown in Figure 9-8 on page 9-8, displays other fields and
literals that have the same value as the selected field in the extended search.
9-8
Abend-AID for CICS User’s Guide
Figure 9-8. Other Fields Screen





To display the Literals With Same Value, select Literal


Fields with the Same Value



... 9 LINES EXCLUDED ...

01 WS-HEADER

02 FILLER
X(16)
CFQCZ000

... 1 LINE EXCLUDED ...

02 FILLER
X(16)
03 APRIL
2006

REMAINING LINES EXCLUDED

****************************** BOTTOM OF DATA *********************************


Abend-AID -------------------- Other Fields ------------ Row 000001 of 000006
COMMAND ===>
SCROLL ===> PAGE
==>
Other fields with the value of CFQCZ000
03 APRIL
2006
Program Call Trace Summary
For more information about the Program Call Trace Summary screen, see “Program Call
Trace Summary Screen” on page 8-24.
COBOL Perform Flow Screen
The COBOL Perform Flow screen, shown in Figure 9-9 on page 9-9, lists the active
PERFORM PROCEDURE statement flow through the COBOL program that occurred prior
to the abend; or for calling programs, the flow prior to the call. This feature is available
for Enterprise COBOL only, requires the viewing server to be using Compuware Shared
Services (CSS) Release 8.8 or more current, and the DDIO listing to have been processed
with CSS Release 8.8 and the COBOL compiler option LIST.
This screen is accessed from the Program Summary Information screen (Figure 9-2 on
page 9-4) by entering the W line command.
COBOL Perform Flow reports only those PERFORM verbs that actually exist in the
executed module. When you compile with OPTIMIZE(STD) or OPTIMIZE(FULL), any
PERFORM verbs used in the source that are converted by the IBM compiler to inline code
cannot be displayed.
The Abend-AID for CICS installation library INS (formerly, TKAZSAMP) provides sample
job $FLOSAMP to demonstrate option W (PERFORM Flow).
Displaying Additional Transaction Abend Information
9-9
Figure 9-9. COBOL Perform Flow Screen







To display the abending statement select
ABEND STMT

To display the initial entry into this listing, select ENTRY


Source Line
Active PERFORM PROCEDURE statements

*******************************************************************************
000015
PERFORM CREATE-ABEND

000023
PERFORM NEST1

000041
PERFORM NEST1A

000029
PERFORM NEST1B

000058
PERFORM NEST2

000035
PERFORM NEST2A

000047
PERFORM NEST2B

-------------------------------------------------------------------------------
COBTST01
SOURCE LISTING STATEMENTS AT TIME OF ABEND

-------------------------------------------------------------------------------
000012
PROCEDURE DIVISION.

000013
PERFORM MOVE-SPACES. 
Abend-AID ---------------COMMAND ===>
COBOL Perform Flow --------- Row 000001 of 000060
SCROLL ===> PAGE
==>
Source Program Name... COBTST01
Program Compile Date.. 12APR2011
Source Listing Date... 12APR2011
Program Compile Time.. 10:42:41
Source Listing Time... 10:42:41
Using the PF8 (DOWN) key, scroll down to the next page to see the procedure statements
and the source listing in their entirety. You can use the cursor point-and-shoot feature to
position the cursor at the ABEND STMT field and press the Enter key to display the
abending statement. You can also use the cursor point-and-shoot feature to position the
cursor at the ENTRY field and press the Enter key to reposition the display at the initial
procedure statement.
Program Levels Screen
The Program Levels screen, shown in Figure 9-10, displays the program logical levels in
effect for this transaction. Access this screen from the Program Information menu, which
is described on page 9-1.
Figure 9-10. Program Levels Screen
Abend-AID ------------------- Program Levels ----------- Row 000001 of 000001 
COMMAND ===>
SCROLL ===> PAGE 

C Display Channels


Invoking Current
COMMAREA

Level Program
Program
COMMAREA Length
Channels

***** ******** ******** ******** ******** ********

1
CWDEMCHC CICS
00000000 00000000 YES

***************************** BOTTOM OF DATA ********************************









Enter the C (Display Channels) line command next to the Level field, or use the cursor
point-and-shoot feature to tab to the YES in the Channels field and press Enter to display
the Channels screen, which is described below.
9-10
Abend-AID for CICS User’s Guide
Channels Screen
The Channels Screen, shown in Figure 9-11, displays the channels associated with a
program. Access this screen from the Program Level screen, which is described above.
Figure 9-11. Channels Screen
Abend-AID ---------------------- Channels -------------- Row 000001 of 000003 
COMMAND ===>
SCROLL ===> PAGE 

Program.... FXCHAN02


C Display Containers


Number of
Container

Channel
Current Creator
Containers Pool Size

**************** ******* ******** ********** **********

CHANNEL001
YES
FXCHAN01
3
000000F6

CHANNEL04A
NO
FXCHAN02
1
00000028

CHANNEL004
NO
FXCHAN02
1
00000028

***************************** BOTTOM OF DATA ********************************





Enter the C (Display Containers) line command next to the Channel field, or use the
cursor point-and-shoot feature to tab to the channel name in the Channels field and
press Enter to display the Containers Screen, which is described below.
Containers Screen
The Containers screen, shown in Figure 9-12, displays the containers associated with a
channel. Access this screen from the Channels screen, which is described above.
Figure 9-12. Containers Screen
Abend-AID --------------------- Containers ------------- Row 000001 of 000018 
COMMAND ===>
SCROLL ===> PAGE 

Program...... WSC076
Current.......... YES

Channel...... DFHAHC-V1
Creator.......... DFHMIRS


S Display Segments


Data
Segment

Container
Length
Type CCSID Address
Data

**************** ******** **** ***** ***************** *******

WSC076I
0000035B BIT
37 00000048_8041E004

DFHWS-BODY
0007A120 CHAR
1208 00000048_80395004 YES

DFHWS-XMLNS
000000D7 CHAR
1208 00000048_80394004

DFHWS-SOAPLEVEL
00000004 BIT
37 00000048_80393004

DFHRESPONSE
00000000 CHAR
37 00000000_00000000

DFH-HANDLERPLIST 00000000 CHAR
37 00000000_00000000

DFHFUNCTION
00000010 CHAR
37 00000048_80392004

DFHWS-URI
0000001E CHAR
37 00000048_80391004

DFHREQUEST
000001D0 CHAR
819 00000048_80390004

DFHWS-RESPWAIT
00000004 BIT
37 00000048_8038F004

DFH-SERVICEPLIST 00000000 CHAR
37 00000000_00000000

DFHWS-PIPELINE
00000008 CHAR
37 00000048_8038E004

DFHWS-USERID
00000008 CHAR
37 00000048_8038D004
Use the S (Display Segments) line command to display the segments associated with this
segment, as shown in the Container Segments screen (Figure 9-13 on page 9-11).
Displaying Additional Transaction Abend Information
9-11
Use the cursor point-and-shoot feature to tab to the data in the Address field and press
Enter to display the data in hexadecimal format on the Memory Display screen, which is
explained in “Using the Memory Display Screen” on page 5-2.
Container Segments Screen
The Container Segments screen, shown in Figure 9-13, displays the segments associated
with a container. Access this screen by entering the S (Display Segments) line command
next to a container on the Containers screen (Figure 9-12 on page 9-10).
Figure 9-13. Container Segments Screen
Abend-AID ----------------- Container Segments --------- Row 000001 of 000016 
COMMAND ===>
SCROLL ===> PAGE 

Container.... DFHWS-BODY
Length........... 0007A120

Data Type.... CHAR
CCSID............ 1208


Length

Address
of Data

*****************
********

00000048_80395004
000053B1

00000048_8039B004
00007FFF

00000048_803A4004
00007FFF

00000048_803AD004
00007FFF

00000048_803B6004
00007FFF

00000048_803BF004
00007FFF

00000048_803C8004
00007FFF

00000048_803D1004
00007FFF

00000048_803DA004
00007FFF

00000048_803E3004
00007FFF

00000048_803EC004
00007FFF

00000048_803F5004
00007FFF

00000048_803FE004
00007FFF

00000048_80407004
00007FFF

00000048_80410004
00007FFF 
Use the cursor point-and-shoot feature to tab to the data in the Address field and press
Enter to display the data in hexadecimal format on the Memory Display screen, which is
explained in “Using the Memory Display Screen” on page 5-2.
Optional z/Architecture Features Screen
The Optional z/Architecture Features screen, shown in Figure 9-14 on page 9-12, displays
the unavailable z/Architecture hardware facility when the abend is due to execution of an
opcode on hardware that does not support the instruction. Access this screen from the
Supporting Information section of the Diagnostic Summary or by entering the ARCH
fast-path command on any relevant screen.
9-12
Abend-AID for CICS User’s Guide
Figure 9-14. Optional zArchitecture Features Screen
Abend-AID ---------- Optional z/Architecture Features -- Row 000001 of 000045 
COMMAND ===>
SCROLL ===> PAGE 

Installed z/Architecture Extensions:


"N3" instructions are available

z/Architecture architectural mode is installed

z/Architecture architectural mode is active

DAT-Enhancement Facility 1

ASN-and-LX-Reuse Facility

Store-Facility-List-Extended Facility

Enhanced-DAT Facility

Sense-Running-Status Facility

Conditional-SSKE Facility

Configuration-Topology Facility

Extended-Translation Facility 2

Message-Security Assist (MSA)

Cryptographic Assist Facility

Long-Displacement Facility

Long-Displacement Facility has high performance option

HFP-Multiply-and-Add/Subtract Facility

Extended-Immediate Facility

Extended-Translation Facility 3

HFP-Unnormalized-Extensions Facility 
COBOL Storage Areas Menu
Note:
The screens containing formatted data that are described in this section are
available only if the program was compiled with the Compuware COBOL
language processor.
The COBOL Storage Areas menu, shown in Figure 9-15 on page 9-13, lets you access four
screens that display all storage and memory information for all supported versions of
COBOL programs: the Program Listing screen for working storage as described in
“Working Storage” on page 9-13, the Program Listing screen for the Linkage Section as
described in “Linkage Section” on page 9-13, the Memory Display for External Cells as
described in “External Cells” on page 9-14, and the Memory Display for Task Global Table
as described in “Task Global Table” on page 9-14. Further, for COBOL for OS/390 and VM
and COBOL for MVS and VM, you can access two additional screens: the Program Listing
screen for local storage as described in “Local Storage” on page 9-14 and the Memory
Display for DSA as described in “Dynamic Storage Area” on page 9-15.
Access the COBOL Storage Areas menu from the Program Link Information screen or the
Program Summary Information screen by entering S as a line command next to any
COBOL program. You can also access this menu by using the cursor point-and-shoot
feature and pressing Enter at the Storage Areas field on the Program Detail screen or by
entering COBOL program-name as a fast-path command on any Abend-AID for CICS
screen.
Displaying Additional Transaction Abend Information
9-13
Figure 9-15. COBOL Storage Areas Menu



Abend-AID ------------------- Cobol Storage Areas ---------------------------
COMMAND ===> 
Program..... CCAADEMO







1
WORK
Working Storage

2
LINK
Linkage Section

3
EXTRN
External Cells
4
TGT
Task Global Table
5
LOCAL
Local Storage
6
DSA
Dynamic Storage Area




Working Storage
The Program Listing screen for working storage, shown in Figure 9-16, displays the
Working-Storage Section of the program listing for the selected program. Scroll up and
down throughout the program listing from this screen. In addition to the WorkingStorage Section, Abend-AID for CICS displays the Linkage and Local-Storage Sections. Use
the cursor point-and-shoot feature and press Enter at any entry in the highlighted value
field to display the selected data in vertical-hexadecimal format. Press Enter at the RESET
field to display the last abending/last executed statement as the first line. Besides
accessing the Program Listing screen for working storage from the Program Detail screen,
you can access this screen from the COBOL Storage Areas menu or by entering WORK
program-name as a fast-path command on any Abend-AID for CICS screen.
Figure 9-16. Program Listing Screen for Working Storage
Abend-AID --------------- Program Listing --------------- Row 000001 of 000307
COMMAND ===>
SCROLL ===> PAGE
==>
Program............... CCAADEMO

Program Compile Date.. 12JUN2007
Source Listing Date... 12JUN2007

Program Compile Time.. 15:58:26
Source Listing Time... 15:58:26


To reset display to the abending/last executed statement, select RESET

To reset display to the point of entry into this listing, select ENTRY


Source Line

*******************************************************************************
DATA DIVISION.
WORKING-STORAGE SECTION. 
77 FILLER
X(12)
CCAADEMO WS:
77 PAYMAP1-LEN
S9(4)
COMP
+80
77 PAYMAP1A-LEN
S9(4)
COMP
+1133
77 PAYMAP2-LEN
S9(4)
COMP
+800
77 EMP-REC-LEN
S9(4)
COMP
+80
77 EMP-KEY-LEN
S9(4)
COMP
+5
77 CURR-PAY
9(5)V99
0000000
77 CURR-TAXES
9(5)V99
0000000
77 EMP-TBL-SUB
# S9(3)
00{
77 SAVE-SUBSCRIPT
# S9(5)
COMP-3
LOW-VALUES
77 SUBROUTINE-C-OR-D
X(1)
C
77 DUMMY-LEN
S9(4)
COMP
+8
Linkage Section
The Program Listing screen for the Linkage Section, shown in Figure 9-17 on page 9-14,
displays the Linkage Section of the program listing for the selected program. You can
scroll up and down throughout the program listing from this screen. In addition to the
9-14
Abend-AID for CICS User’s Guide
Linkage Section, Abend-AID for CICS displays the Working-Storage and Local-Storage
Sections. Use the cursor point-and-shoot feature and press Enter at any entry in the
highlighted value field to display the selected data in vertical-hexadecimal format. Press
Enter at the RESET field to display the abending/last executed statement as the first line.
You can access the linkage section screen from the COBOL Storage Areas menu or by
entering LINK program-name as a fast-path command on any Abend-AID for CICS
screen.
Figure 9-17. Program Listing Screen for Linkage Section
Abend-AID --------------- Program Listing --------------- Row 000221 of 000307
COMMAND ===>
SCROLL ===> PAG
E
==>
Program............... CCAADEMO

Program Compile Date.. 12JUN2007
Source Listing Date... 12JUN2007

Program Compile Time.. 15:58:26
Source Listing Time... 15:58:26


To reset display to the abending/last executed statement, select RESET

To reset display to the point of entry into this listing, select ENTRY


Source Line

*******************************************************************************
LINKAGE SECTION.
01 DFHEIBLK
02 EIBTIME
S9(7)
COMP-3
+225738
02 EIBDATE
S9(7)
COMP-3
+94300
02 EIBTRNID
X(4)
AADM
02 EIBTASKN
S9(7)
COMP-3
+70
02 EIBTRMID
X(4)
S121
02 DFHEIGDI
S9(4)
COMP
LOW-VALUES
02 EIBCPOSN
S9(4)
COMP
+6
02 EIBCALEN
S9(4)
COMP
+1
02 EIBAID
X(1)
’
02 EIBFN
X(2)
X’0402’
02 EIBRCODE
X(6)
X’002000000000’
02 EIBDS
X(8)
LOW-VALUES
02 EIBREQID
X(8)
LOW-VALUES
External Cells
The COBOL base locator external (BLX) cell list is displayed in hexadecimal format on
the Memory Display screen, which is explained in “Using the Memory Display Screen”
on page 5-2. Access the Memory Display screen for external cells storage from the COBOL
Storage Areas menu or by entering EXTRN program-name as a fast-path command on any
Abend-AID for CICS screen.
Task Global Table
The Task Global Table (TGT) storage is displayed in hexadecimal format on the Memory
Display screen, which is explained in “Using the Memory Display Screen” on page 5-2.
Access the Memory Display screen for TGT storage from the COBOL Storage Areas menu
or by entering 
TGT program-name as a fast-path command on any Abend-AID for CICS screen.
Local Storage
Note:
This screen is available for COBOL for OS/390 and VM, and COBOL for MVS and
VM programs only.
The Program Listing screen for local storage, shown in Figure 9-18 on page 9-15, displays
the local storage cells that were allocated to the specified program at the time the abend
occurred. Scroll up and down throughout the program listing from this screen. In
addition to the Local-Storage Section, Abend-AID for CICS displays the Working-Storage
Displaying Additional Transaction Abend Information
9-15
and Linkage Sections. Use the cursor point-and-shoot feature and press Enter at any entry
in the highlighted value field to display the selected data in vertical-hexadecimal format.
Press Enter at the RESET field to display the abending/last executed statement as the first
line. Access the local storage screen from the COBOL Storage Areas menu or by entering
LOCL program-name as a fast-path command on any Abend-AID for CICS screen.
Figure 9-18. Program Listing Screen for Local Storage
Abend-AID -------------------- Program Listing ----------- Row 000104 of 000307
COMMAND ===>
SCROLL ===> PAGE
==>
Program............... CCAADEMO

Program Compile Date.. 12JUN2007
Source Listing Date... 12JUN2007

Program Compile Time.. 15:58:26
Source Listing Time... 15:58:26


To reset display to the abending/last executed statement, select RESET

To reset display to the point of entry into this listing, select ENTRY


Source Line

**************************************************************************** 
LOCAL-STORAGE SECTION.
01 LS-LITERAL-A00
02 FILLER
X(16)
================
02 FILLER
X(16)
LOCAL STOR-A 000
02 FILLER
X(16)
----------------
02 FILLER
X(16)
LOCAL STOR-A 001
02 FILLER
X(16)
----------------
02 FILLER
X(16)
LOCAL STOR-A 002
02 FILLER
X(16)
----------------
02 FILLER
X(16)
LOCAL STOR-A 003
02 FILLER
X(16)
----------------
02 FILLER
X(16)
LOCAL STOR-A 004
02 FILLER
X(16)
----------------
02 FILLER
X(16)
LOCAL STOR-A 005
02 FILLER
X(16)
----------------
02 FILLER
X(16)
LOCAL STOR-A 006
Dynamic Storage Area
Note:
This screen is available for COBOL for OS/390 and VM, and COBOL for MVS and
VM programs only.
The Dynamic Storage Area (DSA) is displayed in hexadecimal format on the Memory
Display screen, which is explained in “Using the Memory Display Screen” on page 5-2.
Access the Memory Display screen for DSA storage from the COBOL Storage Areas menu
or by entering DSA program-name as a fast-path command on any Abend-AID for CICS
screen.
PL/I Storage Selection List
Note:
The screens containing formatted data that are described in this section are
available only if the program was compiled with the Compuware PL/I language
processor.
Available only with source support enabled, the PL/I Storage Selection List, shown in
Figure 9-19 on page 9-16, displays the PL/I internal procedures for the selected
transaction abend. Each internal procedure entry represents a PL/I library procedure,
internal procedure, begin block, or on-unit. Only those active at the time of the failure
are shown.
Display formatted storage, as shown in Figure 9-20 on page 9-16, for an internal
procedure entry by entering the S line command next to it. Further, you can display the
menu for accessing different storage areas for the selected program in hexadecimal
9-16
Abend-AID for CICS User’s Guide
format, as shown in Figure 9-21 on page 9-17, by entering the M line command next to
it.
Access the PL/I Storage Selection List by entering the S line command next to a PL/I
program on the Program Summary Information or Program Link Information screen, or if
source support is enabled, by using the cursor point-and-shoot feature and pressing Enter
at the Storage Areas field on the Program Detail screen.
Figure 9-19. PL/I Storage Selection List
Abend-AID -------------- PL/1 Storage Selection List ----Row 000001 of 000006
COMMAND ===>

Load module............................ RFDPLI61
CSECT.................................. RFDPLI61
External Procedure..................... RFDPLI6 

S Format Storage
M Storage Areas 

Owning Internal Procedure
Offset
Generation
******************************* ********
********
_ RFDPLI6
00000008
0
_ BEGIN_BLOCK_AT_OFFSET_000178
00000178
0
_ BEGIN_BLOCK_AT_OFFSET_000270
00000270
0
_ PROCESS_ONE
0000041C
0
_ PROCESS_TWO
000005A8
0
_ PROCESS_THREE
00000690
0
SCROLL ===> PAGE
PL/I Storage Display
Available only with source support enabled, the PL/I Storage Display, shown in Figure
9-20 on page 9-16, displays formatted program storage for the selected internal
procedure. Use the cursor point-and-shoot feature and press Enter at a storage field value
to display the data in vertical-hexadecimal format.
Access the PL/I Storage Display by entering the S line command next to an internal
procedure on the PL/I Storage Selection List.
Figure 9-20. PL/I Storage Display
Abend-AID ----------------- PL/I Storage Display -------- Row 000001 of 000122
COMMAND ===>
SCROLL ===> PAGE
==>
Program storage for RFDPLI61
Compiled 27JUN2004 at 16:54:49
External Procedure Name..... RFDPLI6
Internal Procedure Name..... RFDPLI6
Generation...
0
Internal Procedure offset... 00000008 

Field name, type and description
Field value 

1
DFHCNSTS
STATIC
2 DFHLDVER
CHAR(22)
LD TABLE DFHEITAB 320.
2 DFHEIB0
FIXED BIN(15)
>> LOW-VALUES <<
2 DFHEID0
FIXED DEC(7)
2 DFHEICB
CHAR(8)
>> SPACES << 

DFHEPI
ENTRY
DFHEIPTR
Displaying Additional Transaction Abend Information
9-17
PL/I Storage Areas Menu
The PL/I Storage Areas menu, shown in Figure 9-21, lets you access various areas of PL/I
storage information:
• Automatic storage areas as described in “Automatic Storage Areas” on page 9-17
• Static storage areas as described in “Static Storage Areas” on page 9-18.
• Control storage area as described in “Controlled Storage Area” on page 9-18.
• External storage areas as described in “External Storage Areas” on page 9-19
Access the PL/I Storage Areas menu by entering the M line command next to a PL/I
internal procedure on the PL/I Storage Selection List, or by using the cursor point-andshoot feature and pressing Enter at the Storage Areas field on the Program Detail screen if
source support is not enabled, or by entering PLI program-name as a fast-path command
on any Abend-AID for CICS screen.
Note:
For VisualAge PL/I and more current versions, the fourth option is not available.
Figure 9-21. PL/I Storage Areas Menu
Abend-AID ------------------ PL/I Storage Areas -----------------------------
COMMAND ===>


Program..... RFDPLI61 

1 AUTO
Automatic Storage Areas 

2 STATIC
Static Storage Area 

3 CONTROL Controlled Storage Area 

4 EXTERNAL External Storage Areas 
Automatic Storage Areas
The PL/I Automatic Storage List, shown in Figure 9-22 on page 9-18, lists the name,
address, length, owning internal procedure name, and generation number of each PL/I
automatic storage area allocated while executing the selected program. Automatic storage
areas are temporary storage blocks created as the selected program executes. Each
automatic storage area represents a PL/I library procedure, internal procedure, begin
block, or on-unit. These storage blocks remain allocated until program execution ends in
the PL/I block containing the storage declaration. The most current generation of the
automatic storage is generation zero.
Access the PL/I Automatic Storage List from the PL/I Storage Areas menu or by entering
AUTO program-name as a fast-path command on any Abend-AID for CICS screen.
9-18
Abend-AID for CICS User’s Guide
Figure 9-22. PL/I Automatic Storage List
Abend-AID -------------- PL/1 Automatic Storage List ----- Row 000001 of 000006
COMMAND ===>
SCROLL ===> PAGE


Automatic storage referenced by program RFDPLI61 

Name
Address
Length
Owning Internal Procedure
Generation
******** ******** ******** ******************************* ********
PLIAUT01 0010C7D0 00000198 PROCESS_THREE
0
PLIAUT02 0010C610 00000198 PROCESS_TWO
0
PLIAUT03 0010C478 00000198 PROCESS_ONE
0
PLIAUT04 0010C180 000002F8 BEGIN_BLOCK_AT_OFFSET_000270
0
PLIAUT05 0010B7C0 000009C0 BEGIN_BLOCK_AT_OFFSET_000178
0
PLIAUT06 00107C60 00000700 RFDPLI6
0 

****************************** BOTTOM OF DATA ********************************* 
After selecting the PL/I Automatic Storage List, access the Memory Display screen for PL/I
automatic storage by using the cursor point-and-shoot feature and pressing Enter at the
Name field. The Memory Display screen is described in “Using the Memory Display
Screen” on page 5-2.
Static Storage Areas
Static storage areas are those storage locations allocated when the selected program is
loaded, and which remain allocated until the selected program ends. Static storage areas
are displayed in hexadecimal format on the Memory Display screen, which is explained
in “Using the Memory Display Screen” on page 5-2. Access the Memory Display screen
for static storage areas from the PL/I Storage Areas menu or by entering STATIC programname as a fast-path command on any Abend-AID for CICS screen.
Controlled Storage Area
The PL/I Controlled Storage List, shown in Figure 9-23, lists the name, address, length,
pseudo register name, and generation number of each PL/I controlled storage area that
was allocated while executing the selected program. Each controlled storage area
represents a PL/I structure that has been declared with the controlled attribute. The
controlled attribute allows multiple procedures to access the same PL/I structure. These
storage blocks remain allocated until program execution ends in the PL/I block
containing the storage declaration. The most current generation of the controlled storage
is generation zero.
Access the PL/I Controlled Storage List from the PL/I Storage Areas menu or by entering
CONTROL program-name as a fast-path command on any Abend-AID for CICS screen.
Figure 9-23. PL/I Controlled Storage List
Abend-AID -------------- PL/1 Controlled Storage List ---- Row 000001 of 000003
COMMAND ===>
SCROLL ===> PAGE


Controlled storage referenced by program RFDPLI61 

Name
Address
Length
Pseudo Register Name Generation
******** ******** ******** ********
********
CTL 0000 1020D5F8 00002EE0
0
CTL 0001 10210528 00000008
0
CTL 0002 10210550 00000008
0
****************************** BOTTOM OF DATA *********************************
After selecting the PL/I Controlled Storage List, access the Memory Display screen for
PL/I controlled storage by using the cursor point-and-shoot feature and pressing Enter at
Displaying Additional Transaction Abend Information
9-19
the Name field. The Memory Display screen is described in “Using the Memory Display
Screen” on page 5-2.
External Storage Areas
Note:
This screen is not available for VisualAge PL/I and more current PL/I versions.
The PL/I External Storage List, shown in Figure 9-24, lists the name, address, and length
of each PL/I external storage area that was allocated while executing the selected
program. Each external storage area represents a PL/I structure that has been declared
with the external attribute. The external attribute allows multiple procedures to access
the same PL/I structure.
Access the PL/I External Storage List from the PL/I Storage Areas menu or by entering
EXTERNAL program-name as a fast-path command on any Abend-AID for CICS screen.
Figure 9-24. PL/I External Storage List
Abend-AID --------------- PL/1 External Storage List ----Row 000001 of 000003
COMMAND ===>
SCROLL ===> PAG
E 

External storage referenced by program RFDPLI61 

Name
Address
Length
******** ******** ********
$EXT13
107029F8 000000C8
$EXT12
10702AC0 000000C8
$EXT11
10702B88 000000C8
****************************** BOTTOM OF DATA *********************************
After selecting the PL/I External Storage List, access the Memory Display screen for PL/I
external storage by using the cursor point-and-shoot feature and pressing Enter at the
Name field. The Memory Display screen is described in “Using the Memory Display
Screen” on page 5-2.
Assembler Storage Menu
The Assembler Storage Menu (Figure 9-25) displays the storage areas that were available
during a program call or at the time of the abend. Access this screen by issuing the S line
command on the Program Link Information screen (Figure 9-2) or the Program Summary
Information screen (Figure 9-3) or by using the cursor point-and-shoot feature to select
the Storage Area field on the Program Detail screen (Figure 8-6 on page 8-6).
Note:
This screen is only accessible if the selected program was assembled with the
Compuware Assembler language processor.
9-20
Abend-AID for CICS User’s Guide
Figure 9-25. Assembler Storage Menu
Abend-AID --------------- Assembler Storage Menu ------ Row 000001 of 000004 
COMMAND ===>
SCROLL ===> PAGE 

Program Storage for CSECT... CCAADEMA

In load module.............. CCAADEMA
Program Compile Date... 04/21/06

Current offset.............. 0000020E
Listing Date........... 04/21/06

Addresses resolved using.... AMODE 31
Listing Time........... 17.57


S Select Active Using


Using

Section address
Register
Section Name
Section Type

***************** ********** ************** **************

00000000_380000D0 R11
DFHEIBLK
DSECT

00000000_B8F00028 R3
CCAADEMA
CSECT

00000000_B8F01028 R4
CCAADEMA
CSECT

00000000_00140018 R13
DFHEISTG
DSECT

**************************** BOTTOM OF DATA ****************************** 





To access the storage area information specific to an address, type an S next to the
address and press Enter.
Assembler Storage Area Screen
The Assembler Storage Area screen (Figure 9-26) displays the fields contained within the
selected program storage area. It provides information about each field such as the field
offset, field label, statement number, and field contents. Access this screen by issuing the
S line command on the Assembler Storage Menu.
Figure 9-26. Assembler Storage Area Screen
Abend-AID --------------- Assembler Storage Area ------ Row 000001 of 000031 
COMMAND ===>
SCROLL ===> PAGE 
==> 
Program Storage for CSECT... CCAADEMA
Program Compile Date... 04/21/06

In load module.............. CCAADEMA
Listing Date........... 04/21/06

Current offset.............. 0000020E
Listing Time........... 17.57

Addresses resolved using.... AMODE 31

Section Name................ DFHEIBLK
Using.................. R11


Field
Field

address
Offset
Statement Label
Statement
Hex
Charac 
******** ******* *******
********************************************** 
380000D0 +000000
71
EIBTIME DS PL4
0175821C
..b.

380000D4 +000004
72
EIBDATE DS PL4
0106111F
....

380000D8 +000008
78
EIBTRNID DS CL4
C1C1C4C1
AADA

380000DC +00000C
79
EIBTASKN DS PL4
0000054C
...<

380000E0 +000010
80
EIBTRMID DS CL4
F1F1F3F9
1139

380000E4 +000014
81
EIBRSVD1 DS H
0000
..

380000E6 +000016
82
EIBCPOSN DS H
0006
..

380000E8 +000018
83
EIBCALEN DS H
0001
..

380000EA +00001A
84
EIBAID
DS CL1
7D
'

380000EB +00001B
85
EIBFN
DS CL2
020A
..

380000ED +00001D
86
EIBRCODE DS CL6
00000000 0000
...... 
If the information displayed in the Hex or Character columns is truncated, place the
cursor on the desired Field Address and press Enter to access the Memory Display screen
(Figure 9-27 on page 9-21) for that field.
Displaying Additional Transaction Abend Information
9-21
Figure 9-27. Memory Display Screen
Abend-AID ------------------- Memory Display -------------------------------- 
COMMAND ===>
SCROLL ===> PAGE 

Clip Prev Next Lock 
Start Addr: 380000D0
Comment:


Address
Offset
Word 1
Word 2
Word 3
Word 4
Storage

380000D0 +00000000 0175821C 0106111F C1C1C4C1 0000054C * b
AADA.. <* 
380000E0 +00000010 F1F1F3F9 00000006 00017D02 0A000000 *1139... . ' ...* 
380000F0 +00000020 000000C3 C3C1C1C5 D4D7C600 00000000 *...CCAAEMPF.....* 
38000100 +00000030 00000040 40404040 40404000 00000000 *...
.....* 
38000110 +00000040 00000000 00000000 00000000 00000000 *................* 
38000120 +00000050 00000000 00000000 00000000 00000000 *................* 
38000130 +00000060 00000000 00000000 00000000 00000000 *................* 
38000140 +00000070 00000000 00000000 00000000 00000000 *................* 
38000150 +00000080 00000000 00000000 00000000 00000000 *................* 
38000160 +00000090 00000000 00000000 00000000 00000000 *................* 
38000170 +000000A0 00000000 00000000 00000000 00000000 *................* 
38000180 +000000B0 00000000 00000000 00000000 00000000 *................* 
38000190 +000000C0 00000000 00000000 00000000 00000000 *................* 
380001A0 +000000D0 00000000 00000000 00000000 00000000 *................* 
380001B0 +000000E0 00500000 0000009A 00000000 00000000 *.&..... ........* 
380001C0 +000000F0 B1BC8800 00000000 03000100 00000000 * h..... . .....* 
Storage Disassembly Screen
The Storage Disassembly screen, shown in Figure 9-28, displays the selected program in
disassembled format. To scroll the Storage Disassembly display to a specific offset from
offset zero, enter +offset or -offset in the command field. To reposition the Storage
Disassembly to offset zero, enter RESET as a primary command. Use the cursor pointand-shoot feature and press Enter at the Address field to display the Memory Display,
which is described in “Using the Memory Display Screen” on page 5-2.
Access the Storage Disassembly screen by using the DISASM primary command, which is
described in “DISASM” on page 21-26, or by entering A as a line command on the
Program Link Information or the Program Summary Information screen
Figure 9-28. Storage Disassembly Screen
Abend-AID ------------------- Storage Disassembly ----------------------------
COMMAND ===>
SCROLL ===> PAGE 

Address
Offset
Object Code
Mnemonic and Operands
00168828 00000000 47F0 F070
B
112(,R15)
0016882C 00000004 23C3
LCDR R12,R3
0016882E 00000006 C3C1
DATA CA
00168830 00000008 C1C4
DATA AD
00168832 0000000A C5D4
DATA EM
00168834 0000000C D640 C3F2 40F1
OC
1010(65,R12),241(R4)
0016883A 00000012 4BF3 4BF2
SH
R15,3058(R3,R4)
0016883E 00000016 40F0 F661
STH
R15,1633(,R15)
00168842 0000001A F2F9 61F9 F440
PACK 505(16,R6),1088(10,R15)
00168848 00000020 F1F0 4BF5 F14B
MVO
3061(16,R4),331(1,R15)
0016884E 00000026 F1F4 0016 887C
MVO
22(16,R0),2172(5,R8)
00168854 0000002C 60E8 6C0C
STD
R14,3084(R8,R6)
00168858 00000030 0000
DATA
0016885A 00000032 0000
DATA
0016885C 00000034 5080 0308
ST
R8,776
00168860 00000038 0000
DATA
00168862 0000003A 0000
DATA
00168864 0000003C 0900
ISK
R0,0
00168866 0000003E 0000
DATA
00168868 00000040 0080
DATA
"
9-22
Abend-AID for CICS User’s Guide
If the registers were captured for a program and you disassemble the program, an
alternate storage disassembly screen is displayed (Figure 9-29). This version of the screen
identifies the program, load point, entry point, address of the program’s storage, and the
contents of the program’s registers. The disassembly begins with the abending PSW
location if the program is the abending program or, if it is not, with the last call location.
In addition, all instruction operands are tab-selectable. Use the cursor point-and-shoot
feature and press Enter at an operand in the Object Code field to display the Memory
Display for the selected register/offset combination.
Figure 9-29. Alternate Storage Disassembly Screen
Abend-AID ------------------- Storage Disassembly ----------------------------
COMMAND ===>
SCROLL ===> PAGE 

Program: CSECTTWO LPA: 08B1C000 EPA: 08B56AB0 Program Storage: 0006C018
0-7 0006C1B6 0006C95C 00068008 000684D4 00063330 00068A68 00068CC4 00068908
8-F 08B57008 00000000 88B1D028 08B56AB0 008B4000 0006C95C 88B56BCE 08B56BD8 

Disassembly begins with abending PSW location. 

Address
Offset
Object Code
Mnemonic and Operands
08B56BD0 00000120 08B5
DATA ..
08B56BD2 00000122 6BD8 0000
SD
R13,0(R8)
08B56BD6 00000126 0000
DATA
08B56BD8 00000128 90EC D00C
STM
R14,R12,12(R13)
08B56BDC 0000012C 4110 D98C
LA
R1,2444(,R13)
08B56BE0 00000130 501D 0008
ST
R1,8(R13)
08B56BE4 00000134 50D1 0004
ST
R13,4(R1)
08B56BE8 00000138 18D1
LR
R13,R1
08B56BEA 0000013A 18BF
LR
R11,R15
08B56BEC 0000013C 47F0 B118
B
280(,R11)
08B56BF0 00000140 0C0C
BASSM R0,R12
08B56BF2 00000142 0C0C
BASSM R0,R12
08B56BF4 00000144 0C0C
BASSM R0,R12
08B56BF6 00000146 0C0C
BASSM R0,R12
Data Locator Search Criteria Screen
The Data Locator Search Criteria screen, shown in Figure 9-30 on page 9-23, displays the
default list of data items that comprise the search criteria for COBOL programs that the
Abend-AID for CICS Data Locator facility uses. Modify this list or use the defaults. The
search criteria are unique to each user, and you can save a maximum of 70 at any one
time. String criteria are compared against COBOL user-defined names, picture criteria are
compared against COBOL picture clauses, and date criteria are compared against field
values of the storage contained in the dump.
Enter the corresponding letter for the line command to the left of a data item to execute
an Insert, Replicate, or Delete command. Enter X in the first column next to a data item
you want to exclude from the search. After you have saved your changes, if you want to
restore the defaults, enter DEFAULTS on the command line. Access the Data Locator
Search Criteria screen by pressing Enter at the FINDDATA field on the Data Locator
Results, the Program Link Information, or the Program Summary Information screen.
Displaying Additional Transaction Abend Information
9-23
Figure 9-30. Data Locator Search Criteria Screen
Abend-AID -------------- Data Locator Search Criteria ---- Row 000001 of 000013
COMMAND ===>
SCROLL ===> PAGE


Enter search criteria below. A "X" in the first column indicates the entry
is excluded. To restore defaults, enter DEFAULTS on the command line and
press the enter key.
______________________________________________________________________________ 

I Insert
R Replicate
D Delete 

Type
Substring Name or Data Value
* ****** ****************************************************************
_ _ STRING EIBDATE
_ _ STRING CALENDAR
_ X STRING ANNUAL
_ _ STRING YYMMDD
_ _ STRING MONTH
_ _ STRING JULIAN-DATE
_ X DATE
98000
_ _ DATE
99365
_ _ PICTURE XX
_ _ PICTURE X(4)
_ PICTURE 999
Data Locator Results Screen
The Data Locator Results screen, shown in Figure 9-31 on page 9-23, displays the results
of a search of a COBOL program. Abend-AID for CICS displays the COBOL storage section
definitions matching any of the specified criteria along with the COBOL procedure
division statements that reference them. The criteria used in the search are summarized
following any matches found.
The search is based on a default list of data items, which you can modify. To display the
list of data items, tab to the FINDDATA field and press Enter. The Data Locator Search
Criteria screen is displayed, as shown in Figure 9-30. To access the Data Locator Results
screen, enter the R line command next to a COBOL program on the Program Link
Information or Program Summary Information screen.
Figure 9-31. Data Locator Results Screen





YEARWINDOW N/A

"#" - Field data does not match PIC
"!" - Field matches DATE criteria

"@" - Field matches PIC criteria


Source Line

*******************************************************************************
DATA DIVISION.

WORKING-STORAGE SECTION.

77 SAVTRNID
@ X(4)
NMR.

01 DUMMY-EMP

02 FILLER
X(3)
X'1140C6'

02 DUMMY-PAYEMP1
X(5)
00001

02 ABCDE
REDEFINES DUMMY-PAYEMP1

03 ACTION
X
0

03 ABEND-CODE
@ X(4)
0001

01 PAYROLL-DATA-EMP001

02 PAY001-TYPE
X
N

02 PAY001-NAME
X(15)
MR. DAVID ABEND

02 PAY001-ADDRESS 
Abend-AID ---------------- Data Locator Results -------- Row 000001 of 000277
COMMAND ===>
SCROLL ===> PAGE
==>
To display the current Data Locator search criteria, select FINDDATA
9-24
Abend-AID for CICS User’s Guide
File Request Summary
The File Request Summary, shown in Figure 9-32, summarizes key identification data for
each file request on the storage chain at the time of the abend. Access the File Request
Summary from the Primary Options menu or by entering FILE as a fast-path command
on any Abend-AID for CICS screen.
Figure 9-32. File Request Summary
Abend-AID ---------------- File Request Summary -------- Row 000001 of 000004
COMMAND ===>
SCROLL ===> PAGE
==>
R Record Image D File Detail
F File Areas
I Recovery Information

File
File
Access Data
Maximum Key Remote
Remote
Name
Type
Method Type
Reclen
Len Name
System
Dataset N
******** ****** ****** ******** ******* *** ******** ******** *********
_ COLTVSAM LOCAL
VSAM
VARIABLE
80
5
CFXSRE0.T
_ NEWVSAM
LOCAL
VSAM
VARIABLE
80
5
CFXSRE0.T
_ NONRLS
LOCAL
VSAM
VARIABLE
80
5
CFXSRE0.T
_ MULTTEST Remote VSAM
N/A
80
5
UNKNOWN
****************************** BOTTOM OF DATA *******************************











Type a line command and press Enter to process it.
Enter the following line commands next to the file name in the File Name field to display
additional information about each file request:
• R: Valid for local files only. Displays the Record Image screen, which is described in
“Record Image Screen” on page 9-24
• D: Displays the File Detail screen, which is described in “File Detail Screens” on page
9-25.
• F: Displays the File-Related Areas screen, which is described in “File-Related Areas
Screen” on page 9-26.
• I: Valid for local files only. Displays the File Recovery Information screen, which is
described in “File Recovery Information Screen” on page 9-26.
Scroll right to display the dataset name of all open files.
Record Image Screen
Available for local files only, the Record Image screen, shown in Figure 9-33 on page 9-25,
displays the key and record data associated with the selected file request. Use the cursor
point-and-shoot feature and press Enter at a storage address to display the selected
storage data in vertical hexadecimal format. Access the Record Image screen from the
Local File Detail screen or by entering R as a line command next to a local file on the File
Request Summary screen.
Displaying Additional Transaction Abend Information
9-25
Figure 9-33. Record Image Screen
Abend-AID ----------------- Record Image ---------------- Row 000001 of 000015
COMMAND ===>
SCROLL ===> PAGE

Record RID at Address 0875A358 
Char 01000
Zone FFFFF
Digit 01000
1...+ 

Record Data at Address 0875A358 

Char 01000ADAMS
0100010000
Zone FFFFFCCCDE4444444444FFFFFFFFFF444444444444444444444444444444
Digit 010001414200000000000100010000000000000000000000000000000000
1...+...10....+...20....+...30....+...40....+...50....+...60 

Char
Zone 44444444444444444444
Digit 00000000000000000000
61...+...70....+...80 

File Detail Screens
The File Detail screens, shown in Figure 9-34 and Figure 9-35 on page 9-26, display
general file information, statistics, and status about the selected file. In addition, the
Local File Detail screen provides access to the Record Image screen. Use the cursor pointand-shoot feature and press Enter at the Record Image field to display the Record Image
screen, which is described in “Record Image Screen” on page 9-24.
Access the File Detail screens from the File Request Summary screen or by entering
FILEDET filename as a fast-path command on any Abend-AID for CICS screen.
Figure 9-34. Local File Detail Screen
Abend-AID ----------------- Local File Detail ------------------------------- 
COMMAND ===>


File......... COLTVSAM

Dataset Name. PFHSRE0.TEST.VSAM

To display the record image for this file, select Record Image


File Information
File Status


Access Method.......... VSAM
Status 1............ OPENED

Access Type............ KSDS - KEY
Status 2............ ENABLED

Record Length.......... 80
Last File Request... READ/UPDATE

Key Length............. 5
Record Level Sharing NO

Relative Key Position.. 0
RLS Locks........... NO

LSR Pool ID............ 1
DSN Validated....... YES


File Statistics


Add...................... 0
Read..................... 0

Browse................... 0
Update................... 0

Delete................... 0
Update Browse............ 0

ACBs Open................ 0
ACBs Open for Update..... 1


9-26
Abend-AID for CICS User’s Guide
Figure 9-35. Remote File Detail Screen
Abend-AID ------------------- Remote File Detail ----------------------------
COMMAND ===> 

Local File............... MULTTEST
Access Method............ VSAM
Remote File.............. MULTTEST
Maximum Record Length.... 80
Remote System............ S146
Key Length............... 17 

File Statistics 

Add...................... 0
Read..................... 4
Browse................... 0
Update................... 0
Delete................... 0
Update Browse............ 0 
File-Related Areas Screen
The File-Related Areas screen, shown in Figure 9-36, provides access to file-related storage
areas for the selected file. Access this screen by entering F as a line command on the File
Request Summary screen, or by entering FILEAREA filename as a fast-path command on
any Abend-AID for CICS screen.
Figure 9-36. File-Related Areas Screen
Abend-AID ----------------- File-Related Areas ------------------------------ 
COMMAND ===>


File......... CCAAEMPF

Dataset Name. PFHAMJ0.VSAM.DEMO.EMPLFILE


FCT Entry.............. 37F08168
DSN................. 37F0B370

VSWA................... 37EFC460
FLAB................ 37F25030

RPL.................... 37EFC468
FLLB................ 00000000

FRTE................... 37F26030
IFGLUWID............ 37F28080

FRAB................... 37F24128


Use the cursor point-and-shoot feature at a storage address to do the following:
• To display the selected storage data in hexadecimal format, tab to the address and
press the HEXD PF key to display the Memory Display screen, which is explained in
“Using the Memory Display Screen” on page 5-2.
• If applicable, to display the selected storage data in DSECT format, tab to the address
and press the DSECT PF key to display the DSECT Support screen, which is explained
in “Displaying Control Blocks in DSECT Format” on page 6-1.
File Recovery Information Screen
Available for local files only, the File Recovery Information screen, shown in Figure 9-37
on page 9-27, displays file recovery information for the selected file. Access this screen by
entering I as a line command next to a local file on the File Request Summary screen, or
by entering FILEREC filename as a fast-path command on any Abend-AID for CICS
screen.
Displaying Additional Transaction Abend Information
9-27
Figure 9-37. File Recovery Information Screen
Abend-AID --------------- File Recovery Information -------------------------
COMMAND ===> 

File......... COLTVSAM
Dataset Name. CFXSRE0.TEST.VSAM 

Journal ID.......................... 12
Journal Read Only Operations........ No
Journal Read Update Operations...... No
Journal Write Update Operations..... Yes
Journal Write Add Operations........ Yes
Synchronous Journaling for Reads.... No
Asynchronous Journaling for Writes.. Yes
Backout Logging..................... Yes
Forward Recovery.................... Yes
Forward Recovery Log ID............. 14
Forward Recovery Log Stream......... CFXRFD0.CF40CICS.DFHJ10 
CICS Web Interface Menu
For CICS applications using the CICS Web Interface (CWI), Abend-AID for CICS provides
enhanced diagnostics on the Diagnostic Summary screen, including an analysis of error
in the application using the CWI, describing an explanation of went wrong with the
application using the CWI, what action is taken by CICS, and suggestions to correct the
problem.
Using the cursor point-and-shoot feature, from the Diagnostic Summary in the
Supporting Information section, tab to the CWI field and press Enter to display the CICS
Web Interface menu, as shown in Figure 9-38. You can also access this menu directly
from the Abend-AID for CICS Primary Options menu by selecting the CWI option or by
entering CWI as a fast-path command on any Abend-AID for CICS screen.
The CICS Web Interface menu provides access to Web-specific information for the
abending program using the CWI, including Web request, Web application program, Web
attach transaction, Web alias transaction, Web message data, and sockets information.
Figure 9-38. CICS Web Interface Menu
Abend-AID ------------- CICS Web Interface ------------- Row 000001 of 000002 
COMMAND ===>
SCROLL ===> DATA 


The abending transaction CWXN was a Web attach task.






Related Web Information


1 BRIDGE
3270 Bridge Info
6 SOCKETST Sockets Listener Task


2 WEBREQ
Web Request
7 SOCKETSD Sockets Data


3 WEBAPPPG Web Appl Program
8 WEB3270 Web 3270 State Data


4 WEBATTTR Web Attach Tran
9 WEBDATA Web Data


5 WEBALIAS Web Alias Tran
10 DFHWBEP DFHWBEP Parameters

9-28
Abend-AID for CICS User’s Guide
LE Information Menu
The LE Information menu, shown in Figure 9-39, lets you access two screens that display
language environment information: the Language Environment Options screen as
described in “LE Options Control Block Screen” and the LE Information Summary screen,
as described in “LE Information Summary Screen” on page 9-28. Access the LE
Information menu from the Primary Options menu or by entering LEINFO as a fast-path
command on any Abend-AID for CICS screen.
Figure 9-39. LE Information Menu

Abend-AID ------------------- LE Information -------------------------------- 
OPTION ===> 

1
LEOCB
Language Environment Options 
2
LESUMM
LE Information Summary 
LE Options Control Block Screen
The LE Options Control Block screen, shown in Figure 9-40, displays the Language
Environment (LE) options available at the time of a COBOL, PL/I, or Assembler abend.
The screen also shows the LE version and from where the LE option was set. Access the LE
Options Control Block screen from the LE Information menu or by entering LEOCB as a
fast-path command on any Abend-AID for CICS screen.
Figure 9-40. LE Options Control Block Screen
Abend-AID ---------- LE Options Control Block ----------Row 000001 of 000060 
COMMAND ===>
Options in effect at time of error
OS/390 2.10.0
Option
************************************************************
ABPERC(NONE)
ABTERMENC(ABEND)
NOAIXBLD
ALL31(OFF)
ANYHEAP(16384,8192,ANYWHERE,FREE)
NOAUTOTASK
BELOWHEAP(8192,4096,FREE)
CBLOPTS(ON)
CBLPSHPOP(ON)
CBLQDA(ON)
CHECK(ON)
COUNTRY(US)
DEBUG
DEPTHCONDLMT(10)
SCROLL ===> PAGE 





Set From

**************

CEEDOPT

CEEDOPT

CEEDOPT

CEEDOPT

CEEDOPT

CEEDOPT

CEEDOPT

CEEDOPT

CEEDOPT

CEEDOPT

CEEDOPT

CEEDOPT

CEEDOPT

CEEDOPT

LE Information Summary Screen
The LE Information Summary screen, shown in Figure 9-41 on page 9-29, provides a
summary of the LE Information and allows navigation to other screens showing more
detailed LE information. Access the LE Information Summary screen from the LE
Information menu or by entering LESUMM as a fast-path command on any Abend-AID
for CICS screen.
Displaying Additional Transaction Abend Information
Figure 9-41. LE Information Summary Screen





Abend-AID --------------- LE Information Summary ---------------------------- 
COMMAND ===> 
LE version....................... LE FOR z/OS 1.7.0 
Common Anchor Area............... 00142608 
Parent CAA.......................
Enclave Data Block...............
Process Control Block............
Region Control Block.............
Condition Information Block......
Options Control Block............
LE Writable Stack Area...........
LE Enclave Storage Area..........
LE User Heap.....................
LE Anywhere Heap.................
LE Below Heap....................
LE User Stack Storage 
LE Library Stack Storage 
00000000
00140478
00169188
001051F8
00147F88
00140B80
00000000
00140940
360861E8
360821E8
00167178











9-29
9-30
Abend-AID for CICS User’s Guide
10-1
Chapter 10.
Managing Source Files
Chap 10
Compuware strongly recommends that you always use source support to make the best
use of Abend-AID for CICS. Source support gives you many additional diagnostic benefits
such as displaying your actual source code and providing an enhanced program listing
with merged data that is easy to read and does not require any hexadecimal calculations.
To obtain source support for your COBOL, PL/I, and Assembler programs, you need to
modify your compile/link-edit JCL to use the Compuware COBOL language processor,
the Compuware PL/I language processor, and the Compuware Assembler language
processor. Refer to the Compuware Shared Services User/Reference Guide for more information
about the COBOL, PL/I, and Assembler language processors.
This chapter describes how to manage source files and source shared directories using the
Source Directory screen. From this screen you can display user-defined source datasets,
and after you select a transaction abend, you can access the source datasets allocated to
the CICS region at the time of the abend. In addition to the Source Directory, the
following screens are described:
•
•
•
•
•
•
•
Source Program Directory
Source Dataset Information
Source Program Browse
Source Program Information
Source Mismatch Selection
Source Program Directory for source mismatch selection
Convert Program Compiler Listing
– Matching Listing Data Set Names
– Known Compiler Listings
• No Source Selected.
Source Directory Screen
The Source Directory screen lets you enter a dataset name for a specific source listing or a
source shared directory, as shown in Figure 10-4 on page 10-4, or additionally display the
source datasets and source shared directories allocated to the CICS region at the time of
the transaction abend, as shown in Figure 10-1 on page 10-2. Besides accessing the Source
Directory screen directly from the Abend-AID for CICS Primary Options menu, you can
access this screen by entering SD or SRCDIR as a fast-path command on any Abend-AID
for CICS screen.
Access the Source Directory screen as described above, noting:
• If you access this screen without first selecting a transaction entry, Abend-AID for
CICS displays the Source Directory screen with any user-defined source datasets.
• If you access this screen after selecting a transaction entry, Abend-AID for CICS
displays the Source Directory screen with not only any user-defined source datasets
but also the source datasets allocated to the CICS region at the time of the abend, as
shown in Figure 10-1 on page 10-2. Source datasets are allocated to the CICS region
using either an FCT entry or an SLSF001 DD statement, as described in the Abend-AID
for CICS Installation and Customization Guide.
10-2
Abend-AID for CICS User’s Guide
Figure 10-1. Source Directory Screen with List of User-Defined and CICS Source Datasets
Compuware Abend-AID --------- Source Directory ---------- Row 000001 of 000003
COMMAND ===>
SCROLL ===> PAGE
==>
To add a dataset to the list, select Add
S Directory
I Information
X Include/Exclude
D Delete










Defined
Remote
Dataset Name
Status
By
Server
******************************************** ******** ******** ********
_ AACICS.BETA.TEST.PGMFILE
User
AACSRVR3
_ AACICS.FX.BETA.DEMO.LISTFILE
User
AACSRVR3
_ AACICS.BETA.QA.SRCE.SHRDIR
CICS
_ CF.DEVL.CIMSCF01.CWPDDIO
CWPDDIO
_ AACICS.VSAM.PROGRAM.LISTING3
Server 
_ CICSUSR.COBOL.PROGRAM.SSD
SSD 
******************************* BOTTOM OF DATA *********************************
You can do the following on the Source Directory screen:
• Use the cursor point-and-shoot feature and press Enter at the Add field to display the
input window, as shown in Figure 10-4 on page 10-4. Enter a user-defined source
dataset name in the Dataset field to add a dataset to the list. All datasets in the list
are included in the search that Abend-AID for CICS makes to find the best source
listing match unless you explicitly exclude them from the search list.
• Enter S at any dataset name to display the Source Program Directory for that dataset,
as shown in Figure 10-6 on page 10-5.
• Enter I at any dataset name to display the Source Dataset Information screen, as
shown in Figure 10-2 on page 10-3.
• Enter X at any user-defined dataset name to include an excluded dataset or to
exclude an included dataset from the list of source datasets used in the search for the
best match for program source display.
• Enter D at any user-defined dataset name to delete the source dataset from the list.
Press Enter to confirm or End (PF3) to cancel the deletion.
Notes:
1. User-defined datasets are those added by a user. Any user with READ authority to view
the datasets can control their display on the Source Directory for his or her AbendAID for CICS session by using the X or D line commands. These commands affect
only the display of the user-defined source datasets list on the Source Directory for
the logged-on user who executes them and do not affect the actual datasets.
2. CICS datasets are those included in the CICS JCL or defined by an FCT entry to the
CICS region. The X (Include/Exclude) and D (Delete) line commands are not valid for
these source datasets.
3. Server datasets are Compuware Source Listing datasets that have been specified on the
MFDDXLSF DD statement. You can concatenate several datasets on the MFDDXLSF
DD statement. The X (Include/Exclude) and D (Delete) line commands are not valid
for these source datasets.
4. CWPDDIO is the scratchpad source listing dataset specified on the CWPDDIO DD
statement in the server JCL. The X (Include/Exclude) and D (Delete) line commands
are not valid for these source datasets.
5. CPWRPROC datasets are those inserted into the IDR User Data by the Compuware
Language Processor at the time the source listing entry is created.
6. CPWRREMT datasets are those inserted into the IDR User Data by the Compuware
Language Processor at the time the source listing entry is created. The site has set all
IDR datasets to be treated as REMOTE. The user MUST provide a valid user ID and
password for this entry. This entry cannot be excluded or deleted.
Managing Source Files
10-3
7. SSD datasets are those generated from the name of the load library from which the
program was loaded. The last node of the load library name is replaced with .SSD.
Figure 10-2. Source Dataset Information Screen
Compuware Abend-AID ---Source Dataset Information ------------------------
COMMAND ===> 

Dataset Name................. AACICS.BETA.DEMO.LISTFILE
Volume Serial................ PRD906
Dataset Type................. VSAM
Format Type.................. SOURCE LISTING FILE
Format Sub Type.............. AUTODELETE=DUPS
Block Size................... 4,089
Number of Blocks............. 900
Blocks per Group............. 8
Number of Groups............. 111
Allocated Groups............. 61
Max Extents per Member....... 64
Number of Directory Blocks... 6
Directory Entries per Block.. 18
Length of Directory Entry.... 220 
Using Distributed Viewing Support
Distributed Viewing Support (DVS) lets you view a CICS transaction abend entry using
source support when the source listings for the abending program reside on an MVS
system other than the one on which the abend occurred. For example, if you develop
applications at a central site and distribute them to other remote sites, DVS eliminates
the need to distribute source listing datasets with the applications.
If your site has implemented Distributed Viewing Support (DVS), you can display the list
of user-defined remote source listings (Figure 10-3) by entering the REMOTE fast-path
command on any related screen.
Figure 10-3. List of Remote Source FilesL





To update this list, select......... Update


Dataset Name
Error Message

******************************************** *********************************
AAUSER1.SLS

AAUSER1.TEST.SHRDIR

****************************** BOTTOM OF DATA *********************************


Compuware Abend-AID -- List of Remote Source Files ----- Row 000001 of 000002
COMMAND ===>
SCROLL ===> CSR
==>
User Id... AAUSER1
Press Enter at the Update field to display the Source Directory (Figure 10-1 on page 10-2).
From this screen, you can add a user-defined source dataset name for a listing that resides
on an MVS system other than the one on which the abend occurred by doing the
following:
1. Use the cursor point-and-shoot feature and press Enter at the Add field on the Source
Directory (Figure 10-1 on page 10-2) to display the input window, as shown in Figure
10-4 on page 10-4. Enter a user-defined source dataset name in the Dataset field to
add a dataset to the list.
2. Specify the name of the Abend-AID for CICS server running on the remote MVS
system in the Remote Server field.
10-4
Abend-AID for CICS User’s Guide
3. Specifying a user ID and password in the fields are optional when you are adding the
remote dataset to the list of source datasets. However, if you or other users add any
remote datasets, whenever you select a transaction entry from the Abend-AID
Directory, you are required to enter a valid user ID and password with the
appropriate READ authority to access the dataset on the remote MVS system, as
shown in the input window in Figure 10-5.
If you do not specify a valid user ID and password for the remote dataset displayed in
the window, that dataset will not be included in the list of source datasets searched
for a source listing corresponding to the transaction program in the selected
transaction entry. For security reasons, the user ID and password are not retained
from one Abend-AID for CICS session to another. Whenever you log onto the AbendAID for CICS server, you must enter the user ID and password for each remote dataset
in the list that you want to include in the search.
Instead of entering the user ID and password in the pop-up window shown in
Figure 10-5, you can access the Source Directory, press the Right PF key (PF11) to
scroll the display to the right, and add your user ID and password in the appropriate
corresponding fields for each remote dataset you want to include in the list of source
datasets searched for any transaction entries you want to view.
Figure 10-4. Add Source Dataset Window
Compuware Abend-AID--------- Source Directory --------- Row 000001 of 000003 
COMMAND ===>
SCROLL ===> PAGE 
==> 
To add a dataset to the list, select Add

+-------------------------------------------------------------+

S Direc | Specify source dataset name below
|

|
|

| Dataset ===>AACICS.BETA.TEST2.PGMLIST
| e
Re
Datas |
| r
Us
***** | If the dataset resides on another MVS system,
| *** **
FX.BET| specify the following
|

FX.BET|
|

FX.BET| Server Name ===>AACSRVR3
|

***** | Userid
===>TSOUSER
| *******
| Password
===>
|

|
|

| Server 1
End=PF03
|

+-------------------------------------------------------------+

Figure 10-5. Remote Dataset Access Window
Compuware Abend-AID------- Abend-AID Directory -------- Row 000001 of 000004 
COMMAND ===>
SCROLL ===> PAGE 
==>

M Menu
L Lock
H Dup History
R Recall
T Terminate Analysis

S Diag
U Unlock
I Information
E Migrate
C Change Priority

D Delete
G Messages A Analyze
P Print
N Contact Information 
+-------------------------------------------------------------+

Entry
| Remote Dataset Access
| s

******* |
| ****
0000004 | Dataset ===> AACICS.BETA.TEST2.PGMLIST
| ETE 
0000003 | Server
===> AACSRVR3
| ETE 
0000002 |
| ETE 
0000001 | Specify userid and password below (omit to exclude dataset) | ETE 
******* |
| *****
| Userid
===> _______
|

| Password ===>
|

|
|

| Help=PF01
End=PF03
|

+-------------------------------------------------------------+




Type a line command and press Enter to process it

Managing Source Files
10-5
4. Alternatively, if you know you do not want to include any of the remote datasets in
the search for source listings, access the Source Directory and enter the X
(Include/Exclude) line command to exclude them. If at a later date you choose to use
any of the remote datasets, you can again use the X line command to include them.
5. Further, if you think you will never want to include one or more of the remote
datasets in the search for source listings, you can use the D (Delete) command on the
Source Directory to remove the dataset(s) from the list of source datasets. This
command removes the dataset from the list of source datasets on the Source
Directory for your user ID only and does not perform any function against the
dataset itself. If circumstances change and you later want to use the deleted remote
dataset, you can add it to the list of source datasets for your Abend-AID for CICS
session(s), as explained in steps 1 through 3 above.
Source Program Directory
The Source Program Directory, shown in Figure 10-6, displays the source listings for the
selected dataset. Using the available line commands, you can select, lock or unlock,
delete, or display additional information for any of the listings. If you want Abend-AID
for CICS to automatically restore the mask and sort parameters from your last session on
the Source Program Directory, enable this functionality by using the User Profile screen,
as described in “User Profile Screen” on page 19-1.
Figure 10-6. Source Program Directory
Compuware Abend-AID ---- Source Program Directory ------ Row 000001 of 000014
COMMAND ===>
SCROLL ===> PAGE

Dataset Name..... AACICS.BETA.DEMO.LISTFILE 

S Select
L Lock
I Information
U Unlock
D Delete 

Compile
Compile Return
Locked
Completion
Program
Date
Time
Code
Language
Size
Status
Status
******** ********* ******** ****** ********* ****** ******** **********
_ CELPROG1 22JUN2014 10:55:35
4
COBIIR3
63K LOCKED-M COMPLETE
_ CCAADEMO 14APR2014 08:09:26
0
COBIIR3
191K LOCKED-M COMPLETE
_ CCAADEMO 26MAR2014 13:59:14
8
COBIIR3
159K LOCKED-M COMPLETE
_ CCASQLD
08FEB2014 14:45:29
4
OSVSCOB
223K LOCKED-M COMPLETE
_ CCASQLD
09OCT2013 14:33:43
4
OSVSCOB
223K LOCKED-M COMPLETE
_ CCAADLI
30NOV2012 13:18:58
4
OSVSCOB
63K LOCKED-M COMPLETE
_ CCAADLG
30NOV2012 13:17:19
4
OSVSCOB
95K LOCKED-M COMPLETE
_ CCAAEIP
20SEP2012 11:50:36
0
COBIIR2
63K LOCKED-A COMPLETE
_ CCAMENU
16SEP2012 16:46:17
0
COBIIR2
95K LOCKED-M COMPLETE
_ CCAASRA
19APR2012 09:17:13
0
COBIIR2
63K LOCKED-A COMPLETE
_ CCAAEIM
19APR2012 08:29:24
0
COBIIR2
63K LOCKED-M COMPLETE
_ CCAAEIP
17APR2012 01:50:36
0
COBIIR2
63K LOCKED-A COMPLETE
Type a line command and press Enter to process it.
Access the Source Program Directory by doing one of the following:
• Enter S as a line command at any dataset name on the Source Program Directory
screen.
• Use the cursor point-and-shoot feature and press Enter at the entry for the source
dataset name field on the Program Detail screen.
Use the available line commands to do the following:
• Enter S at any source listing to select it for viewing. Abend-AID for CICS displays the
Source Program Browse screen, shown in Figure 10-7 on page 10-6.
• Enter L or U at any source listing to lock or unlock it. The Locked Status field reflects
any change you make with the lock/unlock line commands, indicating the current
10-6
Abend-AID for CICS User’s Guide
status. LOCKED-M means that the listing was manually locked. LOCKED-A indicates
that the listing was automatically locked.
• Enter D at any source listing to delete it from the source dataset. Press Enter when
Abend-AID for CICS displays the Confirm Source Program Delete screen, or press End
(PF3) to cancel the deletion.
• Enter I at any source listing to display the Source Program Information screen, shown
in Figure 10-8.
Figure 10-7. Source Program Browse Screen
Compuware Abend-AID -------- Source Program Browse ------ Row 000543 of 002550
COMMAND ===>
SCROLL ===> PAGE
==>
000407
1
GO TO 300-EMPLOYEE-PAY-RTN.
000408
MOVE ’*** EMPLOYEE NOT ON FILE ****’ TO PAYPROMPT.
000409
GO TO 600-SEND-PAY-MAP.
000410
000411
300-EMPLOYEE-PAY-RTN.
000412
IF WA-TYPE EQUAL ’N’ OR ’I’ OR ’S’
000413
1
COMPUTE CURR-PAY
EQUAL WA-HOURS * WA-RATE
000414
1
COMPUTE CURR-TAXES EQUAL CURR-PAY * WA-TAX-RA
000415
1
ADD CURR-PAY
TO WA-YTD-GRS
000416
1
ADD CURR-TAXES TO WA-YTD-TAX.
000417
000418
IF PAYEMP1 EQUAL ’00001’
000419
1
MOVE WORK-AREA TO PAYROLL-DATA-EMP001.
000420
000421
IF PAYEMP1 EQUAL ’00999’
000422
1
MOVE WORK-AREA TO PAYROLL-DATA-EMP999.
000423
000424
400-TRANSACTION-COMPLETE.
000425
MOVE PAYEMP1
TO EMPNUMB.
000426
MOVE WA-NAME
TO EMPNAME.
000427
MOVE WA-HOURS TO HRSWRKD.
Figure 10-8. Source Program Information Screen
Compuware Abend-AID -------- Source Program Information ----------------------
COMMAND ===>
SCROLL ===> PAGE

Source Program Name.......... CCAADEMO
Source Compile Date.......... 14JUN2014
Source Compile Time.......... 08:09:26
Source Language.............. COBIIR4
LP Release................... 04.02.00
Return Code.................. 0
Listing Number............... 13
Creation Date................ 14JUN2004
Creation Time................ 08:09:26
Locked Status................ LOCKED-M
Completion Status............ COMPLETE
Number of Extents............ 6 

Allocated Extents
*****************************************************************************
533
534
535
536
537
538
******************************* BOTTOM OF DATA ******************************* 
Managing Source Files
10-7
Source Mismatch Selection Screen
The Source Mismatch Selection screen, shown in Figure 10-9, lets you display source
processing for a program that does not have an exactly matching source listing. This
screen displays the compile date and time, the language and release for the selected
program, and the most current version of the source listing.
Figure 10-9. Source Mismatch Selection Screen
Compuware Abend-AID-------- Source Mismatch Selection ------------- ------COMMAND ===>

No matching Compuware Source Listing is available to provide source support
for this program. To provide source support use one of the options below.
Program Information
Program Name............. COBTEST
Compile Date............. 10FEB2014
Compile Time............. 09:06:47
Program Language......... COB Z/OS
Language Release......... V3R2M0
Most Current Source Information
Source Program Name...... COBTEST
Source Compile Date...... 30JAN2014
Source Compile Time...... 11:26:17
Program Language......... COBOL II
Language Release......... V1R4M0
Select one of these to use an available Compuware-processed Source listing:
To use the most current, select CURRENT

To display listings for the same compiler release, select LISTINGS
For all listings for this program for any compiler release, select LISTALL
Select one of the following to create a Compuware Source listing:
To convert an existing compiler listing, select CONVERT
To execute site-specific utilities (ISPF only), select UTILITIES
To continue without source-level support, select NO SOURCE




















Use the cursor point-and-shoot feature and press Enter on any one of the following fields:
• CURRENT field selects the most current source listing for source processing in all
subsequent displays of the program. The previously selected screen appears.
• LISTINGS field displays the Source Program Directory for source mismatch selection,
which displays every occurrence of a listing for the selected program in all available
source listing files, as shown in Figure 10-10 on page 10-8.
• LISTALL field displays more listings that may be suitable for this program.
– For COBOL and PL/I, the Source Program Directory displays all listings for the
language of the selected program name, including listings for different releases of
the compiler.
– For Assembler, the Source Program Directory displays all Assembler listings,
including listings for different program names. This is particularly useful for
those assembler applications where the selected CSECT name does not match the
name used for the listing.
The LISTALL field is only displayed if the SOURCE ANY primary command has been
issued.
• CONVERT field displays the Convert Program Compiler Listing screen, as shown in
Figure 10-11 on page 10-9.
• UTILITIES field displays the Site Customized Utilities menu screen. From there you
can execute a site-defined procedure to compile and process, execute a site-defined
procedure to post-process, or execute the CSS Utilities to create JCL for processing.
This option is only available when you enter Abend-AID for CICS through ISPF.
• NO SOURCE field suppresses source processing in all subsequent displays of the
program.
10-8
Abend-AID for CICS User’s Guide
If at a later time you want to override your selection regarding source processing for this
program, enter the SOURCE RESET primary command on any Abend-AID for CICS
screen displaying information about this program. The program returns to its previous
mismatched condition, and Abend-AID for CICS displays the Source Mismatch Selection
screen, from which you can make a different selection.
Source Program Directory Screen for Source Mismatch
Selection
The Source Program Directory for source mismatch selection, shown in Figure 10-10,
appears when you select either LISTINGS or LISTALL from the Source Mismatch Selection
screen.
If you select LISTINGS, the Source Program Directory screen displays every occurrence of
a source listing for the selected program. For COBOL and PL/I, all listings for the selected
program name will be displayed only if the programming language and the compiler
version match. For Assembler, all Assembler listings for the selected program name will
be displayed. This screen allows you to select the listing that you think is the best match.
If you select LISTALL, the Source Program Directory screen displays more listings that
may be suitable for this program. For COBOL and PL/I, all listings for that language for
the selected program name will be displayed. This may include listings for a different
release of the compiler. For Assembler, all Assembler listings will be displayed. This may
include listings for different program names. This is particularly useful for those
assembler applications where the selected CSECT name does not match the name used
for the listing.
Note:
Because the language and release may not match the selected program,
unpredictable results may occur. These may include the wrong statements being
shown, wrong values for fields, or abends.
Figure 10-10. Source Program Directory Screen for Source Mismatch Selection
Compuware Abend-AID ----- Source Program Directory ------ Row 000001 of 000008
COMMAND ===>
SCROLL ===> PAGE

Program Name... CCAADEMO Compile Date... 29JUN2014 Language....... COBOL II
Compile Time... 10:27:07
Language Rel... V1R3M0 

S Select
B Browse
I Information 

Compile
Compile
Locked
Completion
Program
Date
Time
RC Lang Release Size
Status
Status
******** ******** ******** ** ***** ******* ****** ******** **********
_ CCAADEMO 26MAR2014 13:59:14 8 COBII V1R3M0
159K
COMPLETE
_ CCAADEMO 29JAN2014 10:51:14 0 COBII V1R3M0
191K LOCKED-A COMPLETE
_ CCAADEMO 29JAN2014 16.18.02 4 COBVS V1R3M0
95K LOCKED-A COMPLETE
_ CCAADEMO 05FEB2013 16.18.02 4 COBVS V1R1M0
95K LOCKED-A COMPLETE
_ CCAADEMO 05FEB2013 16.18.02 4 COBVS V1R1M0
95K LOCKED-A COMPLETE
_ CCAADEMO 05FEB2013 16.18.02 4 COBVS V1R1M0
95K LOCKED-A COMPLETE
_ CCAADEMO 05FEB2013 16.18.02 4 COBVS V1R1M0
95K LOCKED-A COMPLETE
_ CCAADEMO 05FEB2013 18:07:58 0 COBII V1R4M0
95K LOCKED-A COMPLETE
_ CCAADEMO 10FEB2013 21:28:18 4 COBII V1R3M0
159K LOCKED-A COMPLETE
******************************* BOTTOM OF DATA ******************************


Type a line command and press Enter to process it.
Managing Source Files
10-9
Use the available line commands to do the following:
• Enter S at any source listing. Abend-AID for CICS displays with source support the
screen you were attempting to access when the Source Mismatch Selection screen was
displayed. You may get a message that the selected source does not match the
program compile date and time.
• Enter B at any source listing to select it for viewing. Abend-AID for CICS displays the
Source Program Browse screen, shown in Figure 10-7 on page 10-6.
• Enter I at any source listing to display the Source Program Information screen, shown
in Figure 10-8 on page 10-6.
After you use one of the line commands, press the END key (PF3) to return to the Source
Program Directory screen. You can select another listing, or press PF3 again to return,
depending upon which screen you were originally attempting to view with source
support, to either the main menu or to the screen from which the Source Mismatch
Selection screen was first displayed.
The selected source listing is available from every applicable subsequent display until you
use the SOURCE RESET command, which returns the program to its previous mismatched
condition. Abend-AID for CICS displays the Source Mismatch Selection screen, from
which you can make another selection.
Convert Program Compiler Listing Screen
Accessed from the Source Mismatch screen, the Convert Program Compiler Listing
screen, shown in Figure 10-11, allows you to convert a compiler listing to a Compuware
source listing. The listing can reside on a sequential dataset or it can be a member of a
PDS. The conversion is done by executing the appropriate Compuware Shared Services
(CSS) post-compile language processor while your user session waits. After the conversion
has successfully completed, the original command you entered is automatically executed
again.
Figure 10-11. Convert Program Compiler Listing Screen
Convert Program Compiler Listing ---------------------- 


Program Information

Program Name......... CCAADEMO

Compile Date......... 01AUG2014
Program Language......... COB/390

Compile Time......... 12:24:03
Language Release......... V2R1M0


The conversion to a Compuware source listing will be done before proceeding.


Select one of the following options:

Search known compiler listing data sets, select SEARCH

Display a list of known compiler listing data sets, select DISPLAY


Or enter the name of the data set that contains the compiler listing:

Data Set Name:

Member name:
CCAADEMO



Compuware Abend-AID
COMMAND ===>
Use the cursor point-and-shoot feature and press Enter at one of the following fields:
• SEARCH field to display a list of partitioned datasets known to the server that
contain the compiler listing member, as shown in Figure 10-12 on page 10-10.
• DISPLAY field to display a list of compiler listing datasets known to the server, as
shown in Figure 10-13 on page 10-10.
10-10
Abend-AID for CICS User’s Guide
Alternatively, you can enter the dataset name of a sequential file or PDS that contains the
source listing. After you enter the dataset name, the Abend-AID Viewer invokes the
appropriate CSS Language Processor postprocessor to analyze the listing and save the
analyzed results to the Scratchpad listing file.
Figure 10-12. Matching Listing Data Set Names Screen
Compuware Abend-AID --- Matching Listing Data Set Names --------------------- 
COMMAND ===>
SCROLL ===> PAGE 

Program Information

Program Name......... CCAADEMO

Compile Date......... 01AUG2014
Program Language......... COB/390

Compile Time......... 12:24:03
Language Release......... V2R1M0


The data sets listed below have matching compiler listings for this program.

Type an S next to the desired data set and press the Enter key.


Compiler Listing Data Set Name
Where Specified

******************************************** ********************

****************************** BOTTOM OF DATA *********************************





Figure 10-13. Known Compiler Listings








Select the compiler listing data set name below that contains the listing for 
this program.

Type an S next to the desired dataset and press the Enter key.


Compiler Listing Data Set Name
Where Specified
Status 
******************************************** ******************** ********
CFUSER1.LISTING1
Viewing Server JCL

CFUSER3.LISTING1
Viewing Server JCL

CFUSER3.LISTING2
Viewing Server JCL

CFUSER2.LISTING1
Viewing Server JCL

CFUSER4.LISTING1
Viewing Server JCL

CFUSER2.LISTING2
Viewing Server JCL

****************************** BOTTOM OF DATA ********************************* 

Compuware Abend-AID ---- Known Compiler Listings ------- Row 000001 of 000009
COMMAND ===>
SCROLL ===> PAGE
==>
Program Information
Program Name......... CCAADEMO
Compile Date......... 01AUG2014
Program Language......... COB/390
Compile Time......... 12:24:03
Language Release......... V2R1M0
If you use the cursor point-and-shoot feature and press Enter at the CONVERT field on
either the Source Mismatch Selection screen or the No Source Selected screen and the
listing file has been processed, the original program search is reissued and the Abend-AID
Viewer will find the just processed listing. If the new entry is an exact match, it is used
automatically, and no further user action is necessary. If it is not an exact match, the
Source Mismatch screen is redisplayed. The new contents includes the just processed
listing, which you can select. On a subsequent request for the same program, the
analyzed listing from the Scratchpad listing file is included in the automatic search for
the source. When you use the cursor point-and-shoot and press Enter at the CONVERT
field, the Abend-AID Viewer remembers that selection and provides a meaningful
message if the converted listing is not subsequently selected by source processing and the
no source or source mismatch screen is redisplayed.
Managing Source Files
10-11
After a listing has been processed and placed on the Scratchpad file, it remains there until
deleted or overwritten. Security checks depend on the
EXTERNAL_SECURITY_DATASET_CHECK setting in the viewing server.
Note:
For more information about the Scratchpad listing file, refer to the Abend-AID
Installation and Customization Guide.
The MFDDLIST DD statement (which your site installer optionally included in the
viewing server JCL at installation) contains a reference to PDS datasets that you can select
as a source for unprocessed IBM compiler listings.
If you use the cursor point-and-shoot and press Enter at the DISPLAY field on the
Convert Program Compiler Listing screen (Figure 10-11 on page 10-9), the Matching
Listing Data Set Names screen (Figure 10-12 on page 10-10) will include the MFDDLIST
datasets in the dataset list. If you use the cursor point-and-shoot and press Enter at the
SEARCH field on the Convert Program Compiler Listing screen (Figure 10-13 on page
10-10), the MFDDLIST datasets will be searched, as well as your previously specified
datasets.
As you enter compiler listing dataset names to be processed and used, the dataset names
are saved in a small (five entries) FIFO table in your user profile. As new entries are added
to the table, older entries are pushed down, and if the table is full, the oldest entry is
discarded. This table is included on the Matching Listing Data Set Names and Known
Compiler Listing screens that you can access from the Convert Program Compiler Listing
screen. If you use the cursor point-and-shoot and press Enter at the SEARCH field, these
datasets will be included in the list to be searched for the listing member name. If you
use the cursor point-and-shoot and press Enter at the DISPLAY field, the list of searchable
datasets (including these) will be shown.
Utilities Screen
From the Source Mismatch Selection screen, if you’re using ISPF viewing access, use the
cursor point and shoot feature to position the cursor on the Utilities field and press Enter
to display the Source Support Utilities Menu, as shown in Figure 10-14. This screen lets
you create a processed listing that can be used for source support in an abend report that
you want to analyze.
Figure 10-14. Source Support Utilities Menu








Compuware Abend-AID ------ Source Support Utilities Menu----Enter Option 
OPTION ===> 
Program............
Compiled Date......
Compiled Time......
Load Library.......
AADBTMP1
Program Language... COB z/OS
05DEC2015
Language Release... V4R1
09:29:16
D2.TECH.SAMPLES.DB211.LOAD
Select one of the following: 
1
-
To execute a site defined procedure to compile and process. 
2
-
To execute a site defined procedure to postprocess. 
3
-
To execute the CSS Utilities to create JCL for processing. 
Enter the number of the desired option in the Option field.
10-12
Abend-AID for CICS User’s Guide
• 1 — To run the Compuware preprocessor. It executes the site-defined procedure
(CXOTFPRE.) to compile a program and process it through the appropriate CSS
language processor.
• 2 — To run the Compuware postprocessor. It executes the site-defined procedure
(CXOTFPST) to process the program that has already been compiled and for which
the listing has been saved.
• 3 — To access the Compuware CSS Utilities CreateJCL Menu, as shown in
Figure 10-15, to create the JCL for processing.
Figure 10-15. Compuware CSS Utilities Screen
--------- Compuware CSS Utilities ---- Create JCL Menu -----OPTION ===>
1
2
Preprocessor
Convert existing compile JCL to use LP
Create compile JCL to use LP
3
Postprocessor
Create JCL to use LP
LP
SE
DD
SD
CSS V16.05.00
Learn about Compuware Language Processor
General Settings
Learn about Compuware DDIO files
Learn about Compuware Shared Directory and Database files
Enter END command to terminate























From the Compuware CSS Utilities - Create JCL Menu, you can perform many tasks. See
the Compuware Shared Services User/Reference Guide for detailed information on how to use
the Compuware Shared Services utilities.
No Source Selected Screen
The No Source Selected screen, shown in Figure 10-16 on page 10-13, is displayed if there
are no source listing available for the selected program name. Use this screen to convert
an existing compiler listing into a Compuware source listing, initiate a site-specific
utility, or opt to process a program request without source support. These processing
overrides are only in effect while viewing the selected dump.
Managing Source Files
10-13
Figure 10-16. No Source Selected Screen
Compuware Abend-AID ------ No Source Selected ------------------------------
COMMAND ===>

MSDSD5500I No suitable Compuware source listing was found for this program
There is no Compuware Source Listing available to provide source support

for this program name. To provide source support you can either convert an

existing compiler listing into a Compuware Source Listing or you can create 
a Compuware Source Listing by compiling the program.


Program Information

Program Name................. CCAADEMA

Compile Date................. 21APR2014

Compile Time................. 00:00:00

Program Language............. ASSEMBLER

Language Release............. UNKNOWN


Select one of the following options to create a Compuware Source listing:

To have Abend-AID convert an existing compiler listing, select CONVERT

To use site customized utilities (ISPF only), select UTILITIES


To continue without source-level support, select NO SOURCE


For all Compuware-processed assembler listings, select LISTALL


Note:
The last field on the screen, LISTALL, only appears if the selected program is an
Assembler program.
Use the cursor point-and-shoot feature and press Enter on any one of the following fields:
• CONVERT field presents the Convert Program Compiler Listing screen, as shown in
Figure 10-11 on page 10-9.
• NO SOURCE field suppresses source processing in all subsequent displays of the
program.
• UTILITIES field initiates site-specific utilities. This option is available only when
using ISPF viewing access.
• LISTALL field displays more listings that may be suitable for this program.
– For COBOL and PL/I, the Source Program Directory displays all listings for the
language of the selected program name, including listings for different releases of
the compiler.
– For Assembler, the Source Program Directory displays all Assembler listings,
including listings for different program names. This is particularly useful for
those assembler applications where the selected CSECT name does not match the
name used for the listing.
The LISTALL field is only displayed if the SOURCE ANY primary command has been
issued.
If at a later time you want to override your selection regarding source processing for this
program, enter the SOURCE RESET primary command on any Abend-AID for CICS
screen displaying information about this program. The program returns to its previous
mismatched condition, and Abend-AID for CICS displays the Source Mismatch Selection
screen, from which you can make a different selection.
10-14
Abend-AID for CICS User’s Guide
11-1
Chapter 11.
Using Abend-AID for CICS with Language Environment
Chap 11
This chapter describes using Abend-AID for CICS with transactions running under IBM’s
Language Environment (LE). Because this chapter does not duplicate information
provided by IBM, refer to the appropriate IBM documentation for more detailed
information about LE.
LE Support
Abend-AID for CICS provides two types of support for COBOL programs:
• Basic support for obsolete releases of Language Environment such as LE for MVS and
VM Versions 1.4.0 and less current
• Extended support for more recent releases such as LE for MVS and VM Version 1.5.0.
The objective of Abend-AID for CICS is to provide the same support for COBOL programs
running under Language Environment as for similar COBOL programs not running under
LE. This support includes COBOL II programs, which may run either with or without LE;
and COBOL for MVS and VM, which requires LE. In addition, selected LE control blocks
and areas are shown on the Control Blocks/Storage screen.
LE Information in the Abend-AID for CICS Report
The following areas are displayed on the Abend-AID for CICS Control Blocks/Storage
screen for abends executing COBOL programs under Language Environment:
• CEECAA: LE common anchor area
• CEECIB: LE condition information block
• CEEMIB: LE message insert block(s).
The CEECIB contains the message prefix (CEE, IGZ, among others) and message number
(for example, 006) for the condition causing the failure. The CEEMIB(s) contain the
variable message insert(s) inserted into the message by Language Environment before the
message was displayed. The message is normally sent to the CESE transient data queue
and is no longer available to Abend-AID for CICS. By referring to the appropriate
messages and codes manual and plugging in the values from the CEEMIB(s) displayed by
Abend-AID for CICS, users can reconstruct the exact message.
11-2
Abend-AID for CICS User’s Guide
Abend-AID for CICS Processing of Abends
For COBOL software-raised conditions for which LE issues the IGZxxxxS message to the
CESE transient data queue, the LE abend code is converted to the appropriate COBOL
abend code by adding 1000 to the condition code. For selected codes including 1006,
1007, 1011, 1058, 1074, 1096, the diagnostic information is extracted and shown on the
diagnostic screen. For others, a standard description is shown. Diagnostic text has been
added for the new abend codes. With LE for MVS and VM Versions 1.5.0 and more
current, some errors shown in previous releases of Language Environment cannot occur,
so IBM reassigned the message numbers. For these, the correct meaning is shown
dependent upon the LE release.
For Language Environment abends for which LE issues the CEExxxxS message, the
message number is used as the abend code, and the diagnostic displays the appropriate
text.
For COBOL for MVS and VM, the Local Storage and Dynamic Storage Area (DSA) are
dumped out and are selectable for the COBOL Storage Areas menu. Source support is
available for the Local Storage Section. The DSA and Local Storage cells are shown on the
Control Blocks/Storage screen.
12-1
Chapter 12.
Analyzing Data Exceptions
Chap 12
This chapter describes how to use the CCAADEMO demonstration program shipped on
the Abend-AID for CICS product tape to create an S0C7 data exception and how to use
Abend-AID for CICS to solve the transaction abend.
Analyzing a Sample S0C7 Data Exception
The sample S0C7 data exception shown in this chapter was produced from the COBOL
demonstration program CCAADEMO provided on the Abend-AID for CICS product tape
in the installation sample library (TKFXSAMP). You can create this abend yourself,
executing the AADM transaction to produce an ASRA abend, provided the appropriate
CICS table entries are defined as described in the Abend-AID Installation and Customization
Guide.
The program in this chapter includes source support. Compuware strongly
recommends that you always use source support to make the best use of Abend-AID
for CICS. To include source support, compile CCAADEMO with compile/link-edit JCL
modified to use the Compuware COBOL language processor. Refer to the Compuware
Shared Services User/Reference Guide for information about the COBOL language processor.
Further, you can also use the supplied PL/I demonstration program CCAADEMP or the
Assembler demonstration program CCAADEMA, located in the installation sample library
(TKFXSAMP) and follow a similar procedure. If the appropriate CICS table entries have
been made, you can execute the PL/I AADP or Assembler AADA transaction to produce an
abend. To include source support, compile CCAADEMP (PL/I) or CCAADEMA (Assembler)
with compile/link-edit JCL modified to use the Compuware PL/I language processor or
Compuware Assembler language processor, respectively. Refer to the Compuware Shared
Services User/Reference Guide for information about the PL/I and Assembler language
processors.
As an alternative to using CCAADEMO/CCAADEMP/CCAADEMA, you can create your
own transaction report and follow along using the procedure described below.
The following steps describe a possible approach to solving a data exception. Abend-AID
for CICS provides a great deal of information related to the abend that may be of interest
to you in your analysis, and not all relevant screens are discussed in this approach.
Note:
Performing these steps requires some familiarity with the Abend-AID for CICS
analysis functions and screen navigation facilities. For illustration purposes, this
approach shows one screen access method per screen, but most screens have
more than one valid access method. Refer to “Screen Access” on page 3-6.
12-2
Abend-AID for CICS User’s Guide
1. Select the Diagnostic Summary for this S0C7 data exception, as shown in Figure 12-1
on page 12-2 through Figure 12-5 on page 12-4. Note the following information
about this abend:
– Program name as shown in Figure 12-1 on page 12-2
– Abending statement, its statement number, and paragraph name as shown in
Figure 12-1 on page 12-2
– Field in error, its picture length and type, and the field’s value as shown in Figure
12-2 on page 12-3
– Next Sequential Instruction as shown in Figure 12-2 on page 12-3
– Program’s compile date and time as shown in Figure 12-3 on page 12-3
– Last EXEC CICS command and its statement number as shown in Figure 12-3 on
page 12-3 and Figure 12-4 on page 12-4
– PSW and SCREEN fields as shown in Figure 12-5 on page 12-4.
Figure 12-1. Diagnostic Summary, Page 1
Abend-AID -------------- Diagnostic Summary ------------- Row 000001 of 000073
COMMAND ===>
SCROLL ===> PAGE

An ASRA abend occurred in program CCAADEMO. The abending transaction was
AADM running at terminal A494 for user ID CICSUSER. 


Analysis of error 

The Data Exception is caused when a decimal instruction is attempted on a
field that does not contain valid packed data, eg. contains an invalid digit
(not 0-9), or its last byte contains an invalid sign (Not F, C, OR D). 



The data exception occurred in the following statement: 

000400
COMPUTE CURR-PAY
EQUAL WA-HOURS * WA-RATE 

This statement is contained in paragraph "300-EMPLOYEE-PAY-RTN" in program
CCAADEMO. 

COBOL Information 
Analyzing Data Exceptions
Figure 12-2. Diagnostic Summary, Page 2
Abend-AID ----------------- Diagnostic Summary --------- Row 000020 of 000073
SCROLL ===> PAGE 
COMMAND ===>

COBOL Information


Current values of fields on this statement:


Level/Field Name
Picture/Type
77 CURR-PAY
Value
9(5)V99
02 WA-HOURS
0000000
# 999
02 WA-RATE
***
9(3)V99
00950


’#’ - Indicates field contains invalid data that does not match 
field description in the program. Note that even valid data
could cause an error (for example, a zero divide).

Next Sequential Instruction


The next statement is:


COMPUTE CURR-TAXES EQUAL CURR-PAY * WA-TAX-RATE 
000401

This statement is contained in paragraph "300-EMPLOYEE-PAY-RTN" in program
CCAADEMO. 
Figure 12-3. Diagnostic Summary, Page 3
Abend-AID ----------------- Diagnostic Summary --------- Row 000038 of 000073
SCROLL ===> PAGE 
COMMAND ===>

Next Sequential Instruction


The program was compiled on 29JUN2004 at 10:51:14 and is 0017B0 bytes long.
It is part of load module CCAADEMO which was loaded from CW.CC.DEMO.PGMLOAD.
It was link edited on 29JUN2004 and is 001C20 bytes long.
The program AMODE is 31 and program RMODE is 24.

The execution key for this program was USER_KEY.


Last Call or EXEC CICS Request


The last call or ’EXEC CICS’ command was:


000369
*EXEC CICS RECEIVE
000370
*
INTO
(DUMMY-EMP)
12-3
12-4
Abend-AID for CICS User’s Guide
Figure 12-4. Diagnostic Summary, Page 4

Abend-AID ----------------- Diagnostic Summary --------- Row 000057 of 000073
COMMAND ===>
SCROLL ===> PAGE 

Last Call or EXEC CICS Request 

This statement is contained in paragraph "200-RECEIVE-INPUT" of program
CCAADEMO. 

Program Link Summary 

Called
Called
------- Status ------- Calling
Calling
Return
Load Mod Program
Load Mod Program
Offset
CCAADEMO CCAADEMO Linked By
System
000000 

Supporting Information:
DATASTRM - Data Stream Analysis
EIB
- User Execute Interface Block
Note:
The Return Offset field in the Program Link Summary is selectable using the
cursor point-and-shoot feature, and displays a Call Detail screen as shown in the
“Call Detail Screen” on page 8-10.
Figure 12-5. Diagnostic Summary, Page 5
Abend-AID ----------------- Diagnostic Summary --------- Row 000070 of 000073
COMMAND ===>
SCROLL ===> PAGE


Supporting Information:
SCREEN
- Last 3270 Screen
PSW
- Program Status Word
REGS
- Registers 
2. Use the cursor point-and-shoot feature and press Enter at the value for the field in
error, WA-HOURS, as shown in Figure 12-2 on page 12-3. Abend-AID for CICS
displays the Expanded Data Field screen as shown in Figure 12-6. This screen displays
the selected data in vertical-hexadecimal format.
Figure 12-6. Expanded Data Field Screen

Abend-AID --------------- Expanded Data Field ----------- Row 000001 of 000004
COMMAND ===>
SCROLL ===> PAGE

Field Name... WA-HOURS

Storage Type. Working Storage
0875A3E4
Char
Zone
Digit
***
555
CCC
1..

3. Press the END PF key to return to the Diagnostic Summary. Use the cursor point-andshoot feature and press Enter at the PSW field, as shown in Figure 12-4 on page 12-4.
Abend-AID for CICS displays the PSW Information screen as shown in Figure 12-7 on
page 12-5. This screen displays the actual abending assembler instruction issued for
the COBOL compute statement and identifies it as a multiply decimal instruction.
Analyzing Data Exceptions
12-5
The first operand of the instruction is the packed decimal format of WA-HOURS,
which is 000000CCCF in hexadecimal storage.
Figure 12-7. PSW Information Screen
Abend-AID --------------- PSW Information --------------- Row 000001 of 000018
COMMAND ===>
SCROLL ===> PAGE


To display Registers at abend, select REGS 

Program Status Word at Time of Abend
Program Information 

PSW................. 078D1000 801695A0
Instruction Length.. 0006
Program..CCAADEMO
Interrupt Code...... 0007
Offset...000D72
Description......... Multiply Decimal 

Address
Instruction
Opcode D1(L1,B1),D2(L2,B2)
0016959A FC42 D1B0 D1B8
MP
432(5,13),440(3,13) 

The first operand was located at address 08A481E0 and contained - 

000000CC CF
*
..
* 


The second operand was located at address 08A481E8 and contained - 

00950F
* n. * 
Note:
To accomplish the COBOL compute statement, a series of assembler
instructions are executed:
a. The two fields to be computed are converted to packed-decimal format.
b. The sign of the number for each field is set.
c. The multiply packed instruction is executed.
d. The result of the multiplication is changed to a character format and the sign
code is eliminated, as shown in Figure 12-11 on page 12-7.
4. If you compile your program with the PMAP compiler option for OS/VS COBOL or
the LIST compiler option for VS COBOL II, a section of the output in the source
listing displays the equivalent assembler instructions of a COBOL program. To view
the statement in error from the PMAP/LIST of the source listing, access the entire
program listing via the Source Directory. You can access the Source Directory in
several alternate ways:
– Enter the fast-path command SRCDIR.
– Enter the =R jump command.
– Select it directly from the Primary Options menu.
– Return to the Diagnostic Summary and follow the sequence described below.
5. Press the END PF key to return to the Diagnostic Summary screen. Use the cursor
point-and-shoot feature and press Enter at the program name field, CCAADEMO.
Abend-AID for CICS displays the Program Detail screen, as shown in Figure 12-8 on
page 12-6.
12-6
Abend-AID for CICS User’s Guide
Figure 12-8. Program Detail Screen
Abend-AID ---------------------- Program Detail -----------------------------
COMMAND ===> 

Program CCAADEMO is part of load module CCAADEMO which was loaded from
CW.CC.DEMO.PGMLOAD
Source was loaded from dataset CWV.CC.DEMO.LISTFILE
To display the source listing for this program, select Listing
To display Cobol storage areas for this program, select Storage Areas 

Program Information
Program-Related Areas
Compile Date............. 29JUN2004
PPT Entry................ 08302928
Compile Time............. 10:51:14
Commarea................. 08330018
Link Date................ 29JUN2004
Entry Point Address...... 00168828
Source Compile Date...... 29JUN2004
Savearea................. 08A48030
Source Compile Time...... 10:51:14
BREXIT................... N
Program Size............. 000017B0
Program Rmode............ 24
Program Amode............ 31 

Language Information
CICS Type................ COMMAND
EXECkey.................. USER
Language................. COBOL II
Data above 16meg?........ N
LE/370 Enabled?.......... N 
6. Use the cursor point-and-shoot feature and press Enter at the source dataset name
field on the Program Detail screen. Abend-AID for CICS displays the Source Program
Directory, as shown in Figure 12-9.
Figure 12-9. Source Program Directory
Abend-AID ----------- Source Program Directory ---------- Row 000001 of 000014
COMMAND ===>
SCROLL ===> PAGE

Data Set Name.... CWV.CC.DEMO.LISTFILE 

S Select
L Lock
I Information
U Unlock
D Delete 

Compile
Compile Return
Locked
Completion
Program
Date
Time
Code
Language
Size
Status
Status
******** ******** ******** ****** ********** ****** ******** **********
_ CELPROG1 06FEB2004 10:55:35
4
COBIIR3
63K LOCKED-M INCOMPLETE
_ CCAADEMO 29JAN2004 10:51:14
0
COBIIR3
191K LOCKED-M COMPLETE
_ CCAADEMO 26JAN2004 13:59:14
8
COBIIR3
159K LOCKED-M COMPLETE
_ CCASQLD
08DEC2003 14.45.29
4
OSVSCOB
223K LOCKED-M COMPLETE
_ CCASQLD
30NOV2003 14.33.43
4
OSVSCOB
223K LOCKED-M COMPLETE
_ CCAADLI
30NOV2003 13.18.58
4
OSVSCOB
63K LOCKED-M COMPLETE
_ CCAADLG
30NOV2003 13.17.19
4
OSVSCOB
95K LOCKED-M COMPLETE
_ CCAASMB
11AUG2003 15.41.12
0
ASMH
63K LOCKED-M COMPLETE
_ CCAAEIP
24APR2003 11.50.36
0
COBIIR2
63K LOCKED-A COMPLETE
_ CCAMENU
23APR2003 16.46.17
0
COBIIR2
95K LOCKED-M COMPLETE
_ CCAASRA
19APR2003 9.17.13
0
COBIIR2
63K LOCKED-A COMPLETE
_ CCAAEIM
18APR2003 11.52.24
0
COBIIR2
63K LOCKED_A COMPLETE
Type a line command and press Enter to process it.
7. Enter the S line command at the Program field of the source listing for the abending
program. Be sure to select the source listing whose name and date most closely match
the program name and compile date shown in the Diagnostic Summary. Abend-AID
for CICS displays the Source Program Browse screen, as shown in Figure 12-10 on
page 12-7.
Analyzing Data Exceptions
12-7
Figure 12-10. Source Program Browse Screen
Abend-AID ------------ Source Program Browse ------------ Row 000001 of 002893
COMMAND ===>
SCROLL ===> DATA
==>
COMPUWARE COBOL PROCESSOR*COMPUWARE COBOL PROCE
COMPUWARE COBOL PROCESSOR*COMPUWARE COBOL PROCE
COMPUWARE COBOL PROCESSOR*COMPUWARE COBOL PROCE
COMPUWARE COBOL PROCESSOR*COMPUWARE COBOL PROCE
COMPUWARE COBOL PROCESSOR*COMPUWARE COBOL PROCE
COMPUWARE COBOL PROCESSOR*COMPUWARE COBOL PROCE
COMPUWARE COBOL PROCESSOR*COMPUWARE COBOL PROC*
COMPUWARE COBOL PROCESSOR*COMPUWARE COBOL PRO*
COMPUWARE COBOL PROCESSOR*COMPUWARE COBOL PR*
COMPUWARE COBOL PROCESSOR*COMPUWARE COBOL P*
COMPUWARE COBOL PROCESSOR*COMPUWARE COBOL *
*
COMPUWARE COBOL PROCESSOR*COMPUWARE COBOL******



RELEASE 12.02.00 (05/16/



COPYRIGHT (C) 1984, 2011, COMPUWARE CORPOR
RIGHTS RESERVED UNDER THE COPYRIGHT LAWS O
8. Enter the FIND ’000400 COMPUTE’ primary command to locate the statement in
error from the PMAP/LIST of the source listing. Enter two spaces between ’000400’
and ’COMPUTE’ to find this exact text string, as shown in Figure 12-11. Note the
assembler instructions for the COBOL compute statement—in particular, the
multiply packed (MP) instruction, which was identified as the statement in error on
the PSW screen, as shown in Figure 12-7 on page 12-5.
Figure 12-11. Source Program Browse Screen — COMPUTE Statement in Error
Abend-AID ------------ Source Program Browse ----------- Row 001838 of 002295
COMMAND ===>
SCROLL ===> PAGE
==>
000399 IF
000D46 95D5 A160
CLI 352(10),X’D5’
WA-TYPE
000D4A 4780 B66A
BC
8,1642(0,11)
GN=11(000D5E)
000D4E 95C9 A160
CLI 352(10),X’C9’
WA-TYPE
000D52 4780 B66A
BC
8,1642(0,11)
GN=11(000D5E)
000D56 95E2 A160
CLI 352(10),X’E2’
WA-TYPE
000D5A 4770 B6FC
BC
7,1788(0,11)
GN=10(000DF0)
000D5E
GN=11
EQU *
000400 COMPUTE
000D5E F242 D1B0 A1AC
PACK 432(5,13),428(3,10)
TS2=0
000D64 960F D1B4
OI
436(13),X’0F’
TS2=4
000D68 F224 D1B8 A18B
PACK 440(3,13),395(5,10)
TS2=8
000D6E 960F D1BA
OI
442(13),X’0F’
TS2=10
000D72 FC42 D1B0 D1B8
MP
432(5,13),440(3,13)
TS2=0
000D78 F363 A038 D1B1
UNPK 56(7,10),433(4,13)
CURR-PAY
000D7E 96F0 A03E
OI
62(10),X’F0’
CURR-PAY+6
000401 COMPUTE
000D82 F266 D1B0 A038
PACK 432(7,13),56(7,10)
TS2=0
000D88 960F D1B6
OI
438(13),X’0F’
TS2=6
000D8C F223 D1B8 A19A
PACK 440(3,13),410(4,10)
TS2=8
000D92 960F D1BA
OI
442(13),X’0F’
TS2=10
9. Next, to determine how the invalid data was placed in the WA-HOURS field, go to the
Last 3270 Screen Image. Looking at the last screen image before the abend can help
in determining the program flow to the abend. Repeatedly press the END PF key until
you return to the Diagnostic Summary. Use the cursor point-and-shoot feature and
12-8
Abend-AID for CICS User’s Guide
press Enter at the SCREEN field, shown in Figure 12-5 on page 12-4. Abend-AID for
CICS displays the Last 3270 Screen Image, as shown in Figure 12-12. Note that 00001
was entered as the employee number when the abend occurred.
Figure 12-12. Last 3270 Screen Image
AADM 00001 - ENTER EMPLOYEE NUMBER

*** COMPUWARE CORPORATION ***
DEMONSTRATION TRANSACTION 

ENTER DESIRED EMPLOYEE ABOVE:
00001 - CAUSES ASRA ABEND
00002 - CAUSES AEIM
00003 - CAUSES AEIP
00004 - CAUSES DB2 IVP
00999 - ENDS NORMALLY 

10. Press the END PF key to return to the Diagnostic Summary screen. Use the UP PF key
to scroll to the field that contains invalid data, 02 WA-HOURS. Use the cursor pointand-shoot feature and press Enter at this field to display working storage for this
program. The Program Listing screen, as shown in Figure 12-13 on page 12-8,
displays the Working-Storage Section, Linkage Section, and Procedure Division for
the abending program. You can scroll throughout the sections using the PF keys.
Further, you can search for specific data or text strings using the FIND primary
command.
Figure 12-13. Program Listing Screen — Working Storage — Field in Error
Abend-AID -------------------- Program Listing ---------- Row 000078 of 000307
COMMAND ===>
SCROLL ===> PAGE
==>
Program............... CCAADEMO

Program Compile Date.. 12JUN2007
Source Listing Date... 12JUN2007

Program Compile Time.. 15:58:26
Source Listing Time... 15:58:26


To reset display to the abending/last executed statement, select RESET

To reset display to the point of entry into this listing, select ENTRY


Source Line

*******************************************************************************
02 WA-HOURS
# 999
***
02 WA-MSG
X(26)
SPACES
01 VSAM-EMP-RECORD
02 EMP-NUM-KEY
X(5)
LOW-VALUES
02 EMP-NAME
X(15)
LOW-VALUES
02 EMP-HOURS
# 999
LOW-VALUES
02 EMP-TOTPAY
# 9(5)V99
LOW-VALUES
02 FILLER
X(50)
X’00000E040404400000
01 EMP-RECORD-TABLE
02 EMP-RECORD-TBL
03 EMP-NUM-KEY-TBL (1 )
X(5)
SPACES
03 EMP-NAME-TBL (1 )
X(15)
1107302C03C0
11. Use the UP PF key to scroll to the 01 level or group name, WORK-AREA, for the field
in error, as shown in Figure 12-14. Note that WA-HOURS is the second to last field
under group name WORK-AREA, as shown in the previous Figure 12-13 on page 12-8.
Analyzing Data Exceptions
12-9
Figure 12-14. Program Listing Screen — Working Storage — Group Name for Field in Error
Abend-AID ------------------- Program Listing ----------- Row 000055 of 000307
COMMAND ===>
SCROLL ===> PAGE
==>
Program............... CCAADEMO

Program Compile Date.. 12JUN2007
Source Listing Date... 12JUN2007

Program Compile Time.. 15:58:26
Source Listing Time... 15:58:26


To reset display to the abending/last executed statement, select RESET

To reset display to the point of entry into this listing, select ENTRY


Source Line

*******************************************************************************
01 WORK-AREA
02 WA-TYPE
X
N
02 WA-NAME
X(15)
MR. DAVID ABEND
02 WA-ADDRESS
03 WA-STREET
X(12)
456 MAIN ST.
03 WA-CITY
X(8)
HOMETOWN
03 WA-STATE
XX
MI
03 WA-ZIP
X(5)
48010
02 WA-RATE
9(3)V99
00950
02 WA-DATE-EFF
03 WA-DTEFF-MM
XX
01
03 WA-DTEFF-DD
XX
01
12. Next, press Enter at the RESET field to display the Procedure Division of the program
with the cursor positioned at the abending statement, as shown in Figure 12-15.
Figure 12-15. Program Listing — Abending Statement
Abend-AID ------------------- Program Listing ----------- Row 000070 of 000287
COMMAND ===>
SCROLL ===> PAGE
==>
Program............... CCAADEMO

Program Compile Date.. 12JUN2007
Source Listing Date... 12JUN2007

Program Compile Time.. 15:58:26
Source Listing Time... 15:58:26


To reset display to the abending/last executed statement, select RESET

To reset display to the point of entry into this listing, select ENTRY


Source Line

*******************************************************************************
000400
COMPUTE CURR-PAY
EQUAL WA-HOURS * WA-RATE
000401
COMPUTE CURR-TAXES EQUAL CURR-PAY * WA-TAX-RAT
000402
ADD CURR-PAY
TO WA-YTD-GRS
000403
ADD CURR-TAXES TO WA-YTD-TAX.
000404
000405
IF PAYEMP1 EQUAL ’00001’
000406
MOVE WORK-AREA TO PAYROLL-DATA-EMP001.
000407
000408
IF PAYEMP1 EQUAL ’00999’
000409
MOVE WORK-AREA TO PAYROLL-DATA-EMP999.
000410
000411
400-TRANSACTION-COMPLETE.
13. Because the Diagnostic Summary, as shown in Figure 12-3 on page 12-3, indicates
that the last EXEC CICS command begins at statement number 000369, use the UP
PF key to scroll up to that statement. Because the Last 3270 Screen Image indicates
that 00001 was entered as the employee number and because the Diagnostic
Summary indicates that the abending statement is contained in 300-EMPLOYEE-PAYRTN, you can conclude that statement numbers 378 through 380 are the previous
instructions executed prior to the abending statement, as shown in Figure 12-16. The
invalid data in the WA-HOURS field, which is part of the WORK-AREA group name,
was placed there by the MOVE statement, 379. This MOVE statement placed data
located in the group name PAYROLL-DATA-EMP001 into the group name WORKAREA.
12-10
Abend-AID for CICS User’s Guide
Figure 12-16. Program Listing — Last EXEC CICS Command
Abend-AID ------------------- Program Listing ----------- Row 000070 of 000287
COMMAND ===> f payroll-data-emp001
SCROLL ===> PAGE
==>
Program............... CCAADEMO

Program Compile Date.. 12JUN2007
Source Listing Date... 12JUN2007

Program Compile Time.. 15:58:26
Source Listing Time... 15:58:26


To reset display to the abending/last executed statement, select RESET

To reset display to the point of entry into this listing, select ENTRY


Source Line

*******************************************************************************
000369
*EXEC CICS RECEIVE
000370
*
INTO
(DUMMY-EMP)
000371
*
LENGTH (DUMMY-LEN)
000372
*END-EXEC.
000373
MOVE ’........... ...00282
’ TO DFHEIV0
000374
CALL ’DFHEI1’ USING DFHEIV0 DUMMY-EMP DUMMY-LEN.
000375
000376
000377
MOVE DUMMY-PAYEMP1 TO PAYEMP1.
000378
IF PAYEMP1 EQUAL ’00001’
000379
MOVE PAYROLL-DATA-EMP001 TO WORK-AREA
000380
GO TO 300-EMPLOYEE-PAY-RTN.
14. Next, enter the FIND PAYROLL-DATA-EMP001 primary command to locate this
group name, as shown in Figure 12-17.
Figure 12-17. Program Listing Screen — Working Storage — Group Name
Abend-AID ------------------- Program Listing ----------- Row 000017 of 000307
COMMAND ===>
SCROLL ===> PAGE
==>
Program............... CCAADEMO

Program Compile Date.. 12JUN2007
Source Listing Date... 12JUN2007

Program Compile Time.. 15:58:26
Source Listing Time... 15:58:26


To reset display to the abending/last executed statement, select RESET

To reset display to the point of entry into this listing, select ENTRY


Source Line

*******************************************************************************
02 FILLER
S9(1)
COMP-3
+8
02 FILLER
X
LOW-VALUES
01 WS-130
S9(3)
COMP-3
+130
01 WS-130-X
REDEFINES WS-130
02 WS-13
X
X’13’
02 WS-0C
X
X’0C’ 

01 PAYROLL-DATA-EMP001
02 PAY001-TYPE
X
N
02 PAY001-NAME
X(15)
MR. DAVID ABEND
02 PAY001-ADDRESS
03 PAY001-STREET
X(12)
456 MAIN ST.
15. Because WA-HOURS was the second to last field under WORK-AREA, press the DOWN
PF key to locate the second to last field under PAYROLL-DATA-EMP001, which is
PAY001-HOURS, as shown in Figure 12-18. The data in this field was moved to WAHOURS.
Analyzing Data Exceptions
12-11
Figure 12-18. Program Listing Screen — Working Storage — Invalid Data
Abend-AID ------------------- Program Listing ----------- Row 000033 of 000307
COMMAND ===>
SCROLL ===> PAGE
==>
Program............... CCAADEMO

Program Compile Date.. 12JUN2007
Source Listing Date... 12JUN2007

Program Compile Time.. 15:58:26
Source Listing Time... 15:58:26


To reset display to the abending/last executed statement, select RESET

To reset display to the point of entry into this listing, select ENTRY


Source Line

*******************************************************************************
03 PAY001-DTEFF-MM
XX
01
03 PAY001-DTEFF-DD
XX
01
03 PAY001-DTEFF-YY
XX
84
02 PAY001-LST-PCT
9(3)V9
0110
02 PAY001-TAX-RAT
9(3)V9
0200
02 PAY001-YTD-GRS
S9(5)V99
+1500000
02 PAY001-YTD-TAX
S9(5)V99
+0300000
02 PAY001-HOURS
XXX
***
02 PAY001-MSG
X(26)
SPACES
01 PAYROLL-DATA-EMP999
02 PAY999-TYPE
X
I
02 PAY999-NAME
X(15)
MR. JOHN DOE
16. Note that PAY001-HOURS is defined as alphanumeric, XXX, and was initialized to
’***’. However, this data was moved to WA-HOURS, which is a numeric field. To
correct the invalid data and resolve the abend, change PAY001-HOURS to a numeric
field, 999, and initialize it to a numeric value.
12-12
Abend-AID for CICS User’s Guide
Part 3.
3
Region Dump Processing
Part 3 of this guide describes the following Abend-AID for CICS procedures unique to
region dump processing:
• Importing region dumps
• Analyzing region dumps
• Analyzing storage violations
• Analyzing MVS virtual storage
• Analyzing WebSphere MQ queue manager dumps.
Note:
Systems programmers should read this part of the guide in its entirety.
Application programmers may refer to this part of the guide on an as-needed
basis.
The following chapters are in Part 3:
Chapter 13, “Importing Region Dumps”
Chapter 13 describes the procedures for automatically or manually importing region
dumps into Abend-AID for CICS.
Chapter 14, “Analyzing CICS Region Dumps”
Chapter 14 describes how to use the Diagnostic Summary. This screen diagnoses and
analyzes region dumps, provides reasons why they occur, and recommends solutions.
Chapter 15, “Analyzing SVC Dumps”
Chapter 15 describes how to use the Diagnostic Summary for non-CICS SVC dumps.
Chapter 16, “Analyzing Storage Violations”
Chapter 16 describes possible approaches for using Abend-AID for CICS to analyze
the cause of storage violations.
Chapter 17, “Analyzing MVS Virtual Storage”
Chapter 17 describes a possible approach for using Abend-AID for CICS to resolve an
S878-xx abend or S80A-xx.
Chapter 18, “Analyzing WebSphere MQ Queue Manager Dumps”
Chapter 18 describes how to access WebSphere MQ queue manager region dump
information to determine the cause of a WebSphere MQ region abend.
Abend-AID for CICS User’s Guide
13-1
Chapter 13.
Importing Region Dumps
Chap 13
To analyze a region dump, you first must import it. This chapter describes the dataset
requirements necessary for dump import, the impact dump import has on the Abend-AID
Directory and dump analysis, and the methods available for performing dump import.
These methods include:
• Automatically via the MVS post-dump exit
• Manually from the SVC Dump Import screen
• Manually from the MVS console.
Abend-AID for CICS can import and analyze all standard IBM region dumps, both CICS
and non-CICS, also known as SVC dumps.
The term SVC dump refers to the following types of standard IBM machine-readable
dumps supported by Abend-AID for CICS:
•
•
•
•
Dumps taken using the SDUMP or SDUMPX macro instruction
Console dumps taken using the MVS DUMP system command
Dumps taken as the result of a SLIP trap with the ACTION=SVCD parameter specified
SYSMDUMPs taken as a result of a program ABEND in a jobstep containing an
SYSMDUMP DD statement
• Dumps taken using the IEATDUMP macro instruction.
Required Dump Dataset Attributes
Abend-AID for CICS completes the importing of dumps at the dataset level. For these
datasets to be imported, they must have the following attributes:
Table 13-1. Required Dump Dataset Attributes
z/OS Systems
RECFM=F
RECFM=FBS
LRECL=4160
LRECL=4160
BLKSIZE=4160
BLKSIZE=a multiple of
4160
Dump datasets are imported in a first-in, first-out order, with the automatic import queue
holding a maximum of 162 dumps.
Note:
Abend-AID for CICS cannot automatically import a dump directly from a
SYS1.DUMPxx dataset. Instead, it copies the dataset to another DASD file and
then imports that file. For Abend-AID for CICS to perform a dump copy, the
region dump capture option must be customized and the MVS post-dump exit
installed. For the steps, refer to the Abend-AID Installation and Customization Guide.
Abend-AID for CICS can automatically import dumps taken to automatically allocated
datasets if the MVS post-dump exit is installed.
13-2
Abend-AID for CICS User’s Guide
Impact on the Abend-AID Directory
When Abend-AID for CICS imports a dump dataset, it adds one or more entries to the
Abend-AID Directory. This directory lists the dumps available for a specific CICS region
or region group. For more information about the Abend-AID Directory, refer to
“Abend-AID Directory” on page 4-3.
If the imported dump dataset contains more than one address space, Abend-AID for CICS
adds separate entries to the Abend-AID Directory for each one and assigns them all the
identical entry number. For example, SVC dumps usually contain a single address space,
but console and SLIP dumps can have several address spaces within a single dump
dataset. Because Abend-AID for CICS does not reuse entry numbers, it assigns the next
highest ID number to each successive entry added. The Abend-AID Directory displays
these IDs in its Entry field.
Impact on Dump Analysis
Once imported, a dump is available for display through the Abend-AID for CICS online
interface. However, until dump analysis is run, the dump functions you can perform are
limited to navigating storage and executing IPCS commands. The latter assumes your site
installed IPCS as part of its Abend-AID for CICS installation. Refer to the Abend-AID
Installation and Customization Guide for more information.
Abend-AID for CICS automatically starts dump analysis on all imported datasets that
have a single CICS address space if the appropriate customization option is set. Refer to
Chapter 18, “Customizing Dump Capture and Processing Options” of the Abend-AID
Installation and Customization Guide for additional information. If the dataset that you are
importing contains multiple address spaces, dump analysis will automatically be run
against the dump if one, and only one, CICS address space is found in the dump. You can
invoke dump analysis manually against each address space in the dump dataset with the
Abend-AID Directory’s A (Analyze Dump) line command.
During dump import and dump analysis, system messages are generated in the Dump
Analysis Message Log. To display this log, either select a dump from the Abend-AID
Directory with the G (Messages) line command, or type MLOG in the COMMAND (or
OPTION) field on any Abend-AID for CICS screen and press Enter. For the MLOG fastpath command to function, however, you must first select a dump from the Abend-AID
Directory.
Importing Dumps Automatically
The MVS post-dump exit facilitates the automatic importing of dumps into Abend-AID
for CICS. To use the exit, complete the procedures described in the Abend-AID Installation
and Customization Guide.
Only the following dump types can be imported automatically:
• Console dumps that have an appropriate title (Refer to the Abend-AID Installation and
Customization Guide)
• Dumps taken to a user-defined dataset
• SVC dumps of a single CICS address space initially taken to an SYS1.DUMPxx dataset
and then copied to the dataset defined in the dump capture options
• Dumps taken to automatically allocated datasets.
Importing Region Dumps
13-3
If the automatic importing of a dump dataset fails, Abend-AID for CICS writes an error
message to the System Messages field on the Entry Information screen. For information
about this screen, refer to “Region Entry Information Screen” on page 4-10.
Importing Dumps Manually
Manually import dumps from either the SVC Dump Import screen or from the MVS
console. Importing dumps manually provides an alternative to importing dumps
automatically through the optional MVS post-dump exit. It is also the only method
available for importing SLIP, SYSMDUMP, and most console dumps.
Note:
You cannot import a dump directly from a SYS1.DUMPxx dataset. First, copy the
SYS1.DUMPxx dataset to a dataset with the same attributes, using IEBGENER or
an equivalent utility. Next, import the copied dump into Abend-AID for CICS.
SVC Dump Import Screen
You can initiate the import of any region dump from the SVC Dump Import screen, shown
in Figure 13-1, but you cannot use it to import transaction dumps. Once Abend-AID for
CICS completes a dump import, it sends a confirmation message that the dump is
available for display. When analysis is complete, a second message displays.
Figure 13-1. SVC Dump Import Screen
Abend-AID ------------------------- SVC DUMP Import ---------------------------
COMMAND ===> 



Specify import information below, then press Enter to initiate the import. 

Dataset Name
===> CV.CICS.CTSxxDUMP.SVC001 

Comments (Optional) ===> CICS TS for z/OS x.x SVC dump
You always have access to the SVC Dump Import screen, regardless whether any region or
transaction dump is currently selected. To display this screen from any Abend-AID for
CICS screen, enter IMPORT as a fast-path command. The SVC Dump Import screen is
also available as a selection on the Primary Options menu for region dumps. Once you
select a region dump, you can also enter =I or >I to display the SVC Dump Import screen.
MVS MODIFY Command
You can also manually import dumps directly from the MVS console using the MVS
MODIFY command and its IMPORT keyword. For information about this command, refer
to the Abend-AID Installation and Customization Guide.
13-4
Abend-AID for CICS User’s Guide
14-1
Chapter 14.
Analyzing CICS Region Dumps
Chap 14
This chapter describes how to analyze region dumps using the Diagnostic Summary.
Because the summary provides you direct access to much of the information you need for
diagnosing the region dump, begin your analysis using this screen. Also described are the
following screens that you can access from the Diagnostic Summary for additional
information about the region dump:
• Task Detail
• Task/Wait Analysis menu
– Task Summary
– Task/Wait Analysis
• Program Level Summary
– Channels
– Containers
• Trace Listing
• Kernel Domain Error Table
– Kernel Domain Error Detail
– Kernel Linkage Stack
• Enqueue Summary
• Program Change Summary
• Storage Addressability Summary
• Storage Address Analysis.
Before beginning your analysis of the region dump using the Diagnostic Summary, read
Chapter 3, “Abend-AID for CICS Interface” to familiarize yourself with the Abend-AID for
CICS screen layout and text display defaults. Note how to enter fast-path and line
commands. In particular, review “Cursor Point-and-Shoot Feature” on page 3-7 for an
explanation of the alternative methods for accessing program storage and detailed
information about specific data elements. Online help is available for any Abend-AID for
CICS screen, field, system message, or command.
For information about using the Diagnostic Summary for transaction abend analysis,
refer to Chapter 8, “Analyzing Transaction Abends”.
Diagnostic Summary for CICS Region Dumps
The region dump Diagnostic Summary is the logical starting point for debugging the
majority of CICS Transaction Server for z/OS and OS/390 region dumps for which AbendAID for CICS has run dump analysis. It states the reason for a region failure, identifies the
location of corrupted storage, indicates which tasks most likely caused the error, and
suggests which dump displays to view first. From selected fields on the Diagnostic
Summary, you also have direct access to additional screens that provide further details
about the region dump.
14-2
Abend-AID for CICS User’s Guide
Note:
If you are analyzing a CICS SVC dump, you can also access SVC dump
information. See Chapter 15, “Analyzing SVC Dumps” for more information.
The Diagnostic Summary consists of two or more pages and contains the following
sections:
• Description
• Analysis.
Two different Diagnostic Summary formats are available: full text and abbreviated text. The
full-text format, shown in Figure 14-1 through Figure 14-3 on page 14-3, is the default
format and provides a narrative description of the reason for the dump. It also provides
supporting text that incorporates tab-selectable addresses and the exception trace entry.
Supporting text also describes information displayed in the fields.
To change the default diagnostic summary format, change the Default region dump
Diagnostic Summary format field on the User Profile screen to A (ABBREVIATED).
Figure 14-1. Diagnostic Summary for a CICS Region Dump (Narrative Format), Page1
Abend-AID ------------- Diagnostic Summary -------------- Row 000001 of 000033
COMMAND ===>
SCROLL ===> PAGE

Date... 16FEB2004 Time... 17:09:27
ASID... 0027
Dump Code... SM0102
Title.. CICS DUMP: SYSTEM=H01AC260 CODE=SM0102
I
Category.... STG VIOL 

To display the Diagnostic Summary in abbreviated format select ABBREV 

Description 

This dump ( code SM0102 ) was taken because CICS detected a storage
violation. 

The CICS message associated is: DFHSM0102 H01AC260 A storage violation
(code X’0D11’) has been detected by module DFHSMMF . 

The short symptom string is: PIDS/565501800 LVLS/410 MS/DFHSM0102
RIDS/DFHSMMF PTFS/UN66186 PRCS/00000D11 

Analysis 

A storage violation occurred. CICS detected that the storage at address
00182610 has an invalid storage zone. The leading storage zone is
C2F0F0F0F0F0F6F0 and the trailing storage zone is FFF0F0F0F0F0F6F0.
Analyzing CICS Region Dumps
14-3
Figure 14-2. Diagnostic Summary for a CICS Region Dump (Narrative Format), Page 2
Abend-AID ------------- Diagnostic Summary -------------- Row 000015 of 000033
COMMAND ===>
SCROLL ===> PAG 

Date... 16FEB2004 Time... 17:09:27
ASID... 0027
Dump Code... SM0102
Title.. CICS DUMP: SYSTEM=H01AC260 CODE=SM0102
I
Category.... STG VIOL 

To display the Diagnostic Summary in abbreviated format select ABBREV 

Analysis 

Addressability and matching information are available for the area. 

The current task at the time the dump was taken was 60. 

The CICS trace table has 3 exception entries, and 2 are related to task 60.
The last exception trace entry for task 60 gives the following information: 

00060 1 ME FF45 MEWS *EXC* SYMREC-ERROR 

The CICS Kernel Error Table had 8 (x’ 00000008 ’) entries. The most recent
entry KEER0001 indicated an ---/ASRA abend percolate at 17:07:44 on
16FEB2003. 

There are no CICS enqueues held.
Figure 14-3. Diagnostic Summary for a CICS Region Dump (Narrative Format), Page 3
Abend-AID ------------- Diagnostic Summary -------------- Row 000030 of 000033
COMMAND ===>
SCROLL ===> PAGE


Date... 16FEB2004 Time... 17:09:27
ASID... 0027
Dump Code... SM0102
Title.. CICS DUMP: SYSTEM=H01AC260 CODE=SM0102
I
Category.... STG VIOL 

To display the Diagnostic Summary in abbreviated format select ABBREV 

Analysis 

There are no tasks waiting for storage. 

No programs where changed within the last 14 days. 
The abbreviated format, shown in Figure 14-4 and Figure 14-5, provides the same
information as the full-text format, but without the accompanying narrative. It does not
explain the meaning or use of the listed fields, but you can obtain this information from
the field help or by toggling to the full-text format. Toggle between the two screens using
the ABBREV or FULL selection displayed on the first line of each page of the Diagnostic
Summary.
14-4
Abend-AID for CICS User’s Guide
Figure 14-4. Diagnostic Summary for a CICS Region Dump (Abbreviated Format), Page 1
Abend-AID ------------- Diagnostic Summary -------------- Row 000001 of 000017
COMMAND ===>
SCROLL ===> PAGE 

Date... 16FEB2004 Time... 17:09:27
ASID... 0027
Dump Code... SM0102
Title.. CICS DUMP: SYSTEM=H01AC260 CODE=SM0102
I
Category.... STG VIOL
Message.. DFHSM0102 H01AC260 A stor
Symptom String... PIDS/565501800 LVLS/ 

To display the Diagnostic Summary in full format select FULL 

Storage Violation
Storage in error...... 00182610
Invalid storage zone
Leading storage zone.. C2F0F0F0F0F0F6F0
Trailing storage zone. FFF0F0F0F0F0F6F0 

Task Information
Current task.......... 60 

Trace Information
System exceptions..... 3
Task exceptions....... 2 

Other Information
Kernel Errors......... 8
Enqueues.............. 0
Figure 14-5. Diagnostic Summary for a CICS Region Dump (Abbreviated Format), Page 2
Abend-AID ------------- Diagnostic Summary -------------- Row 000016 of 000017
COMMAND ===>
SCROLL ===> PAGE


Date... 16FEB2004 Time... 17:09:27
ASID... 0027
Dump Code... SM0102
Title.. CICS DUMP: SYSTEM=H01AC260 CODE=SM0102
I
Category.... STG VIOL
Message.. DFHSM0102 H01AC260 A stor
Symptom String... PIDS/565501800 LVLS/ 

To display the Diagnostic Summary in full format select FULL 

Storage suspends...... 0
Recent changes........ 0 
Access the Diagnostic Summary by doing one of the following:
• Enter S as a line command on the Abend-AID Directory next to the entry for the
region dump you want to analyze, and then press Enter.
• If you have already selected the region dump, do one of the following:
– Directly access the Diagnostic Summary from the Abend-AID for CICS Primary
Options menu.
– Enter DIAG as a fast-path command on any Abend-AID for CICS screen, and then
press Enter.
To analyze the selected region dump, do the following:
1. Note general information about the region dump from the fields displayed at the top
of the Diagnostic Summary. Information reported for each dump includes the
following:
–
–
–
–
–
–
–
Date and time of the abend
Address space ID
Dump code
CICS dump title
Problem category
CICS message
Symptom string.
Analyzing CICS Region Dumps
14-5
2. Review the Description section for a description of the abend and an explanation of
the probable cause. Note the dump code, CICS message, and symptom string
associated with the abend.
3. Review the Abend-AID for CICS analysis displayed at the beginning of the Analysis
section. Use the cursor point-and-shoot feature and press Enter to access diagnostic
information specific to the abend.
4. Access task, trace, kernel domain, and enqueue information, when available, as
follows:
– Press Enter on the Current task field to display the Task Detail screen, which is
explained in “Task Detail Screen” on page 14-5.
– Enter TASKS as a fast-path command on the Diagnostic Summary to display the
Task/Wait Analysis menu, which is explained in “Task/Wait Analysis Menu” on
page 14-6.
– Press Enter on the exception entries or trace entries field to display the Trace
Listing screen, which is explained in “Trace Listing Screen” on page 14-11.
– Press Enter on the Kernel errors field to display the Kernel Domain Error Table,
which is explained in “Kernel Domain Error Table Screen” on page 14-12.
– Press Enter on the CICS enqueue field to display the Enqueues Summary screen,
which is explained in “Enqueue Summary Screen” on page 14-14.
– Press Enter on the changed field to display the Program Change Summary screen,
which is explained in “Program Change Summary Screen” on page 14-15.
5. Access the specific storage information in hexadecimal format for any address or
symbol displayed by using the HEXD PF key to display the Memory Display screen,
which is explained in “Using the Memory Display Screen” on page 5-2.
6. When available, display DSECTs using the DSECT PF key, the Storage Addressability
Summary screen using the WHO PF key, and the Storage Address Analysis screen
using the WHERE primary command. The Storage Addressability Summary screen is
explained in “Storage Addressability Summary” on page 14-16. The Storage Address
Analysis is explained in “Storage Address Analysis Screen” on page 14-17.
Task Detail Screen
The Task Detail screen, shown in Figure 14-6, provides detailed information about the
status of a CICS task at the time of the abend. It includes transaction information,
program information, wait reason, register information, and storage utilization. Use the
cursor point-and-shoot feature to access the kernel linkage stack, task control area (TCA),
transaction queue element (TQE), program control table entry (PCT), and dispatcher task
detail (DTA) in interpreted, DSECT, and hexadecimal format. You can also display wait
analysis information by pressing Enter on a resource type or resource name.
Besides accessing the Task Detail screen for only the current active task using the cursor
point-and-shoot feature on the Diagnostic Summary or the TCA Interpreted screen and
pressing Enter, you can also access this screen by executing the S line command against
any CICS task displayed on the Task/Wait Analysis screen.
14-6
Abend-AID for CICS User’s Guide
Figure 14-6. Task Detail Screen
Abend-AID -------------------- Task Detail ---------------------------------- 
COMMAND ===>


Task..... 0000054
Error Flag... YES
Kernel Task..... KETA0033

TCA...... TCA0033
Enqueue Held. NO
Resource Type...

TXN...... TXN0033
Terminal..... 0015
Resource Name...

Tran..... XPND
Program...... EYU9XLOP
TASKDATAKEY..... USER

DTA...... DTA0033
Offset.......
EXECKEY......... CICS

Userid... PFHSAA0
UOWID........ BEB6636AA6070380


Task PSW..... 00000000 B78451A6
LE Information

Instruction.. CLI
297(R11),X'00'


Register Save Area from: HLL

REG 0
REG 1
REG 2
REG 3
REG 4
REG 5
REG 6
REG 7

000007E0 38200080 392700E6 3927012D 38200BC8 B92700CA 0000001C 00000002

REG 8
REG 9
REG 10
REG 11
REG 12
REG 13
REG 14
REG 15

0008443C B7845074 00000004 0005F388 0005F080 800500C0 B78451A6 37845D40


--------------- Transaction Storage --------------Terminal

CICS Below
User Below
CICS Above
User Above
Storage

Areas (Hex) 00000000
00000001
00000001
00000003
00000000

Bytes (Hex) 00000000
00000470
00000170
0000B210
00000000

To obtain additional information about the abending task, do the following:
1. Note general information about the abending task such as the program name and
task number.
2. Access the specific storage information in disassembled format for the Task’s PSW. To
access the Storage Disassembly screen, either tab to the second Task PSW field and
press Enter or issue the DISASM primary command, which is explained in “DISASM”
on page 21-26.
3. Access the specific storage information in hexadecimal format for any address or
symbol displayed by using the HEXD PF key to display the Memory Display screen,
which is explained in “Using the Memory Display Screen” on page 5-2.
4. Display DSECTs using the DSECT PF key, and when available, display the Storage
Addressability Summary screen using the WHO PF key, and the Storage Address
Analysis screen using the WHERE primary command. The Storage Addressability
Summary screen is explained in “Storage Addressability Summary” on page 14-16.
The Storage Address Analysis is explained in “Storage Address Analysis Screen” on
page 14-17.
5. Access other task-related information by using the cursor point-and-shoot feature as
follows:
– Press Enter at the Kernel Task field to display the Kernel Linkage Stack screen.
– Press Enter at the TCA field to display the Interpreted Task Control Area screen.
– Press Enter at the TQE field to display the Interpreted Transaction Queue Element
screen.
– Press Enter at the Tran field entry to display the Program Control Table screen.
– Press Enter at the DTA field to display the Dispatcher Task Detail screen.
Task/Wait Analysis Menu
The Task/Wait Analysis menu, shown in Figure 14-7, lets you access two screens that
display task-related information: the Task Summary screen as described in “Task
Summary Screen” on page 14-7 and the Task/Wait Analysis screen, as described in
“Task/Wait Analysis Screen” on page 14-7. Access the Task/Wait Analysis menu from the
Analyzing CICS Region Dumps
14-7
Primary Options menu for region dumps or by entering TASKS as a fast-path command
on any Abend-AID for CICS screen.
Figure 14-7. Task/Wait Analysis Menu



Abend-AID ----------------- Task/Wait Analysis ------------------------------ 
OPTION ===>


1 TASKSUMM Task Summary


2 TASKLIST Task List/Wait Analysis

Task Summary Screen
The Task Summary screen, shown in Figure 14-8 on page 14-7, displays the number of
tasks on the various task queues controlled by the Dispatcher Domain, the Kernel
Domain, and the Transaction Manager Domain. Access this screen from the Task/Wait
Analysis Menu as shown in Figure 14-7 on page 14-7, or enter TASKSUMM as a fast-path
command on any Abend-AID for CICS screen.
Figure 14-8. Task Summary Screen
Abend-AID -------------------- Task Summary --------------------------------- 
COMMAND ===>


Dispatcher Domain Chains
Kernel Domain Task Entries

Chain
Tasks
Type
Tasks

Total....................
15
Allocated................
22

Executable...............
15
Running..................
0

Hand-Postable............
2
Not Running..............
22

Quasi-Reentrant (Front)..
0
Tasks in Error...........
1

Quasi-Reentrant (Back)...
0

Resource Owning (Front)..
0

Resource Owning (Back)...
0
Transaction Manager Statistics

Concurrent (Front).......
0
Type
Tasks

Concurrent (Back)........
0
Total....................
9

Secondary LU (Front).....
0
Active...................
9

Secondary LU (Back)......
0
Max Tasks................
0

RP/ONC (Front)...........
0
Tclass...................
0

RP/ONC (Back)............
0
Pre-Scheduled............
0

File Owning (Front)......
0

File Owning (Back).......
0




Press ENTER on a tab-selectable field to display the indicated task list 
Task/Wait Analysis Screen
The Task/Wait Analysis screen, shown in Figure 14-9 through Figure 14-11 on page 14-9,
provides a complete summary and detailed information about all tasks. This information
helps system programmers quickly identify any tasks that are waiting on specific
resources and all task-related errors. The Task/Wait Analysis screens lists the number of
tasks on the dispatcher domain, kernel domain, and transaction manager task chains.
Access the Task/Wait Analysis Screen from the Task/Wait Analysis Menu as shown in
Figure 14-7 on page 14-7, or enter TASKLIST as a fast-path command on any Abend-AID
for CICS screen
14-8
Abend-AID for CICS User’s Guide
Figure 14-9. Task/Wait Analysis Screen
Abend-AID ------------------ Task/Wait Analysis ------- Row 000001 of 000011
COMMAND ===>
SCROLL ===> PAGE
==>
S Task Detail
L Program Levels
C Storage Chain
E EIB Detail
T Trace Table
M Monitoring Detail
W Wait Analysis 

DS
XM
DTA
Task
Tran Terminal Status TCA
Status KETASK
TXN
Error
******* ******* **** ****
***
******* ***
******** ******* ***
_ DTA0029 0000082 CEMT B172
RUN
TCA0029 ACT
KETA0029 TXN0029 NO
_ DTA002A 0000078 LINK B173
SUS
TCA002A ACT
KETA002A TXN002A YES
_ DTA0007 0000020 CSNE
SUS
TCA0007 ACT
KETA0007 TXN0007 NO
_ DTA0016 0000018 CFQR
SUS
TCA0016 ACT
KETA0016 TXN0016 NO
_ DTA0030 0000017 CFQS
SUS
TCA0030 ACT
KETA0030 TXN0030 NO
_ DTA0010 0000007 CSTP
SUS
TCA0010 ACT
KETA0010 TXN0010 NO
_ DTA0019 0000005 CSSY
SUS
TCA0019 ACT
KETA0019 TXN0019 NO
_ DTA0009 0000004 CSSY
SUS
TCA0009 ACT
KETA0009 TXN0009 NO
_ DTA0008 0000000
SUS
KETA0008
NO
_ DTA0021 0000000
SUS
KETA0021
NO
_ DTA0006 0000000
SUS
KETA0006
NO
***************************** BOTTOM OF DATA ***************************** 


Type a line command and press Enter to process it
Figure 14-10. Task/Wait Analysis Screen, Scrolled Right
Abend-AID ------------------- Task/Wait Analysis --------- Row 000001 of 000011
COMMAND ===>
SCROLL ===> PAGE
<== ==>
S Task Detail
L Program Levels
C Storage Chain
E EIB Detail
T Trace Table
M Monitoring Detail
W Wait Analysis 

Enq
Resource Resource Time of
DTA
Storage
Program Offset Held NQEA
Type
Name
Suspend
******* ********** ******** ******* *** ******** ******** ******** *********
_ DTA0029
20K DFHEMTD +014BC0 NO
00:00:00.
_ DTA002A
2K RFDREAD1 +000064 NO
ICWAIT
B173
15:30:28.
_ DTA0007
3K DFHZNAC
NO
15:30:54.
_ DTA0016
1K DFHFCQT
NO
FCCFQR
14:48:58.
_ DTA0030
1K DFHFCQT
NO
FCCFQS
15:29:01.
_ DTA0010
1K DFHZCSTP
NO
TCP_NORM DFHZDSP 15:31:34.
_ DTA0019
0K DFHAPATT
NO
ICEXPIRY DFHAPTIX 14:55:33.
_ DTA0009
0K DFHAPATT
NO
ICMIDNTE DFHAPTIM 14:48:37.
_ DTA0008
0K
NO
TIEXPIRY DS_NUDGE 14:55:33.
_ DTA0021
0K
NO
SMSYSTEM
15:27:42.
_ DTA0006
0K
NO
ENF
NOTIFY
14:47:26.
****************************** BOTTOM OF DATA *******************************



Type a line command and press Enter to process it
Analyzing CICS Region Dumps
14-9
Figure 14-11. Task/Wait Analysis Screen, Scrolled Far Right
Abend-AID ------------------- Task/Wait Analysis --------- Row 000001 of 000011
COMMAND ===>
SCROLL ===> PAGE
<==
S Task Detail
L Program Levels
C Storage Chain
E EIB Detail
T Trace Table
M Monitoring Detail
W Wait Analysis 

Resource Resource Time of
DTA
NQEA
Type
Name
Suspend

******* ******** ******** ******** ************ 
_ DTA0029
00:00:00.000 
_ DTA002A
ICWAIT
B173
15:30:28.922 
_ DTA0007
15:30:54.148 
_ DTA0016
FCCFQR
14:48:58.900 
_ DTA0030
FCCFQS
15:29:01.038 
_ DTA0010
TCP_NORM DFHZDSP 15:31:34.276

_ DTA0019
ICEXPIRY DFHAPTIX 14:55:33.804 
_ DTA0009
ICMIDNTE DFHAPTIM 14:48:37.739 
_ DTA0008
TIEXPIRY DS_NUDGE 14:55:33.722
_ DTA0021
SMSYSTEM
15:27:42.409
_ DTA0006
ENF
NOTIFY
14:47:26.603
****************************** BOTTOM OF DATA *******************************

Program Level Summary
The Program Level Summary, shown in Figure 14-12 on page 14-9, displays a summary of
program logical levels in effect for this transaction instance. Access this screen by
entering the L (Program Levels) line command next to the DTA field on the Task/Wait
Analysis screen, which is described above.
Figure 14-12. Program Level Summary





Programs are displayed with the most current level first.


Handle
Current
Commarea
Invokin
PLCB
Program
API Type
Table
Commarea Length
Channels Program
******** ******** ********** ******** ******** ******** ******** *******
36DAFDA8 FXCHAN02 FULL CICS
00000000 00000000 00000000 YES
FXCHAN0
36DADF00 FXCHAN01 FULL CICS
371CC7F0 00000000 00000000 YES
CICS

****************************** BOTTOM OF DATA *********************************




Abend-AID --------------- Program Level Summary -------- Row 000001 of 000002
COMMAND ===>
SCROLL ===> PAGE
<== ==>
TXN Name...... TXN003E
Use the cursor point-and-shoot feature on the tab-selectable fields to display additional
information about this transaction. Press the PF 11 key (Scroll Right) to display
additional fields. Press Enter at the YES displayed in the Channels field to display the
Channels screen, which is described below.
Channels Screen
The Channels screen, shown in Figure 14-13, displays the Channels associated with a
program. Access this screen from the Program Level Summary, which is described above.
14-10
Abend-AID for CICS User’s Guide
Figure 14-13. Channels Screen
Abend-AID ---------------------- Channels -------------- Row 000001 of 000003 
COMMAND ===>
SCROLL ===> PAGE 

Program.... FXCHAN02


C Display Containers


Number of
Container

Channel
Current Creator
Containers Pool Size

**************** ******* ******** ********** **********

CHANNEL001
YES
FXCHAN01
3
000000F6

CHANNEL04A
NO
FXCHAN02
1
00000028

CHANNEL004
NO
FXCHAN02
1
00000028

***************************** BOTTOM OF DATA ********************************



Enter the C (Display Containers) line command next to the Channel field, or use the
cursor point-and-shoot feature to tab to the channel name in the Channel field and press
Enter to display the Containers screen, which is described below.
Containers Screen
The Containers screen, shown in Figure 14-14, displays the containers associated with a
channel. Access this screen from the Channels screen, which is described above.
Figure 14-14. Containers Screen
Abend-AID --------------------- Containers ------------- Row 000001 of 000003 
COMMAND ===>
SCROLL ===> PAGE 

Program...... FXCHAN02
Current.......... YES

Channel...... CHANNEL001
Creator.......... FXCHAN01


Data

Container
Length
Type CCSID Address

**************** ******** **** ***** *****************

CONTAINER-1C
00000052 CHAR
37 00000008_80105004

CONTAINER-1B
00000052 BIT
37 00000008_80104004

CONTAINER-1A
00000052 BIT
37 00000008_80103004

****************************** BOTTOM OF DATA *********************************




Use the cursor point-and-shoot feature to tab to the data in the Address field, where you
can enter any of the following commands to view additional information:
• HEXD (PF18 key): Displays the data in hexadecimal format on the Memory Display
screen, which is described on page 5-2.
• WHO (PF20 key): Displays the Storage Addressability Summary, which is described
on page 14-16.
• WHERE: Displays the STorage Address Analysis screen, which is described on page
14-17.
• MATCH (PF22 key): Displays the data in hexadecimal format on the Memory Display
screen, which is described on page 5-2.
Analyzing CICS Region Dumps
14-11
Trace Listing Screen
The Trace Listing screen — shown in its abbreviated format in Figure 14-15, in its short
format in Figure 14-16, and in its full format in Figure 14-17 on page 14-12 — displays all
or selected entries from the CICS trace table. The Trace Listing screen identifies the order
in which application programs execute in CICS and is useful in diagnosing problems
involving complex system interactions.
Exactly how the trace listing is displayed depends on which field on the Diagnostic
Summary you use to access it. You can display all entries for the selected task starting at
the last exception entry or all exception entries.
Besides accessing the Trace Listing screen using the cursor point-and-shoot feature on the
Diagnostic Summary and pressing Enter, you can also access this screen from the AbendAID for CICS Primary Options menu or by entering TRACE as a fast-path command on
any Abend-AID for CICS screen. Selection criteria are available if you access the trace
table in this manner. Pressing Enter at the SELECT field displays the Trace Selection
Criteria window from which you can choose criteria for displaying the trace data.
Figure 14-15. Abbreviated Trace Listing, Filtered by Exception Entries
Abend-AID --------- Abbreviated Trace Listing ---------- Row 000001 of 000006
COMMAND ===>
SCROLL ===> PAGE
==>
To display the Trace Listing in short format select SHORT
To display the Trace Listing in full format select FULL
To specify selection criteria select SELECT 

KE
Trace
Entry Task Task Point
Interpretation
013606 0011 00052 DS 0069 DSSR *EXC* SUSP_PURGED
SUSPEND,010B0007
016121 0011 00052 AP 0780 SRP
*EXC* RECOVERY_ENTERED
016125 0011 00052 AP 0780 SRP
*EXC* RECOVERY_ENTERED
016131 0011 00052 AP 0509 APDS *EXC* RECOVERY_ENTER_FROM
DFHAPDS
016132 0011 00052 AP 0780 SRP
*EXC* RECOVERY_ENTERED
016429 0011 00052 SM 0D11 SMMF *EXC* Storage_check_failed_on_freemain_reque
****************************** BOTTOM OF DATA ****************************** 
Pressing Enter at the SHORT field displays the following short trace listing.
Figure 14-16. Short Trace Listing
Abend-AID ------------------- Short Trace Listing ------- Row 000001 of 000129
COMMAND ===>
SCROLL ===> PAGE 

To display the Trace Listing in full format select FULL
To display the Trace Listing in abbreviated format select ABBREV
To specify selection criteria select SELECT 

Entry Task Interpretation
013606 00052 DS 0069 DSSR *EXC* SUSP_PURGED SUSPEND
SUSPEND_TOKEN(010B007) RESOURCE_NAME(SUSPEND)
RESOURCE_TYPE(KCCOMPAT) PURGEABLE(NO) DEADLOCK_ACTION(INHIBIT)
RET-850B3000 16:24:49.2247317500 **.********** 

016121 00052 AP 0780 SRP *EXC* RECOVERY_ENTERED
RET-850B3000 16:24:50.3640933752 01.1393616252* 

016125 00052 AP 0780 SRP *EXC* RECOVERY_ENTERED
RET-860B3000 16:24:54.9650980002 04.6010046250* 

016131 00052 AP 0509 APDS *EXC* RECOVERY_ENTERED_FROM DFHAPDS
RET-850B3000 16:24:55.0331000002 **.********** 

016132 00052 AP 0780 SRP *EXC* RECOVERY_ENTERED
14-12
Abend-AID for CICS User’s Guide
Pressing Enter at the FULL field displays the following full trace listing.
Figure 14-17. Full Trace Listing
Abend-AID ------------- Full Trace Listing ------------- Row 000001 of 000129
COMMAND ===>
SCROLL ===> PAGE 

To display the Trace Listing in short format select SHORT
To display the Trace Listing in abbreviated format select ABBREV
To specify selection criteria select SELECT 

Entry Task Interpretation
013606 00052 DS 0069 DSSR *EXC* - SUSP_PURGED - FUNCTION(SUSPEND)
SUSPEND_TOKEN(010B0007) RESOURCE_NAME(SUSPEND)
RESOURCE_TYPE(KCCOMPAT) PURGEABLE(NO) DEADLOCK_ACTION(INHIBIT)
KE_NUM-0011 TCB-0089DBF0 RET-850B3000 TIME-16:24:49.2247317500
INTERVAL-**.**********
1-0000 C4C6C8C4 E2E2D940
*DFHDSSR
*
2-0000 00580000 00000014 00000001 00000000 *................*
0010 A7050000 00000000 04000600 00000000 *x...............*
0020 00000000 010B0007 E2E4E2D7 C5D5C440 *........SUSPEND *
0030 D2C3C3D6 D4D7C1E3 40404040 40200440 *KCCOMPAT
.. *
0040 40404040 40404020 03020003 00000000 *
.........*
0050 00000000 00680000
*........
*
3-0000 FFFFFFFF 01070005 04FA0000 0538FC48 *................*
0010 FFFFFFFF 00000000 00000000 00000000 *................*
0020 00000010 00000003 040BB4B0 00000000 *................*
To obtain additional information about the trace listing associated with the abending
task, do the following:
1. Note general information about the trace listing such as the entry number, kernel
domain task number, CICS transaction task number, CICS component ID, trace point
ID, and the interpretation comment.
2. Access the specific storage information in hexadecimal format for any address or
symbol displayed by using the HEXD PF key to display the Memory Display screen,
which is explained in “Using the Memory Display Screen” on page 5-2.
3. Toggle among the abbreviated, short, and full trace listings using the ABBREV,
SHORT, or FULL selections.
Kernel Domain Error Table Screen
The Kernel Domain Error Table screen, shown in Figure 14-18 on page 14-13, displays an
overview of the program checks and system abends that occurred for the CICS session
associated with the region dump. For each abend, an entry is displayed that identifies the
kernel error number, system and user completion code, abend error type, kernel task, and
date and time of the abend. Press Enter at the Error field for an entry to display detail
information about an individual abend including CICS error data, program information,
and registers. You can also use the cursor point-and-shoot feature to display linkage stack
entries for an individual task by pressing Enter at the Kernel Task field.
Besides accessing the Kernel Domain Error Table screen using the cursor point-and-shoot
feature on the Diagnostic Summary and pressing Enter, you can also access this screen by
entering the KEER command as a fast-path command on any Abend-AID for CICS screen.
Analyzing CICS Region Dumps
14-13
Figure 14-18. Kernel Domain Error Table Screen
Abend-AID ---------- Kernel Domain Error Table ---------- Row 000001 of 000008
COMMAND ===>
SCROLL ===> PAGE


Error
Error Code Error Type
Kernel Task Date
Timestamp
******** ********** ************* ********
********
************
KEER0001 ---/ASRA
AB PERCOLATE
KETA002F
16FEB2004 17:07:44.635
KEER0002 0C7/AKEA
PROGRAM CHECK KETA002F
16FEB2004 17:07:29.835
KEER0003 ---/AEIP
AB PERCOLATE
KETA002F
16FEB2004 16:58:04.097
KEER0004 ---/AEIP
AB PERCOLATE
KETA002F
16FEB2004 16:58:04.097
KEER0005 ---/AEIM
AB PERCOLATE
KETA002F
16FEB2004 16:57:51.179
KEER0006 ---/AEIM
AB PERCOLATE
KETA002F
16FEB2004 16:57:51.179
KEER0007 ---/ASRA
AB PERCOLATE
KETA002F
16FEB2004 16:57:32.711
KEER0008 0C7/AKEA
PROGRAM CHECK KETA002F
16FEB2004 16:57:26.131
******************************* BOTTOM OF DATA ********************************
To obtain additional information about the abending program, do the following:
1. Note general information about the abending program, such as kernel error number,
system and user completion code, abend error type, kernel task, and date and time of
the abend.
2. Access other kernel domain information by using the cursor point-and-shoot feature
as follows:
– Press Enter at an Error field entry to display the Kernel Domain Error Detail
screen, as shown in Figure 14-19.
– Press Enter at a Kernel Task field entry to display the Kernel Linkage Stack screen,
as shown in Figure 14-20 on page 14-14.
Figure 14-19. Kernel Domain Error Detail Screen
Abend-AID ---------------- Kernel Domain Error Detail ------------------------
COMMAND ===> 

KE Error Symbol KEER0001
Code... ---/ASRA
Task... 60
KE Error Number 00000008
Type... AB PERCOLATE
Date... 16FEB2004
Kernel Task.... KETA002F
TCA.... 08567080
Time... 17:07:44.635
Transaction.... ERWV
DTA.... 0849D180
Program........ DFHAPLI1 

Error happened under the CICS RB 

CICS Error Data
PSW............ 00000000 8854B37A
Instruction Length... 0000
Program........ DFHSRP
Interrupt Code....... 0000
Offset......... 0000037A
Reason............... 0007
EXEC Key....... 

Instruction.... 5840 9028
L
R4,40(,R9) 

Reg 0
Reg 1
Reg 2
Reg 3
Reg 4
Reg 5
Reg 6
Reg 7
0000040C 0856756C 80045570 8854B1D2 088099F0 88679B5F 8867AB5E 8867BB5D
Reg 8
Reg 9
Reg 10
Reg 11
Reg 12
Reg 13
Reg 14
Reg 15
085FF958 0856756C 0886C008 01000000 08567080 088099F0 8854B37A 88300080
14-14
Abend-AID for CICS User’s Guide
Figure 14-20. Kernel Linkage Stack Screen
Abend-AID ------------ Kernel Linkage Stack ------------- Row 000001 of 000009
COMMAND ===>
SCROLL ===> PAGE


Kernel Linkage Stack for Kernel Task........ KETA002F 

Stack
Module
Return
Entry
Length Type
Address
Address
Offset
Error Name
******* ****** ********** ******** ******** ******** ***** ********
KETS001
0120 BOTTOM
08300400 883006D0 000002D0
DFHKETA
KETS002
01F0 DOMAIN
0830F058 8830F16E 00000116
DFHDSKE
KETS003
0370 DOMAIN
0832F5E0 8832FD4E 0000076E
DFHXMTA
KETS004
0350 DOMAIN
08620A00 886212B6 000008B6
DFHPGPG
KETS005
0400 DOMAIN
08678B60 887844D6 00000000
DFHAPLI1
KETS006
00F8 LIFO
08784150 887845A2 00000452
DFHESC
KETS007
0290 DOMAIN
0831EDE8 8832028C 000014A4
DFHSMMF
KETS008
0F90 DOMAIN
08379870 8837CFF2 00003782
DFHMEME
KETS009
0480 DOMAIN
0835ABC0 8835C190 000015D0
DFHDUDU
******************************* BOTTOM OF DATA ********************************
Enqueue Summary Screen
The Enqueue Summary screen, shown in Figure 14-21 on page 14-14, displays a listing of
all enqueue element areas (NQEAs) in the system. An NQEA is an area of storage
containing data required by a specific task. NQEAs are created when the EXEC CICS ENQ
command is issued for a particular resource or by CICS for various services.
Use the cursor point-and-shoot feature to access the interpreted task control area (TCA),
program control table (PCT), and PPT detail. You can also use the HEXD PF key to access
the storage information associated with an enqueue name address or NQEA address. In
addition, you can display the Enqueue Detail screen and the Abbreviated Trace Listing
screen for the selected task using the E and T line commands, respectively.
Besides accessing the Enqueue Summary screen using the cursor point-and-shoot feature
on the Diagnostic Summary, you can also access this screen by entering the ENQ
command as a fast-path command on any Abend-AID for CICS screen.
Figure 14-21. Enqueue Summary Screen (Scrolled Left)
Abend-AID -------------- Enqueue Summary ---------------- Row 000001 of 000006
COMMAND ===>
SCROLL ===> PAGE
==>
E Enqueue Detail
T Trace Detail 

DS
Tasks
Enqueue Enqueue Enqueue
Enque
TCA
Tran Task
Program Status Waiting Address Length Character Hexad
******* **** ******* ******** ***
***
******** ***
******** *****
_ TCA0029 CECI 0000025 DFHECID SUS
NO
0632A4CC
3
BO2
C2D6F
_ TCA0029 CECI 0000025 DFHECID SUS
NO
0632A40C
3
BO1
C2D6F
_ TCA0029 CECI 0000025 DFHECID SUS
NO
0632A64C
3
BO4
C2D6F
_ TCA0029 CECI 0000025 DFHECID SUS
NO
0632A70C
3
BO5
C2D6F
_ TCA0029 CECI 0000025 DFHECID SUS
YES
0632A34C
3
BOB
C2D6C
_ TCA0029 CECI 0000025 DFHECID SUS
NO
0632A58C
3
BO3
C2D6F
****************************** BOTTOM OF DATA *******************************

To obtain additional information about enqueues, do the following:
1. Note general information about listed NQEAs from the fields displayed on the
Enqueues Summary screen. Pay particular attention to task status and tasks waiting
entries. These entries indicate the dispatcher status of the task holding the enqueue,
and whether the enqueue selected is causing other tasks to wait.
2. Access the specific storage information in hexadecimal format for the Enqueue
name/address and NQEA address entries by using the cursor point-and-shoot feature
Analyzing CICS Region Dumps
14-15
and pressing the HEXD PF key to display the Memory Display screen, which is
explained in “Using the Memory Display Screen” on page 5-2. Display the first 8
bytes of the enqueue name/address in character format by scrolling right. The default
RIGHT PF key is PF11.
3. When available, display DSECTs using the DSECT PF key, the Storage Addressability
Summary screen using the WHO PF key, and the Storage Address Analysis screen
using the WHERE primary command. The Storage Addressability Summary screen is
explained in “Storage Addressability Summary” on page 14-16. The Storage Address
Analysis is explained in “Storage Address Analysis Screen” on page 14-17.
4. Access other task-related information by using the cursor point-and-shoot feature as
follows:
– Press Enter at the TCA field to display the TCA Interpreted screen.
– Press Enter at the Tran field to display the PCT Detail screen.
– Press Enter at the Program field to display the PPT Detail screen.
Program Change Summary Screen
The Program Change Summary screen, shown in Figure 14-22, displays a listing of CICS
load modules for the abending region in most recently changed order. Any modules that
have changed and have been used in this execution of CICS are listed. Use the cursor
point-and-shoot feature and press Enter at the Module field to display the PPT Detail
screen. Besides accessing the Program Change Summary screen using the cursor pointand-shoot feature and pressing Enter on the Diagnostic Summary, you can access this
screen by entering CHANGES as a fast-path command on any Abend-AID for CICS
screen.
Notes:
1. The region dump interface must be started to produce a Program Change Summary.
Refer to Appendix A, “Supplied Transaction” for information about starting the
region dump interface.
2. Capturing the program change summary information adds a small amount of
overhead to the dump capture process. Usually this amount is insignificant, but if
you see any performance degradation at dump capture time, you can turn off the
region dump interface while still leaving the transaction dump interface active.
14-16
Abend-AID for CICS User’s Guide
Figure 14-22. Program Change Summary
Abend-AID ----------- Program Change Summary ----------- Row 000001 of 000042
COMMAND ===>
SCROLL ===> PAGE

Date of
Date of
Last Zap Last Link
Module
Load Library
******** ********
******** *******************************************
15FEB2004
C21TCVT1 MP.ALPHA.FX.LOAD2.FIX
09FEB2004
CCATCUS2 MP.ALPHA.FX.LOAD2
09FEB2004
C21SAAON MP.ALPHA.FX.LOAD2
09FEB2004
C21SAA2N MP.ALPHA.FX.LOAD2
09FEB2004
C21SDCTL MP.ALPHA.FX.LOAD2
09FEB2004
C21SEXIT MP.ALPHA.FX.LOAD2
09FEB2004
C21SR327 MP.ALPHA.FX.LOAD2
03FEB2004
ERWLFD10 CV.R10.ERW.LOAD
03FEB2004
ERWLFD99 CV.R10.ERW.LOAD
25JAN2004
DFHDMP
CICS212.LOADLIB
25JAN2004
DFHPUP
CICS212.LOADLIB
25JAN2004
DFHQRY
CICS212.LOADLIB
25JAN2004
DFHZCQ
CICS212.LOADLIB
25JAN2004
DFHZNAC
CICS212.LOADLIB
20JAN2004
DFHEIQDS CICS212.LOADLIB
20JAN2004
DFHEIQSP CICS212.LOADLIB
20JAN2004
DFHEIQSX CICS212.LOADLIB
20JAN2004
DFHEMTD
CICS212.LOADLIB
Storage Addressability Summary
The Storage Addressability Summary screen, shown in Figure 14-23 on page 14-16,
displays a list of items found to have addressability to the address specified when using
the WHO command. This screen displays storage areas that match a specified storage area
when using the MATCH command. The Storage Addressability Summary screen is
composed of two areas. The first area is a hexadecimal display of the area at the address
requested for addressability analysis. The first area is not scrollable. The second area is a
list of items that had addressability to the requested address. The second area is
scrollable. Access the Storage Addressability Summary from a specific storage address or
symbol using the WHO or MATCH primary command. To display detailed information
about any task listed in the WHO field, position the cursor on the task entry in the WHO
field and press Enter.
Figure 14-23. Storage Addressability Summary
Abend-AID ------- Storage Addressability Summary ------- Row 000001 of 000001
COMMAND ===>
SCROLL ===> PAGE 

Area:
0025FD84
0025FD84 +00000000 00000000 00000000 00000000 00000000 *................*
0025FD94 +00000010 00000000 00000000 00000000 00000000 *................*
0025FDA4 +00000020 00000000 00000000 00000000 00000000 *................*
0025FDB4 +00000030 00000000 00000000 00000000 00000000 *................* 

Who
Address
Occurrences Description
****************
******** *********** ************************
TCB00009
007A03E0
5 MVS TASK CONTROL BLOCK
****************************** BOTTOM OF DATA ****************************** 










To display the addressability detail, press ENTER on the who field
Analyzing CICS Region Dumps
14-17
Storage Address Analysis Screen
The Storage Address Analysis screen, shown in Figure 14-24, displays a list of storage
areas and control blocks that contain the address or symbol specified in the WHERE
command. The Storage Address Analysis screen is composed of two areas. The first area is
a hexadecimal display of the area at the address requested for address analysis. The first
area is not scrollable. The second area is a list of items that contain the requested address.
The second area is scrollable. Access the Storage Address Analysis screen from a specific
storage address or symbol using the WHERE primary command.
Figure 14-24. Storage Address Analysis
Abend-AID ---------- Storage Address Analysis ---------- Row 000001 of 000003
COMMAND ===>
SCROLL ===> PAGE 

Area..... 00264D88
00264D88 +00000000 00264D88 00264D88 00269008 002D1000 *..(h..(h........*
00264D98 +00000010 00000000 094B5710 094AD5E4 000061A8 *.........¢NU../y*
00264DA8 +00000020 094015E0 002D6408 09CC60C4 094B5958 *. .\......-D....*
00264DB8 +00000030 00264010 8003BBA0 802D657A 00000028 *.. ."..."..:....* 


Storage is located in the following areas: 

Name
Description
Address
Offset
Length
******** ************************************** ******** ******** ********
UDSA
CICS STORAGE AREA
0023A000 0002AD88 00100000
XMB
CICS SUBPOOL PAGE
00264000 00000D88 00001000
XMB00914 TASK STORAGE ALLOCATED - USER_BELOW
00264D70 00000018 00000270
****************************** BOTTOM OF DATA ****************************** 
14-18
Abend-AID for CICS User’s Guide
15-1
Chapter 15.
Analyzing SVC Dumps
Chap 15
The term ‘SVC dump’ refers to the following types of standard IBM machine readable
dumps supported by Abend-AID for CICS:
• Dumps taken using the SDUMP or SDUMPX macro instruction
• Console dumps taken using the MVS DUMP system command
• Dumps taken as the result of a SLIP trap with the ACTION=SVCD parameter
specified
• SYSMDUMPs taken as a result of a program ABEND in a jobstep containing a
SYSMDUMP DD statement
• Dumps taken using the IEATDUMP macro instruction
This section describes how to analyze SVC dumps using the SVC Dump Diagnostic
Summary. Because the summary provides direct access to much of the information
needed for diagnosing the dump, begin analysis using this screen. Also described are the
following screens that are accessible from the SVC Dump Diagnostic Summary. They
provide additional information about the region dump:
• Memory Display (for Entry Point and Translation Except)
• PSW Analysis
• Storage Disassembly
• Dump Header Record
• System Diagnostic Work Area
• Task Control Block
• RTM2 Work Area
Note: By default, CICS diagnostic information is displayed when you select a CICS SVC
dump that has been analyzed by Abend-AID for CICS. See Chapter 14,
“Analyzing CICS Region Dumps” for more information. However, you can also
access SVC dump information for CICS SVC dumps.
Online help is available for any Abend-AID for CICS screen, field, system message, or
command.
SVC Dump Diagnostic Summary Screen
The SVC Dump Diagnostic Summary screen displays information relating to the
abending job. This screen consists of two pages Figure 15-1 shows the first page of a SVC
Dump Diagnostic Summary screen for a SVC dump.
15-2
Abend-AID for CICS User’s Guide
Figure 15-1. SVC Dump Diagnostic Summary, Page1
Abend-AID --------------- SVC Diagnostic Summary ------- Row 000001 of 000037 
COMMAND ===>
SCROLL ===> PAGE 

COMPUWARE SERVER DUMP: SERVER=AACICS03 CODE=S0C4
REPORT BEING VIEWED

00031830 BY AAUSER2


Dump Type............ SVC Dump
Active Load Module... MFDMDDTS

Completion code...... S0C4
Entry point.......... 37AE2EF8

Reason code.......... 00000011
Module Length........ 00001108

Translation Except... 394DE000

Breaking-Event-Addr.. 00000000_37AE3B14

PSW.................. 078D2000 B7AE3B20
ILC: 04 INTC: 0011
ASID: 0063


Address
Offset
Object Code
Mnemonic and Operands

37AE3B20 00000C28
9580 4000
CLI
0(R4),X'80'


GPR 0
GPR 1
GPR 2
GPR 3

00000000_00000001 00000000_394B6FD8 00000000_8000879E 00000000_394B6FD8

GPR 4
GPR 5
GPR 6
GPR 7

00000000_394DE000 00000000_394DE000 00000000_3794D180 00000000_38B5DF00

GPR 8
GPR 9
GPR 10
GPR 11

00000000_0000C000 00000000_00066110 00000000_37AE3B08 00000000_B7AE3168

GPR 12
GPR 13
GPR 14
GPR 15

00000000_B7AE2EF8 00000000_37938618 00000000_B7AE308E 00000000_00000000

Figure 15-2 shows the second page.
Figure 15-2. SVC Dump Diagnostic Summary, Page2
Abend-AID --------------- SVC Diagnostic Summary ------- Row 000022 of 000037 
COMMAND ===>
SCROLL ===> PAGE 

AR 0
AR 1
AR 2
AR 3
AR 4
AR 5
AR 6
AR 7

00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000

AR 8
AR 9
AR 10
AR 11
AR 12
AR 13
AR 14
AR 15

00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000


Additional Information:

Job Name............. AACICSAB
Date of abend........ 22MAY2015

Step Name............ AAV11R03
Time of abend........ 13:02:41

Procedure Name....... N/A


SDWA address......... 020F6708
Dump Header Record... DMPH

TCB requesting dump.. 008A4E00
TCB Summary.......... TCBS

RTM2 Work Area....... 7F51BD60
Storage Analysis..... MVSS

z/Arch Extensions.... ARCH







To access the SVC Dump Diagnostic Summary screen for:
• Non-CICS SVC dump: Issue the S line command on the Abend-AID Directory next to
the appropriate entry. If you have already selected the dump and need to return to
this screen, use the DIAG fast-path command or select the Diagnostic Summary
option from the Primary Options menu.
• CICS SVC dump: Issue the SVCD fast-path command on the Diagnostic Summary
screen (Figure 14-1 on page 14-2) or select the z/OS SVC Dump Analysis option from
the Primary Option menu.
Analyzing SVC Dumps
15-3
To analyze the selected SVC dump, do the following:
1. Note information about the region dump from the fields displayed on the SVC Dump
Diagnostic Summery screen. Information reported for each dump includes the
following:
First Screen
–
–
–
–
–
–
–
–
–
–
–
–
–
Dump Type
Completion code
Reason code
Translation Exception
Breaking Event Address Register (BEAR)
PSW
Active Load Module
Entry Point
Module Length
Address
Offset
Object Code
Mnemonic and Operands
Second Screen
–
–
–
–
–
–
–
–
–
–
–
–
Job Name
Step Name
Procedure Name
Date of abend
Time of abend
Dump Header Record
SDWA address
TCB requesting dump
TCB summary
RTM2 Work Area
MVS storage analysis
z/Architecture extensions
2. Use the cursor point-and-shoot feature to access additional diagnostic information
specific to the abend:
– Press Enter at the Translation Except field, the Breaking-Event-Addr field, the
Entry point field, or any of the GRP fields to view the Memory Display screen
which is explained on page 15-4.
– Press Enter at the first word of the PSW field to view the PSW Analysis screen.
This field contains the Program Status Word at the time of the interrupt. See
Figure 15-4 on page 15-6.
– Press Enter at the Address field or the second word of the PSW field to view the
Storage Disassembly screen. See Figure 15-5 on page 15-7.
– Press Enter at the Dump Header Record field to view the Dump Header Record
screen. See Figure 15-6 on page 15-8.
– Press Enter at the SDWA address field to view the System Diagnostic Work Area
screen. See Figure 15-11 on page 15-11.
– Press Enter at the TCB requesting dump field to view the Task Control Block
screen. See Figure 15-12 on page 15-12.
– Press Enter at the TCB Summary field to view the TCB Summary screen. See
Figure 17-14 on page 17-11.
– Press Enter at the RTM2 Work Area field to view the RTM2 Work Area screen. See
Figure 15-13 on page 15-12.
– Press Enter at the Storage Analysis field to access the MVS Storage Analysis menu.
See Figure 17-2 on page 17-2.
15-4
Abend-AID for CICS User’s Guide
– Press Enter at the z/ARCH Extensions field to access the Optional z/Architecture
Features screen. Figure 9-14 on page 9-12.
Memory Display Screen
This screen displays the requested storage via address, symbol name, or table entry. For
complete details about the Memory Display screen, refer to the online help.
To access the Memory Displays screen, press Enter at the Translation Except field, the
Entry point field, or any of the GRP fields on the SVC Dump Diagnostic Summary
screen.
Figure 15-3. Memory Display Screen for Translation Exception
Abend-AID ------------------- Memory Display -------------------------------- 
COMMAND ===>
SCROLL ===> PAGE 

Clip Prev Next Lock

Start Addr: 37AE3B14
Comment:

37AE3B14 area EPVT
sp 251 key 8 ASID 0063
EBCDIC


Address
Offset
Word 1
Word 2
Word 3
Word 4
Storage

37AE3B14 +00000000 4770A018 92FFD165 47F0A056 95804000 *
k J 0 n" .*

37AE3B24 +00000010 4780A028 92FFD165 47F0A056 BF4F4004 * " k J 0
| *

37AE3B34 +00000020 4770A038 9214D165 47F0A056 95804000 *
k J 0 n" .*

37AE3B44 +00000030 4780A048 92FFD165 47F0A056 5040D150 * " k J 0 & J&*

37AE3B54 +00000040 9200D165 181445B0 C28E58B0 D09C07FB *k.J
B
}
*

37AE3B64 +00000050 00000000 90ABD0A0 5830D0D8 4510A018 *.... }
}Q
*

37AE3B74 +00000060 C0098000 37AE3230 37AE3238 0A38BF4F *{ ".
|*

37AE3B84 +00000070 30044770 A02A92FF D16547F0 A04ED503 *
k J 0 +N *

37AE3B94 +00000080 400CD158 4780A044 BF4F4004 4770A02A * J "
|
*

37AE3BA4 +00000090 920CD165 47F0A04E D2004001 D1679200 *k J 0 +K. J k.*

37AE3BB4 +000000A0 D1650700 4510A060 C0090000 37AE3230 *J .
-{ ..
*

37AE3BC4 +000000B0 37AE3238 0A3058B0 D0A407FB 90ABD0A8 *
}u
}y*

37AE3BD4 +000000C0 5830D0D8 4510A018 C0090000 37AE3230 * }Q
{ ..
*

37AE3BE4 +000000D0 37AE3238 0A38BF4F 30044770 A02A92FF *
|
k *

37AE3BF4 +000000E0 D16547F0 A090D503 400CD158 4780A044 *J 0 N
J " *

37AE3C04 +000000F0 BF4F4004 4770A02A 920CD165 47F0A090 * |
k J 0 * 
Scrollable Information
UP (PF7) and DOWN (PF8) commands scroll information on the Memory Display, but
LEFT (PF10) and RIGHT (PF11) commands are not applicable. The output lines that you
can scroll consist of the following fields:
Address
Address of the 16 bytes displayed on the line.
Note: Wider terminals such as IBM’s 3278 Model 5 display 32 bytes on
the line.
Word1
Bytes 0 – 3 of the 16 (or 32) bytes.
Word2
Bytes 4 – 7 of the 16 (or 32) bytes.
Word3
Bytes 8 – B of the 16 (or 32) bytes.
Word4
Bytes C – F of the 16 (or 32) bytes.
storage
Interpreted display of the 16 (or 32) bytes.
Analyzing SVC Dumps
15-5
Primary Commands
The following primary commands can be used on the Memory Display:
+offset
-offset
@offset
CLIP FIRST
CLIP LAST
CLIP LOCK
CLIP NEXT
CLIP PREV
CLR
COMM
DECODE
FIND
MAPD
PCLP
RESTORE
RESET
SAVE
SMAP
ADSTCK
UNSTCK
For a description of these commands, refer to the online help or see Part 5, “Commands”.
Paperclip Function
The paperclip function provides an automatic and convenient method for you to keep
track of your navigation through the memory display. Each time the displacement shown
on the memory display equals zero, an entry is automatically added to the bottom of a
table of addresses known as the current paperclip table.
A current paperclip table is maintained for each user accessing a given dump. Your
current paperclip table can be accessed using the PCLP primary command.
You can easily reaccess any paperclipped address using either of the clip tab selectable
fields:
• PREV - Display the previous paperclip entry.
• NEXT - Display the next paperclip entry.
Note:
For more information see the online help or “CLIP” on page 21-13
Chain Command
The Chain command runs a control block chain and creates a list of chained memory
entries. Each entry’s address is added to your current paperclip table. The comments
associated with the paperclip entries created reflect the entry number of the chain
element with the user-specified chain prefix as the chain name. When the chain
command is finished, you are placed on the first paperclip entry for the first entry of the
chain. See the online help or “CHAIN” on page 21-11 for more details.
PSW Analysis Screen
To access the PSW Analysis screen (Figure 15-4) press Enter at the first word of the PSW
field on the SVC Dump Diagnostic Summary screen.
The program-status word (PSW) includes the instruction address, condition code, and
other information used to control instruction sequencing and to hold and indicate much
of the status of the CPU in relation to the program currently being executed.
The Instruction Address is the adjusted next sequential instruction (NSI). If the
instruction is a 31-bit address, the high-order bit will be turned off. If the instruction is a
24-bit address, the high-order byte will be set to low values.
Additional control and status information is contained in control registers and
permanently assigned storage locations. The active or controlling PSW is called the
current PSW. The current PSW in the CPU contains information required for the
execution of the currently active program. Bits 0-7 of the PSW are collectively referred to
as the system mask.
15-6
Abend-AID for CICS User’s Guide
The full z/Architecture PSW is 128 bits in length. However, in many z/OS control blocks
and in the LOAD PSW instruction, the PSW is 64 bits in the format of an ESA/390 PSW
except that bit 31 (the z/Architecture extended- addressing-mode bit) may be one. The
remainder of this discussion refers to the ESA/390 format of the PSW.
The status of the CPU can be changed by loading a new PSW or part of a PSW. Control is
switched during an interruption of the CPU by storing the current PSW, to preserve the
status of the CPU, and then loading a new PSW. Execution of LOAD PSW, or the
successful conclusion of the initial program-loading sequence, introduces a new PSW.
The instruction address is updated by sequential instruction execution and replaced by
successful branches. Other instructions are provided which operate on a portion of the
PSW. A new or modified PSW becomes active (that is, the information introduced into
the current PSW assumes control over the CPU) when the interruption or the execution
of an instruction that changes the PSW is completed. The interruption for PER associated
with an instruction that changes the PSW occurs under control of the PER mask that is
effective at the beginning of the operation.
The CPU has an interruption capability, which permits the CPU to switch rapidly to
another program in response to exceptional conditions and external stimuli. When an
interruption occurs, the CPU places the current PSW in an assigned location, for the
particular class of interruption. The CPU fetches a new PSW from a second assigned
storage location. The new PSW determines the next program to be executed. When it has
finished processing the interruption, the interrupting program can reload the old PSW,
making it again the current PSW, so that the interrupted program can continue.
There are six (6) classes of interruptions: external, I/O, machine check, program, restart,
and supervisor call. Each class has a distinct pair of old-PSW, and new-PSW locations
permanently assigned in real storage. These storage locations can be found in the
Prefixed Save Area (PSA).
Figure 15-4. PSW Analysis Screen
Abend-AID ---------------- PSW Analysis ----------------------------------- 
COMMAND ===>


PSW................... 078D0000 B81225AC Addressing Mode............ 31-BIT 
Instruction Address... 381225AC


Program-Event Recording Mask..... OFF
Program Masks:

Dynamic Address Translation Mode. ON
Fixed-Point Overflow....... OFF

Input/Output Mask................ ON
Decimal Overflow........... OFF

External Mask.................... ON
Exponent Underflow......... OFF

PSW Key.......................... 8
Significance............... OFF

Machine Check Mask............... ON

Wait State....................... OFF

Condition Code................... 0

Address Space Control............ PRIMARY-SPACE

State............................ PROBLEM









For additional information, see the online help.
Storage Disassembly Screen
This screen displays storage in disassembled format. You can use the RESET command to
reposition the storage disassembly screen back to the starting address after scrolling
forwards or backwards.
Analyzing SVC Dumps
15-7
Access this screen by pressing Enter at the following fields:
• Instruction Address field on the PSW Analysis screen
• Address field or the second word of the PSW field on SVC Dump Diagnostic Summary
screen.
Figure 15-5. Storage Disassembly Screen
Abend-AID ---------------- Storage Disassembly ----------------------------- 
COMMAND ===>
SCROLL ===> PAGE 

Address
Offset
Object Code
Mnemonic and Operands

381225AC 00000000 58A0 CAB4
L
R10,2740(,R12)

381225B0 00000004 05BA
BALR R11,R10

381225B2 00000006 58A0 D078
L
R10,120(,R13)

381225B6 0000000A 47F0 A03A
B
58(,R10)

381225BA 0000000E 5810 D450
L
R1,1104(,R13)

381225BE 00000012 9120 D616
TM
1558(R13),X'20'

381225C2 00000016 47E0 A1C6
BNO
454(,R10)

381225C6 0000001A 9602 1001
OI
1(R1),X'02'

381225CA 0000001E 47F0 A1D2
B
466(,R10)

381225CE 00000022 9102 1001
TM
1(R1),X'02'

381225D2 00000026 47E0 A1D2
BNO
466(,R10)

381225D6 0000002A 94FD 1001
NI
1(R1),X'FD'

381225DA 0000002E 41F0 1080
LA
R15,128(,R1)

381225DE 00000032 D201 F05D D5C8
MVC
93(2,R15),1480(R13)

381225E4 00000038 D700 F000 F000
XC
0(1,R15),0(R15)

381225EA 0000003E 9110 D616
TM
1558(R13),X'10'

381225EE 00000042 47E0 A1EE
BNO
494(,R10)

381225F2 00000046 9280 F000
MVI
0(R15),X'80'

381225F6 0000004A 9104 D616
TM
1558(R13),X'04'

Dump Header Record Screen
The Dump Header Record screen (Figure 15-6) displays header record information from
the currently selected dump. It contains valuable information about the dump and the
error that caused the dump.
Access this screen in one of the following ways:
• Press Enter at the Dump Header Record field on the SVC Dump Diagnostic Summary
screen.
• Issue the DMPHDR fast-path command on the Diagnostic Summary screen or SVC
Dump Diagnostic Summary screen.
• Select the Dump Header Record option on the z/OS SVC Dump Analysis menu.
15-8
Abend-AID for CICS User’s Guide
Figure 15-6. Dump Header Record Screen
Abend-AID ---------------- Dump Header Record ----------------------------COMMAND ===>
COMPUWARE SERVER DUMP: SERVER=AACICS03 CODE=S0C1
00031780 BY AAUSER7

Dump type.............................
Name of program requesting dump.......
Date of dump..........................
Time of dump..........................
Processor model.......................
Processor version.....................
Processor serial number...............
Processor address.....................
System name...........................
Product name..........................
Product version.......................
Offset of SDUMP/SYSMDUMP common.......
Offset of SLIP section................
Offset of SYSMDUMP section............
Offset of SDWA........................
REPORT BEING VIEWED
SVC Dump
SVCDUMP
08FEB2010
13:08:18.641541
2086
00
015D0A
0002
CW01
z/OS
01.11.00
01AC
0000
0000
09DC























Use the cursor point-and-shoot feature and press Enter at the 01AC entry in the Offset of
SDUMP/SYSMDUMP common field to display the SDUMP/SYSMDUMP Common Section
screen (Figure 15-7).
SDUMP/SYSDUMP Common Section Screen
The SDUMP/SYSMDUMP Common Section screen, shown in Figure 15-7, displays
information from the SDUMP/SYSMDUMP common section of the header record from
the currently selected dump. Access this screen from the “Dump Header Record Screen”,
as described above.
Figure 15-7. SDUMP/SYSMDUMP Common Section Screen
Compuware Abend-AID - SDUMP/SYSMDUMP Common Section ------------------------- 
COMMAND ===>


Virtual address of CVT....... 00FD78C8

Original Dump data set....... DUMP.MVSPG.D141204.T092002.AAFXPMVS.S00003

CML ASID ASCB address........ 00000000

Primary ASID................. 0070

Secondary ASID............... 0070

Home ASID.................... 0070

SDWA owner ASID.............. 0070

SDWA address................. 02C0D9E8

Trace Table Control Header... 7FF6F000

Offset to SDUMP PLIST........ 05B4

TCB of task requesting dump.. 009C1AC0

Caller's PSW before SDUMP.... 070C1000 A1808AFC

Dump ID...................... 003

Start of common storage...... 00A00000

End of common storage........ 21800000

Home ASID jobname............ AAFXPMVS


To display registers upon entering SDUMP, select REGS

Use the cursor point-and-shoot feature and press Enter at REGS field to display the
Registers Upon Entry to Dump screen (Figure 15-8 on page 15-9).
Analyzing SVC Dumps
15-9
Registers Upon Entry to Dump Screen
The Registers Upon Entry to Dump screen, shown in Figure 15-8, displays the contents of
the general purpose registers and access registers on entry to the dump.
Figure 15-8. Registers Upon Entry to Dump Screen
Compuware Abend-AID -- Registers Upon Entry to Dump ------------------------- 
COMMAND ===>


GPR 0
GPR 1
GPR 2
GPR 3

00000000_2352E770 00000000_2352E6F0 00000000_2352E770 00000000_00000000

GPR 4
GPR 5
GPR 6
GPR 7

00000000_0228C000 00000000_0006C158 00000000_00000000 00000000_00000000

GPR 8
GPR 9
GPR 10
GPR 11

00000000_0000C000 00000000_0006C110 00000000_218088A8 00000000_A18086FC

GPR 12
GPR 13
GPR 14
GPR 15

00000000_218083E8 00000000_2352E678 00000000_A180898C 00000000_00000000


AR 0
AR 1
AR 2
AR 3
AR 4
AR 5
AR 6
AR 7

00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000

AR 8
AR 9
AR 10
AR 11
AR 12
AR 13
AR 14
AR 15

00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000


To display Control and Floating Point registers, select CR/FPR




Use the cursor point-and-shoot feature and press Enter at CR/FPR field to display the
Registers Upon Entry to Dump (Control and Floating Point Registers) screen, as shown in
Figure 15-9 on page 15-10.
Registers Upon Entry to Dump (Control and Floating
Point Registers) Screen
The Registers Upon Entry to Dump (Control and Floating Point Registers) screen, as
shown in “SDUMP/SYSDUMP Common Section Screen” on page 15-8, displays the
contents of the control registers and floating point registers on entry to the dump. Access
this screen from the Registers Upon Entry to Dump screen, as described in “Registers
Upon Entry to Dump Screen” above.
15-10
Abend-AID for CICS User’s Guide
Figure 15-9. Register Upon Entry to Dump (Control and Floating Point Registers) Screen
Compuware Abend-AID -- Registers Upon Entry to Dump ------------------------- 
COMMAND ===>


CR 0
CR 1
CR 2
CR 3

00800002_DF88EE70 0000000D_441B0007 00000000_092BAA00 00000001_80C00070

CR 4
CR 5
CR 6
CR 7

00000001_000E0070 00000000_0F64FC00 00000000_FC000000 0000000D_441B0007

CR 8
CR 9
CR 10
CR 11

00000000_00000000 00000000_00000000 00000000_00000000 00000000_00000000

CR 12
CR 13
CR 14
CR 15

00000007_7FFE315F 0000000D_441B0007 00000000_DF88F64B 00000000_7F61E4B0


To display Interpreted Floating-Point Registers, select Interpretation


Floating Point Control Register...... 00000000

FPR 0
FPR 1
FPR 2
FPR 3

5C800000_00000054 00000000_00000000 4E802717_51074200 00000000_00000000

FPR 4
FPR 5
FPR 6
FPR 7

5D080000_00000000 00000000_00000000 00000000_00000000 00000000_00000000

FPR 8
FPR 9
FPR 10
FPR 11

00000000_00000000 00000000_00000000 00000000_00000000 00000000_00000000

FPR 12
FPR 13
FPR 14
FPR 15

00000000_00000000 00000000_00000000 00000000_00000000 00000000_00000000

Use the cursor point-and-shoot feature and press Enter at the Interpretation field to
display the Floating Point Interpretation screen (Figure 15-10).
Floating Point Interpretation Screen
The Floating Point Interpretation screen, shown in Figure 15-10, displays the content of
the 16 floating point registers, along with the value they represent. Access this screen
from the Registers Upon Entry to Dump (Control and Floating Point Registers) screen as
described above. Alternatively, enter the INTFLOAT fast-path command. This screen
shows the interpretation based on one of the following types and formats:
• Decimal Floating Point long format
• Binary Floating Point long format
• Hexadecimal Floating Point long format
Figure 15-10. Floating Point Interpretation Screen
Abend-AID ----------- Floating Point Interpretation ---- Row 000001 of 000008 
COMMAND ===>
SCROLL ===> PAGE 

Interpretation based on Short Decimal Floating-Point

Change to Decimal
Short
Long
Extended

Change to Binary
Short
Long
Extended

Change to Hexadecimal Short
Long
Extended


FPR 0 content: 00000000_00000000
FPR 8: 7F800000_00000000

value:
ZERO
SNAN


FPR 1 content: 3F800000_00000000
FPR 9: 00000000_00000000

value: +7.x10~24
ZERO


FPR 2 content: BF800000_00000000
FPR10: 7F800000_00000000

value: -7.x10~24
SNAN


FPR 3 content: 4640E400_00000000
FPR11: 00000000_00000000

value: +1.039x10~68
ZERO


FPR 4 content: C640E400_00000000
FPR12: 7F800000_00000000

value: -1.039x10~68
SNAN


Analyzing SVC Dumps
15-11
In the long format the entire 64 bits of the register represent a floating point number.
Use the cursor point-and-shoot feature and press Enter at the Short, Long, or Extended
fields to display the alternate types and formats. An attempt is made to interpret the
content of all floating point registers based on the requested combination of type (DFP,
BFP, HFP) and format (short, long, extended), but the result is accurate only if the
floating point register was being used in that manner. For example, if a floating point
register is being used in the extended mode, then the wrong interpretation will be shown
if it is displayed in short or long. Similarly, if a floating point register is being used as a
decimal FP, then a binary or Hexadecimal interpretation will not yield the correct result.
It is not possible to determine the type or format by examining the content as most
content is valid for all combinations but just represents a different value in each
combination.
System Diagnostic Work Area Screen
The System Diagnostic Work Area (SDWA) screen displays information from the SDWA.
Addresses displayed on this screen are assumed to be from the address space owning
SDWA. When displaying areas using the HEXD command, the memory displayed will be
from the SDWA owner address space.
To access this screen, press Enter at the SDWA address field on the SVC Dump Diagnostic
Summary screen.
Figure 15-11. System Diagnostic Work Area Screen
Abend-AID ------------ System Diagnostic Work Area ------------------------- 
COMMAND ===>


SDWA Address................. 00162918


ABEND Code................... S0C1

PSW at time of error......... 078D0000 B81225AC

Instruction length........... 02

Interrupt code............... 01

Translation exception address 3907A000

Home ASID.................... 0053

Primary ASID................. 0053

Secondary ASID............... 0053

Error type................... Program Check

Recovery routine type........ ESTAE

Recovery routine address..... 80015590

Address of extension pointers 00162DA8


An enabled RB was in control at the time of the error


To display registers at the time of the error, select ABEND

To display status of the program that established the ESTAE, select RB


Several of the fields on the SDWA screen show the address for that field and the rest are
self-explanatory. Use the cursor point-and-shoot feature and press Enter at the desired
address field to access the Memory Display screen.
Additional text appears at the bottom of the screen that will let you display registers at
the time of the error or display the status of the program that established the ESTAE.
Task Control Block Screen
The Task Control Block Screen (TCB) displays the information from the TCB.
15-12
Abend-AID for CICS User’s Guide
Figure 15-12. Task Control Block Screen (TCB)
Abend-AID ----------------- Task Control Block ----------------------------- 
COMMAND ===>


TCB Address....... 008A19C0


Request Block Address....... 008FD850 SPIE/EPIE Control Area..... 00000000

DEB Queue................... 00000000 TIOT Address............... 008AFFE8

System Completion Code...... 940C1000 Nondispatchability Flag4... 00

Task Dispatching Priority... 255
Nondispatchability Flag5... 00

Job Pack Area Queue Area.... 00000000 Joblib DCB Address......... 008A1B18

Queue of TCB's in Addr Space 008A1828 First Problem Save Area.... 00066248

Jobstep TCB................. 008C7C48 Previous Attached TCB...... 008A1B58

Original TCB................ 008C7C48 Last Attached TCB.......... 00000000

Current STAE Control Block.. 0087BD80 STAE Routine Flag.......... 00

Secondary Flags BYTE 2...... 00
Level number of TCB........ JBB2133

Address of Common Extension. 008A1B18 Job Step Control Block..... 008F91EC

Timing Control Table........ 00881200 Secondary Task Control Blk. 7F743A68

Subsystem Facility Cntl Blk. 00000000 ACEE for Task.............. 00000000


General Register Save Area
GRSA




Many of the fields on the TCB screen show the address for that field and the others are
self-explanatory. Use the cursor point-and-shoot feature and press Enter at the desired
address field to access the Memory Display screen.
RTM2 Work Area Screen
The RTM2 Work Area screen describes errors and control flags for sub-functions of task or
memory termination within RTM2.
Figure 15-13. RTM2 Work Area Screen
Abend-AID ------------------- RTM2 Work Area ------------------------------- 
COMMAND ===>


RTM2WA Address.............. 7F5BEDE0 CVT Address................. 00FD4DB8 
Previous RTM2WA............. 00000000 Current TCB Address......... 008A19C0 
User's SDWA Address......... 00162918 Current RB Address.......... 008FD660 
Flags....................... 84
Current ASCB Address........ 00F7AA00 
Completion Code............. 0C1000
Abending Program Name....... MFDMDSRV 
Translation Except Address.. 3907A000 Abending Program EPA........ 38120F00 
PSW at Time of Error........ 078D0000 B81225AC

Breaking-Event-Address...... 00000000_37AE3B14


To view the Access Registers at the time of the ABEND select ARs


GPR 0
GPR 1
GPR 2
GPR 3

00000000_00000000 00000000_00162E80 00000000_38123EF6 00000000_36E3E118

GPR 4
GPR 5
GPR 6
GPR 7

00000000_38125388 00000000_36E4A3F0 00000000_36E370A8 00000000_38124B08

GPR 8
GPR 9
GPR 10
GPR 11

00000000_0000C000 00000000_000F4000 00000000_38122408 00000000_B8122596

GPR 12
GPR 13
GPR 14
GPR 15

00000000_B8120F00 00000000_381248C0 00000000_B8123E58 FFFFFFFF_00000000


Many of the fields on the TCB screen show the address for that field and the others are
self-explanatory. Use the cursor point-and-shoot feature and press Enter at the desired
address field to access the Memory Display screen.
16-1
Chapter 16.
Analyzing Storage Violations
Chap 16
This chapter describes possible approaches for using Abend-AID for CICS to analyze
storage violations. A CICS Transaction Server for OS/390 version 1 storage violation
example is provided.
Programming errors that commonly cause storage violations include the following:
• A failure to reassemble or recompile programs after redefining a common storage
area. This mistake can result in issuing a GETMAIN for insufficient storage.
• Runaway subscripts caused by tables with no size limitations.
• Writing data to an area after a FREEMAIN has been issued.
• Posting an ECB for a canceled task. With this type of error, a transaction attempts to
hand-post an ECB after a task waiting on it has been canceled. As a result, data
belonging to an unrelated activity becomes corrupted.
The approach described in this chapter for analyzing storage violations is based on a
specific storage violation dump. To generate this dump, install and invoke the supplied
CICS transaction ERWV described in the Abend-AID Installation and Customization Guide.
After generating the dump, use the Dataset Import screen to import it. However, if you
installed Abend-AID for CICS to import dumps automatically, this final step is not
necessary. For information about importing dumps, refer to “SVC Dump Import Screen”
on page 13-3.
Note:
Because of unique CICS system activity, the dump information in your AbendAID for CICS screens will differ from the information shown in this chapter. In
particular, addresses may vary.
Storage Violation Overview
CICS detects storage violations when one of the following becomes corrupted:
• The initial or trailing SAA of a TIOA
• The leading or trailing storage check zone of a user-task storage element.
The approach to solving a storage violation consists of three major steps:
1. Locate the corrupted area of storage and identify the owner of the storage.
To locate the address of the storage, display the Diagnostic Summary screen. The text
that begins the screen’s Analysis section states the address at which Abend-AID for
CICS detected the storage violation. Use the HEXD command to display the affected
storage. You can then examine the corrupted storage to determine whether the data
suggests which transaction, program, or routine caused the error. For information
about the Diagnostic Summary, refer to Chapter 14, “Analyzing CICS Region
Dumps”. For specifics about the HEXD command, refer to “HEXD” on page 21-42.
2. Determine the error that CICS encountered.
CICS detects storage violations by checking the SAA or the storage check zones when
it receives a FREEMAIN request for an element of storage. When a TIOA becomes
corrupted, CICS also checks the chains when it issues a FREEMAIN request for the
16-2
Abend-AID for CICS User’s Guide
storage belonging to a TCTTE after the last output has taken place. In the case of user
task storage, CICS also checks the chains when a FREEMAIN request for the storage
belonging to a TCA is issued at the end of the task. Therefore, CICS detects the
storage violation at the time it occurs, not when you check the SAA chain or the
storage check zones.
When CICS detects a storage violation, it makes an exception trace entry in the
internal trace table, issues message DFHSM0102, and takes a CICS system dump. In
addition, CICS abends the transaction (if running) whose storage has been violated.
Using the CICS Trace Table function, you can view the exception trace entry to
determine the error that CICS encountered. The Diagnostic Summary also has a
description of the error that occurred.
3. Determine who corrupted the area of storage.
View the data overlaying the SAA or storage check zone to determine if its nature
suggests which program put it there. You can view the overlaying data by examining
the exception trace entry in the internal trace table, or by examining the violated
storage. If task storage has been corrupted, Abend-AID for CICS uses the storage
control data areas to rebuild the chains. Because these areas are not part of the task
subpool, they are less likely to be corrupted. You can view storage control areas on
the Task Subpool Summary Display.
If you are still unable to find the cause of the storage violation, examine the trace
entries in more detail to determine when the storage was last checked and found to
be correct. The code causing the storage violation will have been executing between
the time that trace entry was made and the time the exception trace entry was made.
To get more detailed trace data, you may have to force storage chain checking using
either the CSFE transaction, or the CHKSTSK or CHKSTRM startup override.
Storage violations that CICS does not detect generally affect innocent transactions (those
that did not cause the violation). Such violations are usually more difficult to resolve,
because you often are not aware of them until long after they have occurred. A lengthy
history of system activity is usually required to determine the cause.
Use the following technique to determine the cause of these storage violations:
1. Examine the content of the data overlaying the SAA or storage check zone to see if it
is familiar and suggests who caused the corruption.
2. Examine the trace table to locate an entry showing a GETMAIN or FREEMAIN
addressing the storage area.
3. After you have located the GETMAIN or FREEMAIN entry addressing the storage, find
the ID of the associated transaction by locating the trace entry for TASK ATTACH.
Storage Violation Debugging Example
The following steps provide a suggested approach to solving a CICS Transaction Server
for OS/390 version 1 storage violation using Abend-AID for CICS:
Note:
This approach generally also applies to CICS Transaction Server for z/OS and to
CICS version 4.1
1. The Abend-AID for CICS Diagnostic Summary usually provides the logical starting
point for solving any dump. Choose option 1 from the Abend-AID for CICS Primary
Options Menu, shown in Figure 16-1 on page 16-3, to display the Abend-AID for
CICS Diagnostic Summary screen shown in Figure 16-2 on page 16-3.
Analyzing Storage Violations
16-3
Figure 16-1. Primary Options Menu for CICS Region Dumpsfor CICS
Abend-AID ------------------- Primary Options ------------------------------- 
OPTION ===>


1 DIAG
Diagnostic Summary
6 MVSINFO MVS Information


2 TASKS
Task/Wait Analysis
7 IPCS
IPCS Command Facility


3 TRACE
CICS Trace Listing
8 DOMAINS CICS Domain Analysis


4 CICSINFO CICS Information
9 ZOSSDMP z/OS SVC Dump Analysis


5 CB
Control Blocks/Storage




D DIRECTRY Abend-AID Directory
I IMPORT
Dataset Import


S SUMMARY Fault Summary
U USER
User Control Facility


X EXIT
Exit
N NEWS
Product News
Figure 16-2. Diagnostic Summary
Abend-AID ------------- Diagnostic Summary ------------- Row 000001 of 000032
COMMAND ===>
SCROLL ===> PAGE 

Date... 12FEB2004 Time... 09:54:41
ASID... 0000
Dump Code... SM0102
Title.. CICS DUMP: SYSTEM=H01AC118 CODE=SM0102
I
Category.... STG VIOL 

To display the Diagnostic Summary in abbreviated format select ABBREV 

Description 

This dump ( code SM0102 ) was taken because CICS detected a storage
violation. 

The CICS message associated is: DFHSM0102 H01AC118 A storage violation
(code X’0D11’) has been detected in module DFHSMMF . 

The short symptom string is: PIDS/566540301 LVLS/330 MS/DFHSM0102
RIDS/DFHSMMF PTFS/UN34195 PRCS/00000D11 

Analysis 

A storage violation occurred. CICS detected that the storage at address
0013C690 has an invalid storage zone. The leading storage zone is
E7D4C2F0F0F0F2F7 and the trailing storage zone is FFD4C2F0F0F0F2F7. 

Addressability and matching information are available for the area. 

The current task at the time the dump was taken was 27. 

The CICS trace table has 2 exception entries, and 2 are related to task 27.
The last exception trace entry for task 27 gives the following information: 

00027 1 ME FF45 MEWS *EXC* SYMREC-ERROR 

The CICS Kernel Error Table has no entries. 

There are no CICS enqueues held. 

Unable to determine the number of programs changed in the last 14 days
because the region dump interface was not active at the time the dump was
taken.
Note:
Your screen may contain other entries depending upon the errors found.
The Diagnostic Summary provides a list of errors found within the CICS region
dump. Because this dump was caused by a storage violation, the corrupted storage
16-4
Abend-AID for CICS User’s Guide
address displayed in the Analysis section is a good place to start. The current task
message indicates that task 27 owns the corrupted storage. (Your task number
probably will be different.)
You now have completed the first step in storage violation problem determination:
you have located the storage and identified its owner.
The Diagnostic Summary offers direct access to several other related Abend-AID for
CICS displays. For example, addressability to the corrupted storage can be obtained
by selecting the Addressability field and pressing Enter. Pressing the HEXD PF key
with the cursor positioned on any address displays the contents of the memory at
that address. Because this is a storage violation error, it may help to look at the
corrupted memory first.
2. Press the HEXD PF key with the cursor on the storage address having the invalid
storage zone. This displays the Memory Display, beginning at the corrupted address
(0013C690 in this example). The Memory Display is shown in Figure 16-3.
Figure 16-3. Memory Display

Abend-AID --------------------- Memory Display ------------------------------
COMMAND ===>
SCROLL ===> PAGE

Clip Prev Next Lock 

Start Addr: 0013C690 Comment: ___________________________________ 
0013C690 area PVT
sp 130 key 8 ASID 0053
EBCDIC
Address
0013C690
0013C6A0
0013C6B0
0013C6C0
0013C6D0
0013C6E0
0013C6F0
0013C700
0013C710
0013C720
0013C730
0013C740
0013C750
0013C760
0013C770
Offset
+00000000
+00000010
+00000020
+00000030
+00000040
+00000050
+00000060
+00000070
+00000080
+00000090
+000000A0
+000000B0
+000000C0
+000000D0
+000000E0
Word 1
E7D4C2F0
FFFFFFFF
FFFFFFFF
FFFFFFFF
FFFFFFFF
FFFFFFFF
FFFFFFFF
FFFFFFFF
FFFFFFFF
00000000
00000000
00000000
00000000
00000000
00000000
Word 2
F0F0F2F7
FFFFFFFF
FFFFFFFF
FFFFFFFF
FFFFFFFF
FFFFFFFF
FFFFFFFF
FFFFFFFF
FFFFFFFF
00000000
00000000
00000000
00000000
00000000
00000000
Word 3
FFFFFFFF
FFFFFFFF
FFFFFFFF
FFFFFFFF
FFFFFFFF
FFFFFFFF
FFFFFFFF
FFFFFFFF
FFD4C2F0
00000000
00000000
00000000
00000000
00000000
00000000
Word 4
FFFFFFFF
FFFFFFFF
FFFFFFFF
FFFFFFFF
FFFFFFFF
FFFFFFFF
FFFFFFFF
FFFFFFFF
F0F0F2F7
00000000
00000000
00000000
00000000
00000000
00000000
Storage
*XMB00027........*
*................*
*................*
*................*
*................*
*................*
*................*
*................*
*.........MB00027*
*................*
*................*
*................*
*................*
*................*
*................*
The trailing SAA has been overlaid with X’FF’. Note that although the Analysis
message referred to the beginning storage zone address, it is the trailing zone which
is actually corrupted. You have now determined the error that was encountered by
CICS, the second step in solving a storage violation. At this point, it would be useful
to know who could have addressed the storage and is therefore a candidate for
corrupting the storage. The Abend-AID for CICS WHO command is very useful in this
situation.
3. Enter +8 in the Command field of the Memory Display to position the screen at the
beginning address of the storage (past the first SAA), as shown in Figure 16-4 on page
16-5.
Analyzing Storage Violations
16-5
Figure 16-4. Positioning the screen at the beginning address of the storage

Abend-AID --------------------- Memory Display ------------------------------
COMMAND ===>
SCROLL ===> PAGE 

Clip Prev Next Lock
Start Addr: 0013C690 Comment: 
0013C698 area PVT
sp 130 key 8 ASID 0053
EBCDIC
Address
0013C698
0013C6A8
0013C6B8
0013C6C8
0013C6D8
0013C6E8
0013C6F8
0013C708
0013C718
0013C728
0013C738
0013C748
0013C758
0013C768
0013C778
0013C788
Offset
+00000008
+00000018
+00000028
+00000038
+00000048
+00000058
+00000068
+00000078
+00000088
+00000098
+000000A8
+000000B8
+000000C8
+000000D8
+000000E8
+000000F8
Word 1
FFFFFFFF
FFFFFFFF
FFFFFFFF
FFFFFFFF
FFFFFFFF
FFFFFFFF
FFFFFFFF
FFFFFFFF
FFD4C2F0
00000000
00000000
00000000
00000000
00000000
00000000
00000000
Word 2
FFFFFFFF
FFFFFFFF
FFFFFFFF
FFFFFFFF
FFFFFFFF
FFFFFFFF
FFFFFFFF
FFFFFFFF
F0F0F2F7
00000000
00000000
00000000
00000000
00000000
00000000
00000000
Word 3
FFFFFFFF
FFFFFFFF
FFFFFFFF
FFFFFFFF
FFFFFFFF
FFFFFFFF
FFFFFFFF
FFFFFFFF
00000000
00000000
00000000
00000000
00000000
00000000
00000000
00000000
Word 4
FFFFFFFF
FFFFFFFF
FFFFFFFF
FFFFFFFF
FFFFFFFF
FFFFFFFF
FFFFFFFF
FFFFFFFF
00000000
00000000
00000000
00000000
00000000
00000000
00000000
00000000
Storage
*................*
*................*
*................*
*................*
*................*
*................*
*................*
*................*
*.MB00027........*
*................*
*................*
*................*
*................*
*................*
*................*
*................*
4. Place the cursor on the displayed address (0013C698 in this example), and press the
WHO PF key to display the Storage Addressability Summary, shown in Figure 16-5.
Figure 16-5. Storage Addressability Summary

Abend-AID ------- Storage Addressability Summary ------- Row 000001 of 000002
COMMAND ===>
SCROLL ===> PAGE

Area:
0013C698
0013C698 +00000000 FFFFFFFF FFFFFFFF FFFFFFFF FFFFFFFF *................*
0013C6A8 +00000010 FFFFFFFF FFFFFFFF FFFFFFFF FFFFFFFF *................*
0013C6B8 +00000020 FFFFFFFF FFFFFFFF FFFFFFFF FFFFFFFF *................*
0013C6C8 +00000030 FFFFFFFF FFFFFFFF FFFFFFFF FFFFFFFF *................* 

Who
Address
Occurrences Description
***************** ******** *********** ************************ 
TCA0007.ERWV
00055000
4 CICS TASK CONTROL AREA
KETA0007.ERWV
07D81AD0
3 CICS KERNEL TASK
******************************* BOTTOM OF DATA ********************************
The Storage Addressability Summary identifies a TCA (TCA0007 in this example) and
transaction ERWV as the only task that had addressability to the corrupted storage
(although this task may not be the only one corrupting the storage). It would be
useful to identify the program that transaction ERWV was executing.
5. Place the cursor on the displayed TCA value (TCA0007 in this example) in the WHO
field, and press Enter to display the Addressability Detail shown in Figure 16-6 on
page 16-6.
16-6
Abend-AID for CICS User’s Guide
Figure 16-6. Addressability Detail (TCA)
Abend-AID --------- Addressability Detail - TCA -------- Row 000001 of 000004
COMMAND ===>
SCROLL ===> PAGE
==>
Area:
0013C698
0013C698 +00000000 FFFFFFFF FFFFFFFF FFFFFFFF FFFFFFFF *................*
0013C6A8 +00000010 FFFFFFFF FFFFFFFF FFFFFFFF FFFFFFFF *................*
0013C6B8 +00000020 FFFFFFFF FFFFFFFF FFFFFFFF FFFFFFFF *................*
0013C6C8 +00000030 FFFFFFFF FFFFFFFF FFFFFFFF FFFFFFFF *................* 

Who
TRAN Save Area Address Description
Program Register Contents Disp
******** **** ********* ******** ************* ******** ***
******** ****
TCA0007 ERWV HLLSA000 0013C508 HLL SAVE AREA ERWMSTGV R01
0013C570 +128
R04
0013C698 +000
R07
0013C0C4 +5D4
R08
0013C508 +190
******************************* BOTTOM OF DATA ********************************
The Addressability Detail identifies program ERWMSTGV as the program that had
addressability to the overlaid storage. This means that program ERWMSTGV owns
the save area containing the registers that had addressability to the storage.
It is also helpful to know the task number associated with this transaction and
program. The Abend-AID for CICS TCA Interpreted screen provides this information.
6. Place the cursor on the displayed TCA value (TCA0007 in this example) and press
Enter. The user TCA Interpreted screen shown in Figure 16-7 is displayed, identifying
the associated task (in this example, task 27). This is the same task identified by the
Diagnostic Summary as the current task.
Figure 16-7. TCA Interpreted Screen
Abend-AID -------------------- TCA Interpreted ------------------------------ 
COMMAND ===>


To access the Task Detail screen, select Task Detail

To access the Trace Table screen, select Trace Table

To access the EIB screen, select EIB


TCA......................... TCA0004
Task Number................. 06516

TCA Address................. 0006B190 Transaction Id.............. ERWV

System TCA Address.......... 0006B000 Queue Element Area.......... 00000000

Facility Control Indicator.. 01
ICE Address................. 00000000

Facility Control Area....... 0106AA74 HLL Save Area Address....... 0FA10E50

KC ECB Address.............. 00006C94 DLI Indicator............... 00

Common Control Overlay...... 0006B210 ISB Address................. 00000000

TWA Address................. 0006B290 EIS Initialized............. YES

TWA Length.................. 0
EIS Address................. 0006B344



------------ Transaction Storage -------------- Terminal -
CICS24
User24
CICS31
User31
Storage

Areas (Hex) 00000001
00000000
00000003
00000000
0000

Bytes (Hex) 00000440
00000000
00004820
00000000
00000000

The Abend-AID for CICS presentation of the trace table lets you determine what
program ERWMSTGV was doing just before the corruption.
7. Enter TRACE as a fast-path command or =3 as a jump command to display the
Abbreviated Trace Listing screen. This screen allows you to view a short, an
abbreviated, and a full version of the trace table. The default display is the entire
abbreviated trace table. The oldest entry appears at the top of the screen, as shown in
Figure 16-8.
Analyzing Storage Violations
16-7
Figure 16-8. Abbreviated Trace Listing

Abend-AID ---------- Abbreviated Trace Listing ---------- Row 000001 of 000091
COMMAND ===>
SCROLL ===> PAGE
==>
To display the Trace Listing in short format select SHORT 
To display the Trace Listing in full format select FULL
To specify selection criteria select SELECT 

KE
Trace
Entry Task Task Point
Interpretation
000001 0007 00027 MN 0202 MNMN EXIT TRANSACTION_INITIALISATION/OK
000002 0007 00027 AP FD05 ZSUP ENTRY TASK_STARTUP
07EB8228
000003 0007 00027 AP 00EA TMP
ENTRY LOCATE
PFT DFHCICST
000004 0007 00027 AP 00EA TMP
EXIT NORMAL
000005 0007 00027 AP 00E5 XSMN ENTRY CHECK
ERWV
000006 0007 00027 AP 00E5 XSMN EXIT OK
000007 0007 00027 AP 00F2 PCP
ENTRY XCTL-CONDITIONAL
ERWMSTGV
000008 0007 00027 AP 00EA TMP
ENTRY LOCATE
PPT ERWMSTGV
000009 0007 00027 AP 00EA TMP
EXIT NORMAL
000010 0007 00027 LD 0001 LDLD ENTRY ACQUIRE_PROGRAM
07E9A590 , 00000001
000011 0007 00027 DS 0002 DSAT ENTRY CHANGE_MODE
RO
000012 000F TCP
DS 0005 DSSR EXIT WAIT_OLDW/OK
000013 000F TCP
DS 0004 DSSR ENTRY WAIT_OLDW
DFHZDSP,TCP_NORM,00
000014 0007 00027 DS 0003 DSAT EXIT CHANGE_MODE/OK
QR
At this point, you can choose specific selection criteria by tabbing to the SELECT
field and pressing Enter. A pop-up window is displayed in which you can select trace
entries by domain ID, trace point ID, kernel task number, or task identifier, or display
only the exception entries.
Note:
Your screen may have other entries.
8. Enter M (maximum) in the Command field and press the DOWN PF key to scroll
down to the bottom of the Abbreviated Trace Listing. The entry displayed at the
bottom of the screen shown in Figure 16-9 on page 16-7 is the newest trace entry.
Figure 16-9. Abbreviated Trace Listing (bottom)

Abend-AID ---------- Abbreviated Trace Listing ---------- Row 000077 of 000091
COMMAND ===>
SCROLL ===> PAGE
==>
To display the Trace Listing in short format select SHORT 
To display the Trace Listing in full format select FULL
To specify selection criteria select SELECT 

KE
Trace
Entry Task Task Point
Interpretation
000079 0007 00027 ME 0402 MEBU EXIT BUILD_MESSAGE/OK
0
000080 0007 00027 ME FF00 SUWT ENTRY SEND_DIRECT
07DD0AA7 , 00000002
000081 0007 00027 ME FF35 MEFO ENTRY -FUNCTION(FORMAT_MESSAGE) 09153312 , 0000
000082 0007 00027 ME FF36 MEFO EXIT -FUNCTION(FORMAT_MESSAGE) OK
000083 0007 00027 ME FF02 SUWT EVENT BEFORE-MVS-WTO
000084 0007 00027 ME FF03 SUWT EVENT AFTER-MVS-WTO
000085 0007 00027 ME FF01 SUWT EXIT SEND_DIRECT/OK
000086 0007 00027 ME 0314 MEME EVENT ISSUE-MVS-FREEMAIN
000087 0007 00027 ME 0315 MEME EVENT MVS-FREEMAIN-COMPLETE
000088 0007 00027 ME 0302 MEME EXIT SEND_MESSAGE/OK
000089 0007 00027 DU 0101 DUDU ENTRY SYSTEM_DUMP
SM0102,07D95311 , 0
000090 0007 00027 DU 0600 DUTM ENTRY LOCATE_SYSTEM_DUMPCODE SM0102
000091 0007 00027 DU 0601 DUTM EXIT LOCATE_SYSTEM_DUMPCODE/OK NO,YES
******************************* BOTTOM OF DATA ********************************
At this point, the easiest way to find the last exception trace entry is to use the FIND
command to search backward through the trace table (from newest to oldest entry).
16-8
Abend-AID for CICS User’s Guide
9. Enter F *EXC* PREV to search for a previous occurrence of the *EXC* character
string. The request is successful, and a screen similar to the one shown in
Figure 16-10 is displayed.
Figure 16-10. Finding a Previous Occurrence on the Abbreviated Trace Listing Screen

Abend-AID ---------- Abbreviated Trace Listing ---------- Row 000033 of 000091
COMMAND ===>
SCROLL ===> PAGE
==>
To display the Trace Listing in short format select SHORT 
To display the Trace Listing in full format select FULL
To specify selection criteria select SELECT 

KE
Trace
Entry Task Task Point
Interpretation
000034 0007 00027 AP 00E1 EIP
ENTRY FREEMAIN
000035 0007 00027 SM 0D01 SMMF ENTRY FREEMAIN
0013C698,EXEC,CICS
000036 0007 00027 SM 0D11 SMMF *EXC* Storage_check_failed_on_freemain_request
000037 0007 00027 ME 0301 MEME ENTRY SEND_MESSAGE
66,SM0102,07D1D1C9
000038 0007 00027 ME 0501 MEIN ENTRY INQUIRE_MESSAGE_DATA 87E15048,DFHMET1E,6
000039 0007 00027 KE 0101 KETI ENTRY INQ_LOCAL_DATETIME_DECIMAL
000040 0007 00027 KE 0102 KETI EXIT INQ_LOCAL_DATETIME_DECIMAL/OK 10121994,09
000041 0007 00027 KE 0401 KEGD ENTRY INQUIRE_KERNEL
000042 0007 00027 KE 0402 KEGD EXIT INQUIRE_KERNEL/OK
H01AC118,JOHN
000043 0007 00027 ME 0502 MEIN EXIT INQUIRE_MESSAGE_DATA/OK 07E152B4,07E2D1C7
000044 0007 00027 ME 0401 MEBU ENTRY BUILD_MESSAGE
07E2D1C7,07E152B4,1
000045 0007 00027 ME FF40 MEWS ENTRY WRITE_SYMREC
07D9524D , 0000004C
000046 0007 00027 ME FF45 MEWS *EXC* SYMREC-ERROR
000047 0007 00027 ME FF30 SUME ENTRY SEND_ME_MSG
7E,00011B3F , 00000
Your display may include an *EXC* SYMREC-ERROR entry. This entry indicates an
error in the attempt to write a symptom record to LOGREC. If you encounter this
entry, press the RFIND PF key to repeat the FIND command and locate the next
previous occurrence of *EXC*. This occurrence is due to an SAA check failing on a
user FREEMAIN. The task corresponding to program ERWMSTGV (task 27 in this
example) is shown as the task that issued the FREEMAIN. You should determine what
task 27 was doing before the FREEMAIN.
10. Press the UP PF key to scroll up. A page of the Abbreviated Trace Listing, similar to
the screen shown in Figure 16-11, is displayed.
Note:
Abbreviated trace table displays are left/right scrollable.
Analyzing Storage Violations
16-9
Figure 16-11. Abbreviated Trace Listing
Abend-AID ---------- Abbreviated Trace Listing ---------- Row 000022 of 000091
COMMAND ===>
SCROLL ===> PAGE
==>
To display the Trace Listing in short format select SHORT 
To display the Trace Listing in full format select FULL
To specify selection criteria select SELECT 

KE
Trace
Entry Task Task Point
Interpretation
000023 0007 00027 AP F221 LIP
EXIT Establish_Ownership_Type OK
000024 0007 00027 SM 0C01 SMMG ENTRY GETMAIN
18C,YES,00,TASK24
000025 0007 00027 SM 0C02 SMMG EXIT GETMAIN/OK
0013C4F8
000026 0007 00027 AP 00E1 EIP
ENTRY INQUIRE-SYSTEM
000027 0007 00027 AP FF10 SUXS ENTRY CSLC
DFHEIQSA,SYSTEM,INQ
000028 0007 00027 AP FF11 SUXS EXIT CSLC/OK
000029 0007 00027 AP 00E1 EIP
EXIT INQUIRE-SYSTEM
OK
000030 0007 00027 AP 00E1 EIP
ENTRY GETMAIN
000031 0007 00027 SM 0C01 SMMG ENTRY GETMAIN
80,YES,USER24,EXEC
000032 0007 00027 SM 0C02 SMMG EXIT GETMAIN/OK
0013C698
000033 0007 00027 AP 00E1 EIP
EXIT GETMAIN
OK
000034 0007 00027 AP 00E1 EIP
ENTRY FREEMAIN
000035 0007 00027 SM 0D01 SMMF ENTRY FREEMAIN
0013C698,EXEC,CICS
000036 0007 00027 SM 0D11 SMMF *EXC* Storage_check_failed_on_freemain_request
In the example, note that task 27 issued a GETMAIN request several entries prior to
the FREEMAIN request. Because entry 32 shows the corrupted storage address, task 27
(program ERWMSTGV) is the probable cause of this storage violation.
11. Place the cursor on the entry number associated with the GETMAIN entry (30 in the
example) on the Abbreviated Trace Listing screen, and press the DOWN PF key to
scroll down as shown in Figure 16-12.
Figure 16-12. Selecting FULL on Abbreviated Trace Listing
Abend-AID ---------- Abbreviated Trace Listing ---------- Row 000030 of 000091
COMMAND ===>
SCROLL ===> PAGE
==>
To display the Trace Listing in short format select SHORT 
To display the Trace Listing in full format select FULL
To specify selection criteria select SELECT 

KE
Trace
Entry Task Task Point
Interpretation
000030 0007 00027 AP 00E1 EIP
ENTRY GETMAIN
000031 0007 00027 SM 0C01 SMMG ENTRY GETMAIN
80,YES,USER24,EXEC
000032 0007 00027 SM 0C02 SMMG EXIT GETMAIN/OK
0013C698
000033 0007 00027 AP 00E1 EIP
EXIT GETMAIN
OK
000034 0007 00027 AP 00E1 EIP
ENTRY FREEMAIN
000035 0007 00027 SM 0D01 SMMF ENTRY FREEMAIN
0013C698,EXEC,CICS
000036 0007 00027 SM 0D11 SMMF *EXC* Storage_check_failed_on_freemain_request
000037 0007 00027 ME 0301 MEME ENTRY SEND_MESSAGE
66,SM0102,07D1D1C9
000038 0007 00027 ME 0501 MEIN ENTRY INQUIRE_MESSAGE_DATA 87E15048,DFHMET1E,6
000039 0007 00027 KE 0101 KETI ENTRY INQ_LOCAL_DATETIME_DECIMAL
000040 0007 00027 KE 0102 KETI EXIT INQ_LOCAL_DATETIME_DECIMAL/OK 10121994,09
000041 0007 00027 KE 0401 KEGD ENTRY INQUIRE_KERNEL
000042 0007 00027 KE 0402 KEGD EXIT INQUIRE_KERNEL/OK
H01AC118,JOHN
000043 0007 00027 ME 0502 MEIN EXIT INQUIRE_MESSAGE_DATA/OK 07E152B4,07E2D1C7
Finally, select FULL, and press the Enter key to display the Full Trace Listing screen
shown in Figure 16-13.
16-10
Abend-AID for CICS User’s Guide
Figure 16-13. Full Trace Listing Screen
Abend-AID -------------- Full Trace Listing ------------- Row 000241 of 001071
COMMAND ===>
SCROLL ===> PAGE

To display the Trace Listing in abbreviated format select ABBREV 
To display the Trace Listing in short format select SHORT 
To specify selection criteria select SELECT 

Entry Task Interpretation
000030 00027 AP 00E1 EIP ENTRY GETMAIN REQ(0004) FIELD-A(0013C508 ..E.)
FIELD-B(08000C02 ....) KE_NUM-0007 TCB-008DF960 RET-50053914
TIME-09:54:27.9506599455 INTERVAL-**.********** 

000031 00027 SM 0C01 SMMG ENTRY - FUNCTION(GETMAIN) GET_LENGTH(80)
SUSPEND(YES) STORAGE_CLASS(USER24) CALLER(EXEC) KE_NUM-0007
TCB-008DF960 RET-88F51C80 TIME-09:54:27.9506711955
INTERVAL-00.0000112500
1-0000 00480000 00000011 00000000 00000000 *................*
0010 B6580000 00000000 02D80158 00000000 *.........Q......*
0020 00000000 00055000 00000080 00010E30 *......&.........*
0030 0013C4F8 01131201 00053A78 07D94884 *..D8.........R.d*
0040 07D9483A 07D948E0
*.R...R..
* 

000032 00027 SM 0C02 SMMG EXIT - FUNCTION(GETMAIN) RESPONSE(OK)
ADDRESS(0013C698) KE_NUM-0007 TCB-008DF960 RET-88F51C80
This screen displays the full individual trace entry for the GETMAIN, which identifies
the address of the return point in program ERWMSTGV at which the GETMAIN was
issued. This information helps resolve the program error.
Note:
The trace listing is also available in short format, as shown in Figure 16-14.
Figure 16-14. Short Trace Listing Screen
Abend-AID ------------------ Short Trace Listing -------- Row 000089 of 000372
COMMAND ===>
SCROLL ===> PAGE

To display the Trace Listing in short format select FULL
To display the Trace Listing in abbreviated format select ABBREV
To specify selection criteria select SELECT 

Entry Task Interpretation
000030 00027 AP 00E1 EIP ENTRY GETMAIN REQ(0004)
FIELD-A(0013C508 ..E.) FIELD-B(08000C02 ....)
RET-50053914 TIME-09:54:27.9506599455 **.********** 

000031 00027 SM 0C01 SMMG ENTRY GETMAIN GET_LENGTH(80)
SUSPEND(YES) STORAGE_CLASS(USER24) CALLER(EXEC)
RET-88F51C80 TIME-09:54:27.9506711955 00.0000112500 

000032 00027 SM 0C02 SMMG EXIT GETMAIN/OK ADDRESS(0013C698)
RET-88F51C80 TIME-09:54:27.9509271318 00.0000189383
17-1
Chapter 17.
Analyzing MVS Virtual Storage
Chap 17
This chapter describes the Abend-AID for CICS Virtual Storage Analysis and the Memory
Display screens. It also describes an approach for using Abend-AID for CICS to resolve an
878-xx abend or S80A-xx.
An S878 occurs when the system tries and fails to satisfy a STORAGE request, an RU or
VRU form of a GETMAIN request, or an RU form of a FREEMAIN request, and depending
on the reason code, indicates an out-of-storage condition. An S80A-xx occurs when the
system tries and fails to process an R form of the GETMAIN or FREEMAIN macro. The xx
is the reason code that explains the error which is also found in the system diagnostic
work area (SDWA) in field SDWACRC.
Programming errors that commonly cause an S878-xx or S80A-xx include the following:
• GETMAIN(s) without subsequent FREEMAIN(s); that is, orphaned storage.
• A section of program code that contains a GETMAIN which is repeatedly being
executed (loop). Looking at the system trace table also assists in this case.
• An invalid length specified on a GETMAIN.
Further, if the reason code indicates a GETMAIN failure for private area or local system
queue area (LSQA) storage, verify that the size specified on the REGION parameter coded
on the JOB or EXEC statement is large enough. The size specified on the REGION
parameter is limited by the size of the private areas. The size of the private areas is
determined by the size of the common areas at IPL time. In other words, storage for the
common areas is set aside first and what is left over is for the private areas. The common
areas include the prefixed save area (PSA); common service area (CSA); pageable, fixed,
and modified link pack areas (PLPA, FLPA, and MLPA); system queue area (SQA); and the
nucleus, which is fixed and non-swappable.
Note:
For an in-depth discussion of the virtual storage areas, refer to the IBM OS/390
MVS initialization and tuning guide.
In order to determine the exact cause of the S878 or S80A, examine the IEA705I message
in the JESMSGLG of the abending job for the xx reason code. If it is not available, the
data area containing the unformatted information for the IEA705I is found in the
extended nucleus. To find this area in the dump, go to the Control Blocks/Storage screen
and select the CVT. Once the CVT is displayed on the Memory Display screen, select the
address at offset x'10C'.
Refer to IBM informational APAR II05506 or IEA705I in the IBM messages manual for the
layout of this area, which virtual storage manager (VSM) uses as a save area for error
conditions. This area is in a module called IEAVMSGS in the extended read/write nucleus,
which can also be found from the Nucleus Map display.
The JESMSGLG for the S878 sample created for this demonstration is shown in Figure
17-1 on page 17-2. The reason code is 10, which indicates the GETMAIN was for private
area storage that could not be satisfied.
17-2
Abend-AID for CICS User’s Guide
Figure 17-1. JESMSGLOG for the S878 Abend
Abend-AID ---------------- JES2 System Log --------------- Row 000001 of 000095 
COMMAND ===>
SCROLL ===> PAGE 
==>
Time
Job
Message
******** ******** *************************************************************
11.41.42 JOB12501 +DFHCP0102I H01AC118 CPI initialization has ended.
11.41.42 JOB12501 +DFHPR0105I H01AC118 Partner resource manager initialization
11.41.42 JOB12501 +DFHAI0102I H01AC118 AITM initialization has ended.
11.41.43 JOB12501 +DFHJC4508 H01AC118 CICS SYSTEM LOG. SECONDARY DATA SET NOW 
11.41.43 JOB12501 +DFHJC4553 07/03/04 11:41:43 H01AC118 Archive job submitted
11.41.43 JOB12501 +DFHAP1204I H01AC118 COBOL2 is being initialized.
11.41.43 JOB12501 +DFHSI1517 H01AC118 Control is being given to CICS.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
11.42.49 JOB12501 IEA705I ERROR DURING GETMAIN SYS CODE = 878-10 CCFXC410 CICS
11.42.49 JOB12501 IEA705I 00F0C100 008C97D0 008C97D0 00377200 00008000
11.45.30 JOB12501 IEA995I SYMPTOM DUMP OUTPUT
SYSTEM COMPLETION CODE=878 REASON CODE=00000010
TIME=11.42.49 SEQ=50362 CPU=0047 ASID=007B
PSW AT TIME OF ERROR 070C1000
8155EE6E ILC 2 INTC 0D
.
.
.
.
.
.
.
.
.
.
.
.
******************************** BOTTOM OF DATA *********************************
Note: Because most of the screens displayed in this chapter are wider than the standard,
default display format (24 rows by 80 characters), you may want to change your
emulator/terminal display to a wider format (27 rows by 132 columns).
Access the MVS Storage Analysis function from the MVS Information menu, which is a
selection on the Primary Options menu for region dump analysis. Alternatively, once you
have selected a region dump, you can enter the MVSSTG fast-path command from the
Command line on any Abend-AID for CICS screen to directly access the MVS Storage
Analysis menu, as shown in Figure 17-2.
Figure 17-2. MVS Storage Analysis Menu
Abend-AID ---------------- MVS Storage Analysis ----------------------------- 
OPTION ===>


1 VSMAP
Virtual Storage Map
8 SQASP
SQA Subpools


2 PVTSUM
Private Area Summary
9 CSASUM
CSA Summary


3 PVTSP
Private Subpools
10 CSASP
CSA Subpools


4 LSQA
LSQA Summary
11 LPAMAP
LPA Map


5 LSQASP
LSQA Subpools
12 NUCMAP
Nucleus Map


6 ASMAP
Allocated Storage Map
13 MEMOBJ
Memory Objects


7 SQASUM
SQA Summary
14 DSPACE
Data Spaces

This menu provides links to different storage areas to help you determine the cause of
memory errors:
1. VSMAP (Virtual Storage Map) — Displays the starting and ending address of the
virtual storage areas for an MVS system from which the address space was dumped.
See “Private Storage Analysis” on page 17-3 for more information.
2. PVTSUM (Private Area Summary) — Displays allocations of the private areas of the
address space at the time the SVC dump was taken. The information is obtained from
the VSM LDA (Local Data Area) directly or is computed from data contained therein.
See “Private Storage Analysis” on page 17-3 for more information.
Analyzing MVS Virtual Storage
17-3
3. PVTSP (Private Subpools) — Displays the totals of allocated storage by subpool in
the Private and Extended Private areas for all TCBs or for a specific TCB at the time of
the error. Amounts are only displayed once for a shared (SHR) subpool under the TCB
that owns (OWN) it. Select a shared-only subpool to see the owning TCB address. See
“Private Storage Analysis” on page 17-3 for more information.
4. LSQA (LSQA Summary) — Displays information on the local system queue area
(LSQA) in the private areas of the address space at the time the SVC dump was taken.
The information is obtained from the VSM local data area (LDA) or computed from
data addressed by it. See “LSQA Analysis” on page 17-14 for more information.
5. LSQASP (LSQA Subpools) — Summarizes the allocated subpools in the LSQA or SQA
and the extended LSQA or SQA areas at the time of the error. See “LSQA Analysis” on
page 17-14 for more information.
6. ASMAP (Allocated Storage Map) — Displays allocated virtual storage by starting
address, ending address, and number of pages (range), virtual storage area (Private,
CSA, or SQA), subpool, key (applicable to Private and CSA), ownership and owning
TCB address (applicable to Private only). All fields can be sorted except Ownership
and TCB Address. See “Allocated Storage Map” on page 17-42 for more information.
7. SQASUM (SQA Summary) — Displays information on the global system queue area
(SQA) at the time the SVC dump was taken. The information is obtained from the
VSM global data area (GDA) or computed from data addressed by the GDA. See
“Common Storage Analysis” on page 17-25 and “SQA Analysis” on page 17-31 for
more information.
8. SQASP (SQA Subpools) — Summarizes the allocated subpools in the LSQA or SQA
and the extended LSQA or SQA areas at the time of the error. See “SQA Analysis” on
page 17-31 for more information.
9. CSASUM (CSA Summary) — Displays allocations of the common service areas of
virtual storage at the time the SVC dump was taken. The information is obtained
from the VSM GDA directly or is computed from data contained therein. See “SQA
Analysis” on page 17-31 for more information.
10. CSASP (CSA Subpools) — Summarizes the allocated subpools in the CSA and the
extended CSA at the time of the error. See “SQA Analysis” on page 17-31 for more
information.
11. LPAMAP (LPA Map) — Displays a mapping of the modules located in link pack areas
(LPA) sorted by address. There are three chains/queues containing either a CDE or an
LPDE. The pagable link pack areas (PLPA) are chained from the CVTLPDIA. The fixed
and modified LPAs (FLPA and MPLA) are chained from the CVTQLPQA and the
dynamic LPAs (available from OS/390 V2R4) are chained from the ECVTDLPF. See
“Link Pack Areas” on page 17-38 for more information.
12. NUCMAP (Nucleus Map) — Displays a mapping of the CSECTs located in the system
nucleus areas sorted by address. The NUCMAP is addressed from CVTNUCMP. See
“Nucleus Areas” on page 17-40 for more information.
13. MEMOBJ (Memory Objects) — Displays information on memory objects that were
allocated using the IARV64 macro (storage above the bar). See “64-bit Memory
Analysis” on page 17-44 for more information.
14. DSPACE (Data Spaces) — Displays the data spaces that are owned by a TCB running
in the selected ASID. There may be other data spaces contained in the dump that are
owned by other ASIDs.
Private Storage Analysis
By looking at the IEA705I, you can also see that the GETMAIN was unconditional for 32K
of subpool 55 with backing storage (real) above or below 16 megabytes and virtual
storage either above or below. When LOC=ANY is coded on the GETMAIN, VSM first
17-4
Abend-AID for CICS User’s Guide
looks to satisfy the request from above 16 megabytes. If unsuccessful, VSM then looks to
satisfy the request from below 16 megabytes.
However, this does not necessarily indicate that subpool 55 was over-allocated. It just
means that the virtual storage area that is constrained is the private area that includes
the LSQA. Use the Abend-AID for CICS MVS Storage Analysis function to examine the
allocations in the private area(s).
The Virtual Storage Map, shown in Figure 17-3, is a good place to start for any issues
regarding storage allocations because it provides an overall picture of the address space.
Access this screen by selecting menu option 1 from the MVS Storage Analysis menu
(Figure 17-2 on page 17-2), or once you have selected a region dump, you can enter the
VSMAP fast-path command on the Command line on any Abend-AID for CICS screen.
Figure 17-3. Virtual Storage Map Screen
Abend-AID ------------ Virtual Storage Map ------------- Row 000001 of 000021 
COMMAND ===>
SCROLL ===> DATA 

The Ext User Region had reached the highest allocatable address.

The Ext CSA had no pages converted to Ext SQA.

The CSA had no pages converted to SQA.

The User Region had reached the highest allocatable address.


Starting Ending
Size of
Total
Percent

Storage Area
Address
Address
Area
Allocated
Allocated

**************** ******** ******** ********** ********** ***********

Ext Private
10300000 7FFFFFFF 1,831,936K
42,432K
2.316

Ext User Region 10300000 122FFFFF
32,768K
32,768K
100.000

Ext CSA
08540000 102FFFFF
128,768K
107,732K
83.664

Ext MLPA
0853F000 0853FFFF
4K

Ext FLPA
0853C000 0853EFFF
12K

Ext PLPA
04E2C000 0853BFFF
56,384K

Ext SQA
022FE000 04E2BFFF
44,216K
43,176K
97.648

Ext Nuc (R/W)
0165E000 022FDFFF
12,928K

Ext Nuc (R/O)
01000000 0165DFFF
6,520K

- 16Mb Line ---- -------- -------- ---------- ---------- ----------
Nucleus (R/O)
00FD9000 00FFFFFF
156K

Nucleus (R/W)
00FC3000 00FD8FFF
88K

SQA
00EA7000 00FC2FFF
1,136K
1,136K
100.000
The amount of storage allocated in each area except for the LPA and nucleus areas is
displayed along with the percentages these amounts represent. These figures are
accumulated or calculated from the actual allocations found during analysis of the
address space.
The analysis programs can produce messages in the Dump Analysis Message Log if errors
or conditions such as invalid VSM control blocks are found. Normally you can find
invalid control blocks for SQA DFEs or CSA DQEs and FQEs if the QUIESCE=NO option
was specified on the SDUMP (X) request. QUIESCE=NO leaves the system dispatchable
during the dumping of the SQA and CSA so that these areas can be modified
(GETMAIN/FREEMAIN) such that the control blocks no longer reflect the storage
dumped. Error detection is done such that processing stops only for looping conditions
or broken chains, such as a DFE chain that causes the same series of DFEs to be repeatedly
processed. This could significantly throw off the calculations of free areas.
In the header of the Virtual Storage Map screen, you can see that both user regions hit
the highest allocatable address allowed. This information confirms that the private
area(s) were indeed constrained, more specifically the user regions. Exactly what this
indicates is described in the explanation of the Private Area Summary screen below. Also
note that the SQA had reached 100 percent allocation and that any further requests for
SQA subpools must be allocated from the CSA.
Analyzing MVS Virtual Storage
17-5
User Region Analysis
Find further detailed information on the Private Area Summary screen, as shown in
Figure 17-4. Access this screen in one of the following ways:
• From the Virtual Storage Map (Figure 17-3 on page 17-4), use the cursor-point-andshoot feature and press Enter at the Ext Private, Ext User Region, Private, or User
Region field under the Storage Area column.
• After selecting a region dump, enter the PVTSUM fast-path command on the
Command line from any Abend-AID for CICS screen.
• Select option 2 from the MVS Storage Analysis menu (Figure 17-2 on page 17-2).
Figure 17-4. Private Area Summary Screen
Abend-AID ------------------ Private Area Summary ----------------------------
COMMAND ===>


LDA Address................ 7FF15EB0

Region Size (Kbytes)....... 8,192

To view the local system queue area select LSQA

To view a list of allocated subpools select List


Extended Private Area
Private Area

Maximum Address............ 7FFFFFFF
Maximum Address............ 008FFFFF

Low MVS Page Address....... 7F68C000
Low MVS Page Address....... 00899000

User Region Limit Address.. 122FFFFF
User Region Limit Address.. 00814FFF

High User Region Address... 122FFFFF
High User Region Address... 00814FFF

Starting Address........... 10300000
Starting Address........... 00005000

Maximum Size (Kbytes)...... 1,831,936 Maximum Size (Kbytes)...... 9,196

Limit Size (Kbytes)........ 32,768
Limit Size (Kbytes)........ 8,256

Adjusted Size (Kbytes)..... 32,768
Adjusted Size (Kbytes)..... 8,192

Free Blocks Available...... Yes
Free Blocks Available...... Yes


SM Block Address........... 7F80C000

SM Block Size (Kbytes)..... 7,932

Figure 17-4 displays detailed information on both the extended private area and private
area. The local data area (LDA) is the VSM anchor block for information specific to an
address space. The first five lines under each grouping map the private areas from the top
of each area down to the start of each area. The private areas are further broken down
into areas reserved for the operating system and its subsystems (MVS high private), and
for user programs running in problem state (user region). LSQA, scheduler work area
(SWA), and authorized user key subpools are allocated from the MVS high private area.
These subpools are allocated from the top of the private area downward, while the user
region subpools (0-127, 251, 252) are allocated from the start of the private area upward.
No boundaries exist between LSQA, SWA, and authorized user key storage. They are all
interspersed with each other, which can be seen on the Allocated Storage Map under the
E/PVT Area column.
The user regions are limited in size depending on how the REGION parameter is coded on
the JOB or EXEC statement, or whether the site chooses to override the defaults via
system exit IEFUSI or IEALIMIT (controls below 16 megabyte private area only). Refer to
the IBM OS/390 MVS Installation Exits manual for default limits or for coding either of these
exits. Although there may be a limit on the user region, this does not place a limit on the
MVS high private area. These subpools can be allocated from below the user region limit,
but not below the highest allocated user region address (or page) also known as the top of
the user region. This top is dynamic as storage is allocated and freed. Therefore, the low
MVS page address line may be above or below the user region limit address line.
17-6
Abend-AID for CICS User’s Guide
Keep in mind that MVS recovery/termination requires LSQA below 16 megabytes; and if
it cannot be acquired, the address space will be terminated. When this occurs, an SVC
dump is rarely usable.
This address space had REGION=8M or 8192K coded since the Region Size (Kbytes) field
has 8,192. Note that the User Region Limit Address and High User Region Address
fields contain the same addresses, 122FFFFF and 00814FFF. Note also that both Free
Blocks Available fields display Yes, indicating that free blocks of storage do exist. Use the
cursor-point-and-shoot feature and press Enter at the Yes field under the Extended
Private Area column to display the Free Block Queue Elements screen (Figure 17-5). The
significance of the Low MVS Page Address field is further discussed in “LSQA Analysis”
on page 17-14.
Figure 17-5. Free Block Queue Elements Screen, Extended Private Area
Abend-AID --------- Free Block Queue Elements ---------- Row 000001 of 000003 
COMMAND ===>
SCROLL ===> DATA 

Total free storage (K)...... 1,789,500 Free Below High User (K)... 0

Maximum Address.............. 7FFFFFFF Free from User to Limit (K) 0

Low MVS Page Address......... 7F68C000 Free from Limit to MVS (K). 1,789,488

User Region Limit Address.... 122FFFFF Free Between User & MVS (K) 1,789,488

High User Region Address..... 122FFFFF Free Above Low MVS (K)..... 12


FBQE
Start of End of
Size of

Address
Area
Area
Area
Location

******** ******** ******** ********** **********************************

7F765778 12300000 7F68BFFF 1,789,488K Between High User Region & Low MVS

7F697358 7F68E000 7F68EFFF
4K Above the Low MVS Page Address

7F697478 7F691000 7F692FFF
8K Above the Low MVS Page Address

****************************** BOTTOM OF DATA *********************************
The Free Block Queue Elements screen displays all the blocks of unallocated storage in
the extended private area. The first free block starts at 12300000 to 7F68BFFF for
1,789,488K, which means that the only free blocks are above the limit of the extended
user region. In other words, the entire extended user region is allocated. Note that the
Free from User to Limit (K) field in the header is 0, which could mean that the extended
user region limit needs to be increased. Note also that the Free from Limit to MVS (K)
field is 1,789,488K. Therefore, the extended user limit could be increased if necessary.
Press the End (PF3) key to return to the Private Area Summary screen. Use the cursorpoint-and-shoot feature and press Enter at the Yes displayed in the Free Blocks Available
field under the Private Area section to display the Free Block Queue Elements screen for
the private area, as shown in Figure 17-6.
Figure 17-6. Free Block Queue Elements Screen, Private Area
Abend-AID ---------- Free Block Queue Elements --------- Row 000001 of 000002 
COMMAND ===>
SCROLL ===> DATA 

Total free storage (K)...... 548
Free Below High User (K)... 20

Maximum Address.............. 008FFFFF Free from User to Limit (K) 0

Low MVS Page Address......... 00899000 Free from Limit to MVS (K). 528

User Region Limit Address.... 00814FFF Free Between User & MVS (K) 528

High User Region Address..... 00814FFF Free Above Low MVS (K)..... 0


FBQE
Start of End of
Size of

Address
Area
Area
Area
Location

******** ******** ******** ********** **********************************

7F69FEF8 0080F000 00813FFF
20K Below the High User Region Address

7F765448 00815000 00898FFF
528K Between High User Region & Low MVS

****************************** BOTTOM OF DATA *********************************
The first free block starts at 0080F000 to 00813FFF with a size of 20K. Although the user
region has some unallocated storage remaining, this amount is not enough to satisfy the
Analyzing MVS Virtual Storage
17-7
GETMAIN request for 32K. There is another free block from 00815000 to 00898FFF of
528K, but it is above the user region limit. This block corresponds with the 00899000 in
the Low MVS Page Address field displayed in the private area section of the Private Area
Summary screen.
From the Free Block Queue Elements screen for the private areas, note that there is only
20K available in the user region below 16 megabytes, and there is nothing available in
the extended user region. The GETMAIN for subpool 55 of 32K failed for this reason. The
next step is to determine what subpool(s) in the user region(s) if any are excessively
allocated, or if the user region limit(s) needs to be increased. If there are excessive
allocations, the owner/allocator needs to be identified.
Press the END (PF3) key to return to the Private Area Summary screen. From this screen,
use the cursor point-and-shoot feature and press Enter at the List field in the header to
display the Allocated Private Subpools screen, as shown in Figure 17-7. Alternatively, you
can enter the PVTSP fast-path command on the Command line of any Abend-AID for
CICS screen once you have selected a region dump.
Figure 17-7. Allocated Private Subpools Screen













Percent of 
Total >16Mb
***********
0.000 
0.083 
0.401 
0.094 
0.094 
0.118 
0.024 
0.024
Abend-AID --------- Allocated Private Subpools --------- Row 000001 of 000139
COMMAND ===>
SCROLL ===> DATA
==>
Private Size (Kbytes)....................... 9,196
Extended Private Size (Kbytes).............. 1,831,936
Total Private Allocated (Kbytes)............ 8,604
Total Extended Private Allocated (Kbytes)... 33,936
To
To
To
To
Id
***
229
229
229
229
230
230
230
230
view
view
view
view
Key
***
0
1
5
8
0
1
2
3
a summary of these subpools select Summarize
user region subpools select User Region
scheduler work area subpools select SWA
authorized user key subpools select Authorized
Ownership
*********
OWN
OWN
OWN
OWN
OWN
OWN
OWN
OWN
TCB
Address
********
008FE1B8
008FE1B8
008FE1B8
008FE1B8
008FE1B8
008FE1B8
008FE1B8
008FE1B8
Allocated
<16Mb
**********
0K
0K
0K
0K
4K
28K
4K
4K
Percent of
Total <16Mb
***********
0.000
0.000
0.000
0.000
0.046
0.325
0.046
0.046
Allocated
>16Mb
**********
0K
28K
136K
32K
32K
40K
8K
8K
The Allocated Private Subpools screen displays a list of allocated subpools that are
chained off each task control block (TCB) found in the address space. The TCBs are
processed in the order found on the TCB Summary screen. The LSQA subpools do not
appear on this screen because they are not chained off the TCB. They are found from the
AQATINDX and AQAT control blocks. However, the SWA and authorized user key
subpools are chained off the TCB and appear here. Because it was previously determined
that the user regions were constrained, use the cursor point-and-shoot feature and press
Enter at the User Region field in the header to display the Allocated Private Subpools
screen for the user region subpools only, as shown in Figure 17-8.
17-8
Abend-AID for CICS User’s Guide
Figure 17-8. Allocated Private Subpools Screen for User Regions












Percent of 
Total >16Mb
***********
0.000 
4.114 
0.000 

0.000 
0.000 
0.000 
0.000 
0.318
Abend-AID --------- Allocated Private Subpools --------- Row 000001 of 000043
COMMAND ===>
SCROLL ===> DATA
==>
Private Size (Kbytes)....................... 9,196
Extended Private Size (Kbytes).............. 1,831,936
Total Private Allocated (Kbytes)............ 8,604
Total Extended Private Allocated (Kbytes)... 33,936
To view a summary of these subpools select Summarize
To view scheduler work area subpools select SWA
To view authorized user key subpools select Authorized
Id
***
0
0
252
0
8
131
132
132
132
Key
***
0
8
0
8
8
8
1
5
8
Ownership
*********
OWN,SHR
OWN,SHR
OWN
SHR
OWN
OWN
OWN
OWN
OWN
TCB
Address
********
008FDE28
008EC9B0
008EC9B0
008C9BF8
008C9BF8
008C9BF8
008C9BF8
008C9BF8
008C9BF8
Allocated
<16Mb
**********
0K
52K
0K
0K
0K
0K
0K
24K
Percent of
Total <16Mb
***********
0.000
0.604
0.000
0.000
0.000
0.000
0.000
0.279
Allocated
>16Mb
**********
0K
1,396K
0K
0K
0K
0K
0K
108K
This screen lists the total allocations for a subpool only if it is owned (OWN or
OWN,SHR), but not if it is shared (SHR). Incorrect calculations would otherwise result
because the descriptor queue elements (DQEs) would be counted more than once. If you
select a subpool that is SHR only, the Private Subpool Detail screen displays with the
owning TCB address in the header as well as the DQEs and FQEs as if the subpool of the
owning TCB had been selected. User region subpools can be summarized since a subpool
can appear more than once whether it is owned exclusively or shared with other TCBs.
On the Allocated Private Subpools screen, use the cursor point-and-shoot feature and
press Enter at the Summarize field to display the Summarized Private Subpools screen, as
shown in Figure 17-9.
Figure 17-9. Summarized Private Subpools
Abend-AID --------- Summarized Private Subpools -------- Row 000001 of 000015 
COMMAND ===>
SCROLL ===> DATA 

Private Size (Kbytes)....................... 9,196

Extended Private Size (Kbytes).............. 1,831,936

Total Private Allocated (Kbytes)............ 8,604

Total Extended Private Allocated (Kbytes)... 33,936


Allocated
Percent of
Allocated
Percent of
Total
Percent of 
Id
<16Mb
Total <16Mb >16Mb
Total >16Mb Allocated
<16M + >16M 
*** ********** *********** ********** *********** ********** *********** 
0
52K
0.604
1,396K
4.114
1,448K
3.404

1
4K
0.046
0K
0.000
4K
0.009

2
4K
0.046
20K
0.059
24K
0.056

3
4K
0.046
16K
0.047
20K
0.047

8
0K
0.000
0K
0.000
0K
0.000

55
1,948K
22.641
12,292K
36.221
14,240K
33.474

66
4K
0.046
4K
0.012
8K
0.019

82
0K
0.000
512K
1.509
512K
1.204

97
0K
0.000
20K
0.059
20K
0.047

100
0K
0.000
544K
1.603
544K
1.279

127
0K
0.000
0K
0.000
0K
0.000

131
0K
0.000
0K
0.000
0K
0.000

132
24K
0.279
108K
0.318
132K
0.310 
Sort the Summarized Private Subpools screen by any of the columns. Because the
extended area is used first for GETMAINs with LOC=ANY, sort the screen by the Allocated
>16Mb column to show what subpool is using the most amount of extended user region.
Type SORT on the Command line, place the cursor on the Allocated >16 Mb column
heading and press Enter. Use the BOTTOM primary command or type MAX on the
Analyzing MVS Virtual Storage
17-9
Command line and press the DOWN (PF8) key to scroll to the bottom of the data, as
shown in Figure 17-10. Note that subpool 252 has the most allocated.
Figure 17-10. Summarized Private Subpools Screen, Sorted and Scrolled Down
Abend-AID --------- Summarized Private Subpools -------- Row 000004 of 000015 
COMMAND ===>
SCROLL ===> DATA 

Private Size (Kbytes)....................... 9,196

Extended Private Size (Kbytes).............. 1,831,936

Total Private Allocated (Kbytes)............ 8,604

Total Extended Private Allocated (Kbytes)... 33,936


Allocated
Percent of
Allocated
Percent of
Total
Percent of 
Id
<16Mb
Total <16Mb >16Mb
Total >16Mb Allocated
<16M + >16M 
*** ********** *********** ********** *********** ********** *********** 
127
0K
0.000
0K
0.000
0K
0.000

66
4K
0.046
4K
0.012
8K
0.019

3
4K
0.046
16K
0.047
20K
0.047

2
4K
0.046
20K
0.059
24K
0.056

97
0K
0.000
20K
0.059
20K
0.047

132
24K
0.279
108K
0.318
132K
0.310

82
0K
0.000
512K
1.509
512K
1.204

100
0K
0.000
544K
1.603
544K
1.279

0
52K
0.604
1,396K
4.114
1,448K
3.404

251
1,296K
15.063
5,288K
15.582
6,584K
15.477

55
1,948K
22.641
12,292K
36.221
14,240K
33.474

252
4,900K
56.950
12,568K
37.034
17,468K
41.063

****************************** BOTTOM OF DATA *********************************
Press the END (PF3) key to return to the Allocated Private Subpools screen for user
regions only. Enter the SORT primary command, or type SORT on the command line and
press Enter at the Allocated > 16 Mb column heading. Enter the BOTTOM primary
command, or type MAX on the command line and press the DOWN (PF8) key to scroll to
the bottom of the data, as shown in Figure 17-11.
Figure 17-11. Allocated Private Subpools Screen, Sorted and Scrolled Down








To view a summary of these subpools select Summarize

To view scheduler work area subpools select SWA

To view authorized user key subpools select Authorized


TCB
Allocated
Percent of
Allocated
Percent of 
Id
Key Ownership Address
<16Mb
Total <16Mb >16Mb
Total >16Mb
*** *** ********* ******** ********** *********** ********** ***********
132
8 OWN
008C9BF8
24K
0.279
108K
0.318 
82
8 OWN
008C9A60
0K
0.000
512K
1.509 
100
8 OWN,SHR
008B2748
0K
0.000
544K
1.603 
0
8 OWN,SHR
008EC9B0
52K
0.604
1,396K
4.114 
55
8 OWN
008C97D0
1,948K
22.641
4,100K
12.082 
251
8 OWN
008C9BF8
1,296K
15.063
5,288K
15.582 
55
8 OWN
008C9A60
0K
0.000
8,192K
24.140 
252
0 OWN
008C9BF8
4,900K
56.950
12,568K
37.034 
****************************** BOTTOM OF DATA *********************************
Abend-AID --------- Allocated Private Subpools --------- Row 000036 of 000043
COMMAND ===>
SCROLL ===> DATA
==>
Private Size (Kbytes)....................... 9,196
Extended Private Size (Kbytes).............. 1,831,936
Total Private Allocated (Kbytes)............ 8,604
Total Extended Private Allocated (Kbytes)... 33,936
Use the cursor point-and-shoot feature and press Enter at 252 to display the Private
Subpool Detail screen for this subpool. Press the RIGHT (PF11) key to display the rightmost portion of the screen, as shown in Figure 17-12.
17-10
Abend-AID for CICS User’s Guide
Figure 17-12. Private Subpool Detail Screen
Abend-AID ----------- Private Subpool Detail ------------ Row 000001 of 000096
COMMAND ===>
SCROLL ===> DATA
<==

Subpool..................... 252
SPQA Address................ 7FF15640

Key......................... 0
Allocated <16Mb (Kbytes).... 4,900

SPQE Address................ 7F765388 Allocated >16Mb (Kbytes).... 12,568

TCB Address................. 008C9BF8 Total Allocated (Kbytes).... 17,468

Ownership................... OWN
Free <16Mb.................. 7,440

Free >16Mb.................. 36,528

Total Free.................. 43,968


DQE
Backing
Area
Size of
Data

Address
Storage
Address
Area
Address
First 32 Bytes of Data

******** ******** ******** ********** ******** ***************************
7F6EC268 BELOW
00008000
192 000080C0 CIPT.....FP . .. ... l...
7F735DA8 BELOW
0001A000
1,592 0001A638 *DFHASV . w 0410I
UN647
7F765C88 BELOW
0001B000
0001B000 CIST. ...... l.. _.."{ CF
7F6D7070 BELOW
0001F000
1,888 0001F760
00
IGZECIC .C24.003/20/
7F7359E8 ANYWHERE 0000D000
3,768 0000DEB8 ... ..
..... .. .......
7F7656B8 ANYWHERE 00080000
00080000 . >MODHEAD P.410DFHDUIO 06/
7F6EC430 ANYWHERE 001C0000
001C0000 DFHYA160 0. 00. 00 00} 00
7F6D7280 ANYWHERE 10300000
10300000 . >MODHEAD P.410DFHKEDCL10/
7F735640 ANYWHERE 103FB000
103FB000 .... ?"
$8 ?a
.
}.. 
24 103FB5E8
.
{q.. . {q. .........
Not only is the DQE and FQE information displayed, but as an aid in attempting to
determine the ownership of the storage, the first 32 bytes of allocated storage is
displayed. Several first-32-bytes-for-a-DQE may exist if there is free storage (FQE) within
that DQE. The methods used in displaying the first 32 bytes of data are the following:
• If there is no free area within a DQE, the first 32 bytes are at the start of the DQE, or
DQE area address. Data address reflects this.
• If there are FQE(s), there are additional first 32 bytes after each free area as
determined by adding FQE area size to FQE area address. Data address reflects this
calculation.
• If the free area is at the end of the DQE, << REACHED END OF DQE AREA >> is
displayed. Data address is blank.
• If the page on which the allocation is located is not contained in the SDUMP dataset,
<< STORAGE NOT AVAILABLE >> is displayed.
Looking at these first 32 bytes of data, you see that subpool 252 contains either programs
or CICS DSA data. Select a DSA name on the CICS Environment Summary or the
Dynamic Storage Area Summary to determine in which subpools the DSAs exist. Refer to
“Enhanced Memory Display” on page 17-21 for information about how these screens can
be used along with an enhancement to the Memory Display screen.
Press the END (PF3) key to return to the Allocated Private Subpools screen again. Next,
use the cursor point-and-shoot feature and press Enter at the subpool with the next most
extended storage allocated, subpool 55, to display the associated Private Subpool Detail
screen. Press the RIGHT (PF11) key to display the right-most portion of the screen, as
shown in Figure 17-13.
Analyzing MVS Virtual Storage
17-11
Figure 17-13. Private Subpool Detail Screen, Scrolled Right












First 32 Bytes of Data

***************************
>VECTTBY...................
>VECTTBY...................
>VECTTBY...................
>VECTTBY...................
>VECTTBY...................
>VECTTBY...................
>VECTTBY...................
>VECTTBY...................
>VECTTBY...................
>VECTTBY...................
Abend-AID --------------- Private Subpool Detail ------- Row 000001 of 000064
COMMAND ===>
SCROLL ===> DATA
<==
Subpool..................... 55
SPQA Address................ 7F6F9400
Key......................... 8
Allocated <16Mb (Kbytes).... 0
SPQE Address................ 7F6F93E8 Allocated >16Mb (Kbytes).... 8,192
TCB Address................. 008C9A60 Total Allocated (Kbytes).... 8,192
Ownership................... OWN
Free <16Mb.................. 0
Free >16Mb.................. 81,920
Total Free.................. 81,920
DQE
Address
********
7F6F9418
7F6F9448
7F6F9478
7F6F94A8
7F6F94D8
7F6F9508
7F6F9538
7F6F9568
7F6F9598
7F6F95C8
Backing
Storage
********
ANYWHERE
ANYWHERE
ANYWHERE
ANYWHERE
ANYWHERE
ANYWHERE
ANYWHERE
ANYWHERE
ANYWHERE
ANYWHERE
Area
Address
********
115F7000
116E1000
11701000
11721000
11741000
11761000
11781000
117A1000
117C1000
117E1000
Size of
Area
**********
1,280
1,280
1,280
1,280
1,280
1,280
1,280
1,280
1,280
1,280
Data
Address
********
115F7500
116E1500
11701500
11721500
11741500
11761500
11781500
117A1500
117C1500
117E1500
In addition to looking at the first 32 bytes of data, watch for large size DQEs. You can see
repeated allocations of 129,792 bytes, just 1,280 bytes less than 128K. All of the
allocations have an eye catcher of >VECTTBY so now you can use the TCB address to
identify the owner. However, if the subpool were shared (OWN,SHR) among several TCBs,
it would not be so easy to identify the owner. This situation is usually the case with
subpool 0.
Press the END (PF3) key to return to the Allocated Private Subpools screen. Note that the
TCB address owning subpool 55 is 008C9A60. At the Command line, enter the TCBS fastpath command to display the TCB Summary screen, as shown in Figure 17-14. Enter the
BOTTOM primary command, or type MAX on the command line and press the DOWN
(PF8) key to scroll to bottom of the display, where the TCB address for subpool 55 is
located. Note that the program running on that TCB is VENXPGMY. Keep in mind that
there may be several programs that run/ran on a TCB, but in the case of a vendor
product, they will usually all be owned by that vendor.
Figure 17-14. TCB Summary Screen
Abend-AID -------------------- TCB Summary ------------- Row 000010 of 000019
COMMAND ===>
SCROLL ===> DATA
==>
Job Name................. CCFXC410
Number of TCBs........... 14
Abend Date............... 03JUN2003
Number of RBs............ 19
Abend Time............... 11:42:49
R RTM2 Work Area
E TCB Storage
K Linkage Stack
TCB
Address
********
_
_
_
_
_
_
_
_
S Save Area Trace
I EPIE
D TCB Detail
G RB Register Contents
L TCB Load List
C LE Information
RB
RB
Abend Address
Type Program
***** ******** **** ********
008CB7D0 PRB
DFHSIP
008CB498
008CB410 PRB
DFHJCOCP
008B20C8 PRB
DFHAPSIP
008B2AC8
008A2378 PRB
DFHSKTSK
008B2748
008B26C0 PRB
CTCCJCDP
008B2528
008B2460 PRB
CTCCJVUE
008C9A60
008C99C8 PRB
VENXPGMY
008C97D0
<TCB
008FFC10 SVRB
RB>
008FF928 SVRB
***************************** BOTTOM OF DATA










Interrupt Completion I
Offset Code
Code
L
****** ****
*****
*
00CDD2 0001
2
0000B6 0001
2
001066 0006
2
000000 0001
2
0001CA 0001
2
0005C2 0001
2
0001A6 0001
2
000C
S878
2
0033
2
********************************
17-12
Abend-AID for CICS User’s Guide
Now that the owning TCB is identified, the entry point address is displayed in the hope
some copyright information is in the program. Note the data in the Offset column
(X'1A6'), and press the RIGHT (PF11) key to display the right-most portion of the screen.
Use the cursor point-and-shoot feature and press Enter at the second fullword of the data
in the PSW column to display the Storage Disassembly screen, as shown in Figure 17-15.
Figure 17-15. Storage Disassembly Screen
Abend-AID ------------------ Storage Disassembly ----------------------------
COMMAND ===>
SCROLL ===> DATA 

Address
Offset
Object Code
Mnemonic and Operands

115C7F8E 00000000 47F0 C1C8
B
456(,R12)

115C7F92 00000004 0000
DATA

115C7F94 00000006 D4C1 C9D5 7CF8
NC
2517(194,R12),3320(R7)

115C7F9A 0000000C F0F0 0000 D4C1
SRP
0(16,R0),1217(R13),0

115C7FA0 00000012 C9D5
DATA IN

115C7FA2 00000014 7CF8 F2F0
ME
R15,752(R8,R15)

115C7FA6 00000018 0000
DATA

115C7FA8 0000001A D4C1 C9D5 7CF8
NC
2517(194,R12),3320(R7)

115C7FAE 00000020 F4F0
DATA 40

115C7FB0 00000022 5830 D004
L
R3,4(,R13)

115C7FB4 00000026 50F0 3010
ST
R15,16(,R3)

115C7FB8 0000002A 47F0 C1DC
B
476(,R12)

115C7FBC 0000002E 0000
DATA

115C7FBE 00000030 0070
DATA

115C7FC0 00000032 0000
DATA

115C7FC2 00000034 4203 5800
STC
R0,2048(R3,R5)

115C7FC6 00000038 C1D4
DATA AM

115C7FC8 0000003A 181D
LR
R1,R13

115C7FCA 0000003C 58F0 C1D8
L
R15,472(,R12)

115C7FCE 00000040 0A78
SVC
120
FREEMAIN
Use the cursor point-and-shoot feature and press Enter at the address of the PSW to
display the Memory Display. At the Command line, enter -1A6 to move the display back
to the EPA, as shown in Figure 17-16.
Figure 17-16. Memory Display Screen
Abend-AID ------------------- Memory Display -------------------------------- 
COMMAND ===>
SCROLL ===> DATA 

Clip Prev Next Lock

Start Addr: 115C7F8E
Comment: _______________________________________
115C7DE8 area EPVT
sp 251 key 8 ASID 0053
EBCDIC


Address
Offset
Word 1
Word 2
Word 3
Word 4
Storage

115C7DE8 -000001A6 47F0F0A2 E5C5D5E7 D7C7D4E8 40F0F64B * 00sVENXPGMY 06.*

115C7DF8 -00000196 F0F64BF0 F640D7E3 C660F0F3 F0F6F940 *06.06 PTF-03069 *

115C7E08 -00000186 F0F661F2 F261F0F0 7CF0F74B F1F85C5C *06/22/00@07.18***

115C7E18 -00000176 40E5C5D5 C4D6D940 D7D9D6C4 E4C3E340 * VENDOR PRODUCT *

115C7E28 -00000166 E8404DC3 5D40F1F9 F6F06BF2 F0F0F040 *Y (C) 1960,2000 *

115C7E38 -00000156 E5C5D5C4 D6D940E7 40C3D6D9 D74B40E4 *VENDOR X CORP. U*

115C7E48 -00000146 D5D7E4C2 D3C9E2C8 C5C460D9 C9C7C8E3 *NPUBLISHED-RIGHT*

115C7E58 -00000136 E240D9C5 E2C5D9E5 C5C440E4 D5C4C5D9 *S RESERVED UNDER*

115C7E68 -00000126 40E3C8C5 40C3D6D7 E8D9C9C7 C8E340D3 * THE COPYRIGHT L*

115C7E78 -00000116 C1E6E240 D6C640E3 C8C540E4 4BE24B40 *AWS OF THE U.S. *

115C7E88 -00000106 5C5C90EC D00C18CF 47F0C0B4 00000070 *** }
0{ ... *

115C7E98 -000000F6 00004212 5800C0AC 58F0C0B0 1B110A78 *..
.{ 0{
*

115C7EA8 -000000E6 12FF4770 C1EA5010 D00850D0 100418D1 *
A & } &}
J*

115C7EB8 -000000D6 5080D048 41700001 47F0C0E4 00080000 *&"}
. 0{U. ..*

115C7EC8 -000000C6 00006472 5800C0DC 58F0C0E0 1B110A78 *..
.{ 0{\
*

115C7ED8 -000000B6 12FF4770 C1BE1841 5040D06C D2074000 *
A
& }%K .*

Looking in the Storage column at the copyright text, you can see that Vendor X owns
this module, and it is at release 6.6.0 with a PTF level of 03069 dated 06/22/00. Press the
END (PF3) key three times to return to the Allocated Private Subpools screen. Note that
there is another subpool 55 allocation, and its TCB address is 008C97D0. Enter the TCBS
fast-path command to display the TCB Summary screen for this subpool. Enter the
Analyzing MVS Virtual Storage
17-13
BOTTOM primary command, or type MAX on the command line and press the DOWN
(PF8) key to scroll down to the TCB address for this subpool, as shown in Figure 17-17.
Figure 17-17. TCB Summary Screen
Abend-AID -------------------- TCB Summary ------------- Row 000011 of 000019
COMMAND ===>
SCROLL ===> DATA
==> 
Job Name................. CCFXC410
Number of TCBs........... 14
Abend Date............... 03JUN2003
Number of RBs............ 19
Abend Time............... 11:42:49
R RTM2 Work Area
E TCB Storage
K Linkage Stack
S Save Area Trace
I EPIE
D TCB Detail
G RB Register Contents
L TCB Load List
C LE Information
TCB
RB
RB
Address
Abend Address
Type Program
********
***** ******** **** ********
_ 008CB498
008CB410 PRB
DFHJCOCP
_
008B20C8 PRB
DFHAPSIP
_ 008B2AC8
008A2378 PRB
DFHSKTSK
_ 008B2748
008B26C0 PRB
CTCCJCDP
_ 008C9A60
008C99C8 PRB
VENXPGMY
_ 008C97D0
<TCB
008FFC10 SVRB
_
RB>
008FF928 SVRB
_
008A0388 PRB
VENXPGMZ
***************************** BOTTOM OF DATA









Interrupt Completion I
Offset Code
Code
L
****** ****
*****
*
0000B6 0001
2
001066 0006
2
000000 0001
2
0001CA 0001
2
0001A6 0001
2
000C
S0C4
2
0033
2
0001A8 0078
2
********************************
The TCB Summary screen shows this is program VENXPGMZ, and it is also owned by the
same vendor. Enter the E (TCB Storage) line command next to the TCB address to display
all private area subpools allocated by the TCB, as shown in Figure 17-18. The total
amount of storage allocated below, above, and combined by the TCB is shown in the
header.
Figure 17-18. Allocated Private Subpools Screen
Abend-AID --------- Allocated Private Subpools --------- Row 000001 of 000016
COMMAND ===>
SCROLL ===> DATA
==> 
Private Size (Kbytes)....................... 9,196
Extended Private Size (Kbytes).............. 1,831,936
Total Private Allocated (Kbytes)............ 8,604
Total Extended Private Allocated (Kbytes)... 33,936
Total Allocated to TCB <16Mb (Kbytes)....... 1,980
Total Allocated to TCB >16Mb (Kbytes)....... 4,132
Total Amount Allocated to TCB (Kbytes)...... 6,112
Id
***
229
229
229
229
230
230
230
230
230
Key
***
0
5
8
10
0
1
5
8
10
Ownership
*********
OWN
OWN
OWN
OWN
OWN
OWN
OWN
OWN
OWN
TCB
Address
********
008C97D0
008C97D0
008C97D0
008C97D0
008C97D0
008C97D0
008C97D0
008C97D0
008C97D0
Allocated
<16Mb
**********
0K
0K
16K
0K
4K
0K
8K
4K
0K
Percent of
TCB <16Mb
***********
0.000
0.000
0.808
0.000
0.202
0.000
0.404
0.202
0.000
Allocated
>16Mb
**********
0K
0K
0K
0K
8K
4K
4K
4K
8K











Percent of 
TCB >16Mb 
***********
0.000 
0.000 
0.000 
0.000 
0.194 
0.097 
0.097 
0.097 
0.194 
The vendor needs to determine if this is a normal situation; and if it is, to make
recommendations for increasing the limit on user region storage. If it is not normal, then
the vendor needs to remedy the situation.
17-14
Abend-AID for CICS User’s Guide
Note: This scenario is only a simulation and VENXPGMY and VENXPGMZ were written
to show how Abend-AID for CICS Virtual Storage Analysis can be used in such
situations as S878-xx or S80A-xx.
LSQA Analysis
If the over-allocated storage was in MVS high private (LSQA, SWA, or authorized user
subpool), it would be difficult to identify the culprit since these subpools are allocated
indirectly by calls to system/subsystem services. For example, issuing an ATTACH macro
allocates subpool 255 storage for the TCB, or an OPEN macro allocates subpool 230
storage for the DEB. However, the Virtual Storage Map and the Private Area Summary
screens indicate if MVS high private is over-allocated.
Select the VSMAP option (1) from the MVS Storage Analysis menu or enter the VSMAP
fast-path command from any Abend-AID for CICS screen after you have selected the
region dump. The Virtual Storage Map is displayed, as shown in Figure 17-19. Note that
neither user region had hit the highest allocatable address, yet an 878-10 abend had
occurred in this address space. Looking at the Ext Private area, which includes MVS high
private, note that it is only 3.049 percent allocated. The Ext User Region does have a
limit of 131,584K, but is only 33.375 percent allocated, so there is no problem in
extended private.
Figure 17-19. Virtual Storage Map Screen
Abend-AID ------------ Virtual Storage Map ------------- Row 000001 of 000021 
COMMAND ===>
SCROLL ===> DATA 

The Ext User Region had not reached the highest allocatable address.

The Ext CSA had no pages converted to Ext SQA.

The CSA had no pages converted to SQA.

The User Region had not reached the highest allocatable address.


Starting Ending
Size of
Total
Percent

Storage Area
Address
Address
Area
Allocated
Allocated

**************** ******** ******** ********** ********** ***********

Ext Private
13100000 7FFFFFFF 1,784,832K
54,420K
3.049

Ext User Region 13100000 1B17FFFF
131,584K
43,916K
33.375

Ext CSA
0C2C5000 130FFFFF
112,876K
80,084K
70.949

Ext MLPA
00000000 00000000
0K

Ext FLPA
0C2C2000 0C2C4FFF
12K

Ext PLPA
08A3E000 0C2C1FFF
57,872K

Ext SQA
026AD000 08A3DFFF
101,956K
100,724K
98.792

Ext Nuc (R/W)
0165F000 026ACFFF
16,696K

Ext Nuc (R/O)
01000000 0165EFFF
6,524K

- 16Mb Line ---- -------- -------- ---------- ---------- ----------
Nucleus (R/O)
00FD9000 00FFFFFF
156K

Nucleus (R/W)
00FC9000 00FD8FFF
64K

SQA
00CDE000 00FC8FFF
2,988K
2,988K
100.000

Enter the BOTTOM primary command, or type MAX and press the DOWN (PF8) key to
scroll down to display the data for below the line, as shown in Figure 17-20. Looking at
the private area, you will see that it is 99.462 percent allocated, so the problem is below
the line. More importantly, the user region is also limited at 7,680K, yet is only 26.719
percent allocated. This data indicates that the MVS high private is consuming 74.351
percent of the private area (8128K - 2052K = 6076K; 6076K/8172K = 74.351 percent).
Analyzing MVS Virtual Storage
17-15
Figure 17-20. Virtual Storage Map Screen
Abend-AID ------------- Virtual Storage Map ------------ Row 000010 of 000021 
COMMAND ===>
SCROLL ===> DATA 

The Ext User Region had not reached the highest allocatable address.

The Ext CSA had no pages converted to Ext SQA.

The CSA had no pages converted to SQA.

The User Region had not reached the highest allocatable address.


Starting Ending
Size of
Total
Percent

Storage Area
Address
Address
Area
Allocated
Allocated

**************** ******** ******** ********** ********** ***********

- 16Mb Line ---- -------- -------- ---------- ---------- ----------
Nucleus (R/O)
00FD9000 00FFFFFF
156K

Nucleus (R/W)
00FC9000 00FD8FFF
64K

SQA
00CDE000 00FC8FFF
2,988K
2,988K
100.000

PLPA
00BB0000 00CDDFFF
1,208K

FLPA
00BAF000 00BAFFFF
4K

MLPA
00000000 00000000
0K

CSA
00800000 00BAEFFF
3,772K
1,600K
42.418

Private
00005000 007FFFFF
8,172K
8,128K
99.462

User Region
00005000 00784FFF
7,680K
2,052K
26.719

System Region
00001000 00004FFF
16K

PSA
00000000 00000FFF
4K

****************************** BOTTOM OF DATA *********************************
Enter the PVTSUM fast-path command to display the Private Area Summary screen, as
shown in Figure 17-21.
Figure 17-21. Private Area Summary Screen
Abend-AID ------------------ Private Area Summary ----------------------------
COMMAND ===>


LDA Address................ 7FF14EB0

Region Size (Kbytes)....... 7,168

To view the local system queue area select LSQA

To view a list of allocated subpools select List


Extended Private Area
Private Area

Maximum Address............ 7FFFFFFF
Maximum Address............ 007FFFFF

Low MVS Page Address....... 7F532000
Low MVS Page Address....... 0020E000

User Region Limit Address.. 1B17FFFF
User Region Limit Address.. 00784FFF

High User Region Address... 15C69FFF
High User Region Address... 0020DFFF

Starting Address........... 13100000
Starting Address........... 00005000

Maximum Size (Kbytes)...... 1,784,832 Maximum Size (Kbytes)...... 8,172

Limit Size (Kbytes)........ 131,584
Limit Size (Kbytes)........ 7,680

Adjusted Size (Kbytes)..... 131,072
Adjusted Size (Kbytes)..... 7,168

Free Blocks Available...... Yes
Free Blocks Available...... Yes


SM Block Address........... 7F83A000

SM Block Size (Kbytes)..... 7,744

The Private Area Summary screen reveals the storage amounts consumed using addresses.
Note the sequence of the User Region Limit Address and Low MVS Page Address,
indicating that MVS high private storage has gone below the user region limit. Also note
that it could go no lower because the high user region address is right up against it, nor
could the user region go any higher. However, what is significant is how far below the
User Region Limit Address the Low MVS Page Address has gone.
Note:
The LDA reports the current top of user region address as 0020E000.
Use the cursor point-and-shoot feature and press Enter at the LSQA field in the header to
display the LSQA Summary screen, as shown in Figure 17-22.
17-16
Abend-AID for CICS User’s Guide
Figure 17-22. LSQA Summary Screen
Abend-AID ---------------- LSQA Summary ---------------- Row 000001 of 000004 
COMMAND ===>
SCROLL ===> DATA 

LDA Address................ 7FF14EB0

To view a summary of LSQA subpools select Summarize


AQATINDX +---------- DFE Queue Origins -----------+

Sp
Address
Addr <16M Addr >16M Size <16M Size >16M

*** ******** ******************************************

255 7FF15C00 7FF14400
7FF14460
7FF14400
7FF14460

205 7FF15000 -------7FF14580
-------7FF14580

215 7FF15400 -------7FF14520
-------7FF14520

225 7FF15800 -------7FF144C0
-------7FF144C0

****************************** BOTTOM OF DATA *********************************
For a description of the DFE Queue Origins, refer to “SQA Analysis” on page 17-31. Use
the cursor point-and-shoot feature and press Enter at the Summarize field in the header
to display the Summarized LSQA Subpools screen, as shown in Figure 17-23.
Figure 17-23. Summarized LSQA Subpools Screen
Abend-AID ---------- Summarized LSQA Subpools ---------- Row 000001 of 000004 
COMMAND ===>
SCROLL ===> DATA 

Private Size (Kbytes)....................... 8,172

Extended Private Size (Kbytes).............. 1,784,832

Total LSQA Allocated (Kbytes)............... 5,624

Total Extended LSQA Allocated (Kbytes)...... 1,192


Allocated
Percent of
Allocated
Percent of
Total
Percent of 
Id
<16Mb
Total <16Mb >16Mb
Total >16Mb Allocated
<16M + >16M 
*** ********** *********** ********** *********** ********** *********** 
255
5,624K
100.000
292K
24.497
5,916K
86.796

205
0K
0.000
768K
64.430
768K
11.268

215
0K
0.000
120K
10.067
120K
1.761

225
0K
0.000
12K
1.007
12K
0.176

****************************** BOTTOM OF DATA *********************************
Note that subpool 255 has 5624K or 92.560 percent of the 6076K MVS high private
allocated below 16M. Use the cursor point-and-shoot feature and press Enter at subpool
255 to display the LSQA Subpool Detail screen, as shown in Figure 17-24.
Analyzing MVS Virtual Storage
17-17
Figure 17-24. LSQA Subpool Detail Screen










Data
Addr
****
0020
0021
0021
0021
0021
0021
0021
0021
0022
0022
0022
Abend-AID ------------- LSQA Subpool Detail ------------ Row 000001 of 000007
COMMAND ===>
SCROLL ===> DATA
==>
Subpool..................... 255
Allocated <16Mb (Kbytes).... 5,624
AQATINDX Address............ 7FF15C00 Allocated >16Mb (Kbytes).... 292
Non-zero AQATINDX Entries... 3
Total Allocated (Kbytes).... 5,916
Free <16Mb................. 363,576
Free >16Mb................. 21,896
Total Free................. 385,472
Page
Address
********
0020F000
00212000
00213000
00214000
00215000
0021D000
0021E000
0021F000
00220000
00221000
00222000
DFE
Address
********
7F57B748
7F57B6A0
7F57B760
7F57B778
7F57B790
7F57B6E8
7F57B388
7F57B670
7F57B5E0
7F57B688
7F57B550
DFE Area
********
0020F000
00212000
00213000
00214000
00215000
0021D000
0021E000
0021F000
00220000
00221000
00222000
Size of
Area
*********
256
256
1,400
256
256
256
256
256
256
256
256
DFE
Count
******
1
1
1
1
1
1
1
1
1
1
1
AQAT
Address
********
7FF16314
7FF16314
7FF16314
7FF16314
7FF16314
7FF16314
7FF16314
7FF16314
7FF16314
7FF16314
7FF16314
AQAT
Entry
******
32
33
33
33
33
33
33
33
34
34
34
Index
Entry
******
0
0
0
0
0
0
0
0
0
0
0
This screen displays an LSQA page, a DFE address, DFE area, size of area, DFE count (if the
LSQA page has free storage), AQAT information, data address (of first 32 bytes), and the
first 32 bytes of used storage. Having the first 32 bytes of data for each page may aid in
determining what kind of data is being stored in the allocated storage. Press the DOWN
(PF8) key several times to display subsequent pages for data allocated above the 16Mb
boundary. Press the RIGHT (PF11) key to display the right-most portion of the screen.
Enter RTM2 in the first four positions of the mask line under the First 32 Bytes of Data
column heading to display the multiple RTM2 work areas, as shown Figure 17-25.
Figure 17-25. LSQA Subpool Detail Screen, Masked











First 32 Bytes of Data

RTM2****************************
RTM2" & . . " .' . h..k"dg".
RTM2" & . . " .#`Y.
..k"dg".
RTM2" & . . " .' .
..k"dg".
RTM2" & . . " .#`Y."8 ..k"dg".
RTM2" {& . . " .#`Y."9 ..k"dg".
RTM2"$.& . . " .#`Y." ..k"dg".
RTM2"$ & . . " .#@0." ..k" g".
*********************************
Abend-AID ------------- LSQA Subpool Detail ------------ Row 000001 of 000007
COMMAND ===>
SCROLL ===> DATA
<==
Subpool..................... 255
Allocated <16Mb (Kbytes).... 5,624
AQATINDX Address............ 7FF15C00 Allocated >16Mb (Kbytes).... 292
Non-zero AQATINDX Entries... 3
Total Allocated (Kbytes).... 5,916
Free <16Mb................. 363,576
Free >16Mb................. 21,896
Total Free................. 385,472
Page
DFE
AQAT
Index
Data
Address
Address
Entry
Entry
Address
******** ********
****** ****** ********
7F537000 7F5320D0
83
254 7F537050
7F539000 7F57BE80
83
254 7F539050
7F53A000 7F57BBF8
83
254 7F53A050
7F574000 7F57B970
87
254 7F574050
7F57C000 7F57B700
87
254 7F57C050
7F5B0000 7F57BE38
91
254 7F5B0050
7F5B2000 7F57BB38
91
254 7F5B2050
****************************** BOTTOM OF DATA
Use the cursor point-and-shoot feature and press Enter at the Data Address 7F537050
field to display the RTM2WA on the Memory Display, as shown in Figure 17-26.
17-18
Abend-AID for CICS User’s Guide
Figure 17-26. Memory Display Screen
Abend-AID ------------------- Memory Display -------------------------------- 
COMMAND ===>
SCROLL ===> DATA 

Clip Prev Next Lock

Start Addr: 7F537050
Comment:

7F53706D area EPVT
sp 255 key 8 ASID 0053
EBCDIC


Address
Offset
Word 1
Word 2
Word 3
Word 4
Storage

7F53706D +0000001D 87800000 00000000 00000000 00000000 *g"..............*

7F53707D +0000002D 00000000 7D212800 21388800 FBFA3081 *....' . h.
a*

7F53708D +0000003D 4648B284 87800000 00000000 E192807F *
dg".......k""*

7F53709D +0000004D F1300000 00000500 00000400 00087800 *1 .... ... .. .*

7F5370AD +0000005D 00001001 463D907F 5388A012 BD998881 *..
" h
rha*

7F5370BD +0000006D 4648B27F F1300881 4648B200 00001007 *
"1 a
... *

7F5370CD +0000007D 0C100081 4648C400 02000D00 00000000 * .a D. . .....*

7F5370DD +0000008D 00000000 00000000 00000000 00000000 *................*

7F5370ED +0000009D 00000000 00000000 00000000 00000000 *................*

7F5370FD +000000AD 00000000 00000010 04000100 00000000 *....... . .....*

7F53710D +000000BD 00000000 0000007F 71020000 00000100 *......." .... .*

7F53711D +000000CD 213E5000 00000000 00000000 00000000 * &.............*

7F53712D +000000DD 00000000 00000000 00000000 00000000 *................*

7F53713D +000000ED 00000000 00000000 00000000 00000000 *................*

7F53714D +000000FD 00000000 00000000 00000000 00000000 *................*

7F53715D +0000010D 0000007F 53761800 0000007F 53770800 *..."
...."
.*

Enter +1D at the Command line. The RTM2CC at +1D indicates an 878 abend, as do all
the other RTM2 work areas listed after masking for RTM2. Because there were seven 878
abends, look at IEAVMSGS in the nucleus. Enter the NUCMAP fast-path command on the
Command line to display the Nucleus Map screen, as shown Figure 17-27.
Figure 17-27. Nucleus Map Screen
Abend-AID ---------------------- Nucleus Map --------------------- Row 000001 
COMMAND ===>
SCROLL ===> DATA 

NUCMAP Address........................ 01649470

Nucleus suffix (IEANUC0x)............. 1

Number of Read/Write CSECTs........... 76

Number of Read Only CSECTs............ 87

Number of Ext Read Only CSECTs........ 1,614

Number of Ext Read/Write CSECTs....... 121


Entry
CSECT
CSECT

Point
Name
Length
Amode Storage Area

******** ******** ******** ***** ****************

00FC9000 IGC217
000000B0 24
Nucleus (R/W)

00FC90B0 IGC238
00000AA8 24
Nucleus (R/W)

00FC9B58 IGC241
000000E0 24
Nucleus (R/W)

00FC9C38 IGC243
00000088 24
Nucleus (R/W)

00FC9CC0 IGC251
00000AA8 24
Nucleus (R/W)

00FCA768 IECVDDT7 0000004C 24
Nucleus (R/W)

00FCA7B8 IECVOPTB 00000118 24
Nucleus (R/W)

00FCA8D0 IECVPRNT 000004F8 31
Nucleus (R/W)

00FCADC8 IRDVDDT
00000048 24
Nucleus (R/W)

00FCAE10 CBROPDDT 0000004C 24
Nucleus (R/W)

00FCAE60 IECVDDTR 0000021C 24
Nucleus (R/W)
Next, enter IEAVMSGS in the mask line under the CSECT Name column heading to
locate IEAVMSGS. Use the cursor point-and-shoot feature and press Enter at the Entry
Point address to display the Memory Display screen, starting at 01686858, as shown in
Figure 17-28.
Analyzing MVS Virtual Storage
17-19
Figure 17-28. Memory Display Screen
Abend-AID ------------------- Memory Display -------------------------------- 
COMMAND ===>
SCROLL ===> DATA 

Clip Prev Next Lock

Start Addr: 01686858
Comment:

01686858 area ENUC-R/W Mod
key 8 ASID 0053
EBCDIC


Address
Offset
Word 1
Word 2
Word 3
Word 4
Storage

01686858 +00000000 01686B2C 00E19280 007B79E8 00FEBF80 * , ..k".#`Y. "*

01686868 +00000010 00050878 10000000 00E19280 007B79E8 *.
.....k".#`Y*

01686878 +00000020 007B79E8 00141200 00008170 00000000 *.#`Y. ...a ....*

01686888 +00000030 00000000 00E19280 007B7CF0 00FEBF80 *......k".#@0. "*

01686898 +00000040 00050878 10000000 00E19280 007B7CF0 *.
.....k".#@0*

016868A8 +00000050 007B7CF0 007F1200 000049C0 00000000 *.#@0." ... {....*

016868B8 +00000060 00000000 00E19280 007B79E8 00FEBF80 *......k".#`Y. "*

016868C8 +00000070 00050878 10000000 00E19280 007B79E8 *.
.....k".#`Y*

016868D8 +00000080 007B79E8 00E51200 000009D8 00000000 *.#`Y.V ... Q....*

016868E8 +00000090 00000000 00E19280 007B79E8 8A4F14D4 *......k".#`Y | M*

016868F8 +000000A0 00050878 10000000 00E19280 007B79E8 *.
.....k".#`Y*

01686908 +000000B0 007B79E8 00E61200 00002000 00000000 *.#`Y.W ... .....*

01686918 +000000C0 00000000 00E19280 007D2128 00FEBF80 *......k".' . "*

01686928 +000000D0 00050878 10000000 00E19280 007D2128 *.
.....k".' *

01686938 +000000E0 007D2128 00E61200 00002000 00000000 *.' .W ... .....*

01686948 +000000F0 00000000 00E19280 007B79E8 811F4BE8 *......k".#`Ya .Y*

Each entry of the IEA705I message variables is x'30' bytes long. Examining the contents
of each entry using the IBM OS/390 MVS system messages manual indicates GETMAIN
failures for subpools 20, 127, 229, 230, 230, and 229, all below 16M. Although examining
IEAVMSGS may be helpful, it doesn't always indicate that the subpool is over-allocated.
Press the END (PF3) key three times to return to the masked LSQA Subpool Detail screen.
Enter the RESET primary command on the Command line to reset the masking and to
redisplay all of the pages. Press the LEFT (PF10) key to display the left-most portion of the
screen, as shown in Figure 17-29.
Figure 17-29. LSQA Subpool Detail Screen
Abend-AID ------------- LSQA Subpool Detail ------------ Row 000001 of 001479
COMMAND ===>
SCROLL ===> DATA
==> 
Subpool..................... 255
Allocated <16Mb (Kbytes).... 5,624
AQATINDX Address............ 7FF15C00 Allocated >16Mb (Kbytes).... 292
Non-zero AQATINDX Entries... 3
Total Allocated (Kbytes).... 5,916
Free <16Mb................. 363,576
Free >16Mb................. 21,896
Total Free................. 385,472
Page
Address
********
0020F000
00212000
00213000
00214000
00215000
0021D000
0021E000
0021F000
00220000
00221000
00222000
DFE
Address
********
7F57B748
7F57B6A0
7F57B760
7F57B778
7F57B790
7F57B6E8
7F57B388
7F57B670
7F57B5E0
7F57B688
7F57B550
DFE Area
********
0020F000
00212000
00213000
00214000
00215000
0021D000
0021E000
0021F000
00220000
00221000
00222000
Size of
Area
*********
256
256
1,400
256
256
256
256
256
256
256
256
DFE
Count
******
1
1
1
1
1
1
1
1
1
1
1
AQAT
Address
********
7FF16314
7FF16314
7FF16314
7FF16314
7FF16314
7FF16314
7FF16314
7FF16314
7FF16314
7FF16314
7FF16314
AQAT
Entry
******
32
33
33
33
33
33
33
33
34
34
34
Index
Entry
******
0
0
0
0
0
0
0
0
0
0
0









Data
Addr
****
0020
0021
0021
0021
0021
0021
0021
0021
0022
0022
0022
Scrolling down the list of allocated pages, note that many have a DFE area address at the
beginning with an area size equal to 256. Enter 256 in the last three positions of the
mask line under the Size of Area column heading to reveal that 1354 out of 1479 pages
have the first 256 bytes free, a suspicious pattern, as shown Figure 17-30.
17-20
Abend-AID for CICS User’s Guide
Figure 17-30. LSQA Subpool Detail Screen, Masked
Abend-AID ------------- LSQA Subpool Detail ------------ Row 000001 of 001354
COMMAND ===>
SCROLL ===> DATA
==> 
Subpool..................... 255
Allocated <16Mb (Kbytes).... 5,624
AQATINDX Address............ 7FF15C00 Allocated >16Mb (Kbytes).... 292
Non-zero AQATINDX Entries... 3
Total Allocated (Kbytes).... 5,916
Free <16Mb................. 363,576
Free >16Mb................. 21,896
Total Free................. 385,472
Page
Address
********
0020F000
00212000
00214000
00215000
0021D000
0021E000
0021F000
00220000
00221000
00222000
00223000
DFE
Address
********
7F57B748
7F57B6A0
7F57B778
7F57B790
7F57B6E8
7F57B388
7F57B670
7F57B5E0
7F57B688
7F57B550
7F57B580
DFE Area
********
0020F000
00212000
00214000
00215000
0021D000
0021E000
0021F000
00220000
00221000
00222000
00223000
Size of
Area
******256
256
256
256
256
256
256
256
256
256
256
256
DFE
Count
******
1
1
1
1
1
1
1
1
1
1
1
AQAT
Address
********
7FF16314
7FF16314
7FF16314
7FF16314
7FF16314
7FF16314
7FF16314
7FF16314
7FF16314
7FF16314
7FF16314
AQAT
Entry
******
32
33
33
33
33
33
33
34
34
34
34
Index
Entry
******
0
0
0
0
0
0
0
0
0
0
0









Data
Addr
****
0020
0021
0021
0021
0021
0021
0021
0022
0022
0022
0022
Press the RIGHT (PF11) key to display the right-most portion of the screen. Use the cursor
point-and-shoot feature and press Enter at 0020F100 in the Data Address column to
display the Memory Display, as shown in Figure 17-31.
Figure 17-31. Memory Display Screen
Abend-AID ------------------- Memory Display -------------------------------- 
COMMAND ===>
SCROLL ===> DATA 

Clip Prev Next Lock

Start Addr: 0020F100
Comment:

0020F100 area PVT
sp 255 key 8 ASID 0053
EBCDIC


Address
Offset
Word 1
Word 2
Word 3
Word 4
Storage

0020F100 +00000000 0020F130 134D8E1A 10000000 8065A098 *. 1 (
..." q*

0020F110 +00000010 0380DB00 0020F118 00C00000 00000000 * " .. 1 .{......*

0020F120 +00000020 00000000 1590ED20 00000000 7F6F6158 *....
...."?/ *

0020F130 +00000030 0020F160 134D8E1A 10000000 8065A098 *. 1- (
..." q*

0020F140 +00000040 0380DB00 0020F148 00C00000 00000000 * " .. 1 .{......*

0020F150 +00000050 00000000 1590ED20 00000000 7F6F6158 *....
...."?/ *

0020F160 +00000060 0020F190 134D8E1A 10000000 8065A098 *. 1 (
..." q*

0020F170 +00000070 0380DB00 0020F178 00C00000 00000000 * " .. 1 .{......*

0020F180 +00000080 00000000 1590ED20 00000000 7F6F6158 *....
...."?/ *

0020F190 +00000090 0020F1C0 134D8E1A 10000000 8065A098 *. 1{ (
..." q*

0020F1A0 +000000A0 0380DB00 0020F1A8 00C00000 00000000 * " .. 1y.{......*

0020F1B0 +000000B0 00000000 1590ED20 00000000 7F6F6158 *....
...."?/ *

0020F1C0 +000000C0 0020F1F0 134D8E1A 10000000 8065A098 *. 10 (
..." q*

0020F1D0 +000000D0 0380DB00 0020F1D8 00C00000 00000000 * " .. 1Q.{......*

0020F1E0 +000000E0 00000000 1590ED20 00000000 7F6F6158 *....
...."?/ *

0020F1F0 +000000F0 0020F220 134D8E1A 10000000 8065A098 *. 2 (
..." q*

At 0020F100 is the address 0020F130; at 0020F130 is 0020F160, and so on. These
addresses appear to be a chain of control blocks x'30' in length. At 0020F104 is a pointer
(address) into a vendor program. Upon contacting the vendor, they identified it as an
ESTAE routine. The chain of control blocks were SCBs created when the vendor
repeatedly issued the ESTAE macro without deactivation in between.
Analyzing MVS Virtual Storage
17-21
Enhanced Memory Display
The enhancement to the Abend-AID for CICS Memory Display allows you to determine
the storage subpools of the CICS dynamic storage areas (DSAs). From the Command line
of any region dump screen, enter DSA to display the Dynamic Storage Area Summary
screen, as shown in Figure 17-32.
Figure 17-32. Dynamic Storage Area Summary Screen
Abend-AID -------- Dynamic Storage Area Summary -------- Row 000001 of 000008 
COMMAND ===>
SCROLL ===> DATA 

First Task Subpool SCA.... 1151CD7C
First Domain Subpool SCA.... 1152C674

Last Task Subpool SCA..... 1152EAAC
Last Domain Subpool SCA..... 1152D674


D Domain Subpool Summary


DSA
Total Pages

Name
DSA Size
Available

*****
********
********

CDSA
768K
192

UDSA
256K
64

SDSA
256K
64

RDSA
512K
128

ECDSA
4096K
1024

EUDSA
1024K
256

ESDSA
0K
0

ERDSA
3072K
768

***************************** BOTTOM OF DATA ********************************
Use the cursor point-and-shoot feature and press Enter at any of the CICS DSA names to
display the Dynamic Storage Area Detail screen, as shown in Figure 17-33.
Figure 17-33. Dynamic Storage Area Detail Screen
Abend-AID --------- Dynamic Storage Area Detail -------- Row 000001 of 000003 
COMMAND ===>
SCROLL ===> DATA 

DSA Name............ CDSA
Free Page Low Water Mark.... 0

DSA Size (Kilobytes) 768
"NOSTG" Returned Count...... 0

Number of Pages..... 192
Total Number of Suspends.... 0

PPA Address......... 103E9580
Current Number Suspended.... 0

Access.............. CICS
High Water Mark Suspended... 0


Currently SOS....... NO
SOS Cushion Released Count.. 0

SOS Count........... 0
Storage Violation Count..... 0

Time Spent SOS...... 00:00:00.000


The following extents are allocated to the DSA:


Start
End

Size
Address
Address

******** ******** ********

256K 00040000 0007FFFF

256K 00100000 0013FFFF

256K 00140000 0017FFFF

****************************** BOTTOM OF DATA *********************************
Use the cursor point-and-shoot feature and press Enter at any extent starting address to
display the Memory Display screen, as shown in Figure 17-34.
17-22
Abend-AID for CICS User’s Guide
Figure 17-34. Memory Display Screen, Page
Abend-AID ------------------- Memory Display --------------------------------
COMMAND ===>
SCROLL ===> DATA 

Clip Prev Next Lock

Start Addr: 00140000
Comment:

00140000 area PVT
sp 251 key 8 ASID 0053
EBCDIC


Address
Offset
Word 1
Word 2
Word 3
Word 4
Storage

00140000 +00000000 5CC4C6C8 D1C3D640 40801400 20F0F4F1 **DFHJCO " . 041*

00140010 +00000010 F0C90814 0917E4D8 F0F9F2F7 F8401400 *0I
UQ09278 .*

00140020 +00000020 58D0021C 58D0D0D0 58D0D014 58D0D008 * }
}}} }} }} *

00140030 +00000030 58C0D04C 50E0C034 58E0C010 90FDE010 * {}<&\{ \{
\ *

00140040 +00000040 D203E00C C0340DB0 4120B388 48020004 *K \ {
h . *

00140050 +00000050 58FC01A4 0DEF41F0 06B841E1 00801B00 *
u
0
.." .*

00140060 +00000060 1B110EE0 5810C010 0DB041A0 BFFE4130 *
\ {
*

00140070 +00000070 AFFE1891 5870C0D4 58807028 41100232 *
j {M "
*

00140080 +00000080 18F14100 937041E0 37020E0E 5810D08C * 1 .l \
} *

00140090 +00000090 D2019374 80589501 80024780 B040D207 *K l " n " " K *

001400A0 +000000A0 93823572 D201938A 93744100 95045000 *lb K l l .n &.*

001400B0 +000000B0 939C4100 938C5000 93A84100 93CC5000 *l .l &.ly .l &.*

001400C0 +000000C0 91944100 94345000 91984100 949C5000 *jm .m &.jq .m &.*

001400D0 +000000D0 919C9280 91A09280 91949280 91989280 *j k"j k"jmk"jqk"*

001400E0 +000000E0 919C9200 700B9140 70094710 B0A89120 *j k. j
yj *

001400F0 +000000F0 80184710 B0C49110 80194710 33AC9118 *"
Dj "
j *

Note the line of data below the Start Addr: field in the header. Whatever address is
displayed in the Start Addr: field initially is echoed as well as matches the first line
under the Address column. If you subsequently enter +32, -210, and so on, the address
on this line is updated to reflect the offset specified following the plus/minus sign (+/-).
The bytes remaining value is also updated, but in the direction opposite the plus/minus
sign. For example, if you enter +23, the following lines are displayed. The address in this
line now echoes the first line under the Address column, but the Start Addr: remains the
same as it always has, as shown in Figure 17-35.
Figure 17-35. Memory Display Screen, Page 2
Abend-AID ------------------- Memory Display -------------------------------- 
COMMAND ===>
SCROLL ===> DATA 

Clip Prev Next Lock

Start Addr: 00140000
Comment:

00140023 area PVT
sp 251 key 8 ASID 0053
EBCDIC


Address
Offset
Word 1
Word 2
Word 3
Word 4
Storage

00140023 +00000023 1C58D0D0 D058D0D0 1458D0D0 0858C0D0 * }}} }} }} {}*

00140033 +00000033 4C50E0C0 3458E0C0 1090FDE0 10D203E0 *<&\{ \{
\ K \*

00140043 +00000043 0CC0340D B04120B3 88480200 0458FC01 * {
h .
*

00140053 +00000053 A40DEF41 F006B841 E100801B 001B110E *u
0
.." .
*

00140063 +00000063 E05810C0 100DB041 A0BFFE41 30AFFE18 *\ {
*

00140073 +00000073 915870C0 D4588070 28411002 3218F141 *j {M "
1 *

00140083 +00000083 00937041 E037020E 0E5810D0 8CD20193 *.l \
} K l*

00140093 +00000093 74805895 01800247 80B040D2 07938235 * " n " " K lb *

001400A3 +000000A3 72D20193 8A937441 00950450 00939C41 * K l l .n &.l *

001400B3 +000000B3 00938C50 0093A841 0093CC50 00919441 *.l &.ly .l &.jm *

001400C3 +000000C3 00943450 00919841 00949C50 00919C92 *.m &.jq .m &.j k*

001400D3 +000000D3 8091A092 80919492 80919892 80919C92 *"j k"jmk"jqk"j k*

001400E3 +000000E3 00700B91 40700947 10B0A891 20801847 *. j
yj " *

001400F3 +000000F3 10B0C491 10801947 1033AC91 18801A47 * Dj "
j " *

00140103 +00000103 E033AC91 09700947 10B0C447 F033AC95 *\ j
D 0 n*

00140113 +00000113 49700947 7033A491 18801A47 E033A491 *
uj " \ uj*

If the offset goes past the bytes remaining in the allocation or before the start of the
allocation, the subpool/key is updated. For example, if you enter +7FFF0, the following
line is displayed, as shown in Figure 17-36.
Analyzing MVS Virtual Storage
17-23
Figure 17-36. Memory Display Screen, Page 3
Abend-AID ------------------- Memory Display -------------------------------- 
COMMAND ===>
SCROLL ===> DATA 

Clip Prev Next Lock

Start Addr: 00140000
Comment:

001C0013 area PVT
sp 252 key 8 ASID 0053
EBCDIC


Address
Offset
Word 1
Word 2
Word 3
Word 4
Storage

001C0013 +00080013 0458F0F0 D058F0F0 1458F0F0 0C58FF00 * 00} 00 00
.*

001C0023 +00080023 0C07FF00 00000000 000000C9 C7E9C3D7 *
........IGZCP*

001C0033 +00080033 C3C34042 00C3F2F4 4BF0F0F1 61F0F661 *CC .C24.001/06/*

001C0043 +00080043 F9F340F2 F24BF0F9 404040D5 00000000 *93 22.09
N....*

001C0053 +00080053 00801C4D 08801C48 F0801C47 08801C45 *." ( " 0"
" *

001C0063 +00080063 20000000 00000000 00000000 00801C82 * ............" b*

001C0073 +00080073 58801C50 C0801C0D D8000000 00801C85 * " &{" Q...." e*

001C0083 +00080083 38801C34 28000000 00801C40 A8801C21 * "
...." y" *

001C0093 +00080093 F8000000 00000000 00000000 00000000 *8...............*

001C00A3 +000800A3 00000000 00000000 00801C7A 28801C79 *........." : " `*

001C00B3 +000800B3 48801C65 40801C11 08000000 00801C81 * "
"
...." a*

001C00C3 +000800C3 60801C59 C0801C55 10801C54 B0000000 *-" {"
"
...*

001C00D3 +000800D3 00000000 00000000 00000000 00801C01 *............." *

001C00E3 +000800E3 48000000 00801C7C 78000000 00000000 * ...." @ .......*

001C00F3 +000800F3 00801C4F 78FFFFFF FFFFFFFF FFFFFFFF *." |
*

001C0103 +00080103 FFFFFFFF FFFFFFFF FFFFFFFF FFFFFFFF *
*

If the new address traverses a VSM area, the area is updated. Enter the PVTSUM fast-path
command to display the Private Area Summary screen, as shown in Figure 17-37.
Figure 17-37. Private Area Summary Screen
Abend-AID ------------------ Private Area Summary ----------------------------
COMMAND ===>


LDA Address................ 7FF15EB0

Region Size (Kbytes)....... 8,192

To view the local system queue area select LSQA

To view a list of allocated subpools select List


Extended Private Area
Private Area

Maximum Address............ 7FFFFFFF
Maximum Address............ 008FFFFF

User Region Limit Address.. 7FFFFFFF
User Region Limit Address.. 008FFFFF
Low MVS Page Address....... 7F68C000
Low MVS Page Address....... 00899000

High User Region Address... 122FFFFF
High User Region Address... 00814FFF

Starting Address........... 10300000
Starting Address........... 00005000

Maximum Size (Kbytes)...... 1,831,936 Maximum Size (Kbytes)...... 9,196

Limit Size (Kbytes)........ 32,768
Limit Size (Kbytes)........ 8,256

Adjusted Size (Kbytes)..... 32,768
Adjusted Size (Kbytes)..... 8,192

Free Blocks Available...... Yes
Free Blocks Available...... Yes


SM Block Address........... 7F80C000

SM Block Size (Kbytes)..... 7,932

Note that the extended private area started at 10300000. Use the cursor point-and-shoot
feature and press Enter at this address to display the Memory Display screen, as shown in
Figure 17-38.
17-24
Abend-AID for CICS User’s Guide
Figure 17-38. Memory Display Screen, Page 1
Abend-AID ------------------- Memory Display --------------------------------
COMMAND ===>
SCROLL ===> DATA 

Clip Prev Next Lock

Start Addr: 10300000
Comment:

10300000 area EPVT
sp 252 key 8 ASID 0053
EBCDIC


Address
Offset
Word 1
Word 2
Word 3
Word 4
Storage

10300000 +00000000 00486ED4 D6C4C8C5 C1C403D7 00F4F1F0 *. >MODHEAD P.410*

10300010 +00000010 C4C6C8D2 C5C4C3D3 F1F061F1 F161F9F6 *DFHKEDCL10/11/96*

10300020 +00000020 7CF1F44B F4F40001 00000000 E4D5F9F6 *@14.44. ....UN96*

10300030 +00000030 F4F7F640 FFFFFFFF 00000001 00000400 *476
... .. .*

10300040 +00000040 00008000 00000008 07000700 07000700 *..".... . . . .*

10300050 +00000050 07000700 07000700 07000700 07000700 * . . . . . . . .*

10300060 +00000060 07000700 07000700 07000700 07000700 * . . . . . . . .*

10300070 +00000070 07000700 07000700 07000700 07000700 * . . . . . . . .*

10300080 +00000080 90EDD00C 183D18E0 98453050 88E00006 * }
\q &h\. *

10300090 +00000090 182089E0 00088920 0002416E 52085892 * i\. i . >
k*

103000A0 +000000A0 523058A0 40305820 904058D0 A0605800 *
} - .*

103000B0 +000000B0 6010418D 20005980 402C4720 F0FE50D0 *. "
0 &}*

103000C0 +000000C0 40301F77 91805100 4780F070 9108403C *
j" . "0 j
*

103000D0 +000000D0 4710F070 9120403C 4780F064 58706018 * 0 j
"0
- *

103000E0 +000000E0 47F0F070 91405100 4780F070 58706014 * 00 j . "0
- *

103000F0 +000000F0 9023D000 904AD050 50D04018 91025055 * }. ¢}&&} j & *

Enter -1 at the command line to display the screen with the VSM area updated to ECSA,
as shown in Figure 17-39.
Figure 17-39. Memory Display Screen, Page 2
Abend-AID ------------------- Memory Display -------------------------------- 
COMMAND ===>
SCROLL ===> DATA 

Clip Prev Next Lock

Start Addr: 10300000
Comment:

102FFFFF area ECSA
sp 241 key 0 ASID 0053
EBCDIC


Address
Offset
Word 1
Word 2
Word 3
Word 4
Storage

102FFFFF -00000001 0000486E D4D6C4C8 C5C1C403 D700F4F1 *.. >MODHEAD P.41*

1030000F +0000000F F0C4C6C8 D2C5C4C3 D3F1F061 F1F161F9 *0DFHKEDCL10/11/9*

1030001F +0000001F F67CF1F4 4BF4F400 01000000 00E4D5F9 *6@14.44. ....UN9*

1030002F +0000002F F6F4F7F6 40FFFFFF FF000000 01000004 *6476
... .. *

1030003F +0000003F 00000080 00000000 08070007 00070007 *...".... . . . *

1030004F +0000004F 00070007 00070007 00070007 00070007 *. . . . . . . . *

1030005F +0000005F 00070007 00070007 00070007 00070007 *. . . . . . . . *

1030006F +0000006F 00070007 00070007 00070007 00070007 *. . . . . . . . *

1030007F +0000007F 0090EDD0 0C183D18 E0984530 5088E000 *. }
\q &h\.*

1030008F +0000008F 06182089 E0000889 20000241 6E520858 *
i\. i . >
*

1030009F +0000009F 92523058 A0403058 20904058 D0A06058 *k
} - *

103000AF +000000AF 00601041 8D200059 80402C47 20F0FE50 *.. "
0 &*

103000BF +000000BF D040301F 77918051 004780F0 70910840 *}
j" . "0 j *

103000CF +000000CF 3C4710F0 70912040 3C4780F0 64587060 *
0 j
"0
-*

103000DF +000000DF 1847F0F0 70914051 004780F0 70587060 * 00 j . "0
-*

103000EF +000000EF 149023D0 00904AD0 5050D040 18910250 *
}. ¢}&&} j &*

For an address in the LPA or Nucleus, a module name is displayed. Also note that if the
address is not found in the SVC dump dataset, the text is not found in the SDUMP dataset is
displayed instead of the text is not allocated storage so you can determine if the storage is
logically not allocated versus physically not dumped. The line at the top of the screen
represents the logical allocation, while the line below the column heading represents the
physical status, as shown in Figure 17-40.
Analyzing MVS Virtual Storage
17-25
Figure 17-40. Memory Display Screen, Page 3
Abend-AID -------------------- Memory Display ------------------------------- 
COMMAND ===>
SCROLL ===> DATA 

Clip Prev Next Lock

Start Addr: 04E2C3C8
Comment:

04E2C3C8 area EPLPA
sp 251 key 8 ASID 0053
EBCDIC


Address
Offset
Word 1
Word 2
Word 3
Word 4
Storage

04E2C3C8 :065CEFF is not found in the SDUMP dataset

065CF000 +017A2C38 05F047F0 F01C16C9 C5C6C4C2 F4F0F040 * 0 00 IEFDB400 *

065CF010 +017A2C48 F0F0F0F2 F740E4E6 F6F7F1F2 F60005C0 *00027 UW67126. {*

065CF020 +017A2C58 4130CFFF 185F18A1 186041F0 00E65800 *
¬ ~ - 0.W .*

065CF030 +017A2C68 3D75B20B 0000B20A 00105800 3D7147F0 *
.. . .
0*

065CF040 +017A2C78 C0280700 00FFFFFF 41100001 131141F0 *{ ..
.
0*

065CF050 +017A2C88 0FA018E0 54E0C024 19EF4720 C058181D *
\ \{
{
*

065CF060 +017A2C98 58F0C050 070005EF 47F0C068 47F0C05C * 0{& .
0{ 0{**

065CF070 +017A2CA8 065D1244 065D1262 41E00000 0A0A120E * )
)
\..
*

065CF080 +017A2CB8 58F0C054 4770C046 18B1181A 180650D0 * 0{
{
&}*

065CF090 +017A2CC8 B0044220 BE4218F5 18DB5040 B0EC58A0 *
5 &
*

065CF0A0 +017A2CD8 40005860 A0245070 B0AC181A 1FAABFA7 * . - &
x*

065CF0B0 +017A2CE8 101D181A D200B430 10111F00 4300B430 *
K.
. . *

065CF0C0 +017A2CF8 1F224320 3C001402 4200B430 91801014 *
.
. j" *

065CF0D0 +017A2D08 47E0C0BC 9680B3D0 47F0C0C0 947FB3D0 * \{ o" } 0{{m" }*

065CF0E0 +017A2D18 9180B3D0 4770C0CC 54603BBD 50D0B0D4 *j" } { - &} M*

If an address lies between allocations, the text ‘not allocated’ is displayed and the bytes
remaining reflects the number of bytes before the next allocation.
Common Storage Analysis
Like the private areas, the common storage areas -- common service area (CSA) and
system queue area (SQA) -- can also be over-allocated. The anchor block used by VSM for
the CSA and SQA is the global data area (GDA). The CSA contains data addressable by all
active virtual storage address spaces. The size of the CSA is directly specified. The SQA is
like the LSQA except on a global basis. It contains tables and queues relating to the entire
system, but unlike the LSQA, its size is directly specified. If the SQA becomes 100 percent
allocated, pages are borrowed or converted from CSA storage. Such pages are flagged with >
for SQA pages converted from CSA, and with < for ESQA pages converted from ECSA.
Refer to the discussion of the Allocated Storage Map in “Allocated Storage Map” on page
17-42 for information on how to locate these converted pages. Since a shortage of SQA
causes borrowing of CSA, you may also experience a CSA shortage.
The S878 and S80A abend codes also pertain to CSA and SQA, but are indicated using
different reason codes. Requests for VSM services that fail due to a common storage
shortage are indicated by an SC78 abend code. Ownership of common storage is at the
address space level, as opposed to the task (TCB) level for private storage. Identifying
ownership requires that common storage tracking be active. The VSM TRACK parameter
in the DIAGxx member of SYS1.PARMLIB is used to control common storage tracking.
The SVC dump used in this example was reported as a CSA storage creep; that is, CSA
storage was being GETMAINed without being FREEMAINed. The best place to start is the
Virtual Storage Map, which you can access from the MVS Storage Analysis menu or by
entering the VSMAP fast-path command from any Command line, once you have
selected the dump, as shown in Figure 17-41. Enter the BOTTOM primary command, or
type MAX and press the Down (PF8) key to display the data for the CSA that is below the
16 Mb boundary.
17-26
Abend-AID for CICS User’s Guide
Figure 17-41. Virtual Storage Map Screen
Abend-AID ------------- Virtual Storage Map ------------ Row 000003 of 000021 
COMMAND ===>
SCROLL ===> DATA 

The Ext User Region had not reached the highest allocatable address.

The Ext CSA had pages converted to Ext SQA.

The CSA had pages converted to SQA.

The User Region had not reached the highest allocatable address.


Starting Ending
Size of
Total
Percent

Storage Area
Address
Address
Area
Allocated
Allocated

**************** ******** ******** ********** ********** ***********

Ext CSA
05597000 0B7FFFFF
100,772K
79,584K
78.974

Ext MLPA
05497000 05596FFF
1,024K

Ext FLPA
05494000 05496FFF
12K

Ext PLPA
02988000 05493FFF
44,080K

Ext SQA
019E4000 02987FFF
16,016K
19,392K
121.079

Ext Nuc (R/W)
0151F000 019E3FFF
4,884K

Ext Nuc (R/O)
01000000 0151EFFF
5,244K

- 16Mb Line ---- -------- -------- ---------- ---------- ----------
Nucleus (R/O)
00FDB000 00FFFFFF
148K

Nucleus (R/W)
00FC8000 00FDAFFF
76K

SQA
00E98000 00FC7FFF
1,216K
1,980K
162.829

PLPA
00C6C000 00E97FFF
2,224K

FLPA
00C69000 00C6BFFF
12K
In the header on the Virtual Storage Map, note that both the extended CSA and CSA had
pages converted to extended SQA and SQA. From the scrollable area, the extended SQA is
at 121.079 percent, and the SQA is at 162.829 percent allocated. Because CSA pages are
converted to SQA when required, the percentages of E/SQA can be greater than 100
percent. You need to add these converted pages to the total allocated for extended CSA
and CSA to determine the true amounts of extended CSA and CSA allocated.
To determine the number of converted CSA pages, use the cursor point-and-shoot feature
and press Enter at either the Ext SQA or SQA field under the Storage Area column, or
enter the SQASUM fast-path command on any Command line to display the SQA
Summary screen, as shown in Figure 17-42.
Figure 17-42. SQA Summary Screen
Abend-AID ----------------- SQA Summary ---------------- Row 000001 of 000005 
COMMAND ===>
SCROLL ===> DATA 

GDA Address................ 021E41A0

SM Block Address........... 021E4000

SM Block Size (Kbytes)..... 40

SQA Tracking Status........ Active

To view a summary of SQA subpools select Summarize


Extended System Queue Area
System Queue Area

Maximum Address (defined).. 02987FFF
Maximum Address (defined).. 00FC7FFF

Defined Size (Kbytes)...... 16,016
Defined Size (Kbytes)...... 1,216

Starting Address........... 019E4000
Starting Address........... 00E98000

ECSA to ESQA (Kbytes)...... 4,120
CSA to SQA (Kbytes)........ 764


AQATINDX +---------- DFE Queue Origins -----------+

Sp
Address
Addr <16M Addr >16M Size <16M Size >16M

*** ******** ******************************************

226 021E73B0 021EAF44
-------021EAF44
-------
239 021E6FB0 021EAA94
021EACEC
021EAA94
021EACEC

245 021E6BB0 021EA5E4
021EA83C
021EA5E4
021EA83C

247 021E77B0 -------021EB19C
-------021EB19C

248 021E7BB0 -------021EB3F4
-------021EB3F4

****************************** BOTTOM OF DATA *********************************
In the header on the SQA Summary screen, note the amounts of ECSA converted to ESQA
and CSA converted to SQA. These may or may not equal the difference between the
allocated amounts and sizes of the SQA areas. The amount of extended CSA converted to
extended SQA is 4,120K, and the amount of CSA converted to SQA is 764K. Adding
Analyzing MVS Virtual Storage
17-27
4,120K to the 79,584K allocated to extended CSA gives 83,704K. Dividing that by the size
of the extended CSA at 100,772K reveals the extended CSA is 83.063 percent allocated.
Adding 764K to the 3,668K allocated to CSA gives 4,432K or 100 percent of the CSA is
allocated. What appeared to be a CSA shortage had actually been caused by the
borrowing of CSA pages for SQA. Had a true CSA shortage occurred, the amounts of
converted CSA would be none at all. The following sections describe ways to determine
the SQA allocators and allocations.
Common Storage Users
The address of the global data area (GDA) is displayed in the header on the SQA Summary
screen (Figure 17-42). This area is the VSM anchor block that contains information on
system-related virtual storage -- in particular, the SQA and CSA subpools. The SQA
tracking status is listed as either Active or Inactive at the time the SVC dump was taken.
If Active, a list of address spaces that had allocated SQA is available. Use the cursor pointand-shoot feature and press Enter at the Active field to display the Common Storage
Users screen, as shown in Figure 17-43. Use the Common Storage Users screen for a CSA
shortage, providing CSA tracking is active.
Figure 17-43. Common Storage Users Screen
Abend-AID ------------------ Common Storage Users ---------------- Row 000001 
COMMAND ===>
SCROLL ===> DATA

==> 
Total CSA
Total SQA
Total ESQA
Total ECSA

System
18,312
789,056
13,176,976
3,302,432

Active
3,027,288
621,960
5,030,624
72,545,872

Owner Gone
372,400
439,856
509,136
4,399,848

------------------ ------------ ------------ ------------ -----------
Totals from CAUBs
3,418,000
1,850,872
18,716,736
80,248,152

Totals from GDA
3,418,000
1,850,872
18,716,736
80,248,152

Differences
0
0
0
0


ASID Name
Id
Status
Total CSA Total ECSA Status
Total SQA Tot
**** ******** ******** ****** ********** ********** ****** ********** ***
0000 *SYSTEM*
18,312
3,302,432
789,056 13,
0000 *UNKNOW*
0
0
0

0001 *MASTER*
127,784
2,200,552
193,104
2,
0002 PCAUTH
0
0
80

0003 RASP
0
0
0

0004 TRACE
0
0
0

0005 DMSAR
STC03675
0
336
0

0005 DUMPSRV
0
144
0

0006 XCFAS
0
2,184
160

In the header, note the summary of the amounts of allocated common storage found in
the common area user blocks (CAUBs). It lists amounts for system-owned, for active
CAUBs found, and for owner-gone (terminated address space) CAUBs found. The
Differences data are the difference between the amounts from the CAUBs and the
amounts from fields found in the GDA. The CAUB cell pool address is the first cell
(block) of storage that contains the CAUBs, of which there are five types:
• The system CAUB describes storage owned by the system, which occurs when it would
not be possible or would be misleading to assign ownership to the job running in the
home address space. Also, when some operating system components GETMAIN
storage, they explicitly indicate that ownership should be assigned to the system.
• An address space CAUB describes storage obtained by an initiator address space during
the time it is between jobs.
• A job CAUB describes storage obtained when the address space in which the job is
running is the home address space. These can be further classified as active or gone.
17-28
Abend-AID for CICS User’s Guide
• An owner gone CAUB describes storage obtained without being freed before the address
space terminated. These are linked together on the "unowned" queue and can further
be classified as job or address space.
• The no detail CAUB describes storage that was in use when CSA tracking was being
either turned on or off.
Address spaces that allocated CSA and/or SQA are listed in the scrollable area of the
screen. By default the screen is sorted by ASID. Any given ASID can appear more than
once because ASCBs are reused when address spaces initialize and terminate. The job or
started task name from the ASCB is listed, as is the job ID from the JSAB. The job ID is
null for entities started under the master scheduler subsystem. The amounts of E/CSA
and E/SQA (total) are listed, which you can sort to find address spaces allocating the most
of each area. The date (0YYYYDDD) and time (HHMMSSth) of termination are listed for
address spaces that terminated without freeing their common storage allocations. Use the
job ID, date/time of termination, along with a system log to determine the reason for
termination.
Because the CSA had been 100 percent allocated, the primary concern is SQA and then
extended SQA. To locate the address space allocating the most SQA, sort on the Total SQA
column heading by Type SORT on the Command line, place the cursor on the Total SQA
column heading and press Enter. Because the sort order is low to high, enter the
BOTTOM primary command, or type MAX on the Command line and press the DOWN
(PF8) key to scroll down to the bottom to see the address spaces using the most SQA, as
shown in Figure 17-44.
Figure 17-44. Common Storage Users, Sorted by Total SQA












ASID Name
Id
Status
Total CSA Total ECSA Status
Total SQA Tot
**** ******** ******** ****** ********** ********** ****** ********** ***
00B7 PDSM00
STC00413
368
123,072
15,424

00A3 NETVIEW STC00312
5,408
132,384
20,824

00C1 CA7ONL
STC01094
6,736
3,216
25,856

00A6 OMIIETE STC00318
72
12,352
29,552

0090 MIMSDSI STC00214
5,568
10,208
55,016

0001 *MASTER*
127,784
2,200,552
193,104
2,
0122 NPM
STC02207
50,856
669,728
213,056

00AE FXC01
STC00366
0
0
291,088

0000 *SYSTEM*
18,312
3,302,432
789,056 13,
****************************** BOTTOM OF DATA *********************************
Abend-AID ------------ Common Storage Users ------------ Row 001371 of 001379
COMMAND ===>
SCROLL ===> DATA
==>
Total CSA
Total SQA
Total ESQA
Total ECSA
System
18,312
789,056
13,176,976
3,302,432
Active
3,027,288
621,960
5,030,624
72,545,872
Owner Gone
372,400
439,856
509,136
4,399,848
------------------ ------------ ------------ ------------ -----------Totals from CAUBs
3,418,000
1,850,872
18,716,736
80,248,152
Totals from GDA
3,418,000
1,850,872
18,716,736
80,248,152
Differences
0
0
0
0
As expected, *SYSTEM* and *MASTER* own most of the storage allocated to the SQA.
However, there are two other address spaces with large amounts of SQA allocated. FXC01,
which is no longer active, looks suspicious, as does NPM, which is still active. Use the
cursor-point-and-shoot feature and press Enter at the ASID field for FXC01 to display the
Common Storage Allocations screen, as shown in Figure 17-45.
Analyzing MVS Virtual Storage
17-29
Figure 17-45. Common Storage Allocations Screen











First 32 
*********
. . 1 8 
. {. ! 8 
. . 8 8 
.6}. ! 8 
. . ! 8 
. . ! 8 
. . ! 8 
.7 . ! 8 
.j .
8 
. &.
8 
. -. ! 8 
Abend-AID --------- Common Storage Allocations --------- Row 000001 of 000107
COMMAND ===>
SCROLL ===> DATA
==>
Total CSA
Total SQA
Total ESQA
Total ECSA
Totals from GQEs
0
291,088
7,616
0
Totals from CAUB
0
291,088
7,616
0
Differences
0
0
0
0
CAUB Address................. 0268B3B8
Name of Address Space........ FXC01
Status of Address Space...... Gone
Address
********
00EB3000
00EAF000
00835000
00EB6000
00F6D000
008D1000
00EBC000
00EA9000
00907000
00801000
00EA6000
Size
**********
4,096
4,096
4,096
4,096
4,096
4,096
4,096
4,096
4,096
4,096
4,096
Area
****
SQA
SQA
SQA
SQA
SQA
SQA
SQA
SQA
SQA
SQA
SQA
Return
********
80F4B344
80F4B344
80F4B344
80F4B344
80F4B344
80F4B344
80F4B344
80F4B344
80F4B344
80F4B344
80F4B344
GQE
********
06B5A2C8
06B5A340
0831BCA0
01ABF148
01ABFAC0
01AA1B50
01AA1F88
0672F478
0672FC28
07EE9118
07EE98C8
Date
*********
31JAN2002
31JAN2002
31JAN2002
31JAN2002
31JAN2002
31JAN2002
31JAN2002
31JAN2002
31JAN2002
31JAN2002
31JAN2002
Time
*********
07:48:57
07:45:02
08:10:28
07:52:39
07:51:23
08:09:13
07:43:47
07:47:33
08:07:57
08:12:54
07:53:54
The Common Storage Allocations screen displays the individual allocations of E/CSA and
E/SQA by the selected address space. This screen is not initially sorted, but can be sorted
by address, size, return address, date or time. The header contains information carried
over from the Common Storage Users screen, but adds totals for E/CSA and E/SQA found
in the GQEs. Use the RIGHT (PF11) key to display the right-most portion of the screen
and the first 32 bytes of data, as shown in Figure 17-46.
Figure 17-46. Common Storage Allocations Screen











First 32 Bytes of Data

********************************
. . 1 8 ... .MFDCATLGSYSV.CICS
. {. ! 8 ... .MFDCATLGSYSV.CICS
. . 8 8 ... .MFDCATLGSYSV.CICS
.6}. ! 8 ... .MFDCATLGSYSV.CICS
. . ! 8 ... .MFDCATLGSYSV.CICS
. . ! 8 ... .MFDCATLGSYSV.CICS
. . ! 8 ... .MFDCATLGSYSV.CICS
.7 . ! 8 ... .MFDCATLGSYSV.CICS
.j .
8 ... .MFDCATLGSYSV.CICS
. &.
8 ... .MFDCATLGSYSV.CICS
. -. ! 8 ... .MFDCATLGSYSV.CICS
Abend-AID --------- Common Storage Allocations --------- Row 000001 of 000107
COMMAND ===>
SCROLL ===> DATA
<==
Total CSA
Total SQA
Total ESQA
Total ECSA
Totals from GQEs
0
291,088
7,616
0
Totals from CAUB
0
291,088
7,616
0
Differences
0
0
0
0
CAUB Address................. 0268B3B8
Name of Address Space........ FXC01
Status of Address Space...... Gone
Address
********
00EB3000
00EAF000
00835000
00EB6000
00F6D000
008D1000
00EBC000
00EA9000
00907000
00801000
00EA6000
Size
**********
4,096
4,096
4,096
4,096
4,096
4,096
4,096
4,096
4,096
4,096
4,096
Area
****
SQA
SQA
SQA
SQA
SQA
SQA
SQA
SQA
SQA
SQA
SQA
Date
******
AN2003
AN2003
AN2003
AN2003
AN2003
AN2003
AN2003
AN2003
AN2003
AN2003
AN2003
Time
*********
07:48:57
07:45:02
08:10:28
07:52:39
07:51:23
08:09:13
07:43:47
07:47:33
08:07:57
08:12:54
07:53:54
The first 32 bytes of data column reveals many occurrences of an Abend-AID for CICS
shared directory name. The resolution is discussed in the next section, “SQA Analysis” on
page 17-31. If SQA tracking had been inactive, you would need to follow the steps
described in that section to determine the problem. That approach is more difficult to
determine the offending address space.
Continue by pressing the END (PF3) key to return to the Common Storage Users screen.
The amount allocated by address spaces that terminated is generally of concern unless it
was intentionally left allocated for other address spaces. To find the address spaces that
17-30
Abend-AID for CICS User’s Guide
terminated, press the RIGHT (PF11) key to display the right-most portion of the Common
Storage Users screen and enter gone in the masking line under the CAUB Type column
heading. Type SORT on the Command line, place the cursor on the TOTAL ESQA column
heading and press Enter. Next, enter the BOTTOM primary command, or type MAX on
the Command line and press the DOWN (PF8) key to scroll down to the bottom to
display the terminated address spaces leaving the largest amount of ESQA as shown in
Figure 17-47.
Figure 17-47. Common Storage Users Screen, Sorted by Total ESQA












ASID To Status
Total SQA Total ESQA CAUB
CAUB Type Date
Time

**** ** ****** ********** ********** ******** GONE****** ******** ********
00AE 0
291,088
7,616 0268B3B8 Gone.. A/S 02003031 04273548
0018 64
3,328
8,160 02492718 Gone.. A/S 02003031 03574058
0055 0
0
8,192 02492D90 Gone.. Job 02003025 05582000
0022 0
0
8,448 02506DD8 Gone.. Job 02003025 04472457
00B8 0
560
14,184 0268B718 Gone.. A/S 02003028 17504867
0057 0
10,280
15,320 0268BB50 Gone.. A/S 02003031 04140523
0090 08
55,016
18,744 0274C958 Gone.. A/S 02003026 01141117
00B0 0
1,296
35,568 0268B490 Gone.. A/S 02003025 01434366
00A6 52
29,552
220,784 0268B130 Gone.. A/S 02003031 04140295
****************************** BOTTOM OF DATA *********************************
Abend-AID ------------ Common Storage Users ------------ Row 001057 of 001065
COMMAND ===>
SCROLL ===> DATA
<==
Total CSA
Total SQA
Total ESQA
Total ECSA
System
18,312
789,056
13,176,976
3,302,432
Active
3,027,288
621,960
5,030,624
72,545,872
Owner Gone
372,400
439,856
509,136
4,399,848
------------------ ------------ ------------ ------------ -----------Totals from CAUBs
3,418,000
1,850,872
18,716,736
80,248,152
Totals from GDA
3,418,000
1,850,872
18,716,736
80,248,152
Differences
0
0
0
0
Sort the display by total SQA by typing SORT on the Command line, placing the cursor
on the Total SQA column heading, and pressing Enter. Enter the BOTTOM primary
command, or type MAX on the Command line and press the DOWN (PF8) key to display
the terminated address spaces leaving the largest amount of SQA, as shown in
Figure 17-48.
Figure 17-48. Common Storage Users Screen, Sorted by Total SQA












ASID To Status
Total SQA Total ESQA CAUB
CAUB Type Date
Time

**** ** ****** ********** ********** ******** GONE****** ******** ********
015F 0
4,096
0 084AF058 Gone.. Job 02002026 00385916
0050 0
4,096
8 086078C8 Gone.. A/S 02002031 04140550
0166 0
4,096
328 084AF5B0 Gone.. Job 02002026 01143073
0069 0
4,096
0 085CF0E8 Gone.. Job 02002026 01572168
0057 0
10,280
15,320 0268BB50 Gone.. A/S 02002031 04140523
007D 0
10,544
752 0268B298 Gone.. A/S 02002031 04140522
00A6 52
29,552
220,784 0268B130 Gone.. A/S 02002031 04140295
0090 08
55,016
18,744 0274C958 Gone.. A/S 02003026 01141117
00AE 0
291,088
7,616 0268B3B8 Gone.. A/S 02003031 04273548
****************************** BOTTOM OF DATA *********************************
Abend-AID ------------ Common Storage Users ------------ Row 001057 of 001065
COMMAND ===>
SCROLL ===> DATA
<==
Total CSA
Total SQA
Total ESQA
Total ECSA
System
18,312
789,056
13,176,976
3,302,432
Active
3,027,288
621,960
5,030,624
72,545,872
Owner Gone
372,400
439,856
509,136
4,399,848
------------------ ------------ ------------ ------------ -----------Totals from CAUBs
3,418,000
1,850,872
18,716,736
80,248,152
Totals from GDA
3,418,000
1,850,872
18,716,736
80,248,152
Differences
0
0
0
0
Analyzing MVS Virtual Storage
17-31
SQA Analysis
If SQA tracking was not active, you need to examine the SQA allocations by subpool.
Press the END (PF3) key to return to the SQA Summary screen (Figure 17-42 on page
17-26). Use the cursor point-and-shoot feature and press Enter at the Summarize field in
the header to display the Summarized SQA Subpools screen, as shown in Figure 17-49.
The percentages are calculated on the total amount allocated for SQA, ESQA, and
SQA+ESQA. They are not calculated on the amounts defined to these areas.
Figure 17-49. Summarized SQA Subpools Screen
Abend-AID ----------- Summarized SQA Subpools ---------- Row 000001 of 000005 
COMMAND ===>
SCROLL ===> DATA 

SQA Size (Kbytes)........................... 1,216

Extended SQA Size (Kbytes).................. 16,016

Total SQA Allocated (Kbytes)................ 1,980

Total Extended SQA Allocated (Kbytes)....... 19,392


Allocated
Percent of
Allocated
Percent of
Total
Percent of 
Id
<16Mb
Total <16Mb >16Mb
Total >16Mb Allocated
<16M + >16M 
*** ********** *********** ********** *********** ********** *********** 
245
1,540K
77.778
12,568K
64.810
14,108K
66.012

226
244K
12.323
0K
0.000
244K
1.142

239
196K
9.899
3,508K
18.090
3,704K
17.331

247
0K
0.000
436K
2.248
436K
2.040

248
0K
0.000
2,880K
14.851
2,880K
13.476

****************************** BOTTOM OF DATA *********************************
Use this screen to narrow down which subpools in SQA have large allocations. This
screen shows that subpool 245 is 77.778 percent of total SQA allocated. It would also
help to know what are the normal allocations for each SQA subpool. Use the cursor pointand-shoot feature and press Enter at any of the subpool numbers under the Id column
heading to display the SQA Subpool Detail screen, as shown in Figure 17-50. You can also
display this screen from the SQA Summary screen.
Figure 17-50. SQA Subpool Detail Screen










Index
Entry
*****











Abend-AID ------------------- SQA Subpool Detail ----------------- Row 000001
COMMAND ===>
SCROLL ===> DATA
==>
Subpool..................... 245
Allocated <16Mb (Kbytes).... 1,540
AQATINDX Address............ 021E6BB0 Allocated >16Mb (Kbytes).... 12,568
Non-zero AQATINDX Entries... 17
Total Allocated (Kbytes).... 14,108
Free <16Mb................. 155,168
Free >16Mb................. 1,018,648
Total Free................. 1,173,816
Page
Address
********
00801000
00826000
00827000
00828000
00829000
0082A000
0082B000
0082C000
0082D000
00832000
00835000
CSA
Page
*****
Yes
Yes
Yes
Yes
Yes
Yes
Yes
Yes
Yes
Yes
Yes
DFE
Address
********
DFE Area
********
Size of
Area
*********
07FC9AF0
00826000
3,072
07FC9448
0082A000
3,072
08429EB0
00832000
128
DFE
Count
******
0
1
0
0
0
1
0
0
0
4
0
AQAT
Address
********
021E84A8
021E84A8
021E84A8
021E84A8
021E84A8
021E84A8
021E84A8
021E84A8
021E84A8
021E84A8
021E84A8
AQAT
Entry
******
0
2
2
2
2
2
2
2
2
3
3
This screen has the same format as the LSQA Subpool Detail screen shown in Figure 17-24
on page 17-17. Another field is added for SQA, the CSA Page indicator. If the page is a
converted CSA page, Yes is displayed in this column. Also, it may take longer to display
17-32
Abend-AID for CICS User’s Guide
because there are considerably more pages (entries). For this reason, only the first DFE
(free area) of each page is displayed. To see additional free areas, use the cursor pointand-shoot feature and press Enter at the DFE Count field to display the DFEs for Specific
Page(s) screen, as shown in Figure 17-51.
Figure 17-51. DFEs for Specific Page(s) Screen
Abend-AID --------------- DFEs for Specific Page(s) ------------------------- 
COMMAND ===>
SCROLL ===> DATA 

Subpool.................. 245
Total Free.................. 2,648

Subpool Location......... SQA <16M
Page Address................ 00832000


DFE
Size of
Data

Address
DFE Area Area
Address
First 32 Bytes of Data

******** ******** ********* ******** ********************************

08429EB0 00832000
128 00832080 ASCB. ". C......"7 .. "........

09A45DA8 00832400
80 00832450 .
.....................: -....

07686358 008324F8
2,056 00832D00 ASCB.6m". "....."9.. Q ........

01D47748 00832E80
384 00833000 << REACHED END OF PAGE
>>

****************************** BOTTOM OF DATA *********************************
This screen is also the same as for LSQA except that the Subpool Location field reflects
SQA. This screen displays the page and all of its free areas.
Press the END (PF3) key to return to the SQA Subpool Detail screen. Scroll down using
the DOWN (PF8) key, and press the RIGHT (PF11) key to display the right-most portion
of the screen. Note the many pages with MFDCATLGSYSV.CICS in the First 32 Bytes of
Data column. Entering MFDCATLG in the mask line in the same column positions for
First 32 Bytes of Data reveals there are 71 such pages in subpool 245, as shown in
Figure 17-52.
Figure 17-52. SQA Subpool Detail Screen, Masked











First 32 Bytes of Data

***************MFDCATLG*********
. &.
8 ... .MFDCATLGSYSV.CICS
. . 8 8 ... .MFDCATLGSYSV.CICS
. . ! 8 ... .MFDCATLGSYSV.CICS
. \. ! 8 ... .MFDCATLGSYSV.CICS
. . r 8 ... .MFDCATLGSYSV.CICS
. . ! 8 ... .MFDCATLGSYSV.CICS
. {. ! 8 ... .MFDCATLGSYSV.CICS
.k . ! 8 ... .MFDCATLGSYSV.CICS
. .
8 ... .MFDCATLGSYSV.CICS
. . ! 8 ... .MFDCATLGSYSV.CICS
. \. ! 8 ... .MFDCATLGSYSV.CICS
Abend-AID ------------- SQA Subpool Detail ------------- Row 000001 of 000071
COMMAND ===>
SCROLL ===> DATA
<==
Subpool..................... 245
Allocated <16Mb (Kbytes).... 1,540
AQATINDX Address............ 021E6BB0 Allocated >16Mb (Kbytes).... 12,568
Non-zero AQATINDX Entries... 17
Total Allocated (Kbytes).... 14,108
Free <16Mb................. 155,168
Free >16Mb................. 1,018,648
Total Free................. 1,173,816
Page
Address
********
00801000
00835000
008A9000
008AB000
008AD000
008AE000
008AF000
008B0000
008CE000
008D1000
008D2000
CSA
Page
*****
Yes
Yes
Yes
Yes
Yes
Yes
Yes
Yes
Yes
Yes
Yes
AQ
Ad
**
A8
A8
A8
A8
A8
A8
A8
A8
A8
A8
A8
AQAT
Entry
******
0
3
10
10
10
10
10
11
12
13
13
Index
Entry
******
1
1
1
1
1
1
1
1
1
1
1
Data
Address
********
00801000
00835000
008A9000
008AB000
008AD000
008AE000
008AF000
008B0000
008CE000
008D1000
008D2000
Each page has no free areas (DFEs). Press the DOWN (PF8) key once to scroll the display
downward. Use the cursor point-and-shoot feature and press Enter at 008D7000 in the
Data Address column to display the Memory Display screen, as shown in Figure 17-53.
Analyzing MVS Virtual Storage
17-33
Figure 17-53. Memory Display Screen for Data Address
Abend-AID ------------------- Memory Display -------------------------------- 
COMMAND ===>
SCROLL ===> DATA 

Clip Prev Next Lock

Start Addr: 008D7000
Comment:

008D7000 area SQA >
sp 245 key 8 ASID 0053
EBCDIC


Address
Offset
Word 1
Word 2
Word 3
Word 4
Storage

008D7000 +00000000 0090C000 0F5A0FF8 06000000 12FE00D4 *. {. ! 8 ... .M*

008D7010 +00000010 C6C4C3C1 E3D3C7E2 E8E2E54B C3C9C3E2 *FDCATLGSYSV.CICS*

008D7020 +00000020 4BC1C1C6 E74BE2C5 D9E5C3F0 F14BE2C8 *.AAFX.SERVC01.SH*

008D7030 +00000030 D9C4C9D9 40404040 404040E2 C3C3F3F0 *RDIR
SCC30*

008D7040 +00000040 F30000C4 C5E2C3D9 C9D7E3E2 C8C1D9C4 *3..DESCRIPTSHARD*

008D7050 +00000050 C4C9D9E2 C8C1D9C4 C4C9D900 00000900 *DIRSHARDDIR... .*

008D7060 +00000060 00000000 00000000 00000000 00000000 *................*

008D7070 +00000070 00000000 00000000 00000000 00000000 *................*

008D7080 +00000080 00000000 00000000 00000000 00000000 *................*

008D7090 +00000090 00000000 00000000 00000000 00000000 *................*

008D70A0 +000000A0 00000000 00000000 00000000 00000000 *................*

008D70B0 +000000B0 00000000 00000000 00000000 00000000 *................*

008D70C0 +000000C0 00000000 00000000 00000000 00000000 *................*

008D70D0 +000000D0 00000000 00000000 00000000 00000000 *................*

008D70E0 +000000E0 00000000 00000000 00000000 00000000 *................*

008D70F0 +000000F0 00000000 00000000 00000000 00000000 *................*

Once the entire page is displayed, it reveals an Abend-AID for CICS enqueue name for the
shared directory. Note the SERVC01 in the name, which reflects the FXC01 address space
from the Common Storage Users screen that had terminated, leaving SQA storage
allocated. This is the reason the SVC dump was reported to Abend-AID for CICS
Technical Support. Once it was researched at Compuware, it was determined to be a
known problem with a resource serialization product leaving partial enqueue data in
SQA.
Enter the SQASUM fast-path command to display the SQA Summary screen, as shown in
Figure 17-54.
Figure 17-54. SQA Summary Screen
Abend-AID ----------------- SQA Summary ---------------- Row 000001 of 000005 
COMMAND ===>
SCROLL ===> DATA 

GDA Address................ 021E41A0

SM Block Address........... 021E4000

SM Block Size (Kbytes)..... 40

SQA Tracking Status........ Active

To view a summary of SQA subpools select Summarize


Extended System Queue Area
System Queue Area

Maximum Address (defined).. 02987FFF
Maximum Address (defined).. 00FC7FFF

Defined Size (Kbytes)...... 16,016
Defined Size (Kbytes)...... 1,216

Starting Address........... 019E4000
Starting Address........... 00E98000

ECSA to ESQA (Kbytes)...... 4,120
CSA to SQA (Kbytes)........ 764


AQATINDX +---------- DFE Queue Origins -----------+

Sp
Address
Addr <16M Addr >16M Size <16M Size >16M

*** ******** ******************************************

226 021E73B0 021EAF44
-------021EAF44
-------
239 021E6FB0 021EAA94
021EACEC
021EAA94
021EACEC

245 021E6BB0 021EA5E4
021EA83C
021EA5E4
021EA83C

247 021E77B0 -------021EB19C
-------021EB19C

248 021E7BB0 -------021EB3F4
-------021EB3F4

****************************** BOTTOM OF DATA *********************************
The DFE Queue Origins for SQA subpools are available. DFEs represent available storage
(free) in a 64K block of storage represented by an address queue anchor table (AQAT)
address. Each AQAT contains 128 entries that consist of an array of queue headers into
17-34
Abend-AID for CICS User’s Guide
L/SQA DFE (by address) queues and 16 allocation bits that represent storage allocated in
an L/SQA subpool. Each AQAT entry is 6 bytes long and describes 64K of storage.
The address of the AQAT is found from an entry in an AQATINDX table. Each L/SQA
subpool has its own AQATINDX, addressed from either the GDA (SQA) or LDA (LSQA).
Each AQATINDX has 256 entries, each representing 8M of storage.
Tab selecting the addresses of the DFE queue origins displays the list of DFEs as described
in the column heading:
•
•
•
•
Sorted
Sorted
Sorted
Sorted
by
by
by
by
address below 16Mb boundary
address above 16Mb boundary
size below 16Mb boundary
size above 16Mb boundary.
Because DFEs are on 8-byte boundaries, VSM places dummy DFEs at each boundary
denoted by an area (address) and size equal to zeroes. Use the cursor point-and-shoot
feature and press Enter at 021EAA94 under the Size < 16M column for subpool 239 to
display the DFEs in Size Queue Order screen, as shown in Figure 17-55.
Figure 17-55. DFEs in Size Queue Order Screen
Abend-AID ---------- DFEs in Size Queue Order ---------- Row 000001 of 000045 
COMMAND ===>
SCROLL ===> DATA 

Subpool.................. 239
Total Free.................. 17,936

Subpool Location......... SQA <16M


DFE
Size of

Address
DFE Area Area
Error

******** ******** ********* ***** ********************************

021EAA94 00000000
0
This is a Dummy DFE

021EB9AC 00FA5000
8

028DE5F8 00FAC000
8

028DE430 00FB3000
8

028DE358 00F95000
8

028DE280 00FA2000
8

021EAAAC 00000000
0
This is a Dummy DFE

07D22B08 00F8ED90
16

0789C6A0 00F89D00
16

028DE568 00F7EFA0
16

021EAAC4 00000000
0
This is a Dummy DFE

01B7ECB8 00F7E000
24

021EAADC 00000000
0
This is a Dummy DFE

021EAAF4 00000000
0
This is a Dummy DFE

021EAB0C 00000000
0
This is a Dummy DFE
CSA Analysis
After selecting a region dump, enter the CSASUM fast-path command on any Command
line or select the CSASUM option (9) on the MVS Storage Analysis menu (Figure 17-2 on
page 17-2) to display the Common Service Area Summary screen, as shown Figure 17-56.
Analyzing MVS Virtual Storage
17-35
Figure 17-56. Common Service Area Summary Screen
Abend-AID -------------- Common Service Area Summary ------------------------ 
COMMAND ===>


GDA Address................ 021E41A0

SPT Address................ 028D09F8

CSA Tracking Status........ Active

To view a summary of CSA subpools select Summarize


Extended Common Service Area
Common Service Area

Maximum Address............ 0B7FFFFF
Maximum Address............ 00C53FFF

Maximum Size (Kbytes)...... 100,772
Maximum Size (Kbytes)...... 4,432

Starting Address........... 05597000
Starting Address........... 00800000

ECSA to ESQA (Kbytes)...... 4,120
CSA to SQA (Kbytes)........ 764

Free Blocks Available...... Yes
Free Blocks Available...... No

The global data area (GDA) address is contained in the header. This address is the VSM
anchor block that contains information on system-related virtual storage; in particular,
the CSA and SQA subpools. The CSA tracking status is listed as either Active or Inactive at
the time the SVC dump was taken. If Active, a list of address spaces that had allocated
CSA is available. For more information about the Common Storage Users screen, refer to
“Common Storage Users” on page 17-27.
Also in the header is the address of the subpool table (SPT), which contains the DQE
chains for the CSA subpools. As on the SQA Summary screen, the amounts of ECSA
converted to ESQA and CSA converted to SQA are listed. These may or may not equal the
difference between the allocated amounts and sizes of the SQA areas. The amount of
extended CSA converted to extended SQA is 4,120K, and the amount of CSA converted to
SQA is 764K. Adding 4,120K to the 79,584K allocated to extended CSA gives 83,704K.
Dividing that by the size of the extended CSA at 100,772K reveals the extended CSA is
83.063 percent allocated. Adding 764K to the 3,668K allocated to CSA gives 4,432K or
100 percent of the defined size of the CSA.
An important indicator is whether there are free blocks of storage available in the
extended CSA or the CSA. If there are, use the cursor point-and-shoot feature and press
Enter at Yes to display the FBQEs with the address and size of each free block. If there are
no free blocks available, No is displayed, which is not selectable. As expected, there are
no free blocks available because the CSA was 100 percent allocated. The extended CSA
does have free blocks, so press Enter at Yes to display the CSA Free Block Queue Elements
screen, as shown in Figure 17-57.
Figure 17-57. CSA Free Block Queue Elements Screen
Abend-AID -------- CSA Free Block Queue Elements ------- Row 000001 of 000109 
COMMAND ===>
SCROLL ===> DATA 

Total free storage (Kbytes)...... 17,068


FBQE
Start of End of
Size of

Address
Area
Area
Area

******** ******** ******** **********

02285F28 05597000 06519FFF
15,884K

01D47F58 065D0000 065D0FFF
4K

01AB5E08 065D7000 065DBFFF
20K

024A8520 065DE000 065E2FFF
20K

07499388 065E4000 065E8FFF
20K

02786610 065EA000 065EAFFF
4K

06A83E98 065EC000 065ECFFF
4K

02786D90 065F4000 065F8FFF
20K

088D9FD0 06604000 06604FFF
4K

02784B80 06606000 0660AFFF
20K

06AA3730 0662B000 0662FFFF
20K

02786880 06632000 06632FFF
4K

0789CA60 0663E000 0663EFFF
4K

02788CA0 06642000 06646FFF
20K

08579298 06648000 0664CFFF
20K

06D718C8 06651000 06651FFF
4K 
17-36
Abend-AID for CICS User’s Guide
Press the END (PF3) key to return to the Common Service Area Summary screen. Use the
cursor point-and-shoot feature and press Enter at the Summarize field to display the
Summarized CSA Subpools screen, as shown in Figure 17-58.
Figure 17-58. Summarized CSA Subpools Screen








Percent of
Total
Percent of 
Total >16Mb Allocated
<16M + >16M 
*********** ********** *********** 
3.021
2,448K
2.940

6.650
5,616K
6.746

41.410
33,940K
40.768

48.919
41,248K
49.546

DATA *********************************
Abend-AID ----------- Summarized CSA Subpools ---------- Row 000001 of 000004
COMMAND ===>
SCROLL ===> DATA
==>
CSA Size (Kbytes)........................... 4,432
Extended CSA Size (Kbytes).................. 100,772
Total CSA Allocated (Kbytes)................ 3,668
Total Extended CSA Allocated (Kbytes)....... 79,584
Allocated
Percent of
Allocated
Id
<16Mb
Total <16Mb >16Mb
*** ********** *********** **********
227
44K
1.200
2,404K
228
324K
8.833
5,292K
231
984K
26.827
32,956K
241
2,316K
63.141
38,932K
****************************** BOTTOM OF
The Summarized CSA Subpools screen is very much like the Summarized Private Subpools
screen with the addition of the DQE Errors and FQE Errors columns. These are indicators
if there were any errors found processing CSA DQEs or FQEs. Unless QUIESCE=YES is
specified on the SDUMP macro or set via the CHNGDUMP command, the CSA and SQA
remain dynamic while they are being dumped. This situation likely causes DQE and/or
FQE chaining errors. Refer to the CHNGDUMP command in the IBM OS/390 MVS System
Commands manual for information on precedence between the SDUMP macro and the
CHNGDUMP command.
The total allocations calculated for a subpool may be inaccurate if there are DQE errors.
Processing for a subpool/key stops for certain DQE errors. The Abend-AID for CICS Dump
Analysis Message Log and viewing server FDBDLOG show messages indicating the nature
of the error(s). The total allocated amounts in the header do not include the amounts (if
any) converted to E/SQA. The percentages are calculated using the total allocated E/CSA
amounts. Use the cursor point-and-shoot feature and press Enter at one of the subpool
numbers under the Id column to display the CSA Subpool Allocations screen, as shown in
Figure 17-59.
Figure 17-59. CSA Subpool Allocations Screen








Percent of
Total
Percent of 
Total >16Mb Allocated
<16M + >16M 
*********** ********** *********** 
36.145
15,488K
37.548

1.726
704K
1.707

0.000
36K
0.087

0.781
316K
0.766

8.096
3,164K
7.671

4.829
1,936K
4.694

37.707
14,720K
35.687

9.144
4,200K
10.182

0.555
268K
0.650

1.017
416K
1.009

DATA *********************************
Abend-AID ----------- CSA Subpool Allocations ---------- Row 000001 of 000010
COMMAND ===>
SCROLL ===> DATA
==>
Subpool..................... 241
Allocated <16Mb (Kbytes).... 2,316
Free <16Mb (Kbytes)......... 195
Allocated >16Mb (Kbytes).... 38,932
Free >16Mb (Kbytes)......... 756
Total Allocated (Kbytes).... 41,248
Total Free (Kbytes)......... 951
Allocated
Percent of
Allocated
Key <16Mb
Total <16Mb >16Mb
*** ********** *********** **********
0
1,416K
61.140
14,072K
1
32K
1.382
672K
2
36K
1.554
0K
3
12K
0.518
304K
4
12K
0.518
3,152K
5
56K
2.418
1,880K
6
40K
1.727
14,680K
7
640K
27.634
3,560K
8
52K
2.245
216K
10
20K
0.864
396K
****************************** BOTTOM OF
Analyzing MVS Virtual Storage
17-37
This screen breaks down the CSA subpool allocations by key. The DQE and FQE error
indicators apply to the subpool/key combination. If no errors were reported on the
Summarized CSA Subpools screen, there should be none here. Use the cursor point-andshoot feature and press Enter at one of the numbers under the Key column heading to
display the CSA Subpool Detail screen, as shown in Figure 17-60.
Figure 17-60. CSA Subpool Detail Screen










Size of
Area

*******
1,4
3,0

1,6
8
1,4
1,6
8
2,9
3,0
3,3
Abend-AID ------------------ CSA Subpool Detail ------------------ Row 000001
COMMAND ===>
SCROLL ===> DATA
==>
Subpool..................... 241
Allocated <16Mb (Kbytes).... 1,416
Key......................... 0
Allocated >16Mb (Kbytes).... 14,072
SPT Entry Address........... 028D0E7C Total Allocated (Kbytes).... 15,488
Free <16Mb.................. 55,032
Free >16Mb.................. 441,376
Total Free.................. 496,408
DQE
Address
********
024C8F88
0672EC10
024F6868
084290B8
024C8F28
027A92F8
06D71958
0672EB08
06D1BFB8
0672ED48
0256CDD8
Backing
Storage
********
BELOW
BELOW
BELOW
BELOW
BELOW
BELOW
BELOW
BELOW
BELOW
BELOW
BELOW
Area
Size of
Address Area
******** **********
00802000
12K
00805000
8K
00807000
4K
00823000
12K
0082F000
12K
00873000
12K
00886000
12K
0088E000
12K
00896000
8K
0089F000
16K
008B5000
12K
DQE
Errors
******
No
No
No
No
No
No
No
No
No
No
No
FQE
Errors
******
No
No
No
No
No
No
No
No
No
No
No
FQE
Address
********
01AB5190
082560D0
09A45DC0
02782130
06DDB5E0
0672E8B0
01AB52E0
027ABBF8
06D1B118
02788910
06D71B98
Area
Address
********
00802000
00805000
00807000
00823000
0082F000
00873000
00886000
0088E000
00896000
0089F000
008B5000
The address of the SPT for this subpool/key, which is composed of several DQE chains, is
displayed in the header. The remainder of the screen is similar to the Private Subpool
Detail screen with the addition of the FQE Errors column. This column indicates if there
were any FQE errors detected for a particular DQE. If Yes, the Free amounts in the header
may be inaccurate. It takes longer to display the CSA Subpool Detail screen for a
subpool/key with a large amount of storage allocated because the first 32 bytes of data
need to be retrieved.
Press the RIGHT (PF11) key to display the right-most portion of the screen. In addition to
looking at the first 32 bytes of data, watch for large DQEs. From the First 32 Bytes of Data
column, note that many modules are loaded into SP241 key 0 storage. Enter DFS in the
mask line starting in the sixth position under the First 32 Bytes of Data column heading
to display some of the IMS modules loaded into CSA storage, as shown in Figure 17-61.
17-38
Abend-AID for CICS User’s Guide
Figure 17-61. CSA Subpool Detail Screen, Masked











First 32 Bytes of Data

*****DFS************************
00 DFSFXC10-410-06/27/95PN7215
00 DFSLDTR0-410-04/10/93PTQ072
00 DFSDRCL0+S203+SP42+410+11/0
00 DFSFXC10-410-06/27/95PN7215
00 DFSFXC10-410-06/27/95PN7215
00 DFSLDTR0-410-04/10/93PTQ072
00 DFSDRCL0+S203+SP42+410+10/3
00 DFSSBT10+410+04/10/93+04.55
00 DFSFDLF0-410-10/30/96-08.41
00 DFSDRCL0+S203+SP53+510+05/1
00 DFSIAFP0-S203-SP31-510-08/0
Abend-AID ------------- CSA Subpool Detail ------------- Row 000001 of 000325
COMMAND ===>
SCROLL ===> DATA
<==
Subpool..................... 241
Allocated <16Mb (Kbytes).... 1,416
Key......................... 0
Allocated >16Mb (Kbytes).... 14,072
SPT Entry Address........... 028D0E7C Total Allocated (Kbytes).... 15,488
Free <16Mb.................. 55,032
Free >16Mb.................. 441,376
Total Free.................. 496,408
DQE
Address
********
024C8F88
0672EC10
024F6868
027A92F8
08AC1070
08AC1088
08CB06D0
08BEF178
Backing
Storage
********
BELOW
BELOW
BELOW
BELOW
BELOW
BELOW
BELOW
BELOW
Area
Address
********
00802000
00805000
00807000
00873000
0095A000
0095D000
0095F000
00990000
0250CDF0
BELOW
009BF000
Size
Area
*****
1,488
3,056
16
1,488
1,488
3,056
16
352
88
8
2,424
Data
Address
********
008025D0
00805BF0
00807010
008735D0
0095A5D0
0095DBF0
0095F010
00990160
009BD148
009BF008
009F1FC8
These modules may be loaded here because of specification in the IEAFIXxx or IEALPAxx
members in SYS1.PARMLIB; that is, the FLPA or MLPA. Verify this from the Link Pack
Areas Map, discussed next.
Link Pack Areas
After you have selected the dump, enter the LPAMAP fast-path command on any
command line or select the LPAMAP option (11) from the MVS Storage Analysis menu
(Figure 17-2 on page 17-2) to display the Link Pack Areas Map screen, as shown in
Figure 17-62.
Figure 17-62. Link Pack Areas Map Screen








LPA Queue 
********* 
F/MLPA

F/MLPA

F/MLPA

F/MLPA

F/MLPA

F/MLPA

F/MLPA

F/MLPA

F/MLPA

F/MLPA

F/MLPA

F/MLPA

F/MLPA

F/MLPA

Abend-AID ------------------ Link Pack Areas Map ----------------- Row 000001
COMMAND ===>
SCROLL ===> DATA
==>
PLPA Directory Address...... 00CA0000
F/MLPA Queue Address........ 00FD37C8
Dynamic LPA Queue Address... 00F0F400
Entry
Point
********
00BC8000
00BC8000
00BCB478
00BCE758
00BD1148
00BD1148
00BD51E0
00BDE350
00BEC210
00BEE010
00BEFD88
00BF2088
00BF2450
00BF91A0
Name
********
CTSPM
TMSPM
TMSSECUR
TMSLABEL
CTSDATE
TMSDATE
TMSOSI26
TMSOCE43
TMSTMVT
CASMINIT
CAS9SAFC
TMSUX2S
TMSQSTS
TMSUX2E
Extent
Address
********
00BC8000
Extent
Length
********
00002C00
00BCB478
00BCE758
00BD1148
00002B88
000028A8
00003EB8
00BD51E0
00BDE350
00BEC210
00BEE010
00BEFD88
00BF2088
00BF2450
00BF91A0
00002E20
00004CB0
00001DF0
00000730
00002278
000003C8
00000B10
000003A8
Load
Module
********
CTSPM
CTSDATE
Amode
*******
AMODE31
AMODE31
AMODE24
AMODE31
AMODE31
AMODE31
AMODE31
AMODE24
AMODE24
AMODE31
AMODE31
AMODE24
AMODE24
AMODE31
CDE/LPDE
Address
********
00F1B010
00F15B00
00F0A550
00F8D150
00F93040
00F12200
00F920D0
00F92150
00F1B070
00F0DC40
00F12008
00F0DC70
00F15B50
00F0DCA0
The addresses of the LPA directories or queues of the modules are displayed in the header.
Depending on the version of OS/390, there is a dynamic LPA queue address. This address
Analyzing MVS Virtual Storage
17-39
is a pointer to a chain of CDEs representing modules defined on LPA statements coded in
the PROGxx members of the SYS1.PARMLIB.
This screen is sorted by entry point address. The entry point may be highlighted if it lies
outside the boundaries of the extent (XTLMSBAD+XTLMSBLN for CDEs or
LPDEXTAD+LPDEXTLN for LPDEs). This situation usually indicates an OEM vendor
replacement or "hook" module for an operating system function. The LPA queue
identifies from which directory or queue the named module was located. The storage area
identifies in which virtual storage area the entry point lies. LPA modules residing in the
E/CSA or E/SQA are not identified on the Memory Display because the underlying E/CSA
or E/SQA subpool is identified.
Press the RIGHT (PF11) key to display the right-most portion of the Link Park Areas Map
screen. Enter PLPA in the first four positions of the mask line under the Storage Area
column heading to display only modules located in the PLPA, as shown in Figure 17-63.
Figure 17-63. Link Pack Areas Map Screen, Masked








Storage Area

PLPA************
PLPA

PLPA

PLPA

PLPA

PLPA

PLPA

PLPA

PLPA

PLPA

PLPA

PLPA

PLPA

PLPA

PLPA

Abend-AID ------------- Link Pack Areas Map ------------ Row 000001 of 000685
COMMAND ===>
SCROLL ===> DATA
<==
PLPA Directory Address...... 00CA0000
F/MLPA Queue Address........ 00FD37C8
Dynamic LPA Queue Address... 00F0F400
Entry
Point
********
00CB5428
00CB54E8
00CB55A0
00CB5680
00CB5760
00CB5818
00CB5A00
00CB5B90
00CB5CE8
00CB5E68
00CB6000
00CB6000
00CB6008
00CB61F0
E
A
*
8
8
0
0
0
8
0
0
8
8
0
Extent
Length
********
000000C0
000000B8
000000E0
000000E0
000000B8
000001E8
00000190
00000158
00000180
00000198
00000008
8
0
000001E8
00000158
Load
Module
********
IEFRSTRT
Amode
*******
AMODE24
AMODE24
AMODE24
AMODE24
AMODE24
AMODE24
AMODE24
AMODE24
AMODE24
AMODE24
AMODE24
AMODE24
AMODE24
AMODE24
CDE/LPDE
Address
********
00CA1568
00CA1838
00CAF988
00CA2300
00CA4F10
00CA34A8
00CA7850
00CA13B0
00CA1388
00CA15B8
00CA9538
00CA93D0
00CA18D8
00CA6EA0
LPA Queue
*********
PLPA
PLPA
PLPA
PLPA
PLPA
PLPA
PLPA
PLPA
PLPA
PLPA
PLPA
PLPA
PLPA
PLPA
Another way to list only modules in the PLPA is to use the cursor point-and-shoot feature
and press Enter at the Starting Address of PLPA on the Virtual Storage Map screen.
However, doing so does not display the same number of entries on the Link Pack Areas
Map because the Allocated Storage Map includes only complete extents (load modules)
from the PLPA. Enter the RESET primary command on the command line to reset the
display. Enter F/MLPA in the first six positions of the mask line under the LPA Queue
column heading to display only modules located in the FLPA/MLPA queue, as shown in
Figure 17-64.
17-40
Abend-AID for CICS User’s Guide
Figure 17-64. Link Pack Areas Map Screen, Masked








Storage Area

****************
CSA

CSA

CSA

CSA

CSA

CSA

CSA

CSA

CSA

CSA

CSA

CSA

CSA

CSA

Abend-AID ------------- Link Pack Areas Map ------------ Row 000001 of 000090
COMMAND ===>
SCROLL ===> DATA
<==
PLPA Directory Address...... 00CA0000
F/MLPA Queue Address........ 00FD37C8
Dynamic LPA Queue Address... 00F0F400
Entry
Point
********
00BC8000
00BC8000
00BCB478
00BCE758
00BD1148
00BD1148
00BD51E0
00BDE350
00BEC210
00BEE010
00BEFD88
00BF2088
00BF2450
00BF91A0
E
A
*
0
Extent
Length
********
00002C00
8
8
8
00002B88
000028A8
00003EB8
0
0
0
0
8
8
0
0
00002E20
00004CB0
00001DF0
00000730
00002278
000003C8
00000B10
000003A8
Load
Module
********
CTSPM
CTSDATE
Amode
*******
AMODE31
AMODE31
AMODE24
AMODE31
AMODE31
AMODE31
AMODE31
AMODE24
AMODE24
AMODE31
AMODE31
AMODE24
AMODE24
AMODE31
CDE/LPDE
Address
********
00F1B010
00F15B00
00F0A550
00F8D150
00F93040
00F12200
00F920D0
00F92150
00F1B070
00F0DC40
00F12008
00F0DC70
00F15B50
00F0DCA0
LPA Queue
F/MLPA***
F/MLPA
F/MLPA
F/MLPA
F/MLPA
F/MLPA
F/MLPA
F/MLPA
F/MLPA
F/MLPA
F/MLPA
F/MLPA
F/MLPA
F/MLPA
F/MLPA
Nucleus Areas
After you select the dump, enter the NUCMAP fast-path command from any Command
line or select the NUCMAP option (12) from the MVS Storage Analysis menu (Figure 17-2
on page 17-2) to display the Nucleus Map screen, as shown in Figure 17-65.
Figure 17-65. Nucleus Map Screen
Abend-AID ---------------------- Nucleus Map --------------------- Row 000001 
COMMAND ===>
SCROLL ===> DATA 

NUCMAP Address........................ 016487B0

Nucleus suffix (IEANUC0x)............. 1

Number of Read/Write CSECTs........... 75

Number of Read Only CSECTs............ 87

Number of Ext Read Only CSECTs........ 1,613

Number of Ext Read/Write CSECTs....... 121


Entry
CSECT
CSECT

Point
Name
Length
Amode Storage Area

******** ******** ******** ***** ****************

00FC3000 IECVPRNT 000004F8 31
Nucleus (R/W)

00FC34F8 IECVAFP1 00000780 31
Nucleus (R/W)

00FC3C78 CBROPDDT 0000004C 24
Nucleus (R/W)

00FC3CC8 IECVDDTR 0000021C 24
Nucleus (R/W)

00FC3EE8 IECVDDT5 0000004C 24
Nucleus (R/W)

00FC3F38 IOSVDDTD 0000004C 24
Nucleus (R/W)

00FC3F88 IOSVDDTE 0000004C 24
Nucleus (R/W)

00FC3FD8 IOSVDDTS 0000004C 24
Nucleus (R/W)

00FC4028 IGGDDT01 00000282 24
Nucleus (R/W)

00FC42B0 IECDPERF 0000014C 24
Nucleus (R/W)

00FC4400 IRDVDDT
00000048 24
Nucleus (R/W)

The suffix of the IEANUC0x module used to IPL the system, the address of the NUCMAP,
and the total CSECTs found in the four nucleus areas are displayed in the header. This
screen is sorted by Entry Point address. If you know the name of a nucleus CSECT, but do
not know where it is located, enter the name in the mask line under the CSECT Name
column heading to find it. For example, if you want to locate all IGC CSECTs, enter IGC
in the first three positions of the mask line, as shown in Figure 17-66.
Analyzing MVS Virtual Storage
17-41
Figure 17-66. Nucleus Map Screen, Masked
Abend-AID ----------------- Nucleus Map ---------------- Row 000001 of 000022 
COMMAND ===>
SCROLL ===> DATA 

NUCMAP Address........................ 016487B0

Nucleus suffix (IEANUC0x)............. 1

Number of Read/Write CSECTs........... 75

Number of Read Only CSECTs............ 87

Number of Ext Read Only CSECTs........ 1,613

Number of Ext Read/Write CSECTs....... 121


Entry
CSECT
CSECT

Point
Name
Length
Amode Storage Area

******** IGC***** ******** ***** ****************

00FC4740 IGC247
00001A30 ANY
Nucleus (R/W)

00FC6170 IGC246
00000048 ANY
Nucleus (R/W)

00FC98A8 IGC234
00000B51 24
Nucleus (R/W)

00FCA400 IGC231
00000B59 24
Nucleus (R/W)

00FCAF60 IGC214
00000A80 24
Nucleus (R/W)

00FCB9E0 IGC203
00000A98 24
Nucleus (R/W)

00FD3A38 IGC037
000000DC 24
Nucleus (R/W)

00FD3B18 IGC117
000005A8 24
Nucleus (R/W)

00FEE718 IGC123
00000E70 31
Nucleus (R/O)

00FF6578 IGC043
00000190 ANY
Nucleus (R/O)

00FFB7F0 IGC111
000000DD 24
Nucleus (R/O)

Enter the RESET primary command on the Command line to reset the display. Enter Ext
Nuc (R/O) in the mask line under the Storage Area column heading to display only
modules located in the extended read-only nucleus, as shown in Figure 17-67.
Figure 17-67. Nucleus Map Screen, Masked
Abend-AID ----------------- Nucleus Map ---------------- Row 000001 of 001613 
COMMAND ===>
SCROLL ===> DATA 

NUCMAP Address........................ 016487B0

Nucleus suffix (IEANUC0x)............. 1

Number of Read/Write CSECTs........... 75

Number of Read Only CSECTs............ 87

Number of Ext Read Only CSECTs........ 1,613

Number of Ext Read/Write CSECTs....... 121


Entry
CSECT
CSECT

Point
Name
Length
Amode Storage Area

******** ******** ******** ***** EXT*NUC*(R/O)***

01000000 IECVXURS 000000F0 31
Ext Nuc (R/O)

010000F0 IECVXURT 00000028 31
Ext Nuc (R/O)

01000118 IOSVEOSC 00000510 31
Ext Nuc (R/O)

01000628 CBROPDSE 000001D8 31
Ext Nuc (R/O)

01000800 IECTTRAP 000006D8 31
Ext Nuc (R/O)

01000ED8 IECVXT6S 00000450 31
Ext Nuc (R/O)

01001328 IECVXT6U 00000228 31
Ext Nuc (R/O)

01001550 IGGSNS02 00000EF0 31
Ext Nuc (R/O)

01002440 IECTDSRV 00001EB8 31
Ext Nuc (R/O)

010042F8 IECTDSR2 00002450 31
Ext Nuc (R/O)

01006748 IECVTMIH 000003E0 31
Ext Nuc (R/O)

Another way to list only modules in the extended read-only nucleus is to use the cursor
point-and-shoot feature and press Enter at the Starting Address field for the extended
nucleus (R/O) on the Virtual Storage Map screen. However, doing so does not display the
amode information on the Nucleus Map because the Allocated Storage Map with modules
from the extended read-only nucleus is displayed, as shown in Figure 17-68.
17-42
Abend-AID for CICS User’s Guide
Figure 17-68. Allocated Storage Map Screen
Abend-AID ----------------- Allocated Storage Map ---------------- Row 000001 
COMMAND ===>
SCROLL ===> DATA 
==> 
Starting Ending
Number
E/PVT Sp
TCB

Address
Address
of Pages
Area
Area
Id
Key Ownership Address
******** ******** ********
*********** ***** *** *** ********* *******
01000000 010000EF
Ext Nuc-R/O

010000F0 01000117
Ext Nuc-R/O

01000118 01000627
Ext Nuc-R/O

01000628 010007FF
Ext Nuc-R/O

01000800 01000ED7
Ext Nuc-R/O

01000ED8 01001327
Ext Nuc-R/O

01001328 0100154F
Ext Nuc-R/O

01001550 0100243F
Ext Nuc-R/O

01002440 010042F7
Ext Nuc-R/O

010042F8 01006747
Ext Nuc-R/O

01006748 01006B27
Ext Nuc-R/O

01006B28 010079B7
Ext Nuc-R/O

010079B8 01007BBF
Ext Nuc-R/O

01007BC0 01007C67
Ext Nuc-R/O

01007C68 01007CBF
Ext Nuc-R/O

01007CC0 01008AD7
Ext Nuc-R/O

01008AD8 01008ED7
Ext Nuc-R/O

01008ED8 01009077
Ext Nuc-R/O

Allocated Storage Map
The Allocated Storage Map displays all allocated storage through x'7FFFFFFF', including
the nucleus and link pack areas providing the nucleus map and/or LPA queues are
included in the SVC dump dataset. After you select the dump, enter the ASMAP fast-path
command on any Command line or select the ASMAP option (6) from the MVS Storage
Analysis menu to display all allocated storage, as shown in Figure 17-69. All virtual
storage areas are included.
Figure 17-69. Allocated Storage Map Screen
Abend-AID ------------ Allocated Storage Map ----------- Row 000001 of 009109 
COMMAND ===>
SCROLL ===> DATA 
==> 
Starting Ending
Number
E/PVT Sp
TCB

Address
Address
of Pages
Area
Area
Id
Key Ownership Address
******** ******** ********
*********** ***** *** *** ********* *******
00005000 00005FFF
1
Private
USER
0
7 OWN,SHR
007FDE8
00006000 00007FFF
2
Private
USER
251
7 OWN
007E2D9
00008000 00008FFF
1
Private
USER
252
0 OWN
007E2D9
00009000 00009FFF
1
Private
USER
251
7 OWN
007E2D9
0000A000 0000AFFF
1
Private
USER
0
7 OWN,SHR
007FDE8
0000B000 0000CFFF
2
Private
USER
251
7 OWN
007E2D9
0000D000 00011FFF
5
Private
USER
0
7 OWN,SHR
007FDE8
00012000 0001FFFF
14
Private
USER
251
7 OWN
007E2D9
00020000 0005AFFF
59
Private
USER
0
7 OWN,SHR
007FDE8
0005B000 0005FFFF
5
Private
USER
251
7 OWN
007E2D9
00060000 00060FFF
1
Private
USER
127
7 OWN
007E2D9
007C0000 007C1FFF
2
Private
SWA
236
1 OWN,SHR
007FDE8
007C4000 007CCFFF
9
Private
SWA
236
1 OWN,SHR
007FDE8
007CD000 007CDFFF
1
Private
AUTH
230
7 OWN
007E2D9
007CE000 007CEFFF
1
Private
LSQA
255

007CF000 007CFFFF
1
Private
AUTH
230
0 OWN
007E2D9
007D0000 007D0FFF
1
Private
LSQA
255

007D1000 007D1FFF
1
Private
AUTH
230
5 OWN
007FDE8
Alternatively, selecting a virtual storage area’s starting address on the Virtual Storage Map
displays only that area’s entries from the map. For example, use the cursor point-andshoot feature and press Enter at the Starting Address field for extended SQA to display a
subset of the Allocated Storage Map including only allocated storage for extended SQA, as
shown in Figure 17-70.
Analyzing MVS Virtual Storage
17-43
Figure 17-70. Allocated Storage Map Screen for Extended SQA





TCB

Address
*******
















Abend-AID ------------ Allocated Storage Map ----------- Row 000001 of 000794
COMMAND ===>
SCROLL ===> DATA
==>
Number of ESQA entries...... 794
Number of ESQA pages.... 4,848
Starting
Address
********
019E4000
01A9C000
01AC2000
01AC3000
01B31000
01B35000
01B36000
01B37000
01B38000
01B3A000
01B3D000
01B3F000
01B7E000
01B80000
01B8A000
01B8C000
Ending
Address
********
019EBFFF
01AC1FFF
01AC2FFF
01B30FFF
01B34FFF
01B35FFF
01B36FFF
01B37FFF
01B39FFF
01B3CFFF
01B3EFFF
01B7DFFF
01B7FFFF
01B89FFF
01B8BFFF
01B8FFFF
Number
of Pages
********
8
38
1
110
4
1
1
1
2
3
2
63
2
10
2
4
Area
***********
Ext SQA
Ext SQA
Ext SQA
Ext SQA
Ext SQA
Ext SQA
Ext SQA
Ext SQA
Ext SQA
Ext SQA
Ext SQA
Ext SQA
Ext SQA
Ext SQA
Ext SQA
Ext SQA
E/PVT
Area
*****
Sp
Id
***
245
245
248
245
247
239
245
239
245
248
245
248
245
247
248
245
Key
***
Ownership
*********
The number of pages found allocated in the Extended SQA is displayed in the header.
Multiplying these by 4096 and then dividing by 1024 equals the amount listed under the
column for extended SQA on the Virtual Storage Map. Because the Allocated Storage Map
is sorted by starting address, enter the BOTTOM primary command, or type MAX on the
Command line and then press the DOWN (PF8) key to display the highest addresses
allocated to the extended SQA. Because the defined extended CSA starting address is after
the ending address of the extended SQA, all of the converted extended CSA pages are at
the end of the extended SQA, as shown in Figure 17-71.
Figure 17-71. Allocated Storage Map Screen for Extended SQA





Starting Ending
Number
E/PVT Sp
TCB

Address
Address
of Pages
Area
Area
Id
Key Ownership Address
******** ******** ********
*********** ***** *** *** ********* *******
09BE4000 09BE9FFF
6
Ext SQA <
245

09BF4000 09BF4FFF
1
Ext SQA <
245

09BF8000 09BF8FFF
1
Ext SQA <
239

09D1A000 09D1AFFF
1
Ext SQA <
245

09E1E000 09E1EFFF
1
Ext SQA <
239

0A085000 0A085FFF
1
Ext SQA <
245

0A358000 0A358FFF
1
Ext SQA <
245

0A37B000 0A37BFFF
1
Ext SQA <
245

0A5E3000 0A5E3FFF
1
Ext SQA <
245

0A5E9000 0A5E9FFF
1
Ext SQA <
245

0A661000 0A66EFFF
14
Ext SQA <
245

0B1C4000 0B1C4FFF
1
Ext SQA <
245

0B1D3000 0B1D3FFF
1
Ext SQA <
245

0B1F8000 0B1F8FFF
1
Ext SQA <
245

0B228000 0B22BFFF
4
Ext SQA <
245

****************************** BOTTOM OF DATA *********************************
Abend-AID ------------ Allocated Storage Map ----------- Row 000780 of 000794
COMMAND ===>
SCROLL ===> DATA
==>
Number of ESQA entries...... 794
Number of ESQA pages.... 4,848
Use masking and sorting on the Allocated Storage Map screen. Enter Ext SQA < in the
mask line under the Area column heading to display only converted CSA pages in the
extended SQA, as shown in Figure 17-72. Now that only converted extended SQA pages
are listed, type SORT on the Command line, place the cursor on the Number of Pages
column heading, and press Enter. Total the number of pages and multiply by 4096. Next,
divide by 1024 for the amount of extended CSA converted in kilobytes. This amount
17-44
Abend-AID for CICS User’s Guide
should equal the amount displayed on the Common Service Area Summary screen or the
SQA Summary screen.
Figure 17-72. Allocated Storage Map Screen, Masked





Starting Ending
Number
E/PVT Sp
TCB

Address
Address
of Pages
Area
Area
Id
Key Ownership Address
******** ******** ********
EXT*SQA*<** ***** *** *** ********* *******
09BE4000 09BE9FFF
6
Ext SQA <
245

09BF4000 09BF4FFF
1
Ext SQA <
245

09BF8000 09BF8FFF
1
Ext SQA <
239

09D1A000 09D1AFFF
1
Ext SQA <
245

09E1E000 09E1EFFF
1
Ext SQA <
239

0A085000 0A085FFF
1
Ext SQA <
245

0A358000 0A358FFF
1
Ext SQA <
245

0A37B000 0A37BFFF
1
Ext SQA <
245

0A5E3000 0A5E3FFF
1
Ext SQA <
245

0A5E9000 0A5E9FFF
1
Ext SQA <
245

0A661000 0A66EFFF
14
Ext SQA <
245

0B1C4000 0B1C4FFF
1
Ext SQA <
245

0B1D3000 0B1D3FFF
1
Ext SQA <
245

0B1F8000 0B1F8FFF
1
Ext SQA <
245

0B228000 0B22BFFF
4
Ext SQA <
245

****************************** BOTTOM OF DATA *********************************
Abend-AID ------------ Allocated Storage Map ----------- Row 000573 of 000587
COMMAND ===>
SCROLL ===> DATA
==>
Number of ESQA entries...... 794
Number of ESQA pages.... 4,848
64-bit Memory Analysis
The Memory Objects screen (as shown in Figure 17-73) displays information on memory
objects that were allocated using the IARV64 macro (storage above the bar). Since the
GETMAIN, FREEMAIN, and STORAGE macros do not work for virtual storage above the
bar, the IARV64 macro, which works in a similar way, is used instead. When a program
no longer needs an allocated memory object, IARV64 releases it.
Navigate to the Memory Objects screen (Figure 17-73) from the MVS Storage Analysis
Menu (see Figure 17-2 on page 17-2). You can also access this screen, after selecting a
region dump, by entering the MEMOBJ fast-path command from the Command line on
any Abend-AID for CICS screen.
Figure 17-73. Memory Objects Screen


Abend-AID ------------------- Memory Objects ----------- Row 000001 of 000004 
COMMAND ===>
SCROLL ===> PAGE 
==> 
Number of memory objects allocated.... 4 
Total storage allocated (MB).......... 16 
Total guard allocate (MB)............. 4 
High Water Mark for Storage (MB)...... 12 
MEMLIMIT size (MB).................... NOLIMIT 
Source of MEMLIMIT.................... Set by SMF 
Number of shared memory objects....... 0 
Guard 
Starting Address Ending Address
Object Size(MB)
Guard Size(MB)
Locati
***************** ***************** **************** **************** ******
00000001_00000000 00000001_002FFFFF
4
1 HIGH 
00000001_00400000 00000001_006FFFFF
4
1 HIGH 
00000001_00800000 00000001_00AFFFFF
4
1 HIGH 
00000001_00D00000 00000001_00FFFFFF
4
1 LOW

****************************** BOTTOM OF DATA *********************************
Analyzing MVS Virtual Storage
17-45
Program storage above the bar is virtual storage that is acquired in chunks called memory
objects. These memory objects are allocated as one or more virtual segments, of which
each segment is one megabyte in size. Each segment begins on a megabyte boundary. In
Figure 17-73, four memory objects for this address space were allocated.
The rest of the header specifies the amount of storage in megabytes for the following
types of storage:
• Total storage allocated
• Total guard storage allocated
• High Water Mark for Storage — the highest amount of allocated storage above the bar
(64-bit) for the life of the address space.
• MEMLIMIT size — the maximum amount of storage that can be allocated above the
bar in the address space.
• Source of MEMLIMIT — where the MEMLIMIT value was set. In Figure 17-73 it was
set by SMF.
• Number of shared memory objects — Shared memory objects are system owned.
Figure 17-73 shows no shared memory objects.
The Starting Address and Ending Address columns list the starting and ending addresses
for each allocated memory object. The number of lines should correspond to the number
of memory objects allocated. The HEXD command is valid for these columns. It displays
storage in hexadecimal format. To use this command, type HEXD on the Command line,
place the cursor in the Starting Address or Ending Address field, and press Enter. The
Memory Display screen for the selected starting or ending address appears.
The other columns show the object size, guard size, and guard location within the
memory object. The Requestor column displays the return address in the program that
used the IARV64 macro to create the memory object. The key column displays the storage
protect key assigned to the memory object.
FPROT specifies whether the memory object is fetch protected. The default is
FPROT=YES. If set to YES, the entire memory object will be fetch protected. A program
must have a PSW key that matches the storage key of the memory object (or have PSW
key of 0) to reference data in the memory object. If set to NO, the memory object is be
fetch protected.
SVC specifies whether the memory object should be included in an SVC dump when a
region dump is requested. The default is SVCDUMPRGN=YES. If SVCDUMPRGN=YES, the
SVC dump includes in its virtual storage capture for the owning address space the usable
area of the memory object whenever SDATA=RGN is specified. If SVCDUMPRGN=NO, the
SVC dump option SDATA=RGN does not include the virtual storage of this memory
object in the dump.
The User Token column specifies the user tokens assigned by a program. A program can
specify that both private and shared memory objects use one user token. Then, when
memory is released, the designated private memory objects will be released and the
portion of the shared memory objects specified by the user token will also be removed
from the shared memory object.
17-46
Abend-AID for CICS User’s Guide
18-1
Chapter 18.
Analyzing WebSphere MQ Queue Manager Dumps
Chap 18
If your site is licensed to use the Abend-AID for WebSphere MQ cost option, you can
access detailed WebSphere MQ queue manager (QMGR) information related to the QMGR
abend that caused the dump.
This chapter describes the following screens:
•
•
•
•
•
•
•
•
•
•
•
•
“Task List Screen” on page 18-1
“Execution Block(s) Screen” on page 18-3
“Execution Block Detail Screen” on page 18-3
“Active Handles Screen” on page 18-4
“Handle Detail Screen” on page 18-5
“Connected Address Spaces Screen” on page 18-5
“Agent Control Elements Screen” on page 18-6
“WebSphere MQ Information Menu” on page 18-7
“Communication Vector Table Screen” on page 18-8
“Early Processing Block Screen” on page 18-8
“System Communication Block” on page 18-9
“Release Information Block” on page 18-10
Task List Screen
The Task List screen (Figure 18-1 and Figure 18-2) displays WebSphere MQ task
information, which is derived from several control blocks such as the ASCE, ACE and
CCB. Access this screen in one of the following ways:
• From the Abend-AID Directory, type the m line command next to the report of
interest and press Enter. Then select the TASKS option from the Primary Options
menu.
• From the Connected Address Spaces screen (Figure 18-8 on page 18-6), use the T line
command.
• Use the TASKS fast-path command from any screen within the selected report.
Depending upon the way you access the Task List screen, it either displays the tasks for
all connected address spaces or for the selected address space.
18-2
Abend-AID for CICS User’s Guide
Figure 18-1. Task List Screen








CCB 
Addr
****
314D
314D
3157
3150
3150
3150
3157
3169
3169
3169
316B
316B
316B
Abend-AID --------------------- Task List -------------- Row 000001 of 000029
COMMAND ===>
SCROLL ===> PAGE
==>
Number of CICS Tasks.........
2 Number of Batch Tasks........
1
Number of IMS/DC Tasks.......
5 Number of System Tasks.......
21
E List Execution Block(s)
Connect
Name
********
M210
M210
M210
M210
M210
M210
M210
M210
M210
M210
M210
M210
M210
Job Name
********
M210MSTR
M210MSTR
M210MSTR
M210MSTR
M210MSTR
M210MSTR
M210MSTR
M210MSTR
M210MSTR
M210MSTR
M210MSTR
M210MSTR
M210MSTR
Original
Userid
********
SYSOPR
SYSOPR
SYSOPR
SYSOPR
SYSOPR
SYSOPR
SYSOPR
SYSOPR
SYSOPR
SYSOPR
SYSOPR
SYSOPR
SYSOPR
H List Active Handle(s)
Tran Id
********
Task Id or
TCB Address
***********
008BD560
008BD780
008BD9A0
008BDB38
008B8E88
008B86F8
008B51B0
008C1078
008C1528
008C19D8
008C1E88
008C0840
008C0CF0
Task
Type
********
SYSTEM
SYSTEM
SYSTEM
SYSTEM
SYSTEM
SYSTEM
SYSTEM
SYSTEM
SYSTEM
SYSTEM
SYSTEM
SYSTEM
SYSTEM
ACE
Address
********
314D2158
31571ED8
31571C98
31571938
315714B8
31571818
31571158
3169E6F8
3169E4B8
3169E278
3169E038
316F9ED8
316F9C98
Use the Right and Left keys to scroll the report right or left.
Figure 18-2. Task List Screen Scrolled Right








Thread 
Address 
********




7F5BC038







Abend-AID --------------------- Task List -------------- Row 000001 of 000029
COMMAND ===>
SCROLL ===> PAGE
<==
Number of CICS Tasks.........
2 Number of Batch Tasks........
1
Number of IMS/DC Tasks.......
5 Number of System Tasks.......
21
E List Execution Block(s)
Connect
Name
********
M210
M210
M210
M210
M210
M210
M210
M210
M210
M210
M210
M210
M210
Job Name
********
M210MSTR
M210MSTR
M210MSTR
M210MSTR
M210MSTR
M210MSTR
M210MSTR
M210MSTR
M210MSTR
M210MSTR
M210MSTR
M210MSTR
M210MSTR
Task
Type
*******
YSTEM
YSTEM
YSTEM
YSTEM
YSTEM
YSTEM
YSTEM
YSTEM
YSTEM
YSTEM
YSTEM
YSTEM
YSTEM
H List Active Handle(s)
ACE
Address
********
314D2158
31571ED8
31571C98
31571938
315714B8
31571818
31571158
3169E6F8
3169E4B8
3169E278
3169E038
316F9ED8
316F9C98
CCB
Address
********
314D3728
314D3288
31570978
3150CBC8
3150C4D8
3150C288
31570288
3169C978
3169C4D8
3169C038
316B4978
316B44D8
316B4038
Primary
EB
********
314D21B8
31571F38
31571CF8
31571998
31571518
31571878
315711B8
3169E758
3169E518
3169E2D8
3169E098
316F9F38
316F9CF8 
RAL
Address
********
316F7F68
316F7B08
Use the cursor point-and-shoot feature on any selectable address fields to display storage
information.
Enter one of the following line commands next to the task(s) of interest and press Enter:
E
Displays the Execute Block(s) screen for the selected task. See “Execution Block(s)
Screen” on page 18-3.
Analyzing WebSphere MQ Queue Manager Dumps
18-3
H
Displays the Active Handles screen for the selected task. See “Active Handles Screen”
on page 18-4.
Execution Block(s) Screen
The Execution Block(s) screen (Figure 18-3) displays a list of Execution Blocks (EBs) for a
specific Agent Control Element (ACE) which represents a task or thread of a connected
address space. There may be more than one EB associated with an agent. Chained from
each EB is an Execution Unit (EU) which represents either a Task Control Block or Service
Request Block unit of work.
Access this screen by entering the E line command next to the desired tasks on the Task
List screen (Figure 18-1 on page 18-2).
Figure 18-3. Execution Block(s) Screen
Abend-AID ----------------- Execution Block(s) --------- Row 000001 of 000001 
COMMAND ===>
SCROLL ===> PAGE 

ACE Address........ 315714B8

Type of Task....... SYSTEM

TCB Address........ 008B8E88


D Execution Block Detail


EB
EB
EU
EU
ROB

Address
Type Address
Type In Control
Address
SA or RB

******** **** ******** **** *********** ******** ********

31571518 Pri
008B8E88 TCB
WebSphere M 31FD0B48 008B8220

***************************** BOTTOM OF DATA ********************************
Use the cursor point-and-shoot feature on any selectable address field to display storage
information.
To display the Execution Block Detail Screen, type the D line command next to the EB(s)
of interest and press Enter. See “Execution Block Detail Screen” on page 18-3.
Execution Block Detail Screen
The Execution Block Detail screen (Figure 18-4) displays detailed information for a
specific Execution Block (EB) which represents an Execution Unit (EU), a Task Control
Block (TCB), or Service Request Block (SRB). These MVS constructs may reside in an allied
address space making the TCB or SRB inaccessible from the Queue Manager address space
storage. For system tasks the TCB or SRB is viewable because it is in local storage.
Access this screen by entering the D line command next to the desired EB on the
Execution Block(s) screen (Figure 18-3 on page 18-3).
18-4
Abend-AID for CICS User’s Guide
Figure 18-4. Execution Block Detail Screen
Abend-AID --------------- Execution Block Detail ---------------------------- 
COMMAND ===>


EB address.................. 31571518 EB type.................. Primary

EU address.................. 008B8E88 EU type.................. TCB

Last spawned EB address..... 00000000 In control............... WebSphere M

ROB address................. 31FD0B48 EU owns log cursor....... No

Savearea or request block... 008B8220 Waiting on unrelated EU.. No

Home ASCE address........... 3277C1D0 Deferred recovery active. No

Primary ASCE address........ 3277C1D0 Retries disabled......... No

Latch waiters ROB........... 00000000 Synch on termination..... No

Latch address............... 00000000

ASID of latch............... 0000

Task type................... Service task+Latch/resume


General Purpose Registers

Reg 0
Reg 1
Reg 2
Reg 3
Reg 4
Reg 5
Reg 6
Reg 7

00000498 7DDE3248 00000000 7DDE3408 000007F1 3277C1D0 31571518 00FE8300

Reg 8
Reg 9
Reg 10
Reg 11
Reg 12
Reg 13
Reg 14
Reg 15

00000B80 317268B0 00FD4600 7DDE3248 B707B43A 000100DD B707B9C4 7DEF00A0


Use the cursor point-and-shoot feature on any selectable address field to display storage
information.
Active Handles Screen
The Active Handles screen (Figure 18-5) displays a list of object handles (MHNDs) for a
specific Agent Control Element (ACE) which represents a task or thread. There may be up
to 25 MHNDs associated with an agent.
Access this screen by entering the H line command next to the desired task on the Task
List screen (Figure 18-1 on page 18-2).
Figure 18-5. Active Handles Screen
Abend-AID ------------------ Active Handle(s) ---------- Row 000001 of 000001 
COMMAND ===>
SCROLL ===> PAGE 

Thread Address.............. 7F5BC038

Handle Vector Address....... 7E3DCE08

Number of Handles........... 1


D Handle Detail


Handle
Sequence Queue

Address
Number
Type

******** ******** ******

7DEC9038
1 Local

***************************** BOTTOM OF DATA ********************************

Use the cursor point-and-shoot feature on any selectable address field to display storage
information.
To display the Handle Detail screen (Figure 18-6), type the D line command next to the
Handles of interest and press Enter.
Analyzing WebSphere MQ Queue Manager Dumps
18-5
Handle Detail Screen
The Handle Detail screen (Figure 18-6) displays detailed information for the selected
object handle (MHND). It shows the queue names, the flag bytes, and the addresses of
Data Manager objects (IVSAs) that are shared with Message Manager. The Message
Manager contains pointers to other key control blocks such as the MPDO and MQLO.
Access this screen by entering the D line command next to the desired Handles on the
Active Handles screen (Figure 18-5).
Figure 18-6. Handle Detail Screen
Abend-AID ------------------- Handle Detail --------------------------------- 
COMMAND ===>


Select OPEN, GET, PUT, or CLOSE to display interpreted options


Handle Address.............. 7DEC9038 Queue Type.................. Local

Sequence Number............. 1
Permanent Dynamic Queue..... No

Named Object IVSA........... 7F0705E8 Temporary Dynamic Queue..... No

Base Object IVSA............ 7F0705E8 Transmit Queue Opened....... No

Alias Object IVSA........... 7F0705E8 Transmit Queue Direct....... No

Local XmitQueue IVSA........ 7F0705E8 Default Transmit Queue...... No

Message Id on MQGET.........

Correlation Id on MQGET.....


Queue Names

CSGMO Resolved Name........ SYSTEM.COMMAND.INPUT

CSPMO Resolved Name........ SYSTEM.COMMAND.INPUT

Named Object Name.......... SYSTEM.COMMAND.INPUT

Base Object Name........... SYSTEM.COMMAND.INPUT


Use the cursor point-and-shoot feature on:
• Any selectable address field to display storage information.
• OPEN, GET, PUT or CLOSE to display the call options that are found in the handle
(MHND) for the selected object.
Connected Address Spaces Screen
The Connected Address Spaces screen (Figure 18-7) displays a list of the address spaces
that were connected to the queue manager (QMGR) address space at the time of the
dump. Each entry represents an Address Space Control Element (ASCE) that was chained
from the subsystem communication block (SCOM). An ASCE is created when an address
space is started. It contains address space information. Access this screen in one of the
following ways:
• From the Abend-AID Directory, type the m line command next to the report of
interest and press Enter. Then select the CONNECT option from the Primary Options
menu.
• Use the CONNECT fast-path command from any screen within the selected report.
18-6
Abend-AID for CICS User’s Guide
Figure 18-7. Connected Address Spaces Screen










ASCB
ASCE
VLCA
A
******** ******** ******** *
00F6A980 3277C1D0 31C9B038 C
00F88400 3277C290 31504008 M
00EF1380 3277C350 31C9B0B0 A
00F4CB80 3277C410 31C9B128 A
00F99400 3277C4D0 31C9B1A0 A
********************************


Abend-AID -------------- Connected Address Spaces ------ Row 000001 of 000005
COMMAND ===>
SCROLL ===> PAGE
==>
Control Address Spaces.........
1 MVS/RRS Address Spaces.........
1
Resource Manager Address Spaces
0 MVS/RRS Dynamic Address Spaces.
0
Allied Address Spaces..........
3
A List ACE(s)
T List Task(s)
Connect
Connect
Name
Type
Job Name
******** ******** ********
M210
M210MSTR
M210
RRS
M210CHIN CHIN
M210CHIN
CANSMQ
BATCH
CANSMQ
H01AC098 CICS
H01AC098
*****************************
Primary
Userid
********
ASID
****
00DD
0030
M210CHIN 0118
CANSMQ
0149
PFHRHH0
01B3
BOTTOM OF DATA
Use the Right and Left keys to scroll to the right and left sides of the screen.
Figure 18-8. Connected Address Spaces Screen Right Side of Screen







A List ACE(s)
T List Task(s)


Connect
Connect

Name
Type
Job Name ASCB
ASCE
VLCA
Address Space Type
******** ******** ******** ******* ******** ******** ******************
M210
M210MSTR 0F6A980 3277C1D0 31C9B038 Control

M210
RRS
0F88400 3277C290 31504008 MVS/RRS

M210CHIN CHIN
M210CHIN 0EF1380 3277C350 31C9B0B0 Allied

CANSMQ
BATCH
CANSMQ
0F4CB80 3277C410 31C9B128 Allied

H01AC098 CICS
H01AC098 0F99400 3277C4D0 31C9B1A0 Allied

***************************** BOTTOM OF DATA ********************************
Abend-AID -------------- Connected Address Spaces ------ Row 000001 of 000005
COMMAND ===>
SCROLL ===> PAGE
<==
Control Address Spaces.........
1 MVS/RRS Address Spaces.........
1
Resource Manager Address Spaces
0 MVS/RRS Dynamic Address Spaces.
0
Allied Address Spaces..........
3
Use the cursor point-and-shoot feature on the ASCB, ASCE, or VLCA fields to display
storage information.
Enter one of the following line commands next to the address space(s) of interest and
press Enter:
A
Displays the Agent Control Elements screen for the selected address space. See “Agent
Control Elements Screen” on page 18-6.
T
Displays the Task List screen for the selected address space. See “Task List Screen” on
page 18-1.
Agent Control Elements Screen
The Agent Control Elements screen (Figure 18-9) displays a list of Agent Control
Elements (ACEs) originating from a connected address space (ASCE). An ACE represents a
unit of work that can be recoverable or non-recoverable, such as a CICS/CTS task or DB2
Analyzing WebSphere MQ Queue Manager Dumps
18-7
thread. It is the focal point for resource(s) and process(es) associated with an agent,
which describe the resource(s) and process(es) of the agent at the time the SVC dump was
taken.
Access this screen by entering the A line command next to the desired address(es) on the
Connected Addresses Spaces screen (Figure 18-7 on page 18-6).
Figure 18-9. Agent Control Elements Screen
Abend-AID --------------- Agent Control Elements ------- Row 000001 of 000045 
COMMAND ===>
SCROLL ===> PAGE 

Connection Name............... M210

ASCE Address.................. 321D7200

VLCA Address.................. 316B3038


R List RALE(s)


ACE
Abend
Reason
CCB
EB

Address
Progress State
Code
Code
Address
Address

******** ****************** ******** ******** ******** ********

30B4A938 Inflight
30A5FA98 30B4A998

30B4A4B8 Inflight
30A40A98 30B4A518

30B4A038 Inflight
30A40568 30B4A098

30A59DB8 Inflight
30A40038 30A59E18

30A59B78 Inflight
30B4B2D0 30A59BD8

30A59938 Inflight
30A58D30 30A59998

30A596F8 Inflight
30A58800 30A59758

30A594B8 Inflight
30A582D0 30A59518

30A59278 Inflight
30A5F038 30A592D8

30A59038 Inflight
30A5CD30 30A59098

30B4ADB8 Inflight
30A5C800 30B4AE18

30B4AC98 Inflight
30A5C2D0 30B4ACF8 
Use the cursor point-and-shoot feature on any selectable address field to display storage
information.
WebSphere MQ Information Menu
Access MQ information relevant to the WebSphere MQ queue manager dump through
the WebSphere MQ Information Menu (Figure 18-10). Display the menu in one of the
following ways:
• From the Abend-AID Directory, type the m line command next to the report of
interest and press Enter. Then select the MQSINFO option from the Primary Options
menu.
• Use the MQSINFO fast-path command from any screen within the selected report.
Figure 18-10. WebSphere MQ Information Menu for Queue Manager Dumps
Abend-AID -------------- WebSphere MQ Information --------------------------- 
OPTION ===>


1 SSCVT
Subsystem Communications Vector Table


2 ERLY
ERLY


3 SCOM
Subsystem Communcation Block


4 RIB
Release Information Block


18-8
Abend-AID for CICS User’s Guide
On the Command line, type one of the following option numbers and press Enter:
• 1 to view detailed subsystem communication vector table information. See
“Communication Vector Table Screen” on page 18-8.
• 2 to view early processing block information. See “Early Processing Block Screen” on
page 18-8.
• 3 to view subsystem communication block information. See “System
Communication Block” on page 18-9.
• 4 to view WebSphere MQ release information. See “Release Information Block” on
page 18-10.
Communication Vector Table Screen
The Communication Vector Table screen (Figure 18-11) displays WebSphere MQ
subsystem communication vector table information.
To access this screen, select option 1 SSCVT from the WebSphere MQ Information Menu
(Figure 18-10) or use the SSCVT fast-path command from any screen within the selected
report.
Figure 18-11. Communication Vector Table Screen
Abend-AID ------------ Communications Vector Table -------------------------- 
COMMAND ===>


SSCVT Address...................... 00CF46E8


Next SSCVT Address................. 00CF470C

Subsystem Name..................... M210

Subsystem Vector Table Address..... 36A957A8

Subsystem User Field 1 (SSCTSUSE).. 36AA1020

Subsystem User Field 2 (SSCTSUS2).. 00000000



Use the cursor point-and-shoot feature on any selectable address field to display storage
information.
Early Processing Block Screen
The Early Processing Block screen (Figure 18-12) displays ERLY control block
information.
To access this screen, select option 2 ERLY from the WebSphere MQ Information Menu
(Figure 18-10) or use the ERLY fast-path command from any screen within the selected
report.
Analyzing WebSphere MQ Queue Manager Dumps
18-9
Figure 18-12. Early Processing Block Screen
Abend-AID --------------- Early Processing Block ---------------------------- 
COMMAND ===>


ERLY Address............. 36AA1020


ERLY Code Module Name.... CSQ3EPX
SSCVT Address............ 00CF46E8

ERLY Code Module Length.. 1363
Program Request Handler.. 36A96D58

Subsystem Name........... M210
Online Request Handler... 31F82300

Procedure Name........... M210MSTR
ASID..................... 00DD

Affinity Index........... 0022
Terminated ASIDs Queue... 00000000

Subsystem Recognition Cha 4E
EEPL Address............. 36A95540

Component ID............. L8200
Command Queue............ 00000000

Component ID Base Number. 5655
Notify Message Queue..... 00000000

Comm Block Address....... 3277C000
Notify Message Queue User 0000

Start Command Console ID. 00000000
Command Prefix........... +M210

PC Linkage Index Value... 00180400
Command Prefix SCOPE..... X

SSVT Address............. 36A957A8

Flags.................... 9C New ERLY Command Processing is present

Early code supports EMCS

WebSphere MQ code supports EMCS


Use the cursor point-and-shoot feature on any selectable address field to display storage
information.
System Communication Block
The System Communication Block screen (Figure 18-13) displays system communication
block information.
To access this screen, select option 3 SCOM from the WebSphere MQ Information Menu
(Figure 18-10) or use the SCOM fast-path command from any screen within the selected
report.
Figure 18-13. System Communication Block Screen
Abend-AID ------------- System Communication Block -------------------------- 
COMMAND ===>


SCOM Address............... 3277C000


ASCE Address............... 3277C1D0 Abnormal Term Work Area.... 00000000

RMVT Address............... 324C24B0 Abnormal Termination....... No

SCT Address................ 7F4EACB0 Local LU Name..............

CCB Address................ 32444DB0 Subsystem Resource Name.... MQCONN

IPC Pending Function....... 00000000 Archive Log Latch.......... 00000000

PCL Address................ 7F5FC328 Dummy RMFT Address......... 00000000

PCL Length................. 00B4
INIT/TERM CCB.............. 00000000

IPC Message Buffer......... 7F800C18 Mover Start Chinit Parm.... M210XPRM

Shutdown Type..............
QMGR Start Parm............ M210PARM

Dump Work Area............. 3247B000 ACE Chain.................. 00000000

Dump Work Area Length...... 6000
RIB Address................ 00C752E8

MEPL Address............... 7DE16000 Control Memory ASID........ 00DD

MEPL Length................ 0000
Queue Sharing Group Name...

Restart Proc Resume ROB.... 31FD0968 QMGR QSG Identifier........ 00

RRS ASCE Address........... 3277C290 Latch Set Token............ 7F800008

RRS Resource Manager Token. 01ECE030

Highest Used Log RBA....... 0000150D4874


Use the cursor point-and-shoot feature on any selectable address field to display storage
information.
18-10
Abend-AID for CICS User’s Guide
Release Information Block
The Release Information Block screen (Figure 18-14) displays WebSphere MQ release
information.
To access this screen, select option 4 RIB from the WebSphere MQ Information Menu
(Figure 18-10) or use the RIB fast-path command from any screen within the selected
report.
Figure 18-14. Release Information Screen
Abend-AID ------------- Release Information Block --------------------------- 
COMMAND ===>


RIB Address.................. 00C752E8


Environment Code............. 5655

Product Code................. A95

Feature Code................. 00

Version...................... 2.1.0

RIBCINFO Address............. 00C75314

Number of RIBCINFO Elements.. 00


Use the cursor point-and-shoot feature on any selectable address field to display storage
information.
Part 4.
4
Setting User Controls
Part 4 describes the steps for changing the user interface defaults that are initially set
during installation.
Part 4 consists of one chapter:
Chapter 19, “Setting User Controls”
Chapter 19 describes the steps for setting the following:
–
–
–
–
User profiles
Print options
Screen attributes
PF key settings
Abend-AID for CICS User’s Guide
19-1
Chapter 19.
Setting User Controls
Chap 19
This chapter describes the User Controls menu, which lists the input screens that enable
you to change the defaults for the following facilities:
•
•
•
•
User profiles
Print options
Screen attributes
PF key settings.
To display the User Controls menu from any Abend-AID for CICS screen, enter USER as a
fast-path command. The User Controls menu is also available as a selection on the
Primary Options menu.
Figure 19-1. User Controls Menu
Abend-AID ---------------------- User Controls -------------------------------
OPTION ===> 

1 PROF
User Profile 

2 LIST
Print Output Options 

3 ATTRBUTE Screen Attributes 

4 KEYS
PF Key Customization 

5 CUSTOM Site Customization Options 
Note:
The Custom mnemonic identifier may be preceded by an asterisk (*) and
displayed in a different color than the other options on the User Controls menu.
This option is not available unless you have the appropriate access authority for
the Abend-AID for CICS customization screens. These screens are documented in
the Abend-AID Installation and Customization Guide.
User Profile Screen
The User Profile screen allows you to modify site-defined defaults for a variety of user
profile options. Modifying these options enables you to personalize how Abend-AID for
CICS formats and displays data and help text. Options modified on the User Profile
screen apply to the current Abend-AID for CICS session and all subsequent sessions.
Note:
If you use multiple Abend-AID for CICS viewing servers, you must modify your
user profile on each viewing server.
To modify a user profile, complete the following procedure:
1. Display the User Profile screen, shown in Figure 19-2 on page 19-2, using one of the
following methods:
– Tab to the PROFILE option on the User Controls menu, and press Enter.
– Enter PROF as a fast-path command.
– Enter =U.1 as a jump command.
19-2
Abend-AID for CICS User’s Guide
Figure 19-2. User Profile Screen
Compuware Abend-AID ---------- User Profile ------------ Row 000001 of 000018 
COMMAND ===>
SCROLL ===> PAGE 

Enter profile options below. Type END (PF3) to save your changes, DEFAULTS

to reset the values, or CANCEL to exit without saving.


Prompt for confirmation when exiting the product................... N

Display instructional text on screens.............................. Y

Display line commands on screens................................... Y

Display screen borders............................................. N

Automatically reselect last dump viewed............................ N

Confirm Abend-AID Directory delete requests........................ Y

Default SDUMP dataset disposition for delete requests.............. K

Default region dump Diagnostic Summary format...................... F

Print dataset prefix for VTAM, CICS and Web browser access.........

Automatically restore Abend-AID Directory sort and mask parameters. N

Automatically restore Source Program Directory sort and mask parms. N

Default FIND command line limit.................................... 2500

Default national language.......................................... ENG

Default region dump MATCH command length (1-26 bytes).............. 4

Default Storage Navigation Mode (31 or 64 bit)..................... 31

Fault Summary group match.......................................... J

Logon Directory view............................................... N

Recall migrated source listing data sets........................... N 
The User Profile screen displays a default user profile containing values supplied at
installation. These values control how Abend-AID for CICS displays certain screen
elements, formats data, and navigates when you enter and exit the product. If the
defaults are acceptable to you, do nothing, and Abend-AID for CICS will use this
profile. To customize the profile to your individual preferences, proceed to step 2.
2. Overtype the default value of the user profile option you want to modify with the
new value. Press PF1 on any field for field help.
3. Do one of the following:
– To save user profile options you modified, enter END (PF3) as a primary
command.
– To discard any modifications you made and return to the previous Abend-AID for
CICS screen, enter CANCEL as a primary command.
– To restore the user profile options to their defaults, enter DEFAULTS as a primary
command.
Notes:
1. If, while viewing an abend, you change the value for using source for transaction
abends, you must reselect the current screen in order to see the change.
2. You can modify certain user profile options temporarily using the following primary
commands:
–
–
–
–
INSTRUCT modifies the instructional text option
LINECMDS modifies the line command descriptions option
BORDERS modifies the borders option
MODE modifies the storage navigation mode.
User profile options modified in this manner revert to their User Profile screen values
at the beginning of the next session. See Part 5, “Commands” for additional
information about these four commands.
Setting User Controls
19-3
Print Options
The Print Options and Initiation screen, shown in Figure 19-3, allows you to modify sitedefined defaults for print options and to submit print jobs. Options modified on this
screen apply to the current Abend-AID for CICS session and all subsequent sessions. To
access this screen, select the LIST option on the User Controls menu. See “Print Options
and Initiation Screen” on page 7-1 for more information about using this screen.
Figure 19-3. Print Options and Initiation
Compuware Abend-AID -- Print Options and Initiation --------------------------
COMMAND ===> 

Specify print information below, then type GO to submit the print job, or
SAVE to save your changes without printing, or CANCEL to cancel your changes. 

Print option........ KN
PD - Print dataset and delete
D - Delete dataset without printing
KN - Keep dataset and continue with new dataset 

Print Output Options:
SYSOUT Class.............. A
Page Width (Characters)... 132
Destination............... LOCAL
Page Length (Lines)....... 60
Print Uppercase Only...... N 

Jobcard Information:
1... //JOBNAME JOB (’ACCOUNTING.INFO’),’PROGRAMMER.NAME’,
2... //
CLASS=A,MSGCLASS=A
3... //*
4... //*
5... //*
6... //* 
Screen Attributes
The Screen Attributes screen allows you to modify site-defined defaults for the color,
intensity, and highlighting of various screen elements. Modifying these options enables
you to personalize how Abend-AID for CICS screen attributes are displayed on your
monitor. Options modified on the Screen Attributes screen apply to the current AbendAID for CICS session and all subsequent sessions.
Notes:
1. If you use multiple Abend-AID for CICS viewing servers, you must modify your
screen attributes profile on each viewing server.
2. If you changed your default ISPF colors, these specifications override the
specifications you make here when Abend-AID for CICS is accessed from ISPF.
To modify screen attributes, complete the following procedure:
1. Display the Screen Attributes screen, shown in Figure 19-4 on page 19-4, using one of
the following methods:
– Tab to the ATTRBUTE option on the User Controls menu, and press Enter.
– Enter ATTRBUTE as a fast-path command.
– Enter =U.3 as a jump command.
19-4
Abend-AID for CICS User’s Guide
Figure 19-4. Screen Attributes Screen
Abend-AID -------------------- Screen Attributes ----------------------------
COMMAND ===>

Enter color code for each screen area, intensity and extended highlighting,
then END (PF3) to save, DEFAULTS to reset the values, or CANCEL to cancel.
After saving, enter TESTSCR to see the effect of the changes. 

W - White
T - Turquoise
R - Red
G - Green
Y - Yellow
B - Blue 

Screen Area
Color
Intensity
Highlighting
Borders
T
N
R
Tab-selectable Data
G
N
N
Input Data
R
H
U
Available Fast-path Commands on Menus
G
N
R
Unavailable Fast-path Commands on Menus
T
N
R
Field Descriptions, Normal
T
N
N
Field Descriptions, Emphasized
Y
H
N
Field Data, Normal
W
H
N
Field Data, Emphasized
Y
H
N
Field Data, Errors
Y
H
N
Column Headings
W
H
R
Group Headings, Normal
W
H
R
Group Headings, Emphasized
Y
H
N
The Screen Attributes screen displays default screen attribute values supplied at
installation. These values control how Abend-AID for CICS should display certain
screen attributes. If the defaults are acceptable to you, do nothing, and Abend-AID
for CICS will use this profile. To customize the values to your individual preferences,
proceed to step 2.
2. Overtype the default value of the screen attribute you want to modify with the new
color, intensity, or highlighting value. Press PF1 on any field for field help.
3. Do one of the following:
– To save screen attribute options you modified, enter END (PF3) as a primary
command.
– To discard any modifications you made and return to the previous Abend-AID for
CICS screen, enter CANCEL as a primary command.
– To restore the screen attribute options to their defaults, enter DEFAULTS as a
primary command.
4. To view screen attribute options you modified and saved, enter TESTSCR as a
primary command. The Attribute Test Screen, displaying screen attributes of the
color, intensity, and highlighting you selected is displayed.
Note:
You must save changed screen attribute options by entering the END (PF3)
primary command on the Screen Attributes screen in order to view the
effects of those changes on the Attribute Test Screen.
Setting User Controls
19-5
Figure 19-5. Attribute Test Screen
Abend-AID ------------ Attribute Test Screen ----------- Row 000001 of 000002 
COMMAND ===>
SCROLL ===> PAGE 


Normal Group Heading
Field Description Normal....... NORMAL INPUT DATA
Field Description Normal....... NORMAL SELECTABLE DATA
Field Description Normal....... NORMAL DATA 

Emphasized Group Heading
Field Description Emphasized... EMPHASIZED INPUT DATA
Field Description Emphasized... EMPHASIZED SELECTABLE DATA
Field Description Emphasized... EMPHASIZED DATA 

1 DUMMYCMD Available Fast-Path Command 

2 DUMMYCMD Unavailable Fast-Path Command 

Column 1
Column 2
Heading
Heading
NORMAL DATA 080105F8
NORMAL DATA 080105F8
****************************** BOTTOM OF DATA ******************************
Press PF1 on any field for field help. You can repeat this entire procedure until you
are satisfied with the appearance of each screen attribute.
PF Keys
This section lists the initial PF key defaults that Abend-AID for CICS defines, and it
details the steps for changing those defaults.
Note: If you use multiple Abend-AID for CICS viewing servers, you must modify your PF
key defaults on each viewing server.
Default PF Key Definitions
Abend-AID for CICS maintains consistency with ISPF PF key definitions for keys PF1
through PF12 (commands such as UP, DOWN, END, and RETURN). In addition, PF13
through PF16 repeat the definitions assigned PF1 through PF4. The remaining keys, PF17
through PF24, are assigned specific Abend-AID for CICS functions.
Table 19-1 describes the defaults assigned to all 24 PF keys. For information on changing
these defaults, see “Modifying PF Key Functions” on page 19-6.
Note:
All references to PF keys in this manual assume the initial default values.
Table 19-1. Default PF Key Definitions
Key
Command
Description
PF1/PF13 HELP
Provides cursor-sensitive information. To display screen-level help, press the
HELP PF key with the cursor positioned off any specific data field. To display
field-level help, press the HELP PF key with the cursor located on the field. To
display system message help, press the HELP PF key with the cursor located on
the message.
PF2/PF14 SPLIT
Divides the display screen into two logical, functionally independent screens.
Valid for ISPF access only.
PF3/PF15 END
Ends the current function and redisplays the previous level screen or menu.
19-6
Abend-AID for CICS User’s Guide
Key
Command
Description
PF4/PF16 RETURN
Redisplays the Primary Options menu.
PF5
RFIND
Repeats the last FIND command executed.
PF6
MAINMENU
Displays the Abend-AID for CICS Primary Options menu for the selected
report/dump.
PF7
UP
Scrolls backward through a screen’s scrollable area. To scroll a specific number
of lines, type the UP command with a numeric value in the Command field. For
example, type UP 12 and press Enter to scroll backward 12 lines.
PF8
DOWN
Scrolls forward through a screen’s scrollable area. To scroll a specific number of
lines, type the DOWN command with a numeric value in the Command field.
For example, type DOWN 8 and press Enter to scroll forward eight lines. Valid
for ISPF access only.
PF9
SWAP
Moves the cursor to the other logical screen when the display is in split screen
mode. Valid for ISPF access only.
PF10
LEFT
Scrolls toward the first column of data. Left scrollable screens display a left
arrow symbol (<) at the end of the message line. To scroll a specific number of
columns, type the LEFT command with a numeric value in the Command field.
For example, type LEFT 2 and press Enter to scroll left two columns.
PF11
RIGHT
Scrolls toward the last column of data. Right scrollable screens display a right
arrow symbol (>) at the end of the message line. To scroll a specific number of
columns, type the RIGHT command with a numeric value in the Command
field. For example, type RIGHT 2 and press Enter to scroll right two columns.
PF12
RETRIEVE
Redisplays the last command entered in the COMMAND or OPTION field.
PF17
DISASM
Disassembles all assembler instructions in storage. Abend-AID for CICS displays
this information on the Storage Disassembly screen, starting with the address
specified. On Memory Display data fields only (for example, Word1), the
DISASM command disassembles the data displayed in the field. For more
information about this command, see “DISASM” on page 21-26
PF18
HEXD
Displays storage in hexadecimal format when the cursor is positioned on an
address, a table entry, or a control block symbol. For more information about
displaying storage, see “Using the Memory Display Screen” on page 5-2.
PF19
DSECT
Displays storage in DSECT“Using the Memory Display Screen” on page 5-2
PF20
INFO
Displays the Entry Information screen for the current dump.
PF21
WHO
For region dumps only. Lists TCBs (for any dump), TCAs (for CICS dumps only),
and KETASKs (for CICS dumps only) that have addressability to the address
specified with the WHO command or for the current cursor field. For more
information about this command, see “WHO” on page 22-52
PF22
MATCH
For region dumps only. Lists TCBs (for any dump), TCAs (for CICS dumps only),
and KETASKs (for CICS dumps only) that have data matching the data at the
address specified with the MATCH command or for the current cursor field. For
more information about this command, see “MATCH” on page 22-3.
PF23
LPRINT
Prints a logical image of a screen to a sequential dataset. For more information
about this command, see “LPRINT” on page 21-55.
ASSIST
Displays the commands available for the current screen, scrollable table, or
field. The position of the cursor determines which commands are listed. For
example, to list the commands available for a specific field, position the cursor
on that field and press the PF ASSIST key. If the field is located in a scrollable
table, the commands available for that table are listed also. To list a screen’s
commands that are not specific to a particular field or scrollable table, position
the cursor off any field in the screen’s non-scrollable area. For more information
about this command, see “ASSIST” on page 21-6.
PF24
Modifying PF Key Functions
Abend-AID for CICS provides an easy method for changing PF key functions.
Notes:
Setting User Controls
19-7
1. Because Abend-AID for CICS maintains its PF key definitions separately from a user’s
ISPF/PDF profile, the changes you make to the PF keys are valid only when using
Abend-AID for CICS. Your ISPF/PDF default PF key definitions are unaffected.
2. You can assign multiple commands to a PF key by using the semicolon (;) as a
delimiter between commands.
To change any PF key definition or label, perform the following steps:
1. Display the PF Key Definitions screen, shown in Figure 19-6 on page 19-7, using one
of the following methods:
– Tab to the KEYS option on the User Controls menu, and press Enter.
– Enter KEYS as a fast-path command.
– Enter =U.4 as a jump command.
Figure 19-6. PF Key Definitions and Labels Screen

Abend-AID --------------- PF Key Definitions - Primary ----------------------
COMMAND ===> 
PF13 Definition... HELP
PF14 Definition... SPLIT
PF15 Definition... END
PF16 Definition... RETURN
PF17 Definition... DISASM
PF18 Definition... HEXD
PF19 Definition... DSECT
PF20 Definition... INFO
PF21 Definition... WHO
PF22 Definition... MATCH
PF23 Definition... LPRINT
PF24 Definition... ASSIST 

PF13 Label...
PF14 Label...
PF15 Label...
PF16 Label...
PF17 Label...
PF18 Label...
PF19 Label...
PF20 Label...
PF21 Label...
PF22 Label...
PF23 Label...
PF24 Label... 


Press Enter to display the alternate keys. Type END command (PF3) to save,
CANCEL to exit without saving, or DEFAULTS to reset the values.
2. Press Enter to display the alternate keys.
3. Type the new value or function for the associated PF key in the area directly
following the key name. See Table 19-1 on page 19-5 for the default PF key function
names.
4. Press Enter. The PF Key Definitions and Labels screen displays the new PF key values.
5. When modifications are complete, press the END PF key to exit the screen and save
your changes. (PF3 and PF15 are the defaults.) Or, enter CANCEL to exit the screen
without saving your changes.
6. To restore the site-defined defaults if you saved your changes, enter DEFAULTS as a
primary command.
19-8
Abend-AID for CICS User’s Guide
Part 5.
5
Commands
Part 5 is a reference that describes the product’s primary and fast-path commands. Page
through Part 5 to become familiar with its content, but reading it from beginning to end
is unnecessary.
Part 5 consists of the following chapters:
Chapter 20, “Abend-AID for CICS Command Syntax”
Chapter 20 explains command syntax and how to access online command
information.
Chapter 21, “Abend-AID for CICS Commands: A through L”
Chapter 21 describes all of the Abend-AID for CICS primary and fast-path commands
beginning with the letter A through the letter L. It includes detailed information and
syntax diagrams.
Chapter 22, “Abend-AID for CICS Commands: M through Z”
Chapter 22 describes all of the Abend-AID for CICS primary and fast-path commands
beginning with the letter M through the letter Z. It includes detailed information
and syntax diagrams.
Abend-AID for CICS User’s Guide
20-1
Chapter 20.
Abend-AID for CICS Command Syntax
Chap 20
Use Abend-AID for CICS primary commands to perform specific functions such as screen
manipulation, cursor movement, and dump information access. Use Abend-AID for CICS
fast-path commands to quickly access specific screens. Both types of commands are
issued from the Command or Option line at the top of the screen.
The next two chapters list all of the Abend-AID for CICS commands in alphabetical order.
They include syntax diagrams that show command parameters. This chapter explains
how to interpret syntax diagrams and access command information online. It includes
the following topics:
• “Reading Syntax Diagrams” on page 20-1
• “Accessing Command Syntax Online” on page 20-2
• “Accessing Available Commands Online” on page 20-2
Reading Syntax Diagrams
Syntax diagrams define command syntax. Minimum strings for commands are shown in
UPPERCASE characters. Commands consist of the command itself and may include either
required or optional parameters.
A parameter is either a keyword or a variable.
• Minimum strings for keywords are shown in UPPERCASE characters and must be
spelled exactly as shown. Any remaining characters of the keyword may be included
at your discretion. However, you cannot substitute another value.
• All variables are user-specified values and are printed in lowercase italics. For example,
dataset-name indicates you are to substitute a value.
The syntax for commands is described in diagrams that help you visualize parameter use.
The following example shows a command and a required parameter:
Read the diagrams from left to right and from top to bottom. These symbols help you
follow the path of the syntax
indicates the beginning of a statement.
indicates the statement is continued on the next line.
indicates the statement is continued from the previous line.
indicates the end of a statement.
20-2
Abend-AID for CICS User’s Guide
Required parameters appear on the horizontal line (the main path):
Optional parameters appear below the main path. Default parameters that appear above
the main path are optional; including or excluding them in the command has the same
effect on the execution.
Vertically stacked parameters are mutually exclusive. If you must choose a parameter, one
item of the stack appears on the main path. If the parameters are optional, the entire
stack appears below the main path. If one of the parameters in a stack is the default, it
appears above the main path:
Accessing Command Syntax Online
To determine a particular command’s syntax while you are using Abend-AID for CICS,
type HELP cmdname in the COMMAND (or OPTION) field and press Enter, or select the
command name in the list and press Enter. For example, HELP FIND displays a pop-up
window describing the FIND command.
Accessing Available Commands Online
To determine which commands are available on a particular screen while you are using
Abend-AID for CICS, type CMDLIST or HELP COMMANDS in the COMMAND (or
OPTION) field and press Enter. A scrollable display appears that lists the available
commands in alphabetical order.
21-1
Chapter 21.
Abend-AID for CICS Commands: A through L
Chap 21
This chapter lists all of the Abend-AID for CICS primary and fast-path commands that
begin with the letter A through the letter L.
Note: Many of these commands, especially the fast path commands, function only after
you have selected an entry from the Abend-AID Directory and, in some cases,
only if you are executing them from specific screens. For information about the
Abend-AID Directory, refer to “Abend-AID Directory” on page 4-3.
ABENDTXT
Command Type: Primary
The ABENDTXT command displays the Abend-AID for CICS diagnostic text for the
specified transaction abend code. This applies to transaction abends only.
abendcode
An abend code that is defined to Abend-AID for CICS.
Example:
ABENDTXT ASRA
ACTIONS
Command Type: Fast Path
Screen Displayed: Action Definition Menu.
ACTREGN
Command Type: Fast Path
Restrictions: Valid only in customization.
Screen Displayed: Region Dump Action Definitions. This screen creates and maintains
region dump action definitions.
21-2
Abend-AID for CICS User’s Guide
ACTTRANS
Command Type: Fast Path
Restrictions: Valid only in customization.
Screen Displayed: Transaction Dump Action Definitions. This screen creates and
maintains transaction dump action definitions.
ADSTCK
Command Type: Primary
The ADSTCK command displays the store clock time that is stored at the specified
address. It is adjusted for GMT and Leap second.
address
A valid hexadecimal address.
Example:
ADSTCK 59ADC00
AID
Command Type: Fast Path
Restrictions: Valid only for CICS region dumps.
Screen Displayed: AID Summary. This screen lists Automatic Initiate Descriptors (AIDs).
Each terminal request for automatic task initiation creates an AID.
AMODE
Command Type: Primary
The AMODE command changes or displays the AMODE setting for the current user
session. The AMODE setting is used when the storage for Assembler programs is being
formatted. The register contents are used to obtain storage from the dump to be
Abend-AID for CICS Commands: A through L
21-3
formatted for source support, and the AMODE setting influences the portion of the
register that is used to locate storage.
24
Indicates that AMODE 24 is to be used when using the register contents to access
storage in the dump
31
Indicates that AMODE 31 is to be used when using the register contents to access
storage in the dump
64
Indicates that AMODE 64 is to be used when using the register contents to access
storage in the dump
Query
Indicates that the current AMODE setting will be displayed.
RESET
Indicates that the AMODE setting will not be used. Instead, the AMODE setting, if
any, known for the selected program will be used
AP
Command Type: Fast Path
Restrictions: Valid only for CICS region dumps.
Screen Displayed: Application Domain Menu. This menu provides access to the
following screens:
•
•
•
•
•
•
•
•
•
•
•
CSA
CSAOPFL
File Control
Terminal Control/MRO/ISC
Table Manager
Interval Control
Static Storage Area
Transient Data
User Exit Table
Auto Initiate Descriptors
3270 Bridge Facility
21-4
Abend-AID for CICS User’s Guide
ARCH
Command Type: Fast Path
Screen Displayed: Optional z/Architecture Features. This screen displays the unavailable
z/Architecture hardware facility when the abend is due to execution of an opcode on
hardware that does not support the instruction.
ARRANGE
Command Type: Primary
The ARRANGE command lets you redesign your screen by showing the screen columns in
whatever order you wish.
After you type ARRANGE or ARR, a window opens showing a list of all of the columns on
your screen. To rearrange your columns, select one or more of the following line
commands.
M (Move column)
M specifies the column you want to move. It will be moved before or after the
column that you select with either the A or B command.
A (After this column)
The column you specified with M (Move column) will move after the column you
specify with A.
B (Before this column)
The column you specified with M (Move column) will move before the column you
specify with B.
L (Lock/unlock column)
Typing L toggles between locked and unlocked. Locked columns appear first from the
left of the screen and are, therefore, the highest in the list of columns on the
ARRANGE subscreen.
If multiple columns are locked, some of which you want to unlock, and you do not
select to unlock the lowest locked column, the column you select moves below the
other locked columns and changes its status to unlocked.
Columns that are unlocked that you want to lock will move up to the position below
the last locked column.
If you move an unlocked column between two other unlocked columns, it will
remain unlocked. If you move a locked column between two other locked columns, it
will remain locked.
However, if you move an unlocked column before or after a locked column, it will
become locked. And, if you move a locked column before or after an unlocked
column, it will become unlocked.
Abend-AID for CICS Commands: A through L
21-5
H (Hide/unhide column)
Typing H toggles between hidden or visible. Hidden columns appear last in the list of
columns on the ARRANGE subscreen and no longer appear on your screen.
If multiple columns are hidden, some of which you want to make visible, and you do
not select to make visible the highest hidden column, the column you select moves
above the other hidden columns and changes its status to visible.
Hidden columns move to the bottom of the list of columns above the first hidden
column.
If you move a hidden column between two other hidden columns, it will remain
hidden. If you move a visible column between two other visible columns, it will
remain visible.
However, if you move a visible column before or after a hidden column, it will
become hidden. And, if you move a hidden column before or after a visible column,
it will become visible.
After you make your changes, you can type END on the command line or press PF3 to
view the changes you requested. To cancel your changes, type CANCEL on the command
line. To restore the defaults, type RESET on the command line.
Note:
The ARRANGE command can be used on any screen that contains columns. You
can save any changes for future use on the Fault Summary, Abend-AID Directory,
File Request Summary, and Task/Wait Analysis screens.
Example:
Type ARR to bring up the Arrange Column Order subscreen (see Figure 21-1).
ARR
Figure 21-1. ARRANGE Command Subscreen
--------------------- Row 00001 of 00018 ----------------------
Arrange Column Order

COMMAND ===>

M Move column
A After this column
B Before this column 
L Lock/unlock column
H Hide/unhide column


Column Heading
Status 
_ Entry
Locked 
Locked 
m Job Name
_ Abend Code
Locked 
_ JESID


a Tran
_ Program


Type END (or press PF3) to save your changes, or CANCEL to

exit without saving, or RESET to restore the defaults.

CIMSCF01
End=PF03
More... 
In this example, the Job Name column will be moved after the Tran column and it will be
unlocked.
ASCB
Command Type: Fast Path
Restrictions: Valid only for region dumps.
21-6
Abend-AID for CICS User’s Guide
Screen Displayed: Address Space Control Block. This screen displays the address space
control block for the currently selected address space.
SIDLIST
ASIDLIST
Command Type: Fast Path
Restrictions: Valid only for region dumps.
Screen Displayed: Address Space Summary. This screen displays the list of address spaces
active in the image at the time the dump was taken.
ASMAP
Command Type: Fast Path
Restrictions: Valid only for region dumps.
Screen Displayed: MVS VSM Allocated Storage Map. This screen lists virtual storage
address ranges and their corresponding virtual storage areas, subpools, keys, etc.
ASSIST
Command Type: Primary
The ASSIST command displays the commands that are available for the current screen,
scrollable table, or field. Pressing the ASSIST PF key (default is PF24) also executes this
command. For example, to list the commands available for the current screen, tab to the
Command field and press the ASSIST PF key, or type ASSIST on the COMMAND line, and
press Enter. To list the commands available for a specific field, tab to the field and press
the ASSIST PF key, or type ASSIST on the COMMAND line, tab to the field, and press
Enter. If the current screen, scrollable table, or field has no commands associated with it,
a message appears stating that the ASSIST function is not available for this screen or field.
ASXB
Command Type: Fast Path
Restrictions: Valid only for region dumps.
Abend-AID for CICS Commands: A through L
21-7
Screen Displayed: Address Space Extension Block. This screen displays the address space
extension block for the currently selected address space.
ATTRBUTE
ATTRBUTE
Command Type: Fast Path
Screen Displayed: Screen Attributes. This screen lets you modify screen attribute options
— for example, screen colors, intensity, and highlighting. After you complete your
changes, enter TESTSCR to see the effect of your changes.
You can change the following screen areas:
•
•
•
•
•
•
•
•
•
•
•
•
•
Borders
Tab-selectable Data
Input Data
Available Fast-path Commands on Menus
Unavailable Fast-path Commands on Menus
Field Descriptions, Normal
Field Descriptions, Emphasized
Field Data, Normal
Field Data, Emphasized
Field Data, Errors
Column Headings
Group Headings, Normal
Group Headings, Emphasized
AUTO
Command Type: Fast Path
Restrictions: Valid only for CICS transaction dumps.
Screen Displayed: PL/I Automatic Storage List. This screen lists the automatic storage
that was allocated to the program at the time of the dump.
programname
The name of a PL/I program in the dump. If you do not include the program name as
an operand for the AUTO command, the automatic storage for the abending program
is displayed.
Example:
AUTO PAYTEST1
21-8
Abend-AID for CICS User’s Guide
BA
Command Type: Fast Path
Restrictions: Valid only for CICS region dumps.
Screen Displayed: Memory Display. This screen displays the Global Storage for the CICS
Business Transaction Services Domain.
BACKWARD
Command Type: Primary
The BACKWARD command is an alias for the UP command (PF7). Use this command to
scroll the active display toward the top of a scrollable list of entries.
lines
The number of lines to scroll.
Example:
BACKW 8
This example scrolls the active display eight lines toward the top of the entries list.
BIND
Command Type: Fast Path
Restrictions: Valid only for dumps with DB2 information.
Screen Displayed: Bind Information.
BLOG
Command Type: Primary
Restrictions: For ISPF access only.
The BLOG command lets you browse the problem log for the current dump using the
ISPF browse.
Abend-AID for CICS Commands: A through L
21-9
BORDERS
Command Type: Primary
The BORDERS command shows or hides the side and bottom borders of all screens in the
current session. (The top border cannot be hidden.) For information about setting the
default values for this command for all sessions, refer to “User Profile Screen” on page
19-1.
ON
Displays the borders on all screens in the current session.
OFF
Removes the borders on all screens in the current session.
BOTTOM
Specifies that only the bottom border is affected by the command.
SIDE
Specifies that only the side borders are affected by the command.
Example:
BORDERS OFF SIDE
This example turns off the side borders for all screens in this session.
BOTTOM
Command Type: Primary
The BOTTOM command scrolls to the bottom of a screen’s scrollable area.
BRIDGE
Command Type: Fast Path
Restrictions: Valid only for CICS transaction dumps.
Screen Displayed: 3270 Bridge Facility menu. This menu provides access to the following
screens.
• 3270 Bridge State Anchor (BRSA)
• 3270 Bridge Keep Chain (BRKEEP)
• 3270 Bridge Task Chain (BRTASK)
21-10
Abend-AID for CICS User’s Guide
BRKEEP
Command Type: Fast Path
Restrictions: Valid only for CICS transaction dumps.
Screen Displayed: 3270 Bridge Keep Chain summary. This screen displays a summary of
the tasks on the 3270 Bridge Facility keep chain.
BRSA
Command Type: Fast Path
Restrictions: Valid only for CICS transaction dumps.
Screen Displayed: 3270 Bridge State Anchor. This screen displays detailed information
about the 3270 Bridge Facility.
BRTASK
Command Type: Fast Path
Restrictions: Valid only for CICS transaction dumps.
Screen Displayed: 3270 Bridge Keep Task summary. This screen displays a summary of
the tasks on the 3270 Bridge Facility task chain.
CALLTRAC
Command Type: Fast Path
Restrictions: Valid only for CICS transaction dumps.
Screen Displayed: CICS Program Call Trace Summary. This screen displays the
information for every known call that Abend-AID for CICS identifies for CICS
Transaction Dumps.
.
CANCEL
Command Type: Primary
Abend-AID for CICS Commands: A through L
21-11
The CANCEL command cancels the current operation without saving the data and then
redisplays the previous menu or screen.
CAPTURE
Command Type: Fast Path
Restrictions: Valid only in customization.
Screen Displayed: Dump Capture and Processing menu. This menu provides access to
the following screens:
• CICS Region Configuration
• Region and Tran Dump Capture Profiles
• Transaction Dump Global Options
CB
Command Type: Fast Path
Restrictions: Valid only for CICS transaction dumps, region dumps, and batch dumps.
Screen Displayed: Control Blocks/Storage menu. This menu is a selectable list of control
blocks that were included in the dump. The listed control blocks can be displayed in
hexadecimal and, if applicable, DSECT format. The menu also provides access to the
current paperclip table and the saved paperclip list.
CC
Command Type: Fast Path
Restrictions: Valid only for CICS region dumps.
Screen Displayed: Local Catalog Anchor Block. This screen displays an interpretation of
the local catalog anchor block. The local catalog is on DFHLCD and holds data used by
CICS to initialize the domains at startup.
CHAIN
Command Type: Primary
The CHAIN command runs a control block chain based on user-specified parameters. For
each control block located, the chain facility creates a paperclip entry in the current
paperclip table. The comments associated with the paperclip entries reflect the entry
number of the chain, with the user-specified chain prefix as the chain name.
21-12
Abend-AID for CICS User’s Guide
If you type the CHAIN command without one of its optional parameters, Abend-AID
displays the Chain Command Parameters screen. This screen includes entry fields for
specifying all of the parameters associated with the CHAIN command, including the
chain prefix and the chain termination value. For more information about this screen,
refer to “Running Control Block Chains” on page 5-7.
address
The address at which the CHAIN command begins executing. The address must be a
valid hexadecimal address.
offset
The link address hexadecimal offset specifying the address of the fullword pointer
that points to the control block in the chain. This parameter is processed based on
whether the addressing mode is 24-bit or 31-bit, as set on the CHAIN Command
Parameters screen.
If the CHAIN command is entered without the optional offset, a screen will appear to
fill in data about the list of entries to be processed.
Example:
CHAIN 00007000 +10
This example specifies the starting address, 00007000, and the link address offset +10. It
will run a chain starting at location 7000 and use the link address in 7010 to find the
next entry in the chain. Processing continues until all entries are processed.
CHANGES
Command Type: Fast Path
Restrictions: Valid only for CICS region dumps.
Screen Displayed: CICS Change Summary. This screen lists the CICS load modules in
most recently changed order.
CICSENV
Command Type: Fast Path
Restrictions: Valid only for CICS region dumps.
Screen Displayed: CICS Environment Summary. This screen overviews CICS operational
status at dump or abend time.
CICSINFO
Command Type: Fast Path
Abend-AID for CICS Commands: A through L
21-13
Restrictions: Valid only for CICS region dumps.
Screen Displayed: CICS Information menu. This menu provides access to the following
screens:
•
•
•
•
CICS Environment Summary
Program Change Summary
DFHRPL Concatenation
CICS Resource Managers
CLEARIDX
Command Type: Primary
WARNING: This command should not be used directly by a user. Normally it will be
invoked in the processing of the PRINT #SUMMARY standard report.
The CLEARIDX command clears the index, if any, for a printed report. This prevents
existing index entries for prior PRINT commands from being included with those for the
current report.
CLIP
Command Type: Primary
Restrictions: This command is valid on the Memory Display and Storage Map Display
screens only.
The CLIP command displays paperclip entries.
The paperclip function provides an automatic and convenient method for you to keep
track of your navigation through the Memory Display. Each time the displacement
shown on the Memory Display equals zero, an entry is automatically added to a table of
addresses, known as the current paperclip table. You can also explicitly add an entry to
the current paperclip table by placing your cursor on any address displayed on the
Memory Display and pressing the Enter key.
A current paperclip table is maintained for each user accessing a given dump. Your
current paperclip table can be accessed using the PCLP primary command. The help text
for the Current Paperclip Table screen provides details about the information provided
and use of the Current Paperclip Table screen.
FIRST
Displays the storage associated with the first (oldest) entry in the current paperclip
table. FIRST is the default if you execute the CLIP command without any keyword
parameter.
21-14
Abend-AID for CICS User’s Guide
LAST
Displays the storage associated with the last (newest) entry in the current paperclip
table.
LOCK
Locks the current paperclip entry.
NEXT
Displays the storage associated with the next newest entry in the current paperclip
table (relative to the current position).
Note:
You can easily reaccess any paperclipped address using either of the clip tab
selectable fields (PREV, NEXT).
PREV
Displays the storage associated with the next oldest entry in the current paperclip
table (relative to the current position).
The following primary commands are used to process the paperclip from the memory
display:
CLIP
Paperclip navigation commands
CLR
Delete all entries in the user’s current paperclip table
COMM
Add a comment to a paperclip entry
PCLP
Access the Current Paperclip Table screen
REST
Restore a previously saved paperclip table
SAVE
Save the user’s current paperclip table, with or without a name specified
RESET
Reset the storage disassembly to the starting address
CLR
Command Type: Primary
The CLR command clears the current paperclip table by deleting all entries.
CMDLIST
Command Type: Primary
The CMDLIST command lists the commands that are available for execution from within
Abend-AID.
A small subset of commands are always available, even when you have not selected an
entry from the Abend-AID Directory. Additional commands become available after you
select a non-CICS entry from the directory. Most commands, however, become available
Abend-AID for CICS Commands: A through L
21-15
only after you select a CICS Transaction Server for z/OS or OS/390 entry from the
directory.
Figure 21-2 is an example of the information displayed when you invoke the CMDLIST
command. You can tab to any command and press Enter to display help for that
command.
Figure 21-2. Command List Example
Abend-AID ---------------- Tutorial - Command List ------ Row 000001 of 000134
COMMAND ===>
SCROLL ===> PAGE 

******** ******************************************************************
AAVIEW
Batch Dump Viewer Interface
ABENDTXT Display information about the selected abend code 
ADSTCK
Displays GMT/Leap second adjusted interpretation of the store 
AMODE
Set or display the AMODE setting
AMODE24
Set the AMODE setting to 24
AMODE31
Set the AMODE setting to 31
AMODE64
Set the AMODE setting to 64
ARRANGE
Arrange columns
ASSIST
Display the Assist Menu for the selected screen or field 
ATTRBUTE Display screen attribute options 
AUTO
Display the PL/I Automatic Storage List 
BACKWARD Scroll up 
BLOG
Browse the problem log for the current dump 
BORDERS
Control screen borders 
BOTTOM
Display the bottom of a scrollable list 
CALLTRAC Display the CICS Program Call Trace 
CANCEL
Cancel the current operation 
CB
Display the Control Block/Storage menu 
CHAIN
Run a control block chain in the memory display 
Press Enter on a command to display Help for that command.
COBOL
Command Type: Fast Path
Restrictions: Valid only for CICS transaction dumps.
Screen Displayed: COBOL Storage Areas menu for the selected program. The menu
displays a list of the COBOL storage areas from which you can select:
•
•
•
•
Working Storage
Linkage Section
External Cells
Task Global Table
programname
The name of a COBOL program in the dump.
Example:
COBOL PAYTEST1
21-16
Abend-AID for CICS User’s Guide
COLSREF
Command Type: Fast Path
Screen Displayed: Columns Referenced.
COMM
Command Type: Primary
The COMM command adds a user-specified comment to a paperclip entry. The Comm
command is valid only on the Memory Display screen.
comment
User-specified text. The maximum comment length allowed is 35 characters
(including spaces).
CONTROL
Command Type: Fast Path
Screen Displayed: PL/I Controlled Storage List. This screen provides a list of the
controlled storage that was allocated to the program at the time of the dump.
programname
The name of a PL/I program in the dump. If you do not include the program name as
an operand for the CONTROL command, the external storage for the abending
program is displayed.
Example:
CONTROL PAYTEST1
CORE
Command Type: Primary
The CORE command displays the storage found at the exact location specified. However,
if you issue the CORE command without one of its optional parameters, Abend-AID for
Abend-AID for CICS Commands: A through L
21-17
CICS displays the Storage Map Display screen. This screen lists in hexadecimal format all
allocated and unallocated segments of storage for the current dump.
address
The address must be in hexadecimal.
symbolname
For region dumps only. The literal S/ must precede the symbol name.
tabletype tableentry
A space or a period separates the table type from the table entry, for example, PCTE
CEMT or PCTE.CEMT. PCTE is the table type, and CEMT is the entry in the table.
Note:
Use field help to determine whether a field contains a table entry or a symbol.
Example 1:
CORE 002744F0
Example 1 displays the storage at hexadecimal address 002744F0.
Example 2:
CORE S/TCA0009
Example 2 displays the storage at symbol TCA0009.
CRETRIEV
Command Type: Primary
The CRETRIEV command functions differently depending on the position of the cursor
when you enter the command.
If the cursor is in the COMMAND (or OPTION) field, CRETRIEV functions like the
RETRIEVE command. That is, the most recently entered commands are redisplayed on
the command line, one command at a time, in the reverse sequence in which they were
entered (last-in, first-out). This command lets you easily recall a command for
resubmission from the command line. You can edit the command before issuing it.
If the cursor is not in the COMMAND (or OPTION) field, CRETRIEV functions like the
CURSOR command. That is, the cursor is moved to the first input field on the menu or
screen being displayed, usually the COMMAND (or OPTION) field. When used in this
way, CRETRIEV functions like a HOME key.
CSA
Command Type: Fast Path
Restrictions: Valid only for CICS region and CICS transaction dumps.
21-18
Abend-AID for CICS User’s Guide
Screen Displayed: Common System Area. This screen displays an interpreted subset of
the CICS Common System Area (CSA) control block.
CSASP
Command Type: Fast Path
Restrictions: Valid only for CICS region dumps.
Screen Displayed: Summarized CSA Subpools. This screen lists the CSA subpools
allocated at the time of the fault.
CSASUM
Command Type: Fast Path
Restrictions: Valid only for CICS region dumps.
Screen Displayed: Common Service Area Summary. This screen lists the CSA area
allocations at the time of the fault.
c
CSSTEXT
Command Type: Fast Path
Restrictions: Valid only for CICS region dumps.
Screen Displayed: Invokes a pop-up screen containing the error message text for CSS
return codes. The first line contains the return code number. The next line contains the
text message for CSS SDINTF RC (########). The return code is a hex value. All eight
digits must be enclosed in brackets.
c
CSSUTIL
Command Type: Fast Path
Restrictions: Valid only when accessing Abend-AID or Abend-AID for CICS using ISPF.
Screen Displayed: CSS Utilities panel. This command can be issued from anywhere
within Abend-AID for CICS when accessing Abend-AID for CICS through ISPF. It allows
you to access the CSS Utilities panel on-the-fly. For detailed information on how to use
the CSS utilities, refer to the Compuware Shared Services User/Reference Guide supplied with
Abend-AID for CICS Commands: A through L
21-19
Abend-AID for CICS.
CURSOR
Command Type: Primary
The CURSOR command moves the cursor to the first input field on the menu or screen
being displayed, usually the COMMAND (or OPTION) field. This command functions like
a HOME key and is usually assigned to a specific PF key. For more information about
modifying PF Key assignments, refer to “Modifying PF Key Functions” on page 19-6.
CUSTOM
Command Type: Fast Path
Screen Displayed: Customization Options menu. This menu provides access to the
following Abend-AID customization menus which in turn let you access additional
screens to tailor your environment:
• Site Default Options Menu (from which you can access the following screens):
–
–
–
–
Site
Site
Site
Site
Print Options
User Profile
Screen Attributes
PF Key - Primary
• Dump Capture and Processing Menu (from which you can access the following
screens):
–
–
–
–
Region Configuration
Dump Capture Profiles
CICS Transaction Dump Capture Profiles
CICS Transaction Dump Global Options
• Action Definition Menu
–
–
–
–
Create Action Job Cards
Transaction Action Definitions
Region Action Definitions
Batch Dump Contact Information
• Create/Maintain Site News
– Maintain news for Abend-AID
– Maintain news for Abend-AID for CICS
• Create/Maintain User-defined Diagnostics
Insert, replicate, delete, update, or display items in your diagnostic summary for
Product, Abend Type, Abend Code, User ID, and Date Saved.
21-20
Abend-AID for CICS User’s Guide
CUSTUSER
Command Type: Fast Path
Restrictions: Delete function is available only to a user with UPDATE authority to the
Customization file.
Screen Displayed: Server List. This screen displays a list of servers using this
Customization file. Active servers and subsystems are highlighted. You may delete
obsolete server records if that server is not active and you have UPDATE access to the
Customization file.
CVT
Command Type: Fast Path
Restrictions: Valid only for region dumps.
Screen Displayed: Communications Vector Table.
CWI
Command Type: Fast Path
Restrictions: Valid only for CICS transaction dumps.
Screen Displayed: CICS Web Information Summary. This screen shows which CICS Web
support process was active at the time of the failure and also provides navigation to all of
the other CICS Web Interface displays.
DATASTRM
Command Type: Fast Path
Restrictions: Valid only for CICS transaction dumps.
Screen Displayed: Data Stream Analysis. This screen shows the data stream attributes of
the last 3270 screen image associated with the abend.
DB2
Command Type: Fast Path
Abend-AID for CICS Commands: A through L
21-21
Restrictions: Only available if you are licensed for either Abend-AID for CICS DB2 or
Abend-AID DB2.
Screen Displayed: DB2 Information menu. This menu provides access to the following
screens containing detailed DB2 information:
•
•
•
•
•
•
•
•
Diagnostic Summary
Host Variables
Bind Information
Precompile Information
Columns Referenced
Package Dependencies
SQL Communications Area
RCT Detail
This menu is available only if you are licensed for the Abend-AID for CICS for DB2
option and if the dump contains DB2 information.
DBCTLACT
Command Type: Fast Path
Restrictions: Valid only for CICS region dumps.
Screen Displayed: DBCTL Transaction Summary. This screen displays the CICS
transactions that are currently using DBCTL.
DBCTLSUS
Command Type: Fast Path
Restrictions: Valid only for CICS region dumps.
Screen Displayed: DBCTL Transaction Summary. This screen displays the CICS
transactions that are currently suspended in DBCTL.
DBCTLUSE
Command Type: Fast Path
Restrictions: Valid only for CICS region dumps.
Screen Displayed: DBCTL Transaction Summary. This screen displays the CICS
transactions that have used DBCTL.
21-22
Abend-AID for CICS User’s Guide
DCIDMCBS
Command Type: Fast Path
Restrictions: Valid only for CICS transaction dumps.
Screen Displayed: Displays the MSA DCI and application DMCBS areas, formatted for
viewing.
DCITRACE
Command Type: Fast Path
Restrictions: Valid only for CICS transaction dumps.
Screen Displayed: Displays a formatted version of the MSA DCI trace.
DCT
Command Type: Fast Path
Restrictions: Valid only for CICS region dumps.
Screen Displayed: Transient Data Queue Summary. Each transient data queue defined to
CICS through the DCT is listed.
DCTE
Command Type: Fast Path
Restrictions: Valid only for CICS region dumps.
Screen Displayed: Displays a specific DCT screen depending on the destination
specified.
destination
A specific destination ID.
Example:
DCTE.cssl
Abend-AID for CICS Commands: A through L
21-23
DD
Command Type: Fast Path
Restrictions: Valid only for CICS region dumps.
Screen Displayed: Directory Manager menu. This menu provides access to the following
screens:
• Directory Manager Anchor
• Directory Manager Summary
DDANCH
Command Type: Fast Path
Restrictions: Valid only for CICS region dumps.
Screen Displayed: Directory Manager Anchor. This screen displays an interpretation of
the directory manager anchor block.
DDSUMM
Command Type: Fast Path
Restrictions: Valid only for CICS redgion dumps.
Screen Displayed: Directory Manager Summary. This screen displays information about
CICS directories including hash table statistics. Directories include PPT and Tclass
entries.
DECODE
Command Type: Primary
The DECODE command disassembles a single assembler instruction at the address
specified, and it places this information on the message line of the current screen.
Note:
On Memory Display data fields only (for example, Word1), the DECODE
command disassembles the data displayed in the field.
21-24
Abend-AID for CICS User’s Guide
Methods of executing this command include the following:
• From any Abend-AID screen — Enter DECODE, a space, and the hexadecimal address of
the instruction as a primary command.
• From any tab-selectable field listing a hexadecimal address — Type DECODE in the
Command field, position the cursor on the hexadecimal address, and press Enter.
• From the Memory Display screen — Type DECODE in the Command field, position the
cursor on the first byte of the instruction to decode, and press Enter.
Note:
To decode all assembler instructions in storage for the current dump, use the
DISASM command. Refer to “DISASM” on page 21-26 for specifics.
address
The hexadecimal address of the instruction you want to decode.
DEFAULTS
Command Type: Primary
This command is valid on the User Profile, Screen Attributes, and the PF Key Definitions
screens only. The DEFAULTS command restores the site-defined defaults for these screens
if you changed them.
DELETECF
Command Type: Fast Path
This command can be accessed from the Site News Menu in the Customization Options
menu or as a fast path command from the Primary Options menu. With DELETECF, you
can delete site news information relating to Abend-AID for CICS. To create or maintain
site news, you must use the SITENEWS command for Abend-AID for CICS. For more
information, see “SITENEWS” on page 22-30.
DEPN
Command Type: Fast Path
Screen Displayed: Package Dependencies (if the program that issued the last DB2 call
was bound in a package) or Plan Dependencies (if the program that issued the last DB2
call was bound in a plan).
Abend-AID for CICS Commands: A through L
21-25
DFHRPL
Command Type: Fast Path
Restrictions: Valid only for CICS region and CICS transaction dumps.
Screen Displayed: DFHRPL Concatenation. This screen provides an ordered list of all
load libraries concatenated in the DFHRPL DD statement.
DH
Command Type: Fast Path
Restrictions: Valid only for CICS region dumps.
Screen Displayed: Document Handler Domain menu. This menu provides access to the
following screens:
Document Handler Anchor Block
In addition, if you are licensed for Abend-AID for WebSphere MQ, you will have access to
the following screen:
Document Handler Document Summary
DHANCH
Command Type: Fast Path
Restrictions: Valid only for CICS region dumps.
Screen Displayed: Document Handler Anchor Block. This screen displays detailed
information about the CICS Document Handler anchor block.
DHDCSUMM
Command Type: Fast Path
Restrictions: Valid only for CICS region dumps.
Screen Displayed: Document Summary. This screen displays a summary of the current
documents being managed by the Document Handler.
21-26
Abend-AID for CICS User’s Guide
DIAG
Command Type: Fast Path
Screen Displayed: Diagnostic Summary. This screen provides important analysis
information about the abend. A description of the abend is provided, and the
transaction, terminal, and program involved are identified.
DIRECTRY
Command Type: Fast Path
Screen Displayed: Abend-AID Directory. This screen provides information on the entries
within the transaction databases and the region dump datasets.
Entering this command without any operands results in the directory being displayed
using the criteria from the last selection made on the Abend-AID Summary screen during
the current session. To display all of the entries in the Abend-AID directory, enter the
command with the ALL operand.
DIRSCAN
Command Type: Primary
The DIRSCAN command initiates an immediate scan for new report entries to be
displayed on the Abend-AID Directory. The command first updates the server database
list and then queries the shared directory for new report entries. Any new report entries
are added to the directory display.
DISASM
Command Type: Primary
The DISASM command disassembles all assembler instructions in storage. It displays this
information on the Storage Disassembly screen, starting with the address specified. Refer
to “Storage Disassembly Screen” on page 9-21 for an explanation of this screen.
Note: On Memory Display data fields only (for example, Word1), the DISASM command
disassembles the data displayed in the field.
You can execute this command in several ways:
• From any Abend-AID screen — Enter DISASM, a space, and the hexadecimal address of
the instruction as a primary command.
Abend-AID for CICS Commands: A through L
21-27
• From any tab-selectable field listing a hexadecimal address — Perform one of the following:
– Type DISASM in the COMMAND (or OPTION) field, position the cursor on the
hexadecimal address, and press Enter.
– Position the cursor on the hexadecimal address and press the DISASM PF key.
(PF17 is the default.)
• From the Memory Display screen — Perform one of the following:
– Type DISASM in the Command field, position the cursor on the first byte of the
first instruction you want to display, and press Enter.
– Position the cursor on the first byte of the first instruction you want to display
and press the DISASM PF key.
Use the UP and DOWN PF keys to scroll through the Storage Disassembly screen. (PF7
and PF8 are the defaults.)
Note:
To decode a single instruction, use the DECODE command. Refer to “DECODE”
on page 21-23 for specifics.
address
The hexadecimal address at which you want the DISASM command to start. When
the Storage Disassembly screen appears, the decoded instruction at that address is
listed first.
Example:
DISASM 59ADC00
DLI
Command Type: Fast Path
Restrictions: Valid only for CICS transaction dumps.
Screen Displayed: DL/I Information. This screen identifies DL/I-related information if it
is present in the selected dump.
DM
Command Type: Fast Path
Restrictions: Valid only for CICS region dumps.
Screen Displayed: Domain Manager Summary. This screen summarizes the domain
initialization and termination data. The domain manager (DM) controls and coordinates
all phases of initialization and termination of the other domains.
21-28
Abend-AID for CICS User’s Guide
DMPHDR
Command Type: Fast Path
Screen Displayed: Dump Header Record. This screen displays header record information
from the currently selected SVC dump. See “Dump Header Record Screen” on page 15-7.
DMPPROF
Command Type: Fast Path
Restrictions: Valid only in customization.
Screen Displayed: Dump Capture Profiles. This screen creates and maintains region and
transaction dump capture profiles.
DOMAINS
Command Type: Fast Path
Restrictions: Valid only for CICS region dumps.
Screen Displayed: CICS Domain Analysis menu. This menu provides access to detailed
information about the following domains:
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
Kernel Domain
Storage Manager
Dispatcher Domain
Lock Manager
Loader Domain
Local Catalog
Domain Manager
Parameter Domain
Global Catalog
Message Domain
Trace Domain
Dump Domain
Timer Domain
Statistics Domain
Monitoring Domain
Application Domain
Recovery Manager
Directory Manager
Program Manager
Transaction Manager
Enqueue Manager
Security Domain
User Domain
Intersystems Communication
Log Manager
Temporary Storage Domain
CBTS Domain
Abend-AID for CICS Commands: A through L
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
21-29
CBTS Event Manager
CBTS Scheduler Services
Recoverable Resource Manager
Sockets Domain
Web Domain
Document Handler Domain
IP ECI Domain
IIOP Domain
Enterprise Java Domain
Pipeline Domain
Object Transaction Service
Partner Domain
Request Streams Domain
JVM Domain
Debugging Profile Domain
Resource Lifecycle Manager
Event Processing Domain
XML Parsing
WEB2.0 Domain
Region Status Domain
DOWN
Command Type: Primary
The DOWN command scrolls the active screen display toward the bottom of a scrollable
list of entries. Pressing the DOWN key also executes this command. (PF8 is the default.)
scrollamount
The number of rows to scroll toward the bottom of a scrollable list of entries.
Example:
DOWN 12
This example scrolls the active screen display 12 rows toward the bottom of a scrollable
list of entries.
DP
Command Type: Fast Path
Screen Displayed: Debugging Profile Domain Anchor. This screen summarizes the
information collected by the Debugging Profile domain.
21-30
Abend-AID for CICS User’s Guide
DS
Command Type: Fast Path
Restrictions: Valid only for CICS region dumps.
Screen Displayed: Dispatcher Domain menu. This menu provides access to the following
screens:
•
•
•
•
Dispatcher
Dispatcher
Dispatcher
Dispatcher
Anchor Block
Domain Task Summary
Domain Task Queues
Domain Statistics
DSA
Command Type: Fast Path
Restrictions: Valid only for CICS transaction dumps.
Screen Displayed: Dynamic Storage Area Summary. This screen displays a dynamic
storage area summary for the specified COBOL program at the time the dump was taken.
The DSA can only occur for COBOL for MVS and VM, COBOL for OS/390 and VM, and
for higher versions of COBOL.
programname
The name of a COBOL program in the dump. If you do not include the program
name as an operand for the DSA command, the Dynamic Storage Area for the
abending program is displayed.
Example:
DSA PAYTEST1
DSANCH
Command Type: Fast Path
Restrictions: Valid only for CICS region dumps.
Screen Displayed: Dispatcher Anchor Block. This screen displays a detailed breakdown
of the dispatcher anchor block.
DSECT
Command Type: Primary
Abend-AID for CICS Commands: A through L
21-31
The DSECT command displays storage in DSECT format. To use the command, type
DSECT in the Command field; position the cursor on an address, a table entry, or a
control block symbol; and then press Enter. Pressing the DSECT PF key also executes this
command. (PF19 is the default.)
Note: The DSECT command functions only in fields for which a control block has been
defined. To determine if the command is available, use the ASSIST command.
Refer to “ASSIST” on page 21-6 for specifics.
For the list of DSECTs that Abend-AID for CICS supports, refer to “Selecting the
Appropriate DSECT Type” on page 6-3.
DSNLIST
Command Type: Primary
The DSNLIST command dynamically updates the list of report databases on the Available
Data Sets screen after a report database is added while the viewing server is active. Access
the Available Data Sets screen by pressing Enter on the DBLIST field on the Fault
Summary or the Abend-AID for CICS Directory. The DSNLIST command gives you access
to the added database without your having to logoff and log back on to the viewing
server.
DSQUEUE
Command Type: Fast Path
Restrictions: Valid only for CICS region dumps.
Screen Displayed: Dispatcher Domain Task Queues. This screen displays the number of
tasks on the various task queues controlled by the dispatcher domain. Most of the
dispatcher chains consist of double chains, called the front and back halves of the
queues. These chains are actually linked lists, which are designed to provide a sorted list
of tasks that can be manipulated concurrently by multiple TCBs.
DSSTAT
Command Type: Fast Path
Restrictions: Valid only for CICS region dumps.
Screen Displayed: Dispatcher Domain Statistics. This screen displays pertinent statistics
about the dispatcher domain.
21-32
Abend-AID for CICS User’s Guide
DSSUMM
Command Type: Fast Path
Restrictions: Valid only for CICS region dumps.
Screen Displayed: Dispatcher Domain Task Summary. This screen displays an overview
of the dispatcher tasks in the system at the time of the dump.
DTA
Command Type: Fast Path
Restrictions: Valid only for CICS region dumps.
Screen Displayed: Dispatcher Task Detail. This screen displays a detailed analysis of an
individual task.
dtasymbol
A valid DTA symbol name.
Example:
DTA.DTA0013
DU
Command Type: Fast Path
Restrictions: Valid only for CICS region dumps.
Screen Displayed: Dump Domain menu. This menu provides access to the following
screens:
• Dump Domain Anchor Block
• System Dump Table
• Transaction Dump Table
DUANCH
Command Type: Fast Path
Restrictions: Valid only for CICS region dumps.
Abend-AID for CICS Commands: A through L
21-33
Screen Displayed: Dump Domain Anchor Block. This screen displays information from
the dump domain anchor block.
DUSYS
Command Type: Fast Path
Restrictions: Valid only for CICS region dumps.
Screen Displayed: System Dump Table. This screen displays a list of the entries in the
CICS system dump table. The dump table facility tailors the dump actions on an
individual system or transaction dump code basis.
DUTRANS
Command Type: Fast Path
Screen Displayed: Transaction Dump Table. This screen displays a list of the entries in
the CICS transaction dump table. The dump table facility tailors the dump actions on an
individual system or transaction dump code basis.
EBUS
Command Type: Fast Path
Restrictions: Valid only for CICS transaction dumps.
Screen Displayed: WebSphere MQ Information. This screen provides information about
WebSphere MQ relating to the abending transaction.
EIBS
Command Type: Fast Path
Restrictions: Valid only for CICS transaction dumps.
Screen Displayed: System Execute Interface Block. This screen displays the system EIB
control block in interpreted format.
21-34
Abend-AID for CICS User’s Guide
EIBU
Command Type: Fast Path
Restrictions: Valid only for CICS transaction dumps.
Screen Displayed: User Execute Interface Block. This screen displays an interpreted user
EIB control block.
EJ
Command Type: Fast Path
Restrictions: Valid only for CICS region dumps.
Screen Displayed: Enterprise Java Domain menu. This menu provides access to the
following screens:
•
•
•
•
•
•
Enterprise Java Domain Anchor
Object Store Anchor
Domain Elements Anchor
CorbaServer Information
DJar Information
Bean Information
EJANCH
Command Type: Fast Path
Restrictions: Valid only for CICS region dumps.
Screen Displayed: Enterprise Java Anchor Block. This screen summarizes the information
collected by the Enterprise Java domain.
EM
Command Type: Fast Path
Restrictions: Valid only for CICS region dumps.
Screen Displayed: CBTS Event Manager. This screen displays the Global Storage for the
CICS Business Transaction Services Event Manager.
EM
Abend-AID for CICS Commands: A through L
21-35
END
Command Type: Primary
The END command terminates the current operation and redisplays the previous menu
or screen. The END command is usually assigned to a PF key. (The default is PF3.)
END
ENQ
Command Type: Fast Path
Restrictions: Valid only for CICS transaction dumps.
Screen Displayed: Enqueues Held. This screen identifies all enqueues that were held by
the abending transaction at the time of the dump.
ENQSUMM
Command Type: Fast Path
Restrictions: Valid only for CICS region dumps.
Screen Displayed: Enqueue Domain Enqueue Summary. This screen displays all of the
queue element areas (NQEAs) in the system. NQEAs are created as a result of issuing the
EXEC CICS ENQ command for a particular resource, or by CICS for various services.
ESRCH
Command Type: Fast-Path
Restrictions: Valid only for transaction dumps.
Screen Displayed: Extended Search Listing. For COBOL programs only, this screen
displays all fields available for extended search.
EXIT
Command Type: Primary
The EXIT command terminates the current session.
21-36
Abend-AID for CICS User’s Guide
EXTERNAL
Command Type: Fast Path
Restrictions: Valid only for CICS transaction dumps.
Screen Displayed: PL/I External Storage List. This screen displays a list of the external
storage that was allocated to the program at the time of the dump.
programname
The name of a PL/I program in the dump. If you do not include the program name as
an operand for the EXTERNAL command, the external storage for the abending
program is displayed.
Example:
EXTERNAL PAYTEST1
EXTRN
Command Type: Fast Path
Restrictions: Valid only for CICS transaction dumps.
Screen Displayed: COBOL External Cells List. Displays a list of the BLX cells that were
allocated to the selected COBOL program at the time of the dump.
programname
The name of a COBOL program in the dump. If you do not include the program
name as an operand for the EXTRN command, the BLX cell list for abending program
is displayed.
Example:
EXTRN PAYTEST1
FC
Command Type: Fast Path
Restrictions: Valid only for CICS region dumps.
Screen Displayed: File Control menu. This menu provides access to the following
screens:
• File Control Table
• Local Shared Resources
Abend-AID for CICS Commands: A through L
21-37
• File Control Request Summary
FCRQSUMM
Command Type: Fast Path
Restrictions: Valid only for CICS region dumps.
Screen Displayed: File Control Request Summary. This screen displays a list of the
inflight file control requests for each transaction in the CICS system.
FCT
Command Type: Fast Path
Restrictions: Valid only for CICS region dumps.
Screen Displayed: FCT Summary. This screen displays a list of entries in the AFCTE,
including remote files, and summary data related to each one.
FCTE
Command Type: Fast Path
Restrictions: Valid only for CICS region dumps.
Screen Displayed: VSAM FCT Detail. This command displays the FCT detail screen for
the selected file name.
filename
A valid FCT entry.
Example:
FCTE.DFHCSD
FILE
Command Type: Fast Path
Restrictions: Valid only for CICS transaction dumps.
21-38
Abend-AID for CICS User’s Guide
Screen Displayed: File Request Summary. This screen describes each file request on the
storage chain at the time of the dump.
FILEAREA
Command Type: Fast Path
Restrictions: Valid only for CICS transaction dumps.
Screen Displayed: File-Related Areas screen for the selected file.
filename
The name of a file that was associated with the transaction at the time of the dump.
Example:
FILEAREA PAYTEST1
FILEDET
Command Type: Fast Path
Restrictions: Valid only for CICS transaction dumps.
Screen Displayed: Local File Detail screen for the selected file.
filename
The name of a file that was associated with the transaction at the time of the dump.
Example:
FILEDET PAYTEST1
FILEREC
Command Type: Fast Path
Restrictions: Valid only for CICS transaction dumps.
Screen Displayed: File Recovery Information screen for the selected file.
Abend-AID for CICS Commands: A through L
21-39
filename
The name of a file that was associated with the transaction at the time of the dump.
Example:
FILEREC PAYTEST1
FIND
Command Type: Primary
The FIND command locates hexadecimal or character data strings. Its function and
syntax depend on the screen from which you are executing the command. By default, the
FIND command searches 2500 lines at a time. To change this value, modify the user
profile FIND command line limit default value. Refer to “User Profile Screen” on page
19-1 for additional information.
Note: The FIND command searches to the end of the page on which the last line of the
search is located. For example, if you change the FIND command line limit to
5000, executing the command actually searches more than 5000 lines, unless the
5000th line happens to be the last line on the page.
Executing FIND from the Memory Display
On the Memory Display screen, the FIND command locates hexadecimal or character
data based on selection parameters you specify. If you execute FIND without parameters,
the Find for Storage Display screen appears. This screen allows you to update FIND
command defaults for use on the Memory Display. For more information about the Find
for Storage Display screen, refer to “Find for Storage Display Screen” on page 5-5.
C'string 1'
Finds the character data identified as string 1.
X'string 2'
Finds the hexadecimal data identified as string 2.
T'string 3'
Finds the mixed-case character data identified as string 3.
NEXT
Finds the next occurrence of the string. Executing FIND without a directional
keyword (NEXT, PREV, FIRST, LAST) accomplishes the same result.
PREV
Finds the previous occurrence of the string.
FIRST
Finds the first occurrence of the string.
21-40
Abend-AID for CICS User’s Guide
LAST
Finds the last occurrence of the string.
Example 1:
F C'DFH'
Example 1 finds the character string DFH.
Example 2:
F X'D010' PREV
Example 2 finds the previous occurrence of the hexadecimal string D010. PREV overrides
the default direction and updates the Find for Storage Display screen.
Executing FIND from Screens Other Than the Memory Display
On screens other than the Memory Display, the FIND command locates specified data
strings. (Not all screens support the FIND command.) If you execute FIND without
specifying a data string, an error message appears.
Note: Because hexadecimal values are considered data strings on screens other than the
Memory Display, enclosing the hexadecimal value with x' ' is not necessary.
string
Finds the specified data string.
NEXT
Finds the next occurrence of the data string. Executing the command without a
directional keyword (NEXT, PREV, FIRST, LAST) accomplishes the same result.
PREV
Finds the previous occurrence of the data string.
FIRST
Finds the first occurrence of the data string.
LAST
Finds the last occurrence of the data string.
Example:
F DELETED LAST
This example finds the last occurrence of data string DELETED.
FLOAT
Command Type: Fast Path
Abend-AID for CICS Commands: A through L
21-41
Restrictions: Valid only for CICS transaction dumps.
Screen Displayed: Floating-Point Registers screen. This screen provides the values of the
floating-point registers for the transaction at the time of the abend.
FORWARD
Command Type: Primary
The FORWARD command is an alias for the DOWN command. (PF8 is the default.). Use
this command to scroll the active display toward the bottom of a scrollable list of entries.
lines
The number of lines to scroll.
Example:
FORW 8
This example scrolls the active display eight lines toward the bottom of the entries list.
GC
Command Type: Fast Path
Restrictions: Valid only for CICS region dumps.
Screen Displayed: Global Catalog Anchor Block. This screen displays the interpreted
global catalog anchor block. The global catalog is on DFHGCD and holds data used by
CICS for recovery/restart.
GO
Command Type: Primary
Valid on the Print Options and Initiation screen only. The GO command processes the
print dataset using the print options specified on the Print Options and Initiation screen.
HELP
Command Type: Primary
21-42
Abend-AID for CICS User’s Guide
The HELP command displays help text that describes a user-selected screen, field,
primary command, fast-path command, or system message. Pressing the HELP PF key also
executes this command. (PF1 and PF13 are the defaults.)
To access help for the current screen, enter HELP as a primary command. For field help,
type HELP, in the Command field, move the cursor to the desired field, and press Enter.
For command help, enter HELP cmdname. For message help, type HELP, in the
COMMAND (or OPTION) field, move the cursor to the message text, and press Enter.
Note:
Use the MSGHELP command to display help text for a particular Abend-AID
message number. For specifics, refer to “MSGHELP” on page 22-8.
For more information about accessing online help, refer to “Online Help” on page 1-12.
COMMANDS
Displays the list of Abend-AID primary and fast-path commands.
cmdname
The name of the primary or fast-path command for which Abend-AID displays help
text.
Example:
HELP FIND
This example displays help text for the FIND command.
HEXD
Command Type: Primary
The HEXD command displays storage in hexadecimal format. To use the command, type
HEXD in the Command field, position the cursor on an address, a table entry, or a
control block symbol; and then press Enter. Pressing the HEXD PF key also executes this
command. (PF18 is the default.)
For more information about displaying storage, refer to “Displaying Control Blocks and
Storage Information” on page 5-1.
HISTORY
Command Type: Fast Path
Restrictions: Valid only for CICS transaction dumps.
Screen Displayed: Duplicate History Log. This screen describes the 100 most recently
suppressed duplicate dumps.
Abend-AID for CICS Commands: A through L
21-43
HOGAN
Command Type: Fast Path
Restrictions: Valid only for CICS transaction dumps.
Screen Displayed: Hogan Information menu. This menu provides access to information
about the Hogan application.
HOSTVAR
Command Type: Fast Path
Restrictions: Valid only for CICS transaction dumps that contain DB2 information.
Screen Displayed: Host Variables. This screen lists the host variables that were referred
to by the SQL statement.
IBMMSG
Command Type: Primary
Restrictions: Valid only for CICS transaction dumps.
For transaction abends only. The IBMMSG command displays the IBM message text for
the specified CICS abend code.
abendcode
The name of a valid CICS abend code.
IC
Command Type: Fast Path
Restrictions: Valid only for CICS region dumps.
Screen Displayed: Interval Control Element (ICE) Summary. This screen displays the
ICEs in the system. Interval control provides various optional task functions based on
specific intervals of time, or time of day.
21-44
Abend-AID for CICS User’s Guide
IE
Command Type: Fast Path
Restrictions: Valid only for CICS region dumps.
Screen Displayed: IP ECI Domain menu. This menu provides access to the following
screens:
• IP ECI Anchor Block
• IP ECI Client State Summary
IEANCH
Command Type: Fast Path
Restrictions: Valid only for CICS region dumps.
Screen Displayed: IP ECI Domain Anchor Block. This screen summarizes the information
collected by the IE ECI domain.
II
Command Type: Fast Path
Restrictions: Valid only for CICS region dumps.
Screen Displayed: IIOP Domain menu. This menu provides access to the following
screens:
• IIOP Domain Anchor Block
• Request Model Class Anchor Block
IIANCH
Command Type: Fast Path
Restrictions: Valid only for CICS region dumps.
Screen Displayed: IIOP Domain Anchor Block. This screen summarizes the information
collected by the IIOP domain.
IMPORT
Command Type: Fast Path
Abend-AID for CICS Commands: A through L
21-45
Screen Displayed: Dataset Import. This screen can be used to import new region dumps
into Abend-AID.
INFO
Command Type: Fast Path
Screen Displayed: Entry Information screen for the current dump. General information
about the dump is displayed including the date and time the dump was taken and the
abend code that occurred.
INSTRUCT
Command Type: Primary
The INSTRUCT command shows or hides the instructional text on all screens in the
current session. For information about setting the INSTRUCT default value for all
sessions, refer to “User Profile Screen” on page 19-1.
INTFLOAT
Command Type: Fast Path
Screen Displayed: Floating Point Interpretation screen. This Floating Point Register
Interpretation screen displays the content of the 16 floating point registers, along with
the value they represent.
INTFloat
IPCS
Command Type: Fast Path
Restrictions: This facility is only available for region dumps, when the optional IPCS
support has been enabled.
Screen Displayed: IPCS Command Facility. This screen lets you enter IPCS commands.
21-46
Abend-AID for CICS User’s Guide
ITCB
Command Type: Fast Path
Restrictions: Valid only for CICS transaction dumps.
Screen Displayed: Hogan ITCB. This screen provides an interpretation of the Hogan
ITCB control block.
ITCB
ITRACE
Command Type: Primary
This command formats the internal trace entries used by the product to capture internal
information.
ITRACE
JOBCARD
Command Type: Fast Path
Restrictions: Valid only in customization.
Screen Displayed: Creates Action Job Cards. This screen create job cards for batch jobs
that are submitted for TSO user notification of CICS region or transaction abends.
JPASUMM
Command Type: Fast Path
Restrictions: Valid only for region dumps.
Screen Displayed: Job Pack Area Summary. This screen displays the Job Pack Area
Summary for the current address space. All of the load modules loaded into private area
storage are displayed on this screen, with further detailed information available from this
screen. The syntax for the JPASUMM command is:
KE
Command Type: Fast Path
Restrictions: Valid only for CICS region dumps.
Screen Displayed: Kernel Domain menu. This menu provides access to the following
screens:
Abend-AID for CICS Commands: A through L
•
•
•
•
Kernel
Kernel
Kernel
Kernel
21-47
Anchor Block
Task Summary
Domain Error Table
Domain Table
KEANCH
Command Type: Fast Path
Restrictions: Valid only for CICS region dumps.
Screen Displayed: Kernel Anchor Block. This screen displays a detailed analysis of the
kernel anchor block.
KEDOMAIN
Command Type: Fast Path
Restrictions: Valid only for CICS region dumps.
Screen Displayed: Kernel Domain Table. This screen displays entries in the kernel
domain table. This table contains data relating to each domain, such as the domain
name, its index, the pointer to its global storage (anchor block) and the state of the
domain (active or terminated).
KEER
Command Type: Fast Path
Restrictions: Valid only for CICS region dumps.
Screen Displayed: Kernel Domain Error Table. This screen displays error information for
tasks in error at the time of the dump. It displays an overview of the program checks and
system abends for this run of CICS, and provides access to detailed information about
each error.
KESUMM
Command Type: Fast Path
Restrictions: Valid only for CICS region dumps.
21-48
Abend-AID for CICS User’s Guide
Screen Displayed: Kernel Task Summary. This screen summarizes the kernel tasks in the
system at the time of the dump. It displays the totals of both the kernel and allocated
tasks, and also provides information about each allocated task.
KEYS
Command Type: Fast Path
Screen Displayed: PF Key Definitions - Primary. This screen modifies PF key definitions
and labels.
LD
Command Type: Fast Path
Restrictions: Valid only for CICS region dumps.
Screen Displayed: Loader Domain menu. This menu provides access to the following
screens:
• Loader Domain Summary
• Program Repertoire
• Program Storage Map
• Not-In-Use Chain
LDMAP
Command Type: Fast Path
Restrictions: Valid only for CICS region dumps.
Screen Displayed: Program Storage Map. This screen displays programs by ascending
load point address.
LDNIU
Command Type: Fast Path
Restrictions: Valid only for CICS region dumps.
Abend-AID for CICS Commands: A through L
21-49
Screen Displayed: Program Not-In-Use Chain. This screen displays programs whose use
count is zero. The storage occupied by these programs is eligible for removal from main
storage by being freemained or by being reused.
LDPROGS
Command Type: Fast Path
Restrictions: Valid only for CICS region dumps.
Screen Displayed: Program Repertoire. This screen displays information about the
programs used by CICS.
LDSUMM
Command Type: Fast Path
Restrictions: Valid only for CICS region dumps.
Screen Displayed: Loader Domain Summary. This screen displays summary information
from the loader domain anchor block:
LEFT
Command Type: Primary
The LEFT command scrolls the active screen display toward the first column of a
scrollable list of entries. Pressing the LEFT PF key also executes this command. (PF10 is
the default.)
scrollamount
The number of columns the active screen display should be scrolled toward the first
column of a scrollable list of entries.
Example:
LEFT 12
This example scrolls the active screen display 12 columns toward the first column of a
scrollable list of entries.
21-50
Abend-AID for CICS User’s Guide
LEINFO
Command Type: Fast Path
Screen Displayed: LE Information menu. This menu provides access to the following
screens:
• Language Environment Options Control Block
• Language Environment Information Summary
LEOCB
Command Type: Fast Path
Restrictions: Valid only for CICS transaction dumps.
Screen Displayed: Language Environment Options Control block.
LEVELS
Command Type: Fast Path
Restrictions: Valid only for CICS transaction dumps.
Screen Displayed: Program Level screen.
LG
Command Type: Fast Path
Restrictions: Valid only for CICS region dumps.
Screen Displayed: Log Manager Domain menu. This menu provides access to the
following screens:
•
•
•
•
•
•
Log
Log
Log
Log
Log
Log
Manager
Manager
Manager
Manager
Manager
Manager
Anchor Block
Journal Summary
Journal Model Summary
Log Stream Summary
General Log Summary
Browse Summary
LGANCH
Command Type: Fast Path
Abend-AID for CICS Commands: A through L
21-51
Restrictions: Valid only for CICS region dumps.
Screen Displayed: Log Manager Anchor Block. This screen displays detailed information
about the CICS Log Manager anchor block.
LGBRSUMM
Command Type: Fast Path
Restrictions: Valid only for CICS region dumps.
Screen Displayed: Log Manager Browse Summary. This screen displays a list of the
inflight browse inquires by either the CEMT INQUIRE STREAM transaction, or an EXEC
CICS INQUIRE JOURNALNAME(*) NEXT command.
LGGLSUMM
Command Type: Fast Path
Restrictions: Valid only for CICS region dumps.
Screen Displayed: Log Manager General Log Summary. This screen displays a list of the
General Logs defined to CICS. There is a general log defined for each forward recovery
log or each file control autojournal.
LGJLSUMM
Command Type: Fast Path
Restrictions: Valid only for CICS region dumps.
Screen Displayed: Log Manager Journal Summary. This screen displays a list of the
Journals defined to CICS.
LGJMSUMM
Command Type: Fast Path
Restrictions: Valid only for CICS region dumps.
Screen Displayed: Log Manager Journal Model Summary. This screen displays a list of
the Journal Models defined to CICS.
21-52
Abend-AID for CICS User’s Guide
LGSTSUMM
Command Type: Fast Path
Restrictions: Valid only for CICS region dumps.
Screen Displayed: Log Manager Log Stream Summary. This screen displays a list of the
Log Streams defined to CICS.
LINECMDS
Command Type: Primary
The LINECMDS command shows or hides the line commands for all screens in the
current session. For information about setting the LINECMDS default value for all
sessions, refer to “User Profile Screen” on page 19-1.
LINK
Command Type: Fast Path
Restrictions: Valid only for CICS transaction dumps.
Screen Displayed: COBOL Linkage Section List. This screen displays a list of the BLL cells
that were allocated to the specified COBOL program at the time the dump was taken.
programname
The name of a COBOL program in the dump.
Example:
LINK PAYTEST1
LIST
Command Type: Fast Path
Screen Displayed: Print Options and Initiation. This command updates the print output
options and processes the print dataset.
Abend-AID for CICS Commands: A through L
21-53
LLESUMM
Command Type: Fast Path
Restrictions: Valid only for region dumps.
Screen Displayed: System Load List Summary. This screen displays information
regarding system-loaded programs, including program name and load point.
LM
Command Type: Fast Path
Restrictions: Valid only for CICS region dumps.
Screen Displayed: Lock Manager Domain menu. This menu provides access to the
following screens:
• Lock Manager Anchor Block
• Lock Manager Summary
The Lock Manager Domain handles the lock services for CICS domains. The lock services
provide protection of resources when CICS domain tasks are running in concurrency
mode.
LMANCH
Command Type: Fast Path
Restrictions: Valid only for CICS region dumps.
Screen Displayed: Lock Manager Anchor Block. This screen displays information from
the lock manager anchor block.
LMODINFO
Command Type: Primary
The LMODINFO command displays the load module name, release level, and service level
information for the specified load module. Look for message RC1977 in the FDBDLOG.
LMSUMM
Command Type: Fast Path
21-54
Abend-AID for CICS User’s Guide
Restrictions: Valid only for CICS region dumps.
Screen Displayed: Lock Manager Summary. This screen lists the CICS locks in the
system.
LOCL
Command Type: Fast Path
Restrictions: Valid only for CICS transaction dumps.
Screen Displayed: Local Storage Cells. This command displays a list of the Local Storage
cells that were allocated to the specified COBOL program at the time the dump was
taken. These cells can only occur for COBOL for MVS and VM, COBOL for OS/390 and
VM, and for higher versions of COBOL.
programname
The name of a COBOL program in the dump. If you do not include the program
name as an operand for the LOCL command, the Local Storage cell list for the
abending program is displayed.
Example:
LOCL PAYTEST1
LOG
Command Type: Fast Path
Screen Displayed: Problem Log Entries for the current dump. This command is available
only with the Abend-AID using ISPF viewing access method.
LOGSPOOL
Command Type: Fast Path
Screen Displayed: Closes and re-opens the FDBDLOG SYSOUT dataset. This allows the
dataset to be saved or printed, potentially reducing the amount of system spool space
used by the server.
Abend-AID for CICS Commands: A through L
21-55
LPAMAP
Command Type: Fast Path
Restrictions: Valid only for region dumps.
Screen Displayed: Link Pack Areas Map. This screen lists the modules in the system
PLPA, MLPA, and FLPA.
LPRINT
Command Type: Primary
The LPRINT command prints a logical image of a screen to a sequential dataset. Pressing
the LPRINT PF key also executes this command. (PF23 is the default). A logical image
includes all data associated with a screen, regardless of how much is currently displayed
(contrasted to a physical image, which includes only the data currently displayed). A
physical print is accomplished using the PRINT command.
When used without an optional parameter, LPRINT prints a logical image of the screen
currently displayed. When used with an optional parameter, LPRINT prints a logical
image of the screen specified by the parameter. Certain exceptions apply. A physical image
of a screen is always printed, even if a logical print is requested, when the screen to be
printed is one of the following:
• A non-scrollable screen
• A memory display screen
• A storage disassembly screen.
These exceptions apply both to currently displayed screens and to those specified by a
parameter.
Screens printed using the LPRINT command are written to a dataset governed by the
Print Options and Initiation screen. You may access this screen using the LIST fast-path
command. The Print Options and Initiation screen controls various print options
including the disposition of the dataset. Printing is initiated using the GO command or
by logging off. You must use this screen to print any datasets created using the LPRINT
command. For more information about displaying print output options or the Print
Options and Initiation screen, refer to “Print Options and Initiation Screen” on page 7-1.
For more information about using the LPRINT command, see Chapter 7, “Printing
Abend-AID for CICS Information”.
21-56
Abend-AID for CICS User’s Guide
fastpathcommand
The fast-path command of the screen to be printed.
#ALL
Valid for transaction entries only. Prints a complete transaction report. Refer to
“Complete Transaction Abend Report” on page 7-5 for a description of what is
contained in this report.
#DB2ALL
Valid for transaction entries only. Prints a complete transaction report, including DB2
information if available. Refer to “Complete DB2 Transaction Abend Report” on page
7-6 for a description of what is contained in this report.
#SUMMARY
Prints a summary report. Refer to “Transaction Abend Summary Report” on page 7-6
and “Region Dump Summary Report” on page 7-7 for a description of what is
contained in a summary report, by entry type.
#DB2SUMM
Valid for transaction entries only. Prints a summary report, including the DB2
information if available. Refer to “DB2 Transaction Abend Summary Report” on page
7-7.
$controlblockname
Prints the DSECT format of the named control block. Only DSECTS of single element
control blocks (CSA or CSAOPFL, for example) can be printed this way. For other
types of control blocks (FCT, for example), you must first display the control block’s
DSECT screen and then use the LPRINT command. Refer to Chapter 5, “Accessing
Storage Information” for additional information about control blocks.
@symbolname ’storage comment’
Prints the hexadecimal storage associated with the named symbol. The symbol name
is required but the storage comment (limited to 66 characters) is optional and, if
specified, must be surrounded by single quotation marks. Refer to Appendix D,
“Symbols List” for a list of valid symbols.
@address.length ’storage comment’
Prints the hexadecimal storage at the given address for the given length. The address
is required and must be in hexadecimal notation. The default length is 4096 and the
maximum length allowed is 1,048,576 (1 megabyte). The storage comment (limited
to 66 characters) is optional and, if specified, must be surrounded by single quotation
marks.
LSQASP
Command Type: Fast Path
Restrictions: Valid only for region dumps.
Screen Displayed: Summarized LSQA Subpools. This screen lists a summary of storage
allocated to the LSQA subpools at the time of the fault.
Abend-AID for CICS Commands: A through L
21-57
LSQASUM
Command Type: Fast Path
Restrictions: Valid only for region dumps.
Screen Displayed: LSQA Summary. This screen lists the LSQA AQAT Index addresses and
DFE chains at the time of the fault.
LSR
Command Type: Fast Path
Restrictions: Valid only for CICS region dumps.
Screen Displayed: LSR Summary. This screen displays the list of VSAM LSR pools.
LSR
L3270
Command Type: Fast Path
Restrictions: Valid only for CICS transaction dumps.
Screen Displayed: Last 3270 menu. This menu provides access to the following screens:
• Last 3270 Screen Image
• Data Stream Analysis.
Note:
The minimum abbreviation for the L3270 command is two characters.
21-58
Abend-AID for CICS User’s Guide
22-1
Chapter 22.
Abend-AID for CICS Commands: M through Z
Chap 22
This chapter lists all of the Abend-AID for CICS primary and fast-path commands that
begin with the letter M through the letter Z.
Note: Many of these commands, especially the fast path commands, function only after
you have selected an entry from the Abend-AID Directory and, in some cases,
only if you are executing them from specific screens. For information about the
Abend-AID Directory, refer to “Abend-AID Directory” on page 4-3.
MAINMENU
Command Type: Fast Path
Screen Displayed: Causes an immediate return to the primary options menu.
MAINTCF
Command Type: Fast Path
Restrictions: Valid only within the Site Customization facility.
Screen Displayed: Add/Maintain Site News screen. This screen lets you add site-specific
text to the Product News facility for Abend-AID for CICS.
MAPD
Command Type: Primary
The MAPD command maps storage into DSECT format. Typing the command without
any parameters, positioning the cursor on a hexadecimal address, and pressing Enter
displays the System DSECT Table, which lists the DSECTs available for the selected dump.
22-2
Abend-AID for CICS User’s Guide
firstdsect
The first DSECT in a DSECT member. The literal O= (“origin equals”) must precede
the name of the first DSECT. MAPD automatically includes the first DSECT by default
if you include neither the first DSECT, nor a DSECT label parameter in the command.
label
First 30 bytes of the DSECT statement’s Name field. The literal O= must precede the
name of the DSECT. Use the label parameter to view DSECTs other than the first
DSECT in a DSECT member.
address
Maps storage at the hexadecimal address specified. You cannot include this
parameter in a MAPD command that uses the tabletype and tableentry parameters.
symbolname
Maps storage at the symbol name specified. The literal S/ must precede the symbol
name. You cannot include this parameter in a MAPD command that uses the tabletype
and tableentry parameters.
tabletype tableentry
Maps storage at the table specified. A space separates the table type from the table
entry, for example, PCTE CEMT. PCTE is the table type, and CEMT is the entry in the
table. You cannot include these parameters in a MAPD command that uses either the
address or the symbolname parameter.
dsecttype
DSECT type. If you do not specify a DSECT type, Abend-AID for CICS automatically
displays the System DSECT Table, which lists the DSECT types available for the
current dump.
To select one from those listed, position the cursor on the desired DSECT type and
press Enter. Use the UP and DOWN PF keys to scroll the list. (PF7 and PF8 are the
defaults.) After you select the DSECT type, the applicable DSECT screen
automatically appears.
For the list of valid DSECT types, you can also refer to “Selecting the Appropriate
DSECT Type” on page 6-3.
USER
This literal specifies that the storage is mapped against a user-defined DSECT type.
For information about defining your own DSECTs, refer to the Abend-AID Installation
and Customization Guide.
Example 1:
MAPD
Example 1 displays the System DSECT Table, which lists the DSECTs available for the
currently selected dump.
Example 2:
MAPD 0045FD34 FCTE
Example 2 maps the storage associated with hexadecimal address 0045FD34 into the FCT
entry DSECT format.
Example 3:
MAPD S/TCA0009 UTCA
Abend-AID for CICS Commands: M through Z
22-3
Example 3 maps the storage associated with symbol TCA0009 into the user TCA DSECT
format.
Example 4:
MAPD PCTE CSTP
Example 4 maps the storage associated with table entry CSTP into the PCT entry DSECT
format.
Example 5:
MAPD 007D0010 MYDSECT USER
Example 5 maps the storage associated with hexadecimal address 007D0010 into the
user-defined DSECT specified by the first DSECT in member MYDSECT.
Example 6:
MAPD O=YOURDSECT 007D00B0 MYDSECT USER
Example 6 maps the storage associated with hexadecimal address 007D00B0 into the
user-defined DSECT specified by starting label YOURDSECT in member MYDSECT.
MATCH
Command Type: Primary
For region dumps only. The MATCH command searches the dump for data matching
user-specified parameters. Pressing the MATCH PF key also executes this command. (PF22
is the default.)
When a match is found, Abend-AID displays the Storage Addressability Summary screen.
On this screen are TCBs (for all dumps), TCAs (for CICS dumps only), and KETASKs (for
CICS dumps only) that have addressability to the data specified in the command. To
display the next occurrence of matching data on this screen, press Enter.
default ##
Searches an address or symbol to match the first occurrence of the number of bytes of
data specified as the default in the user profile. The supplied default is 4 bytes.
Executing the MATCH command without any parameter accomplishes the same
result.
Note:
You can change the default MATCH command search length on the User
Profile screen. For specifics, refer to “User Profile Screen” on page 19-1.
To specify the location, place the cursor at the address or symbol before pressing
Enter.
##
Matches the number of bytes specified (26 maximum) at a symbol or address. To
specify the location, place the cursor at the address or symbol before pressing Enter.
22-4
Abend-AID for CICS User’s Guide
C'string 1'
Matches the character string identified as string 1.
X'string 2'
Matches the hexadecimal string identified as string 2.
Example 1:
MATCH
Example 1 matches the default number of bytes of data found at the address or symbol
on which the cursor is positioned.
Example 2:
MATCH 6
Example 2 matches the first six bytes of data found at the address or symbol on which
the cursor is positioned.
Example 3:
MATCH C'CICSTEST'
Example 3 searches for a match to the character string CICSTEST.
Example 4:
MATCH X'C1000000F0F3'
Example 4 searches for a match to the hexadecimal string C1000000F0F3.
MCT
Command Type: Fast Path
Restrictions: Valid only for CICS region dumps.
Screen Displayed: Monitoring Control Table (in interpreted format). The monitoring
control table describes the way user data fields in the performance class monitoring
records are to be manipulated at each user Event Monitoring Point (EMP). It also controls
which performance class data fields are to be recorded.
ME
Command Type: Fast Path
Restrictions: Valid only for CICS region dumps.
Screen Displayed: Message Domain menu. This menu provides access to the following
screens:
• Message Domain Anchor
• Message Domain Message Modules
Abend-AID for CICS Commands: M through Z
22-5
MEANCH
Command Type: Fast Path
Restrictions: Valid only for CICS region dumps.
Screen Displayed: Message Domain Anchor Block. This screen displays detailed
information about the CICS message domain anchor block.
MESUMM
Command Type: Fast Path
Restrictions: Valid only for CICS region dumps.
Screen Displayed: Message Domain Message Modules. This screen displays information
about National Language Support (NLS).
MLOG
Command Type: Fast Path
Restrictions: Valid only for region dumps.
Screen Displayed: Dump Analysis Message Log for the currently selected dump. This
screen lists the messages generated during dump import and analysis.
MLVL
Command Type: Primary
Restrictions: Valid only for CICS transaction dumps and batch dumps.
This command displays the Abend-AID modules maintenance level at the time of
capture. Modules at GABASE are not displayed.
22-6
Abend-AID for CICS User’s Guide
MM
Command Type: Fast Path
Screen Displayed: Returns immediately return to the primary options menu.
MN
Command Type: Fast Path
Restrictions: Valid only for CICS region dumps.
Screen Displayed: Monitoring Domain menu. This menu provides access to the
following information screens:
•
•
•
•
•
Monitor Anchor Block
Monitoring Control Table
Monitoring Dictionary
Monitoring Statistics
Task Monitoring Areas
MNANCH
Command Type: Fast Path
Restrictions: Valid only for CICS region dumps.
Screen Displayed: Monitoring Anchor Block. This screen displays the interpreted CICS
monitoring anchor block. The top part of the screen shows the status of the domain and
which classes of monitoring are active.
MNDICT
Command Type: Fast Path
Restrictions: Valid only for CICS region dumps.
Screen Displayed: Monitoring Dictionary. This screen displays the CICS monitoring
dictionary. The dictionary data defines all the performance data that can be gathered for
this run. It includes all the system and user specified data in the monitoring control table
(MCT).
Abend-AID for CICS Commands: M through Z
22-7
MNMCT
Command Type: Fast Path
Restrictions: Valid only for CICS region dumps.
Screen Displayed: Monitoring Control Table. This screen displays the CICS monitoring
control table (MCT) in interpreted format. The monitoring control table describes the
way user data fields in the performance class monitoring records are to be manipulated at
each user Event Monitoring Point (EMP).
MNSTAT
Command Type: Fast Path
Restrictions: Valid only for CICS region dumps.
Screen Displayed: Monitoring Statistics. This screen displays the CICS monitoring
domain statistics. It contains the count of exception and performance records, the actual
number of SMF records written, and the number of sysevent records written.
MNTMA
Command Type: Fast Path
Restrictions: Valid only for CICS region dumps.
Screen Displayed: Task Monitoring Areas. This screen displays a list of all task
monitoring areas (TMAs) and monitoring area entries (MAEs). These control blocks
contain data related to the CICS monitoring function on a per-task basis.
MODE
Command Type: Primary
The MODE command sets the Memory Display navigation mode to either 31-bit or 64-bit
for the current session.
MQINFO
Command Type: Fast Path
22-8
Abend-AID for CICS User’s Guide
Restrictions: Valid only for CICS region dumps, CICS transaction dumps, and batch
dumps if the dump contains WebSphere MQ information. You must be licensed for
Abend-AID for WebSphere MQ to use this command.
Screen Displayed: WebSphere MQ Information. This screen provides information about
WebSphere MQ relating to the abending transaction.
MSA
Command Type: Fast Path
Restrictions: Valid only for CICS transaction dumps.
Screen Displayed: MSA Information. This screen provides summary information about
the MSA application.
MSGHELP
Command Type: Primary
The MSGHELP command displays the help text associated with a specific Abend-AID
system message number.
Note:
Use the HELP command to display help text for screens, fields, commands, and
currently displayed system messages. For specifics, refer to “HELP” on page
21-41.
messageID
The number associated with the system message entered minus the first 3 characters,
and the last character. For example, the messageID for message number ERWSI0052E
is SI0052. To display help text for the currently displayed message, you can also type
HELP, move the cursor to the displayed message, and press Enter.
Example:
This example displays the help text associated with system message ERWSI0052E.
MSGHELP SI0052
MSGS
Command Type: Primary
Abend-AID for CICS Commands: M through Z
22-9
The MSGS command toggles the message parameter value to display (ON) or suppress
(OFF) messages in the server FDBDLOG. When no action is specified, the current
MESSAGES parameter value is displayed in the FDBDLOG.
MVSENV
Command Type: Fast Path
Restrictions: Valid only for region dumps.
Screen Displayed: MVS Environment Summary. This screen provides general
information about the address space job and the MVS environment under which it was
executing.
MVSINFO
Command Type: Fast Path
Restrictions: Valid only for region dumps.
Screen Displayed: MVS Information menu. This menu provides access to the following
screens:
•
•
•
•
•
•
•
MVS Environment Summary
MVS TCB Summary
JES2 System Log
MVS Storage Analysis
Job Pack Area Summary
TCB Load List Summary
LE Information
MVSSTG
Command Type: Fast Path
Restrictions: Valid only for region dumps.
Screen Displayed: MVS Storage Analysis menu. This menu provides access to the
following screens:
•
•
•
•
•
•
•
•
•
Virtual Storage Map
Private Area Summary
Allocated Private Subpools
LSQA Summary
Summarized LSQA Subpools
Allocated Storage Map
SQA Summary
Summarized SQA Subpools
Common Service Area Summary
22-10
Abend-AID for CICS User’s Guide
•
•
•
•
•
Summarized CSA Subpools
Link Pack Areas Map
Nucleus Map
Memory Objects
Data Spaces
NEWS
Command Type: Fast Path
Screen Displayed: The NEWS command displays a pop-up window with selections to
either display the summary of changes for the current Abend-AID or Abend-AID/CICS
release or display site-specific news pertaining to each product (see “SITENEWS” on page
22-30 for more information). The first time you log onto Abend-AID, the NEWS pop-up
window is automatically displayed. Enter the NEWS command on the Command line of
any Abend-AID screen to display the summary of changes at any time.
NOTE
Command Type: Primary
Restrictions: This command is available only with the Abend-AID using ISPF viewing
access method.
This command lets you enter notes into the problem log for the current dump using ISPF
EDIT facilities. All commands function as in ISPF.
NOTFYRG
Command Type: Fast Path
Restrictions: Valid only in customization.
Screen Displayed: Region Action Definitions. This screen creates and maintains region
dump action definitions.
NOTFYTR
Command Type: Fast Path
Restrictions: Valid only in customization.
Abend-AID for CICS Commands: M through Z
22-11
Screen Displayed: Transaction Action Definitions. This screen creates and maintains
transaction dump action definitions.
NOTIFY
Command Type: Fast Path
Restrictions: Valid only in customization.
Screen Displayed: Action Definition menu. This menu provides access to the following
screens:
•
•
•
•
Create Job Cards for Action Definitions
Transaction Dump Action Definitions
Region Dump Action Definitions
Batch Dump Contact Information Definitions
NQ
Command Type: Fast Path
Restrictions: Valid only for CICS region dumps.
Screen Displayed: Enqueue Manager Domain menu. This menu provides access to the
following screens:
• Enqueue Manager Anchor Block
• Enqueue Summary
• Enqueue Pool Summary
NQANCH
Command Type: Fast Path
Restrictions: Valid only for CICS region dumps.
Screen Displayed: Enqueue Manager Anchor Block. This screen displays detailed
information about the CICS Enqueue Manager anchor block.
NQPLSUMM
Command Type: Fast Path
Restrictions: Valid only for CICS region dumps.
22-12
Abend-AID for CICS User’s Guide
Screen Displayed: Enqueue Pool Summary. This screen displays a list of the enqueue
pools created by CICS to manage related enqueues.
NUCMAP
Command Type: Fast Path
Restrictions: Valid only for region dumps.
Screen Displayed: Nucleus Map. This screen lists the modules in the system nucleus.
@offset
Command Type: Primary
Valid on the Memory Display screen only. The @offset command positions the display at
the fullword address at the hexadecimal offset.
offset
Hexadecimal offset number
-offset
Command Type: Primary
Valid on the Memory Display and Storage Disassembly screens only. The -offset command
scrolls the display backward the specified hexadecimal offset. Use the RESET primary
command to reset the display to offset zero. Refer to “RESET” on page 22-22 for
additional information.
offset
Hexadecimal offset number
#offset
Command Type: Primary
Abend-AID for CICS Commands: M through Z
22-13
Valid on the Memory Display screen only. The #offset command scrolls the Memory
Display forward to the specified offset relative to the start address.
offset
Hexadecimal offset number
+offset
Command Type: Primary
Valid on the Memory Display and Storage Disassembly screens only. The +offset command
scrolls the display forward the specified hexadecimal offset. Use the RESET primary
command to reset the display to offset zero. Refer to “RESET” on page 22-22 for
additional information.
offset
Hexadecimal offset number
OPFL
Command Type: Fast Path
Restrictions: Valid only for CICS region and CICS transaction dumps.
Screen Displayed: CSA Optional Feature List. This screen displays an interpreted subset
of the CICS common system area optional features list control block.
OT
Command Type: Fast Path
Restrictions: Valid only for CICS region dumps.
Screen Displayed: Object Transaction Anchor Block. This screen summarizes the
information collected by the Object Transaction domain.
PA
Command Type: Fast Path
Restrictions: Valid only for CICS region dumps.
22-14
Abend-AID for CICS User’s Guide
Screen Displayed: Parameter Domain menu. This menu provides access to the following
screens:
•
•
•
•
•
Parameter Anchor Block
System Initialization Table
SIT Overrides
SIT Overrides PRVMOD List
SIT XRF Options
PAANCH
Command Type: Fast Path
Restrictions: Valid only for CICS region dumps.
Screen Displayed: Parameter Domain Anchor Block. This screen displays detailed
information about the CICS parameter domain anchor block.
PCLP
Command Type: Fast Path
Screen Displayed: Current Paperclip Table. This screen lists the 389 most recently
accessed memory locations on the Memory Display screen.
PCT
Command Type: Fast Path
Restrictions: Valid only for CICS region dumps.
Screen Displayed: Transaction Definitions. This screen displays a list of the transactions
defined to CICS.
PCTE
Command Type: Fast Path
Restrictions: Valid only for CICS region dumps.
Screen Displayed: Transaction Definition for the specified transaction.
Abend-AID for CICS Commands: M through Z
22-15
transaction
Specific transaction ID.
Example:
PCTE.cemt
PFKEYS
Command Type: Fast Path
Screen Displayed: Site PF Keys - Primary. This screen sets site defaults for PF key options.
PG
Command Type: Fast Path
Restrictions: Valid only for CICS region dumps.
Screen Displayed: Program Manager menu. This menu provides access to the following
screens:
• Program Manager Anchor Block
• Program (PPTE) Summary
• System Load List Summary
PGANCH
Command Type: Fast Path
Restrictions: Valid only for CICS region dumps.
Screen Displayed: Program Manager Anchor Block. This screen displays an
interpretation of the program manager anchor block.
PGMDET
Command Type: Fast Path
Restrictions: Valid only for CICS transaction dumps.
Screen Displayed: Program Detail for the selected program.
22-16
Abend-AID for CICS User’s Guide
programname
Where programname is the name of a program in the dump.
Example:
PGMDET PAYTEST1
PGMLINK
Command Type: Fast Path
Restrictions: Valid only for CICS transaction dumps.
Screen Displayed: Program Link Information. This screen lists all programs in the
linkage structure.
PGMSUMM
Command Type: Fast Path
Restrictions: Valid only for CICS transaction dumps.
Screen Displayed: Program Summary Information. This screen lists the programs that
were associated with the transaction at the time of the dump.
PLI
Command Type: Fast Path
Restrictions: Valid only for CICS transaction dumps.
Screen Displayed: PL/I Storage Areas menu. This menu provides access to either
automatic or static storage for the selected program.
programname
Where programname is the name of a PL/I program in the dump.
Example:
PLI PAYTEST1
PLIST
Command Type: Fast Path
Restrictions: Valid only for CICS transaction dumps.
Abend-AID for CICS Commands: M through Z
22-17
Screen Displayed: Source listing for the specified program.
programname
The name of a COBOL program in the dump. If you do not include the program
name as an operand for the PLIST command, the source listing for the abending
program is displayed.
Example:
PLIST PAYTEST1
PPT
Command Type: Fast Path
Restrictions: Valid only for CICS region dumps.
Screen Displayed: PPT Summary. This screen displays a list of the programs defined to
CICS. The syntax for the PPT command is:
PPTE
Command Type: Fast Path
Restrictions: Valid only for CICS region dumps.
Screen Displayed: Program Definition. This command displays the detail screen for the
specified PPT entry.
program
Specific program.
Example:
PPTE.dfhemtd
PRECOMP
Command Type: Fast Path
Screen Displayed: Precompile Information.
22-18
Abend-AID for CICS User’s Guide
PRINT
Command Type: Primary
The PRINT command prints a physical image of a screen to a sequential dataset. A
physical image includes only the data currently displayed (contrasted to a logical image,
which includes all data associated with a screen). A logical print is accomplished using
the LPRINT command.
When used without an optional parameter, PRINT prints a physical image of the screen
currently displayed. When used with an optional parameter, PRINT prints a logical image
of the screen specified by the parameter. Certain exceptions apply. A physical image of a
screen is always printed, even if a logical print is requested, when the screen to be
printed is one of the following:
• A non-scrollable screen
• A memory display screen
• A storage disassembly screen.
These exceptions apply both to currently displayed screens and to those specified by a
parameter.
Screens printed using the PRINT command are written to a dataset governed by the Print
Options and Initiation screen. You may access this screen using the LIST fast-path
command. The Print Options and Initiation screen controls various print options
including the disposition of the dataset. Printing is initiated using the GO command or
by logging off. You must use this screen to print any datasets created using the PRINT
command. For more information about displaying print output options or the Print
Options and Initiation screen, refer to “Print Options and Initiation Screen” on page 7-1.
For more information about using the PRINT command, refer to Chapter 7, “Printing
Abend-AID for CICS Information”.
fastpathcommand
The fast-path command of the screen to be printed.
#ALL
Valid for transaction entries only. Prints a complete transaction report. Refer to
“Complete Transaction Abend Report” on page 7-5 for a description of what is
contained in this report.
#DB2ALL
Valid for transaction entries only. Prints a complete transaction report, including DB2
information if available. Refer to “Complete DB2 Transaction Abend Report” on page
7-6 for a description of what is contained in this report.
Abend-AID for CICS Commands: M through Z
22-19
#SUMMARY
Prints a summary report. Refer to “Transaction Abend Summary Report” on page 7-6
and “Region Dump Summary Report” on page 7-7 for a description of what is
contained in a summary report, by entry type.
#DB2SUMM
Valid for transaction entries only. Prints a summary report, including the DB2
information if available. Refer to “DB2 Transaction Abend Summary Report” on page
7-7.
$controlblockname
Prints the DSECT format of the named control block. Only DSECTS of single element
control blocks (CSA or CSAOPFL, for example) can be printed this way. For other
types of control blocks (FCT, for example), you must first display the control block’s
DSECT screen and then use the LPRINT command. Refer to Chapter 5, “Accessing
Storage Information” for additional information about control blocks.
@symbolname ’storage comment’
Prints the hexadecimal storage associated with the named symbol. The symbol name
is required but the storage comment is optional (limited to 66 characters) and, if
specified, must be surrounded by single quotation marks. Refer to Appendix D,
“Symbols List” for a list of valid symbols. To display storage for other types of control
blocks, you must supply the storage address and length of the control block (see next
parameter).
@address.length ’storage comment’
Prints the hexadecimal storage at the given address for the given length. The address
is required and must be in hexadecimal notation. The default length is 4096 and the
maximum length allowed is 1,048,576 (1 megabyte). The storage comment is
optional (limited to 66 characters) and, if specified, must be surrounded by single
quotation marks.
PRINTIDX
Command Type: Primary
The PRINTIDX command results in the index for a report being printed at the end of that
report.
Note:
This command is not meant to be used directly by a user. Instead it is normally
invoked in the processing of the PRINT #SUMMARY standard report.
PROFILE
Command Type: Fast Path
Screen Displayed: User Profile. This screen modifies user profile options.
22-20
Abend-AID for CICS User’s Guide
PROG
Command Type: Fast Path
Restrictions: Valid only for CICS transaction dumps and batch dumps.
Screen Displayed: Program Information menu. This menu provides access to the
following screens:
• Program Link Information
• Program Summary Information
PRTOPTS
Command Type: Fast Path
Screen Displayed: Site Print Options. This screen sets site defaults for print options.
PSA
Command Type: Fast Path
Restrictions: Valid only for region dumps.
Screen Displayed: Prefixed Save Area.
PSW
Command Type: Fast Path
Restrictions: Valid only for CICS transaction dumps and batch dumps.
Screen Displayed: Program Status Word Information screen. This screen displays an
interpretation of the application's program status word (PSW) at the time of the abend.
PT
Command Type: Fast Path
Restrictions: Valid only for CICS region dumps.
Screen Displayed: Partner Domain menu. This menu provides access to the following
screens:
• Partner Anchor Block
Abend-AID for CICS Commands: M through Z
22-21
• Partner Pool Summary
• Partner State Summary
PTANCH
Command Type: Fast Path
Restrictions: Valid only for CICS region dumps.
Screen Displayed: memory location of the Partner Domain Anchor Block.
PVTSP
Command Type: Fast Path
Restrictions: Valid only for region dumps.
Screen Displayed: Allocated Private Subpools. This screen lists the private area subpools
allocated at the time of the fault.
PVTSUM
Command Type: Fast Path
Restrictions: Valid only for region dumps.
Screen Displayed: Private Area Summary. This screen lists the private area allocations of
the current ASID at the time of the fault.
RCTD
Restrictions: Valid only for CICS region dumps.
Command Type: Fast Path
Screen Displayed: RCT Detail.
REGIONS
Command Type: Fast Path
22-22
Abend-AID for CICS User’s Guide
Restrictions: Valid only in customization.
Screen Displayed: CICS Region Configuration. This screen creates and maintains CICS
region configuration entries.
REGS
Command Type: Fast Path
Restrictions: Valid only for CICS transaction dumps and batch dumps.
Screen Displayed: Registers. This screen display the values of the registers and their
storage locations at the time of the dump.
REMOTE
Command Type: Fast Path
Restrictions: Valid only for CICS transaction dumps and batch dumps.
Screen Displayed: List of Remote Source Files. This screen displays the user-defined
remote source datasets.
RESMGR
Command Type: Fast Path
Restrictions: Valid only for CICS region dumps.
Screen Displayed: Resource Manager Summary. This screen displays all active resource
managers in the system. A resource manager (RM) uses the task-related user exit support
in CICS that provides an interface to communicate with CICS applications.
RESET
Command Type: Primary
Valid only on the Memory Display and Storage Disassembly screens, and on any screen
that supports masking and sorting. On the Memory Display and Storage Disassembly
screens, enter the RESET command without a parameter to reset the display to offset zero.
On screens that support masking and sorting, you can enter this command without a
Abend-AID for CICS Commands: M through Z
22-23
parameter to reset both masking and sorting, or specify the parameter to reset only one
or the other.
MASK
Resets the column mask only.
SORT
Resets the column sort only.
RESETDAE
Command Type: Primary
Upon execution, the RESETDAE command increments by one the Dump Analysis and
Elimination (DAE) sequence number when an internal server dump is taken. Updating
the DAE sequence number ensures that the next dump will not be suppressed by the
operating system’s DAE facility. This command is available for use with the Abend-AID
viewing server and transaction dump capture address space (TDCAS).
Normally Compuware Technical Support will ask you to execute this command to obtain
an SVC dump to help resolve a problem when the prior SVC dump is no longer available
and DAE is suppressing duplicate SVC dumps.
RESTORE
Command Type: Primary
The RESTORE command restores a saved paperclip table from the Saved Paperclip List.
Once restored, the table becomes the current paperclip table. For information about the
paperclip list, refer to “Saved Paperclip List” on page 5-7.
tablename
One- to eight-character name of the paperclip table.
Example:
RESTORE PFHTBL12
This example restores paperclip table PFHTBL12 from the Saved Paperclip List.
RETRIEVE
Command Type: Primary
22-24
Abend-AID for CICS User’s Guide
The RETRIEVE command displays the most recently entered commands on the command
line, one command at a time, in the reverse sequence in which they were entered (last-in,
first-out). This command allows you to easily recall a command for resubmission from
the command line. You can edit the command before entering it. Pressing the RETRIEVE
PF key also executes this command. (PF12 is the default.)
RETURN
Command Type: Primary
The RETURN command causes an immediate return to the Abend-AID Primary Options
menu. Pressing the RETURN PF keys also executes this command. (PF4/PF16 are the
defaults.)
REXX
Command Type: Primary
The REXX command processes REXX EXECs for any Abend-AID dumps.
execname
One- to eight-character member name of the REXX EXEC from a dataset allocated to
the viewing server’s SYSEXEC DD statement during Abend-AID for CICS installation.
data
Optional parameter that specifies the data to be passed to the EXEC.
Example:
REXX CHECK CSA
This example processes the EXEC named CHECK, which uses the string ’CSA’ as input.
RFIND
Command Type: Primary
The RFIND command repeats the previously issued FIND command. Pressing the RFIND
PF key also executes this command. (PF5 is the default.)
Abend-AID for CICS Commands: M through Z
22-25
RIGHT
Command Type: Primary
The RIGHT command scrolls the active screen display toward the last column of a
scrollable list of entries. Pressing the RIGHT PF key also executes this command. (PF11 is
the default.)
scrollamount
The number of columns the active screen display should be scrolled toward the last
column of a scrollable list of entries.
Example:
RIGHT 12
This example scrolls the active screen display 12 columns toward the last column of a
scrollable list of entries.
RM
Command Type: Fast Path
Restrictions: Valid only for CICS region dumps.
Screen Displayed: Recovery Manager Domain menu. This menu provides access to the
following screens:
• Recovery Manager Anchor Block
• Recovery Manager Unit of Work Summary
RMANCH
Command Type: Fast Path
Restrictions: Valid only for CICS region dumps.
Screen Displayed: Recovery Manager Anchor Block. This screen displays an
interpretation of the recovery manager anchor block.
RMUWSUMM
Command Type: Fast Path
Restrictions: Valid only for CICS region dumps.
22-26
Abend-AID for CICS User’s Guide
Screen Displayed: Recovery Manager Unit of Work Summary. This screen displays a list
of the units of work managed by the CICS Recovery Manager.
RPL
Command Type: Fast Path
Restrictions: Valid only for CICS region and CICS transaction dumps.
Screen Displayed: DFHRPL Concatenation. This screen provides an ordered list of all
load libraries concatenated in the DFHRPL DD statement.
RX
Command Type: Fast Path
Restrictions: Valid only for CICS region dumps.
Screen Displayed: Recoverable Resource Manager. This screen displays the Global
Storage for the RX Domain Anchor Block.
RZ
Command Type: Fast Path
Restrictions: Valid only for CICS region dumps.
Screen Displayed: RequestStreams Manager Anchor. This screen summarizes the
information collected by the RequestStreams domain.
SACLIP
Command Type: Fast Path
Screen Displayed: Saved Paperclip List. This command displays a list of paperclip tables
that have been saved for the current dump. From the Saved Paperclip List, paperclip
tables can be either restored or deleted.
Use the SAVE command to save the current paperclip table in the saved paperclip list. If
you do not use the SAVE command, the current paperclip table is saved automatically
using your user ID as the name of the saved table.
Abend-AID for CICS Commands: M through Z
22-27
SAVE
Command Type: Primary
The SAVE command saves the current paperclip table to the Saved Paperclip List. For
information about the paperclip list, refer to “Saved Paperclip List” on page 5-7.
tablename
One- to eight-character name of the paperclip table. If the current paperclip table has
been previously restored, you can type the SAVE command without specifying a table
name. Abend-AID will save the table to the same name from which it was restored.
However, if the current paperclip table has not been previously restored and you type
the SAVE command without a table name, the command saves the paperclip table
under your user ID.
Example:
SAVE PFHTBL12
This example saves the current paperclip table as PFHTBL12 on the Saved Paperclip List.
SCRATTR
Command Type: Fast Path
Screen Displayed: Site Screen Attributes. This screen sets site defaults for screen
attributes.
SCREEN
Command Type: Fast Path
Screen Displayed: Last 3270 Screen Image. If the last 3270 image cannot be displayed,
the last 3270 alternate is displayed.
SD
Command Type: Fast Path
Screen Displayed: Source Directory. This command displays the list of source files that
you have added and those that are specified on the CWPDDIO DD statement in the
viewing server. If a CICS transaction dump is selected, the list includes those allocated to
CICS at the time of the dump. If a batch dump is selected, the list includes the file
specified on the ABNLLIST DD statement in the batch job at the time of failure and/or
22-28
Abend-AID for CICS User’s Guide
the file specified in the CWROUTE module available to the viewing server. This
command acts as an alias for the SRCDIR command.
SDPLIST
Command Type: Fast Path
Restrictions: Valid only for region dumps.
Screen Displayed: SVC Dump Parameter List for the currently selected dump.
SERVINFO
Command Type: Fast Path
Screen Displayed: Server Information. This screen lists users currently logged on to the
server. The resulting screen also lets you view the release of each application running in
the server.
SH
Command Type: Fast Path
Restrictions: Valid only for CICS region dumps.
Screen Displayed: CBTS Scheduler Services. This screen displays the Global Storage for
the CICS Business Transaction Services Scheduler Services.
SHOWCOPY
Command Type: Primary
Restrictions: Valid only for reports when source support is used and the source listing
has been processed using the Compuware COBOL, PL/I, or Assembler language
preprocessor.
The SHOWCOPY command provides support for COBOL COPY SUPPRESS, PL/I
%NOPRINT, and Assembler lines suppressed by, for example, the PRINT OFF or PRINT
NOGEN options. The default setting for this command returns suppressed lines to the
report in the Abend-AID Viewer. Users can view the suppressed information on the
Diagnostic Summary in the Abending Statement, Next Sequential Instruction, and Last
Call sections, among others. Users can continue to suppress the lines by issuing the new
SHOWCOPY OFF command.
Abend-AID for CICS Commands: M through Z
22-29
ON
Displays the suppressed lines on all applicable screens in the current session
(default).
OFF
Suppresses the lines on all applicable screens in the current session.
SHUTDOWN
The SHUTDOWN command terminates the current server.
nnnn
Is the number of seconds the region should allow for the current user and transaction
load to be closed down (shutdown timer value). The default value is 30 seconds.
IMMED
Indicates that the server is to terminate immediately.
SIT
Command Type: Fast Path
Restrictions: Valid only for CICS region dumps.
Screen Displayed: Parameter Domain SIT. This screen displays system initialization table
parameters.
SIT2
Command Type: Fast Path
Restrictions: Valid only for CICS region dumps.
Screen Displayed: Parameter Domain SIT (Page 2). This screen displays system
initialization table parameters.
22-30
Abend-AID for CICS User’s Guide
SITENEWS
Command Type: Fast Path
In order for SITENEWS to function, the installer must first access the Customization
Options menu, either directly by entering the CUSTOM command, or by following the
menu selections from the USER command.
Screen Displayed: The SITENEWS command results in the Site News Menu to display
where the installer has the option to create, maintain, or delete site news for Abend-Aid
and Abend-AID for CICS. Any existing news will be displayed which can be modified by
the installer, or a blank screen is presented for the installer to enter news. The installer
can enter CANCEL on the command line if the installer decides to exit the screen
without entering any news. Any data that is entered will be added to the customization
file.
SITOVER
Command Type: Fast Path
Restrictions: Valid only for CICS region dumps.
Screen Displayed: Parameter Domain SIT Overrides. This screen displays the system
initialization table overrides. The SIT overrides are specified through SYSIN or console
entry.
SITPRV
Command Type: Fast Path
Restrictions: Valid only for CICS region dumps.
Screen Displayed: Parameter Domain PRVMOD List. This screen lists the system
initialization override PRVMODs. These are modules that will not be loaded from the
MVS link pack area (LPA) when the SIT parameter LPA=YES is coded.
SITXRF
Command Type: Fast Path
Restrictions: Valid only for CICS region dumps.
Screen Displayed: Parameter Domain XRF Options. This screen displays an
interpretation of the system initialization parameters relating to the Extended Recovery
Facility (XRF).
Abend-AID for CICS Commands: M through Z
22-31
SJ
Command Type: Fast Path
Restrictions: Valid only for CICS region dumps.
Screen Displayed: JVM Domain menu. This menu provides access to the following
screens:
• JVM Domain Anchor Block
• SJ TCB Blocks
SJANCH
Command Type: Fast Path
Restrictions: Valid only for CICS region dumps.
Screen Displayed: JVM Domain Anchor Block. This screen summarizes the information
collected by the JVM domain.
SM
Command Type: Fast Path
Restrictions: Valid only for CICS region dumps.
Screen Displayed: Storage Manager Domain menu. This menu provides access to the
following screens:
•
•
•
•
•
•
Storage Manager Anchor Block
Task Subpool Summary
Domain Subpool Summary
Storage Manager Suspend Queue
Dynamic Storage Area Summary
Transaction Block Summary
SMANCH
Command Type: Fast Path
Restrictions: Valid only for CICS region dumps.
Screen Displayed: Storage Manager Anchor Block. This screen displays basic information
from the storage domain anchor block.
22-32
Abend-AID for CICS User’s Guide
SMAP
Command Type: Fast Path
Restrictions: Valid only for region dumps.
Screen Displayed: Storage Map Display (storage allocation map for the current dump).
The storage map displays alternatively allocated and unallocated segments of storage.
SMDSUMM
Command Type: Fast Path
Restrictions: Valid only for CICS region dumps.
Screen Displayed: Domain Subpool Summary. This screen displays the domain subpools
and associated data.
SMSUSP
Command Type: Fast Path
Restrictions: Valid only for region dumps.
Screen Displayed: Storage Manager Suspend Queue. This screen displays all tasks
currently suspended by the storage domain due to lack of storage to satisfy a GETMAIN
request.
SMTSUMM
Command Type: Fast Path
Restrictions: Valid only for CICS region dumps.
Screen Displayed: Task Subpool Summary. This screen displays the storage subpools for
each task in the system.
SMX
Command Type: Fast Path
Restrictions: Valid only for CICS region dumps.
Abend-AID for CICS Commands: M through Z
22-33
Screen Displayed: Transaction Block Summary. This screen displays information
regarding task storage allocation.
SO
Command Type: Fast Path
Restrictions: Valid only for CICS region dumps.
Screen Displayed: Sockets Domain menu. This menu provides access to the Sockets
Domain Anchor Block screen.
In addition, if you are licensed for Abend-AID for WebSphere MQ, you will have access to
the following screens:
• Sockets Domain Listener Table
• Sockets Domain TCPIPSERVICE Summary
SOANCH
Command Type: Fast Path
Restrictions: Valid only for CICS region dumps.
Screen Displayed: Sockets Domain Anchor Block. This screen displays detailed
information about the CICS Sockets Domain anchor block.
SOLTSUMM
Command Type: Fast Path
Restrictions: Valid only for CICS region dumps, and you must be licensed for Abend-AID
for WebSphere MQ.
Screen Displayed: Sockets Domain Listener Table. This screen displays detailed
information about each sockets listener table entry.
SORTA
Command Type: Primary
The SORTA command reorganizes a screen’s scrollable data according to the column
specified in the column-identifier parameter in ascending order. If you do not specify a
parameter, Abend-AID displays a window from which you can select a valid columnidentifier by pressing Enter. As an alternative, you can issue the SORTA command
22-34
Abend-AID for CICS User’s Guide
without a parameter by typing SORTA in the Command field, positioning the cursor on
the column that you want the data sorted by, and then pressing Enter.
Use the space bar or Erase EOF key to clear the column mask for individual columns. Use
the RESET primary command to reset all columns to their original settings, as described
in “RESET” on page 22-22.
columnidentifier
Unique identifier of the column heading.
SORTD
Command Type: Primary
The SORTD command reorganizes a screen’s scrollable data according to the column
specified in the column-identifier parameter in descending order. If you do not specify a
parameter, Abend-AID displays a window from which you can select a valid columnidentifier by pressing Enter. As an alternative, you can issue the SORTD command
without a parameter by typing SORTD in the Command field, positioning the cursor on
the column that you want the data sorted by, and then pressing Enter.
Use the space bar or Erase EOF key to clear the column mask for individual columns. Use
the RESET primary command to reset all columns to their original settings, as described
in “RESET” on page 22-22.
columnidentifier
Unique identifier of the column heading.
SOTCSUMM
Command Type: Fast Path
Restrictions: Valid only for CICS region dumps, and you must be licensed for Abend-AID
for WebSphere MQ.
Screen Displayed: Sockets Domain TCPIPSERVICE Summary. This screen displays
detailed information about each sockets TCPIPSERVICE.
SOURCE
Command Type: Primary
Restrictions: Valid only for CICS transaction dumps and batch dumps. If the program for
the selected dump was not compiled using the Compuware COBOL language processor or
the Compuware PL/I language processor, the SOURCE command has no effect.
Abend-AID for CICS Commands: M through Z
22-35
The SOURCE command enables and disables the display of source processing for CICS
transaction dumps and batch dumps. The command affects only the currently selected
dump.
ON
Displays source processing for the transaction abend.
OFF
Suppresses source processing for the transaction abend.
RESET
Returns source processing for the transaction abend to its original setting before the
entry of the SOURCE command.
SQASP
Command Type: Fast Path
Restrictions: Valid only for CICS region dumps.
Screen Displayed: Summarized SQA Subpools. This screen lists the system queue area
subpools allocated at the time of the fault.
SQASUM
Command Type: Fast Path
Restrictions: Valid only for CICS region dumps.
Screen Displayed: SQA Summary. This screen lists the system queue area information
obtained from the GDA (Global Data Area) at the time of the fault.
SQLCA
Command Type: Fast Path
Restrictions: Valid only for CICS transaction dumps and only if the dump contains DB2
information.
Screen Displayed: SQL Communications Area.
22-36
Abend-AID for CICS User’s Guide
SRCDIR
Command Type: Fast Path
Screen Displayed: Source Directory. This command displays the list of source files that
you have added and those that are specified on the CWPDDIO DD statement in the
viewing server. If a CICS transaction dump is selected, the list includes those allocated to
CICS at the time of the dump. If a batch dump is selected, the list includes the file
specified on the ABNLLIST DD statement in the batch job at the time of failure and/or
the file specified in the CWROUTE module available to the viewing server.
SSA
Command Type: Fast Path
Restrictions: Valid only for CICS region dumps.
Screen Displayed: Static Storage Areas. This screen displays a list of addresses of the
static storage areas used by various CICS modules.
ST
Command Type: Fast Path
Restrictions: Valid only for CICS region dumps.
Screen Displayed: Statistics Anchor Block. This screen summarizes the information
collected by the statistics domain.
The statistics domain controls the collection of resource statistics for a CICS system (the
monitoring domain collects task statistics). The statistics domain collects data at user
specified intervals, for a system quiesce, at logical end of day, and when requested by the
user.
STATIC
Command Type: Fast Path
Restrictions: Valid only for CICS transaction dumps.
Screen Displayed: Displays PL/I static storage for the selected program in hexadecimal
format.
Abend-AID for CICS Commands: M through Z
22-37
programname
The name of a PL/I program in the dump. If you do not include the program name as
an operand for the STATIC command, the static storage for the abending program is
displayed.
Example:
STATIC PAYTEST1
STORAGE
Command Type: Fast Path
Restrictions: Valid only for CICS transaction dumps and region dumps.
Screen Displayed: Control Blocks/Storage menu. This menu provides a selectable list of
control blocks that can be displayed in hexadecimal, DSECT, or interpreted format. It
also provides access to the current paperclip table and the saved paperclip list.
SUBS
Command Type: Fast Path
Restrictions: Valid only for region dumps.
Screen Displayed: MVS Sub Systems Summary. This screen displays the list of MVS
subsystems located in the currently selected dump.
SUMMARY
Command Type: Fast Path
Screen Displayed: Abend-AID Fault Summary. This screen provides summary
information for all dumps available to this server.
SYSLOG
Command Type: Fast Path
Restrictions: Valid only for region dumps.
Screen Displayed: JES2 System Log. This screen displays the messages from the last two
JES2 system log buffers for the selected dump address space.
22-38
Abend-AID for CICS User’s Guide
TACB
Command Type: Fast Path
Restrictions: Valid for CICS transaction dumps only.
Screen Displayed: Transaction Abend Control Blocks. This screen displays the
transaction control block information associated with the abend.
TASK
Command Type: Fast Path
Restrictions: Valid only for CICS transaction dumps.
Screen Displayed: Task Detail. This screen shows important information about the
abending task.
TASKLIST
Command Type: Fast Path
Restrictions: Valid only for CICS region dumps.
Screen Displayed: Task/Wait Analysis. This screen displays a global view of tasks in the
CICS system. Information is collected from the dispatcher domain, kernel domain, and
the transaction manager domain. Information displayed includes enqueue/wait data,
current program and terminal information, and storage utilization.
TASKS
Command Type: Fast Path
Restrictions: Valid only for CICS region dumps.
Screen Displayed: Task/Wait Analysis menu. This menu provides access to the following
screens:
• Task Summary
• Task/Wait Analysis
TASKSUMM
Command Type: Fast Path
Abend-AID for CICS Commands: M through Z
22-39
Restrictions: Valid only for CICS region dumps.
Screen Displayed: Task Summary. This screen displays summary information about
current dispatcher domain queues, kernel task entries, and transaction manager tasks.
TCA
Command Type: Fast Path
Restrictions: Valid only for CICS region dumps.
Screen Displayed: TCA Interpreted screen for a selected task.
tcasymbol
A valid TCA ID.
Example:
TCA.TCA0000
TCBJST
Command Type: Fast Path
Restrictions: Valid only for region dumps.
Screen Displayed: Jobstep Task Control Block for the currently selected address space.
TCBLLE
Command Type: Fast Path
Restrictions: Valid only for region dumps.
Screen Displayed: TCB Load List Summary. This screen displays summary information
for all tasks (TCBs) in the current address space. All of the load modules loaded by tasks
are displayed on this screen, with further detailed information available from this screen.
For modules loaded by a specific task, either mask the TCB Address column or use an
available line command on the TCB Summary screen.
TCBS
Command Type: Fast Path
22-40
Abend-AID for CICS User’s Guide
Restrictions: Valid only for region dumps.
Screen Displayed: TCB Summary. This screen lists all task control blocks (TCBs) in the
abending job and all request blocks (RBs) for each TCB.
TCLASS
Command Type: Fast Path
Restrictions: Valid only for CICS region dumps.
Screen Displayed: Transaction Class Summary. This screen displays maximum task class
(MAXTASK) and transaction class information, including total attached transactions,
maximum allowed transactions, and currently queued transactions.
TCT
Command Type: Fast Path
Restrictions: Valid only for CICS region dumps.
Screen Displayed: Terminal Control/MRO/ISC menu. This menu provides access to the
following screens:
• TCT Prefix
• TCT System Entries
• Terminal Entries
TCTP
Command Type: Fast Path
Restrictions: Valid only for CICS region dumps.
Screen Displayed: TCT Prefix. This screen displays an interpreted subset of the TCT
control block. Various VTAM indicators are interpreted to show the current state of
VTAM in the CICS system.
TCTS
Command Type: Fast Path
Restrictions: Valid only for CICS region dumps.
Abend-AID for CICS Commands: M through Z
22-41
Screen Displayed: TCT System Entries. This screen displays a list of the system type
terminal control entries known to CICS.
TCTT
Command Type: Fast Path
Restrictions: Valid only for CICS region dumps.
Screen Displayed: Terminal Entries. This screen displays a list of the terminal control
entries known to CICS.
TCTTE
Command Type: Fast Path
Restrictions: Valid only for CICS region dumps.
Screen Displayed: TCT Detail screen for the specified terminal.
terminal
A valid terminal ID.
Example:
TCTTE.cerr
TD
Command Type: Fast Path
Restrictions: Valid only for CICS region dumps.
Screen Displayed: Transient Data Queue Summary. This screen lists each transient data
queue defined to CICS through the destination control table (DCT).
TERM
Command Type: Fast Path
Restrictions: Valid only for CICS transaction dumps.
22-42
Abend-AID for CICS User’s Guide
Screen Displayed: Terminal Detail. This screen shows important information about the
abending terminal.
TESTSCR
Command Type: Fast Path
Screen Displayed: Attribute Test Screen. This screen displays a sample screen containing
examples of the screen attributes that Abend-AID uses. After you change your screen
attributes using the ATTRBUTE command, entering TESTSCR displays your new screen
attributes.
TGT
Command Type: Fast Path
Restrictions: Valid only for CICS transaction dumps.
Screen Displayed: Task Global Table (TGT) storage associated with the selected COBOL
program in hexadecimal format.
programname
The name of a COBOL program in the dump. If you do not include the program
name as an operand for the TGT command, the TGT for the abending program is
displayed.
Example:
TGT PAYTEST1
TI
Command Type: Fast Path
Restrictions: Valid only for CICS region dumps.
Screen Displayed: Timer Domain Summary. This screen displays the CICS timer request
elements (TREs) in the system. The timer domain provides interval timing and alarm
clock services for CICS domains. These are processes that cause an action to occur at a
predetermined time.
Abend-AID for CICS Commands: M through Z
22-43
TM
Command Type: Fast Path
Restrictions: Valid only for CICS region dumps.
Screen Displayed: Table Manager menu. This menu provides access to the following
screens:
• Table Manager Summary
• Lock Block Summary
TMA
Command Type: Fast Path
Restrictions: Valid only for CICS region dumps.
Screen Displayed: Task Monitoring Areas. This screen displays a list of all task
monitoring areas (TMAs) and monitoring area entries (MAEs). These control blocks
contain data related to the CICS monitoring function on a per-task basis.
TMLB
Command Type: Fast Path
Restrictions: Valid only for CICS region dumps.
Screen Displayed: Read Lock Block Task Summary. This screen displays read locks held
by all tasks in the system. Each time a task uses the locate function a read lock is created
on the primary directory entry corresponding to the table entry found.
TMSUMM
Command Type: Fast Path
Restrictions: Valid only for CICS region dumps.
Screen Displayed: Table Manager Summary. The table manager program locates, adds,
deletes, locks, and unlocks entries in the FCT, AFCT, DSNT, and TCT, and locates entries
in the DCT.
TOP
Command Type: Primary
22-44
Abend-AID for CICS User’s Guide
The TOP command scrolls to the top of a screen’s scrollable area.
TR
Command Type: Fast Path
Restrictions: Valid only for CICS region dumps.
Screen Displayed: Trace Domain menu. This menu provides access to the following
screens
• Trace Domain Anchor
• Trace Listing
TRACE
Command Type: Fast Path
Restrictions: Valid only for CICS region and CICS transaction dumps.
Screen Displayed: Trace Listing. This screen displays the formatted CICS internal trace
table. There are three listing formats: SHORT, FULL, ABBREV. Put your cursor on your
choice and press Enter to make a selection. ABBREV is the default.
TRANCH
Command Type: Fast Path
Restrictions: Valid only for CICS region dumps.
Screen Displayed: Trace Domain Anchor Block. This screen displays information from
the CICS trace domain anchor block. The status of the three types of tracing are given:
• Internal
• Auxiliary
• Generalized trace facility (GTF)
TRANGBL
Command Type: Fast Path
Restrictions: Valid only for customization of CICS transaction dumps.
Abend-AID for CICS Commands: M through Z
22-45
Screen Displayed: Transaction Dump Global List. This screen creates and maintains
transaction dump global options members.
TS
Command Type: Fast Path
Restrictions: Valid only for CICS region dumps.
Screen Displayed: Temporary Storage Domain menu. This menu provides access to the
following screens:
•
•
•
•
•
•
•
Temporary
Temporary
Temporary
Temporary
Temporary
Temporary
Temporary
Storage
Storage
Storage
Storage
Storage
Storage
Storage
Anchor Block
Queue Summary
Table
Buffer Summary
String Summary
Browse Summary
Shared SYSID Summary
TSANCH
Command Type: Fast Path
Restrictions: Valid only for CICS region dumps.
Screen Displayed: Temporary Storage Anchor Block. This screen displays an
interpretation of the temporary storage anchor block.
TSBCSUMM
Command Type: Fast Path
Restrictions: Valid only for CICS region dumps.
Screen Displayed: Temporary Storage Buffer Summary. This screen displays a list of the
buffer control areas used by CICS temporary storage.
TSBRSUMM
Command Type: Fast Path
Restrictions: Valid only for CICS region dumps.
22-46
Abend-AID for CICS User’s Guide
Screen Displayed: Temporary Storage Browse Summary. This screen displays a list of
transactions that are browsing the temporary storage queues.
TSQSUMM
Command Type: Fast Path
Restrictions: Valid only for CICS region dumps.
Screen Displayed: Temporary Storage Queue Summary. This screen displays a list of the
temporary storage queues created in the CICS region.
TSSYSUMM
Command Type: Fast Path
Restrictions: Valid only for CICS region dumps.
Screen Displayed: Temporary Storage Shared SYSID Summary. This screen displays a list
of the SYSIDs defined in the temporary storage table used to route temporary storage
queue requests to shared pools.
TST
Command Type: Fast Path
Restrictions: Valid only for CICS region dumps.
Screen Displayed: Temporary Storage Table. This screen displays a list of the data
identifiers that indicate which temporary storage queues participate in recovery, security,
and data sharing.
TSVCSUMM
Command Type: Fast Path
Restrictions: Valid only for CICS region dumps.
Screen Displayed: Temporary Storage String Summary. This screen displays a list of the
VSWA control areas used by CICS temporary storage.
Abend-AID for CICS Commands: M through Z
22-47
TXN
Command Type: Fast Path
Restrictions: Valid only for CICS region dumps.
Screen Displayed: Transaction Instance. This screen shows the TXN details.
txnsymbol
A valid TXN ID.
Example:
TXN.TSN000F
UET
Command Type: Fast Path
Restrictions: Valid only for CICS region dumps.
Screen Displayed: User Exit Table. This screen displays entries in the user exit table. The
user exit facility allows CICS users to run exit programs at selected points in CICS
modules in the various domains.
UNSTCK
Command Type: Primary
The UNSTCK command interprets the store clock date and time at a user-specified
address.
Note:
On Memory Display data fields only (for example, Word1), the UNSTCK
command interprets the data displayed in the field. To use this command, type
UNSTCK in the Memory Display’s Command field, position the cursor on the
first byte of either the address or the data to convert, and press Enter.
address
A valid hexadecimal address.
Example:
UNSTCK 59ADC00
22-48
Abend-AID for CICS User’s Guide
UP
Command Type: Primary
The UP command scrolls the active screen display toward the top of a scrollable list of
entries. Pressing the UP PF key also executes this command. (PF7 is the default.)
scroll-amount
The number of rows the active screen display should be scrolled toward the top of a
scrollable list of entries.
Example:
UP 12
This example scrolls the active screen display 12 rows toward the top of a scrollable list of
entries.
UPCB
Command Type: Fast Path
Restrictions: Valid only for CICS transaction dumps.
Screen Displayed: Hogan UPCB. This screen displays the UPCB control block in
interpreted format.
US
Command Type: Fast Path
Restrictions: Valid only for CICS region dumps.
Screen Displayed: User Domain menu. This menu provides access to the following
screens:
• User Domain Anchor Block
• Userid Summary
USANCH
Command Type: Fast Path
Restrictions: Valid only for CICS region dumps.
Abend-AID for CICS Commands: M through Z
22-49
Screen Displayed: User Domain Anchor Block. This screen displays an interpretation of
the user domain anchor block.
USER
Command Type: Fast Path
Screen Displayed: User Controls menu. This menu provides access to the following
screens:
•
•
•
•
•
User Profile
Print Output Options
Screen Attributes
PF Key Customization
Site Customization Options
USERDIAG
Command Type: Fast Path
Restrictions: Valid only from the Customization Options menu.
Screen Displayed: User-defined diagnostics. This screen is accessed from the
Customization Options menu and provides the ability to insert, replicate, delete, update,
or display user-defined diagnostic records. The USERID indicates who added or updated
the diagnostic.
USERPROF
Command Type: Fast Path
Screen Displayed: Site User Profile. This screen sets site defaults for user profile options.
USIDSUMM
Command Type: Fast Path
Restrictions: Valid only for CICS region dumps.
Screen Displayed: Userid Summary. This screen displays a list of logged on users.
22-50
Abend-AID for CICS User’s Guide
UTCB
Command Type: Fast Path
Restrictions: Valid only for CICS transaction dumps.
Screen Displayed: Hogan UTCB screen. This screen displays the UTCB control block in
interpreted format.
VSMAP
Command Type: Fast Path
Restrictions: Valid only for region dumps.
Screen Displayed: Virtual Storage Map. This screen lists all virtual storage areas of the
MVS operating system from which the address space was dumped.
WB
Command Type: Fast Path
Restrictions: Valid only for CICS region dumps.
Screen Displayed: Web Domain menu. This menu provides access to the Web Domain
Anchor Block screen.
Further, if you're licensed for Abend-AID for WebSphere MQ, this menu also provides
access to the following screens.
• Web Domain Request Summary
• Web Domain 3270 State Summary
WBANCH
Command Type: Fast Path
Screen Displayed: Web Domain Anchor Block. This screen displays detailed information
about the CICS Web Domain anchor block.
WBRQSUMM
Command Type: Fast Path
Abend-AID for CICS Commands: M through Z
22-51
Restrictions: You must be licensed for Abend-AID for WebSphere MQ.
Screen Displayed: Web Domain Request Summary. This screen displays a list of current
web requests.
WBSTSUMM
Command Type: Fast Path
Restrictions: You must be licensed for Abend-AID for WebSphere MQ.
Screen Displayed: Web Domain 3270 State Summary. This screen displays a list of
current web domain 3270 state blocks.
WHERE
Command Type: Primary
Restrictions: Valid only for CICS region dumps.
The WHERE command displays the list of storage areas and control blocks in a CICS
dynamic storage area (DSA) that contain the hexadecimal address, symbol name, or table
entry specified.
You also can execute the WHERE command without specifying an address, symbol name,
or table entry. Type WHERE in the Command field; position the cursor on an address,
control block, or table name field; and press Enter.
address
Hexadecimal address. You cannot use this parameter and the tabletype and tableentry
parameters in the same WHERE command statement.
symbolname
Symbol name. A literal S/ must precede the symbol name. You cannot use this
parameter and the tabletype and tableentry parameters in the same WHERE command
statement.
tabletype tableentry
Table entry. A space separates the table type from the table entry, for example, PCTE
CEMT. PCTE is the table type, and CEMT is the entry in the table. You cannot use
these parameters in a WHERE command that includes either the address, or the
symbolname parameter.
Example 1:
WHERE 002DFBEC
22-52
Abend-AID for CICS User’s Guide
Example 1 lists the storage areas and control blocks that contain hexadecimal address
002DFBEC.
Example 2:
WHERE S/TCA0005
Example 2 lists the storage areas and control blocks that contain symbol TCA0005.
Example 3:
WHERE PCTE CSTP
Example 3 lists the storage areas and control blocks that contain the CSTP table entry in
the PCT entry DSECT format.
WHO
Command Type: Primary
Restrictions: Valid only for CICS region dumps.
The WHO command lists TCBs (for all dumps), TCAs (for CICS dumps only), and
KETASKs (for CICS dumps only) that have addressability to the storage area specified by
the command’s parameter.
You also can execute the WHO command without specifying any parameters. Type WHO
in the Command field; position the cursor on an address, control block, or table name
field; and press Enter. Pressing the WHO PF key also executes this command. (PF21 is the
default.)
WHO
address
S/symbolname
tabletype tableentry
address
Hexadecimal address. You cannot use this parameter and the tabletype and tableentry
parameters in the same WHO command statement.
symbolname
Symbol name. A literal S/ must precede the symbol name. You cannot use this
parameter and the tabletype and tableentry parameters in the same WHO command
statement.
tabletype tableentry
Displays addressability information for the table entry specified. A space separates
the table type from the table entry, for example, PCTE CEMT. PCTE is the table type,
and CEMT is the entry in the table. You cannot use these parameters in a WHO
command that includes either the address, or the symbolname parameter.
Example 1:
WHO 002DFBEC
Example 1 displays items that have addressability to hexadecimal address 002DFBEC.
Example 2:
Abend-AID for CICS Commands: M through Z
22-53
WHO S/KETA001
Example 2 displays items that have addressability to the storage area identified by symbol
KETA001.
Example 3:
WHO PCTE CSTP
Example 3 displays items that have addressability to the storage area for the CSTP PCT
entry.
WORK
Command Type: Fast Path
Restrictions: Valid only for CICS transaction dumps.
Screen Displayed: Displays the COBOL working storage cell list for the specified
program.
programname
The name of a COBOL program in the dump. If you do not include the program
name as an operand for the WORK command, the working storage for abending
program is displayed.
Example:
WORK PAYTEST1
XM
Command Type: Fast Path
Restrictions: Valid only for CICS region dumps.
Screen Displayed: Transaction Manager menu. This menu provides access to the
following screens:
•
•
•
•
Transaction
Transaction
Transaction
Transaction
Manager Anchor Block
Manager Summary
Class Summary
Definitions
XMANCH
Command Type: Fast Path
Restrictions: Valid only for CICS region dumps.
22-54
Abend-AID for CICS User’s Guide
Screen Displayed: Transaction Manager Anchor. This screen displays an interpretation of
the transaction manager anchor block.
XMSUMM
Command Type: Fast Path
Restrictions: Valid only for CICS region dumps.
Screen Displayed: Transaction Manager Summary. This screen displays a list of tasks
known to the application domain transaction manager.
XS
Command Type: Fast Path
Restrictions: Valid only for CICS region dumps.
Screen Displayed: Security Domain menu. This menu provides access to the following
screens:
• Security Domain Anchor
• Security Supervisor Storage
XSANCH
Command Type: Fast Path
Restrictions: Valid only for CICS region dumps.
Screen Displayed: Security Domain Anchor Block. This screen displays an interpretation
of the security domain anchor block.
XSSUP
Command Type: Fast Path
Restrictions: Valid only for CICS region dumps.
Screen Displayed: Security Supervisor Storage. This screen displays information
regarding external security, and class name blocks.
Abend-AID for CICS Commands: M through Z
22-55
ZOSSDMP
Command Type: Fast Path
Restrictions: Valid only for region dumps.
Screen Displayed: z/OS SVC Dump Analysis menu. This menu provides access to the
following screens:
•
•
•
•
•
•
•
•
•
SVC Diagnostic Summary
Dump Header Record
Prefixed Save Area
Communications Vector Table
MVS Subsystems Summary
Address Space Control Block
Address Space Extension Block
Address Space Summary
SVC Dump Parameter List
This command is available on the Primary Options screen.
22-56
Abend-AID for CICS User’s Guide
Part 6.
6
REXX API
Part 6 describes the Abend-AID for CICS REXX application program interface (API). It
consists of the following chapters:
Chapter 23, “Using the Abend-AID for CICS REXX API”
Chapter 23 describes the Abend-AID for CICS REXX API, which lets you
process REXX EXECs against transaction and region dumps. It includes a
sample program.
Chapter 24, “REXX API Functions and Commands”
Chapter 24 lists the Abend-AID for CICS REXX API functions and commands
in alphabetical order and includes a description, example, and syntax
diagram for each.
Abend-AID for CICS User’s Guide
23-1
Chapter 23.
Using the Abend-AID for CICS REXX API
Chap 23
This chapter describes the Abend-AID for CICS REXX application program interface (API),
which lets you process REXX EXECs against both region and transaction dumps. By
default, you can load EXECs from the SYSEXEC DD specified in the Abend-AID for CICS
viewing server JCL.
Using the Abend-AID for CICS REXX API requires a basic understanding of standard IBM
REXX processing and functionality. Refer to the IBM documentation for more
information about REXX.
Invoking the Abend-AID for CICS REXX API
Once you have selected a transaction or region dump, you can invoke the Abend-AID for
CICS REXX API by entering the REXX primary command from the command line on any
screen. Entering the REXX primary command followed by the required name of the EXEC
loads the REXX EXEC from the datasets allocated to the SYSEXEC DD statement. A valid
EXEC name is a one- to eight-character member name. For example, entering REXX
MYEXEC processes the EXEC named MYEXEC.
Optionally, you can enter other parameters in addition to the EXEC name to pass data to
the EXEC. For example, entering REXX CHECK CSA processes the EXEC named CHECK,
which uses the string ’CSA’ as input.
Note:
You need security authorization to use the Abend-AID for CICS REXX API.
Contact your site’s Abend-AID for CICS system administrator if you cannot
invoke the Abend-AID for CICS REXX API.
Coding Abend-AID for CICS REXX API Programs
The Abend-AID for CICS REXX API lets you process REXX EXECs against both region and
transaction dumps. In addition to the standard REXX functions and commands, the
Abend-AID for CICS REXX API provides functions and commands that perform specific
processing against Abend-AID for CICS dumps. Refer to Chapter 24, “REXX API Functions
and Commands” for a description of each function and command, its valid syntax, and
examples.
Toleration Mode
Standard IBM REXX functions or commands terminate processing of the EXEC if the
function or command does not complete successfully. By default, Abend-AID for CICS
REXX API functions and commands do not stop processing of the EXEC if the function or
command does not complete successfully. For example, using the FXGET function to
request storage retrieval may result in partial storage returned. This error condition does
not stop processing of the EXEC. You can change the default setting of the FXMODE
function from TOLERATION to FAIL to cause the Abend-AID for CICS REXX API
functions and commands to stop processing the EXEC when they do not complete
successfully.
23-2
Abend-AID for CICS User’s Guide
Sample Abend-AID for CICS REXX API Program
SAMPREXX
Abend-AID for CICS SKFXREXX library member SAMPREXX, shown in Figure 23-1, is an
Abend-AID for CICS REXX API sample program. This program can be processed against
any selectable CICS region dump with a status of COMPLETE on the Abend-AID
Directory. This EXEC displays file control information about the region dump such as
FCT address, name, type, and dataset name.
Figure 23-1. Sample Abend-AID for CICS REXX API Program, Part 1
/*REXX----------------------------------------------------------REXX*/ 
/*
Procedure: SAMPREXX
*/ 
/*
Function: Identify dump informationi and if CICS dump
*/ 
/*
display some file control information, including
*/ 
/*
FCT address,
*/ 
/*
FCT name,
*/ 
/*
FCT type (VSAM or BDAM) and
*/ 
/*
DSNB data set name.
*/ 
/* updated: 07/17/09 PT 189131 PJR
*/ 
/*
Resides: Abend-AID for CICS SKAZREXX library
*/ 
/*
*/ 
/*
Abend-AID for CICS
*/ 
/*
Copyright (C) 1994, 2010, Compuware Corporation
*/ 
/*
Unpublished - rights reserved under the
*/ 
/*
copyright laws of the U.S.
*/ 
/*
*/ 
/*REXX----------------------------------------------------------REXX*/ 
/*
*/ 
/* verify the dump type and it is CICS
*/ 
/*
*/ 
IF FXINFO('DUMPTYPE') ¬= 'REGION DUMP'

THEN DO

SAY 'Selected dump is not a region dump'

EXIT

END

/*
*/ 
/* get something interesting about the dump
*/ 
/*
*/ 
JOBN = FXINFO(JOBNAME)

ABCD = FXINFO(ABEND)

DTIM = FXINFO(DUMPTIME)

DDAT = FXINFO(DUMPDATE)

COMM = FXINFO(COMMENT)

/*
*/ 
IF SUBSTR(FXINFO('RELEASE'),1,4) = 'CICS'

THEN DO 
SAY 'Selected dump is not a CICS dump'

SAY 'JOBNAME ABEND DATE
TIME
COMMENT'

END

/* and report the findings
*/ 
/*
*/ 
SAY '----------------------------------------------'

SAY JOBN ABCD DDAT DTIM COMM

SAY '
'

/*
*/ 
IF SUBSTR(FXINFO('RELEASE'),1,4) ¬= 'CICS'

THEN DO

SAY '
'

EXIT

END 
Using the Abend-AID for CICS REXX API
Figure 23-2. Sample Abend-AID for CICS REXX API Program, Part 2
/*
/* get some offsets before entering the element loop
/*
/* get the offset to the FCT entry name
x'00'
/*
NAMEOFST = '0'
/*
/* get the offset tin FCT to DSN name
x'60'
/*
DSNBOFST = FXDSOFF('FCTDSDP','FCTE')
/*
/* get the offset to the VSAM/BDAM option
x'18'
/*
VSAMOFST = FXDSOFF('FCTDSVR3','FCTE')
/*
/* get the bit mask for the VSAM/BDAM option x'80'
/*
VSAMMASK = FXDSMSK('FCTVSAMI','FCTE')
/*
/* get the offset to the length of the data set name x'3E'
/*
LENGOFST = FXDSOFF('FCTDNLEN','DSNDS')
/*
/* get the offset to the data set name
x'08'
/*
FILEOFST = FXDSOFF('FCTDNAME','DSNDS')
/*
SAY '
'
SAY 'FCT@
NAME
TYPE DSN'
/*
/*
FCT@ = FXTABENT(FCT)
/*
DO WHILE FCT@ ¬= 0
/*
/* get the character FCT name
/*
FCTCHAR = FXGETC(FXADD(FCT@,NAMEOFST),8)
/*
/* determine the FCT type
/*
IF FXTM(FXADD(FCT@,VSAMOFST),VSAMMASK) = 'ONES'
THEN TYPE = 'VSAM'
ELSE TYPE = 'BDAM'
/*
/* get the address of the DS name block
/*
DSN@ = FXGET(FXADD(FCT@,DSNBOFST),4)
IF DSN@ ¬= '00000000'
THEN DO
/*
/* get the length of the data set name
/*
LEN# = FXGET(FXADD(DSN@,LENGOFST),1)
/*
/* get the character data set name
/*
DSNCHAR = FXGETC(FXADD(DSN@,FILEOFST),LEN#)
END 
/*
/* and report the findings in the paperclip table
/*
COMMENT = FCTCHAR TYPE DSNCHAR
"FXPCLIP("FCT@",'"COMMENT"')"
/*
/* get the address of the next directory element
/*
FCT@ = FXTABENT(FCT,'+')
IF RC ¬= '00000000'
THEN DO
FCT@ = '00000000'
END
END
/*
"FXPSHOW"
SAY '----------------------------------------------'
"FXPCLEAR"
EXIT 0 
*/
*/
*/
*/
*/
*/
*/
*/
*/
*/
*/
*/
*/
*/
*/
*/
*/
*/
*/
*/
*/
*/
*/
*/
*/
*/
*/






































*/ 
*/ 
*/ 



*/ 
*/ 
*/ 



*/ 
*/ 
*/ 

*/ 
*/ 
*/ 

*/
*/
*/
*/
*/
*/
*/


















23-3
23-4
Abend-AID for CICS User’s Guide
After selecting a region dump, entering REXX SAMPREXX on the command line of any
Abend-AID for CICS screen displays results similar to those shown in Figure 23-3.
Figure 23-3. SAMPREXX Sample Program Results
Abend-AID ------------------- REXX Interface --------------------- Row 000001 
COMMAND ===>
SCROLL ===> PAGE 
==> 
REXX messages

*******************************************************************************
SAMPREXX

Selected dump is a CICS dump


JOBNAME ABEND DATE
TIME
COMMENT

---------------------------------------------
CICACIPE S102 20APR2010 22:41:34.508 SYMPTOM STRING IS UNAVAILABLE



FCT@
NAME
TYPE DSN

Address
Comments

3A6853E0 ZIPBCODE VSAM CMMP.POMSB.V.VTJ006

3A685208 VTJB06
VSAM CMMP.POMSB.V.VTJ006

3A685030 VTJB05
VSAM CMMP.POMSB.V.VTJ005

3A684D18 VTJB04
VSAM CMMP.POMSB.V.VTJ004

3A684B40 VTJB03
VSAM CMMP.POMSB.V.VTJ003

3A684968 VTJB02
VSAM CMMP.POMSB.V.VTJ002

3A684790 VTJB01
VSAM CMMP.POMSB.V.VTJ001

3A6845B8 VRDPATH VSAM CMMP.POMSB.V.VRDBXREF

3A6843E0 VRDFILEB VSAM CMMP.POMSB.V.VRDBXREF 
24-1
Chapter 24.
REXX API Functions and Commands
Chap 24
The Abend-AID for CICS REXX application program interface (API) supports specific
Abend-AID for CICS functions and commands that you can use in your REXX EXECs
against transaction and region dumps. These are in addition to the standard IBM REXX
functions and commands.
The remaining sections of this chapter list the Abend-AID for CICS REXX API functions
and commands in alphabetical order and include a description, example, and syntax
diagram for each. Refer to “Reading Syntax Diagrams” on page 20-1 for an explanation of
the rules governing syntax diagrams.
Abend-AID for CICS REXX API Special Variables
The reserved variables, FXRC and FXMSG, are updated after each Abend-AID for CICS
REXX function or command. A third variable, FXLENGTH, may be updated if the
function or command returns data that implies a length of the data. A fourth variable
that is valid only for the FXTABENT function, FXENTKEY, may be updated if the function
returns a table entry name.
• FXRC: A numeric value indicating the function or command return code. The return
codes vary for each function or command. A value of 0 (zero) indicates that the
function or command was successful. A value of 2 indicates either partial completion
or failure.
• FXMSG: A text message string that further explains the FXRC. If FXRC is equal to 0
(zero), then the FXMSG is set to OK.
• FXLENGTH: A hexadecimal value that indicates the length of the data returned. For
example, a request to return 100 bytes of storage at an unallocated address results in
FXLENGTH being set to 0 (zero).
• FXENTKEY: The name of the table entry returned by the FXTABENT function.
Abend-AID for CICS REXX API Functions
Functions return a value that can be assigned to a REXX variable. For example, the
following function assigns the address of the AP anchor block (CSA) to the REXX variable
A:
A=FXSYMBOL('APANCH')
Following are the Abend-AID for CICS REXX API functions.
FXADD
The FXADD function returns the result of adding the two specified hexadecimal values.
FXADD( value1,value2 )
24-2
Abend-AID for CICS User’s Guide
Example:
FXADD('FE','22')
This example adds the two hexadecimal values, and gives the sum, hexadecimal value
120.
The return codes and message text associated with the FXADD function are:
0
OK
2
One of the following message text displays:
ZERO — Sum is zero
NEGATIVE
OVERFLOW — Exceeds 31-bit result
MISSING OPERAND(S)
INVALID HEXADECIMAL OPERAND
OPERAND EXCEEDS MAXIMUM LENGTH
EXTRANEOUS OPERAND(S)
FXDATE
The FXDATE function returns a literal representing the store clock date for the eight
bytes at the specified address in the dump.
FXDATE( address )
Example:
FXDATE('001410E0E')
This example returns the store clock date for the specified hexadecimal address
001410E0E. The result is converted the Abend-AID for CICS standard date format
DDMMMYYYY, where DD represents the day, MMM the month, and YYYY represents the
year; for example, 07DEC2010.
The return codes and message text associated with the FXDATE function are:
0
OK
2
One of the following message text displays:
UNAVAILABLE STORAGE ADDRESS
REQUIRED EIGHT BYTES UNAVAILABLE
MISSING OPERAND(S)
OPERAND EXCEEDS MAXIMUM LENGTH
INVALID HEXADECIMAL OPERAND
EXTRANEOUS OPERAND(S)
REXX API Functions and Commands
24-3
FXDIV
The FXDIV function returns the result of dividing the two specified hexadecimal values.
FXDIV( value1,value2 )
Example 1:
FXDIV('A2','12')
Example 1 divides the two hexadecimal values. The first value is divided by the second
value. The result is hexadecimal value 9.
Example 2:
FXDIV('A2','0')
Example 2 divides the two hexadecimal values. The first value is divided by zero. The
result is a null character string. The return code is 2 and the associated message text is
DIVISION BY ZERO.
The return codes and message text associated with the FXDIV function are:
0
OK
2
One of the following message text displays:
DIVISION BY ZERO
MISSING OPERAND(S)
INVALID HEXADECIMAL OPERAND
OPERAND EXCEEDS MAXIMUM LENGTH
EXTRANEOUS OPERAND(S)
FXDSDUP
The FXDSDUP function returns the duplication factor of the requested label within the
DSECT. The default DSECT type is SYSTEM.
'SYSTEM'
FXDSDUP( label,dsect ,
)
'USER'
Example:
FXDSDUP('CSAOSRSA','CSA')
This example returns the duplication factor of the label CSAOSRSA within the system
DSECT CSA. The result is hexadecimal value 12.
24-4
Abend-AID for CICS User’s Guide
The return codes and message text associated with the FXDSDUP function are:
0
OK
2
One of the following message text displays:
DSECT FILE IS UNAVAILABLE
UNKNOWN SYSTEM DSECT
UNABLE TO OPEN DSECT MEMBER
INVALID DSECT TYPE
MISSING OPERAND(S)
OPERAND EXCEEDS MAXIMUM LENGTH
EXTRANEOUS OPERAND(S)
FXDSLEN
The FXDSLEN function returns the hexadecimal length of the requested label within the
DSECT. The default DSECT type is SYSTEM.
'SYSTEM'
FXDSLEN( label,dsect ,
)
'USER'
Example:
FXDSLEN('TCBJSTCB','TCB51','USER')
This example returns the hexadecimal length of the label TCBJSTCB for the user-defined
DSECT TCB51. The result is 4.
The return codes and message text associated with the FXDSLEN function are:
0
OK
2
One of the following message text displays:
DSECT FILE IS UNAVAILABLE
UNKNOWN SYSTEM DSECT
UNABLE TO OPEN DSECT MEMBER
INVALID DSECT TYPE
MISSING OPERAND(S)
OPERAND EXCEEDS MAXIMUM LENGTH
EXTRANEOUS OPERAND(S)
REXX API Functions and Commands
24-5
FXDSMSK
The FXDSMSK function returns the eight-character bit mask of the requested label within
the DSECT. The default DSECT type is SYSTEM.
'SYSTEM'
FXDSMSK( label,dsect ,
)
'USER'
Example 1:
FXDSMSK('CSASOSON','CSA')
Example 1 returns the eight-character bit mask of the label CSASOSON within the system
DSECT CSA. The result is 00000001.
Example 2:
FXDSMSK('CSAPLTPI','CSA')
Example 2 returns the eight-character bit mask of the label CSAPLTPI within the system
DSECT CSA. The result is 00010000.
The return codes and message text associated with the FXDSMSK function are:
0
OK
2
One of the following message text displays:
DSECT FILE IS UNAVAILABLE
UNKNOWN SYSTEM DSECT
UNABLE TO OPEN DSECT MEMBER
INVALID DSECT TYPE
MISSING OPERAND(S)
OPERAND EXCEEDS MAXIMUM LENGTH
EXTRANEOUS OPERAND(S)
FXDSOFF
The FXDSOFF function returns the hexadecimal offset of the requested label within the
DSECT. The default DSECT type is SYSTEM.
'SYSTEM'
FXDSOFF( label,dsect ,
)
'USER'
Example:
FXDSOFF('CSACDTA','CSA')
This example returns the hexadecimal offset of the label CSACDTA within the system
DSECT CSA. The result is 0000004C.
24-6
Abend-AID for CICS User’s Guide
The return codes and message text associated with the FXDSOFF function are:
0
OK
2
One of the following message text displays:
DSECT FILE IS UNAVAILABLE
UNKNOWN SYSTEM DSECT
UNABLE TO OPEN DSECT MEMBER
INVALID DSECT TYPE
MISSING OPERAND(S)
OPERAND EXCEEDS MAXIMUM LENGTH
EXTRANEOUS OPERAND(S)
FXDSSCL
The FXDSSCL function returns the scaling modifier of the requested label within the
DSECT. The default DSECT type is SYSTEM.
'SYSTEM'
FXDSSCL( label,dsect ,
)
'USER'
Example:
FXDSSCL('CSAKCMT','CSA')
This example returns the scaling modifier of the label CSAKCMT within the system
DSECT CSA. The result is 2.
The return codes and message text associated with the FXDSSCL function are:
0
OK
2
One of the following message text displays:
DSECT FILE IS UNAVAILABLE
UNKNOWN SYSTEM DSECT
UNABLE TO OPEN DSECT MEMBER
INVALID DSECT TYPE
MISSING OPERAND(S)
OPERAND EXCEEDS MAXIMUM LENGTH
EXTRANEOUS OPERAND(S)
REXX API Functions and Commands
24-7
FXDSTYP
The FXDSTYP function returns the assembler field type of the requested label within the
DSECT. The default DSECT type is SYSTEM.
'SYSTEM'
FXDSTYP(label,dsect ,
)
'USER'
Valid assembler field types are:
A
A-type address constant, implied length, aligned
B
Binary constant
C
Character constant
D
Long floating-point constant, implicit length, aligned
E
Short floating-point constant, implicit length, aligned
F
Fullword fixed-point constant, implicit length, aligned
G
Fixed-point constant, explicit length
H
Halfword fixed-point constant, implicit length, aligned
K
Floating-point constant, explicit length
L
Extended floating-point constant, implicit length, aligned
P
Packed decimal constant
Q
Q-type address constant, implicit length, aligned
R
A-, S-, Q-, V-, or Y-type address constant, explicit length
S
S-type address constant, implicit length, aligned
V
V-type address constant, implicit length, aligned
X
Hexadecimal constant
Y
Y-type address constant, implicit length, aligned
Z
Zoned decimal constant
@
Graphic (G) constant
I
Machine instruction
J
Identified as a control section name
M
Name field on a macro instruction
T
Identified as an external symbol by EXTRN instruction
W
CCW, CCW0, or CCW1 instruction
$
Identified as an external symbol by WXTRN instruction
24-8
Abend-AID for CICS User’s Guide
N
Self-defining term or the value of a SETA or SETB variable
O
Omitted operand (has a value of a null character string)
U
Undefined
Example 1:
FXDSTYP('CSACDTA,'CSA')
Example 1 returns the assembler field type of the label CSACDTA for the system DSECT
CSA. The result is A.
Example 2:
FXDSTYP('DFHCSADS,'CSA')
Example 2 returns the assembler field type of the label DFHCSADS for the system DSECT
CSA. The result is J.
The return codes and message text associated with the FXDSTYP function are:
0
OK
2
One of the following message text displays:
DSECT FILE IS UNAVAILABLE
UNKNOWN SYSTEM DSECT
UNABLE TO OPEN DSECT MEMBER
INVALID DSECT TYPE
MISSING OPERAND(S)
OPERAND EXCEEDS MAXIMUM LENGTH
EXTRANEOUS OPERAND(S)
FXGET
The FXGET function returns the storage at the requested address, based on length.
Length is a hexadecimal number of bytes. If you do not specify length, the maximum
length, 4096, is returned. The storage is returned in hexadecimal format. For example,
data is returned as 'C1C2C3C4', not 'ABCD'. Refer to “FXGETC” on page 24-9 if you want
the storage returned in character format.
'4096'
FXGET( address ,
)
length
Example:
FXGET('001830ED','325')
This example returns in hexadecimal format the first 325 hexadecimal bytes of storage at
address 001830ED.
REXX API Functions and Commands
24-9
The return codes and message text associated with the FXGET function are:
0
OK
2
One of the following message text displays:
UNAVAILABLE STORAGE ADDRESS
PARTIAL STORAGE RETURNED
MISSING OPERAND(S)
INVALID HEXADECIMAL OPERAND
OPERAND EXCEEDS MAXIMUM LENGTH
EXTRANEOUS OPERAND(S)
FXGETC
The FXGETC function returns the storage at the requested address, based on length.
Length is a hexadecimal number of bytes. If you do not specify length, the maximum
length, 4096, is returned. The storage is returned in character format. For example, data
is returned as 'ABCD', not 'C1C2C3C4'. Refer to “FXGET” on page 24-8 if you want the
storage returned in hexadecimal format.
'4096'
FXGETC( address ,
)
length
Example:
FXGETC('00057085','520')
This example returns in character format the first 520 hexadecimal bytes of storage at
address 00057085.
The return codes and message text associated with the FXGETC function are:
0
OK
2
One of the following message text displays:
UNAVAILABLE STORAGE ADDRESS
PARTIAL STORAGE RETURNED
MISSING OPERAND(S)
INVALID HEXADECIMAL OPERAND
OPERAND EXCEEDS MAXIMUM LENGTH
EXTRANEOUS OPERAND(S)
24-10
Abend-AID for CICS User’s Guide
FXINFO
The FXINFO function returns a character string that represents the following values:
ENTRY
Dump number; for example, 44,446
ABEND
Abend code; for example, ASRA
DUMPDATE
Dump date; for example, 6SEP1998
DUMPTIME
Dump time; for example, 10:11:40.933
JOBNAME
Job name; for example, H01AC049
RELEASE
CICS release; for example, CICS410_TRAN
DUMPTYPE
Dump type (transaction or region); for example, TRANSACTION
DUMP
COMMENT
Directory comments; for example, SYMPTOM STRING IS AVAILABLE
ROWS
Terminal height of viewing terminal; for example, 24
COLUMNS
Terminal width of viewing terminal; for example, 80
The following are for transaction dumps only:
TRAN
Abending transaction; for example, AAON
PROGRAM
Abending program; for example, CTCCPSTR
OFFSET
Abending instruction offset; for example, 00000234
DUPCOUNT
Number of duplicates; for example, 2
TERMINAL
Terminal ID; for example, D492
USERID
User ID; for example, CICSUSER
FXINFO( value )
Example:
FXINFO('RELEASE')
This example returns the CICS release of the selected dump, CICS630_TRAN.
REXX API Functions and Commands
24-11
The return codes and message text associated with the FXINFO function are:
0
OK
2
One of the following message text displays:
NOT VALID FOR REGION DUMP
MISSING OPERAND
INVALID OPERAND
EXTRANEOUS OPERAND(S)
FXJDATE
The FXJDATE function returns a literal representing the Julian date for the four bytes at
the specified address in the dump. The Julian date is in the format, CCYYDDDF, where
CC represents the century, YY represents the year, DDD represents the day of the year (1
through 366), and F is a packed data indicator.
FXJDATE( address )
Example:
FXJDATE('077DFD84')
This example returns the four-byte literal Julian date at address 077DFD84. The result is
converted to the Abend-AID for CICS standard date format DDMMMYYYY, where DD
represents the day, MMM the month, and YYYY represents the year; for example,
01MAR2001.
The return codes and message text associated with the FXJDATE function are:
0
OK
2
One of the following message text displays:
INVALID JULIAN DATE
UNAVAILABLE STORAGE ADDRESS
REQUIRED FOUR BYTES UNAVAILABLE
MISSING OPERAND
OPERAND EXCEEDS MAXIMUM LENGTH
INVALID HEXADECIMAL OPERAND
EXTRANEOUS OPERAND(S)
FXMODE
The FXMODE function specifies whether the Abend-AID for CICS REXX API functions
and commands that are in error cause the EXEC to stop. Non-zero return codes are
returned in the FXRC variable. If FXMODE is set to FAIL, the message is highlighted and
24-12
Abend-AID for CICS User’s Guide
written to your screen. The default is TOLERATION mode, which allows processing to
continue.
'TOLERATION'
FXMODE(
)
'FAIL'
Example:
FXMODE('FAIL')
This example specifies that if any Abend-AID for CICS REXX API functions or commands
are in error, the EXEC stops processing.
The return codes and message text associated with the FXMODE function are:
0
OK
2
The following message text displays:
INVALID OPERAND
FXMULT
The FXMULT function returns the result of multiplying the two specified hexadecimal
values.
FXMULT( value1,value2 )
Example:
FXMULT('B4','18')
This example returns the hexadecimal value 10E0, the result of multiplying hexadecimal
value B4 by hexadecimal value 18.
The return codes and message text associated with the FXMULT function are:
0
OK
2
One of the following message text displays:
MISSING OPERAND(S)
INVALID HEXADECIMAL OPERAND
OPERAND EXCEEDS MAXIMUM LENGTH
EXTRANEOUS OPERAND(S)
REXX API Functions and Commands
24-13
FXREM
The FXREM function returns the remainder of dividing the two specified hexadecimal
values.
FXREM( value1,value2 )
Example:
FXREM('D1','27')
This example returns the remainder, hexadecimal value E, as a result of dividing
hexadecimal value D1 by hexadecimal value 27.
The return codes and message text associated with the FXREM function are:
0
OK
2
One of the following message text displays:
DIVISION BY ZERO
MISSING OPERAND(S)
INVALID HEXADECIMAL OPERAND
OPERAND EXCEEDS MAXIMUM LENGTH
EXTRANEOUS OPERAND(S)
FXSTIME
The FXSTIME function returns a literal representing the store clock time for the eight
bytes at the specified address in the dump.
FXSTIME( address,length )
Example:
FXSTIME('0014111B')
This example returns the store clock time for the specified hexadecimal address
0014111B. The result is converted to military time format HH:MM:SS.THT, where HH
represents the hour, MM represents minutes, SS represents seconds, and THT represents
tenths, hundredths, and thousandths of a second; for example, 14:59:10.021.
The return codes and message text associated with the FXSTIME function are:
0
OK
2
One of the following message text displays:
UNAVAILABLE STORAGE ADDRESS
REQUIRED EIGHT BYTES UNAVAILABLE
MISSING OPERAND(S)
24-14
Abend-AID for CICS User’s Guide
OPERAND EXCEEDS MAXIMUM LENGTH
INVALID HEXADECIMAL OPERAND
EXTRANEOUS OPERAND(S)
FXSUB
The FXSUB function returns the result of subtracting the two specified hexadecimal
values.
FXSUB( value1,value2 )
Example:
FXSUB('1D8','29')
This example returns hexadecimal value 1AF, the result of subtracting hexadecimal value
29 from hexadecimal value 1D8.
The return codes and message text associated with the FXSUB function are:
0
OK
2
One of the following message text displays:
ZERO
NEGATIVE
OVERFLOW
MISSING OPERAND(S)
INVALID HEXADECIMAL OPERAND
OPERAND EXCEEDS MAXIMUM LENGTH
EXTRANEOUS OPERAND(S)
FXSYMBOL
The FXSYMBOL function returns the storage address of the requested symbol. The
maximum length of a symbol name is 36 characters. Refer to Appendix D, “Symbols List”
for the valid symbol names defined for use with Abend-AID for CICS.
FXSYMBOL( symbol )
Example:
FXSYMBOL('KEANCH')
This example returns the address of the kernel domain anchor KEANCH for the selected
dump.
REXX API Functions and Commands
24-15
The return codes and message text associated with the FXSYMBOL function are:
0
OK
2
One of the following message text displays:
SYMBOL NAME EXCEEDS MAXIMUM LENGTH
SYMBOL UNKNOWN
MISSING OPERAND
EXTRANEOUS OPERAND(S)
FXTABENT
The FXTABENT function returns the storage address of the requested CICS table entry. By
default, if no entry is specified, the first entry is returned. Valid tables are:
DCT
destination control table
FCT
file control table
PCT
program control table
PPT
program processing table
TCT
terminal control table terminal entries
TCTN
terminal control table skeleton entries
TCTS
terminal control table system entries
first
FXTABENT( table,
)
entry
'+'
'-'
Example 1:
FXTABENT(FCT)
Example 1 returns the address of the first file control table entry for the selected dump.
The value of FXLENGTH is set to the length of the file control table entry. The value of
FXENTKEY is set to the name of the file control table entry.
Example 2:
FXTABENT(FCT,'TESTVSAM')
Example 2 returns the address of the file control table entry TESTVSAM for the selected
dump. The value of FXLENGTH is set to the length of the file control table entry. The
value of FXENTKEY is set to the name of the file control table entry.
Example 3:
FXTABENT(FCT,'+')
24-16
Abend-AID for CICS User’s Guide
Example 3 returns the address of the next file control table entry for the selected dump.
The value of FXLENGTH is set to the length of the file control table entry. The value of
FXENTKEY is set to the name of the file control table entry.
Example 4:
FXTABENT(FCT,'-')
Example 4 returns the address of the previous file control table entry for the selected
dump. The value of FXLENGTH is set to the length of the file control table entry. The
value of FXENTKEY is set to the name of the file control table entry.
The return codes and message text associated with the FXTABENT function are:
0
OK
2
One of the following message text displays:
MISSING OPERAND
EXTRANEOUS OPERAND(S)
TABLE NAME EXCEEDS MAXIMUM LENGTH
ENTRY NAME EXCEEDS MAXIMUM LENGTH
INVALID TABLE TYPE
NO TABLE ENTRIES FOUND
END OF TABLE
TOP OF TABLE
FXTM
The FXTM function returns a literal indicating whether the storage at the specified
address has all, none, or some of the mask bits on. The mask is a string of eight binary
digits.
FXTM( address,mask )
Example:
FXTM('0C2FF0A8','00000001')
This example indicates whether the mask 00000001 is on at address 0C2FF0A8.
The return codes and message text associated with the FXTM function are:
0
OK
2
One of the following message text displays:
ZEROS — All bits checked are zeros.
MIXED — All bits checked are zeros and ones.
ONES — All bits checked are ones.
REXX API Functions and Commands
24-17
UNAVAILABLE STORAGE ADDRESS
MISSING OPERAND(S)
INVALID HEXADECIMAL OPERAND
OPERAND EXCEEDS MAXIMUM LENGTH
EXTRANEOUS OPERAND(S)
FXTRACE
The FXTRACE function enables or disables SAY command output to SYSTSPRT. By default
SAY command output is directed to your screen.
'OFF'
FXTRACE(
)
'ON'
Example:
FXTRACE('ON')
This example enables SAY command output to SYSTSPRT.
The return codes and message text associated with the FXTRACE function are:
0
OK
2
The following message text displays:
INVALID OPERAND
Abend-AID for CICS REXX API Commands
Abend-AID for CICS is the only host command environment available for processing
commands for the Abend-AID for CICS REXX API. Commands do not return a value to be
assigned to a REXX variable. Commands are used to perform an action. They must be
enclosed in double quotes.
Following are the Abend-AID for CICS REXX API commands.
FXHEXD
The FXHEXD command displays dump storage in hexadecimal format, starting at the
specified address. The length parameter controls the amount of storage displayed in
hexadecimal bytes. This command always results in the data being sent to your screen. It
cannot result in data being directed to SYSTSPRT.
FXHEXD( address,length )
Example:
"FXHEXD('6000','FF0')"
24-18
Abend-AID for CICS User’s Guide
This example displays in hexadecimal format the storage at address 6000 for FF0 bytes on
your screen.
FXPCLEAR
The FXPCLEAR command clears the current paperclip table.
FXPCLEAR
Example:
"FXPCLEAR"
This example clears the current paperclip table.
FXPCLIP
The FXPCLIP command adds an entry to the current paperclip table, with an optional
comment. The entry consists of the data at the hexadecimal address and can also include
an optional text string.
FXPCLIP( address,
)
comment
Example:
"FXPCLIP('0AEAC270','customer name')"
This example adds the data at address 0AEAC270 as an entry to the current paperclip
table with the comment, customer name.
FXPSHOW
The FXPSHOW command formats the current paperclip table. This command always
results in the data being sent to your screen. It cannot result in the data being directed to
SYSTSPRT.
FXPSHOW
Example:
"FXPSHOW"
This example formats the current paperclip table and displays it on your screen.
Part 7.
7
Appendixes
Part 7 consists of the following appendixes:
Appendix A, “Supplied Transaction”
This appendix describes the CICS transaction included in Abend-AID for
CICS that controls the transaction and region dump interfaces.
Appendix B, “Non-Error Condition Transaction Dumps”
This appendix explains how to use the EXEC CICS DUMP and EXEC CICS
ABEND statements to generate Abend-AID for CICS dumps for non-error
conditions.
Appendix C, “Internal Transaction Abends”
This appendix describes the Abend-AID for CICS internal transaction abends
that may occur during Abend-AID for CICS transaction abend processing.
Appendix D, “Symbols List”
This appendix lists the MVS- and CICS-related symbols that Abend-AID for
CICS uses for CICS Transaction Server for z/OS region dumps.
Abend-AID for CICS User’s Guide
A-1
Appendix A.
Supplied Transaction
Appendix A.
App A
This appendix describes how to manually control transaction and region dump interfaces
using the CICS AAON transaction supplied with 17.02.00. For information about how to
automatically control CICS dump interfaces, refer to the Abend-AID for CICS Installation and
Customization Guide.
Note:
Before you can use the supplied transaction, you must have already defined to
CICS the dump interface control program for the version of CICS you are using.
This procedure is normally completed during installation. For specifics, refer to
the Abend-AID for CICS Installation and Customization Guide.
Controlling the Dump Interface Manually
To control the dump interface manually:
1. Display the AAON Transaction Options Menu, as shown in Figure A-1, by typing
AAON and pressing Enter from a cleared CICS screen.
Figure A-1. AAON Transaction Options Menu
Abend-AID ----------------- AAON Transaction Options Menu ---------------------
Option ===> 

Tab-select an AAON option, or type the name of the option in the OPTION
field. Press PF3 to return to CICS. 

ON
Start transaction dump interface
ONR
Start region dump interface
ONRT
Start transaction and region dump interfaces
OFF
Stop transaction dump interface
OFFX
Cancel transaction dump interface
OFFR
Stop region dump interface
OFFRT Stop transaction and region dump interfaces
EXCP
Display temporary transaction dump capture profile
DB2ON Enable DB2 option
DB2OFF Disable DB2 option 


Status: 

CICS Applid.................. H01AC011
Version.......... 17.02.00
Transaction Dump Interface... STARTED
Viewing Server... CIMSCF01
Region Dump Interface........ STOPPED
Dump Capture AS.. FXTDCAS
The AAON Transaction Options Menu displays AAON options that start, stop, or
cancel a transaction or region dump interface (or a combination of the two
interfaces). You may also display the temporary transaction dump capture option
table from this screen. The current status of each dump interface appears below the
list of AAON options.
A-2
Abend-AID for CICS User’s Guide
2. Select an AAON option using one of two methods:
– Tab to the option you want to select and press Enter.
– Type the name of the option in the OPTION field and press Enter. If you
accidentally enter an invalid option, the system redisplays the AAON Transaction
Options Menu.
Once you make a selection, the status of the appropriate dump interface changes
accordingly.
3. Press Enter to return to the AAON Transaction Options Menu, or press Clear Screen
to return to CICS.
You may also control the transaction and region dump interfaces directly from CICS
using a combination of the AAON transaction ID and an AAON option. For example:
AAON ON
AAON OFFR
Press Enter to process the command from CICS.
Transaction Dump Interface
The transaction dump interface must be started for Abend-AID for CICS to process any
transaction dumps, or if you want to view dumps from CICS (with the AADF
transaction). To start the transaction dump interface, select AAON ON, AAON ONRT, or
AAON DB2ON. Also note the following conditions that affect starting the transaction
dump interface:
• The transaction dump capture subsystem must be active before you start the
transaction dump interface.
• If your site is licensed for the Abend-AID for CICS DB2 extra-cost option and if
Abend-AID for CICS is installed in a CICS region where DB2 itself is not running, the
transaction dump interface still turns on, even if the table updates for the DB2
option have not been completed. Messages are written to the CSMT log and/or the
terminal indicating that DB2 is licensed, but is not active in the CICS region.
• If your site is licensed for the Abend-AID for CICS DB2 extra-cost option, and if DB2
itself is running in a region and the DB2 option table updates are not completed, the
transaction dump interface will not start in that region, regardless of which AAON
option you select.
Additional AAON options are available, but do not appear on the AAON Transaction
Options Menu. These options can be issued from CICS with the AAON transaction ID, or
from the OPTION field on the AAON Transaction Options Menu:
• AAON T0C7 creates a transaction ASRA abend (S0C7).
• AAON DISP allows all Abend-AID messages issued in the CICS region to appear in the
CICS FDBDLOG.
• AAON SUPP reduces the number of Abend-AID messages that appear in the CICS
FDBDLOG. This is the default setting in order to reduce the size of the FDBDLOG
output.
Region Dump Interface
The region dump interface is not required to capture CICS region dumps. It is required
only if you want to capture a list of recently changed programs from the CICS RPL
concatenation. If this list is captured, you can view it through the Abend-AID for CICS
region dump display screens. Entering the CHANGES fast-path command displays the
Program Change Summary screen.
Supplied Transaction
A-3
If you want to use the optional region dump interface, use the Abend-AID for CICS
AAON ONR or AAON ONRT CICS transaction. For PLT processing, the program name
associated with the region dump interface is CTCCJRGN. Note that you may experience
some overhead and increased dump capture time when you enable the region dump
interface. Usually this amount is insignificant, but if you see any performance
degradation at dump capture time, you can turn off only the region dump interface,
while still leaving the transaction dump interface active.
Modifying Temporary Transaction Dump Profiles
Transaction dump profiles and transaction global options control the actions that AbendAID for CICS takes when transaction abends occur. Transaction dump global options
specify actions that are taken for all transaction abends in the CICS region. Transaction
dump profiles can override certain transaction dump global option specifications for
individual abend codes, transactions, programs, terminals, network names, operator IDs,
user IDs, APPLIDs, or local CICS SYSIDs, so that you have more control over exception
conditions in your CICS regions.
There are two types of transaction dump profiles — permanent and temporary.
Permanent transaction dump profiles are created and maintained through the online
customization procedure, and they are loaded by the CICS regions to which they are
assigned when Abend-AID for CICS is initiated in the CICS region. Permanent
transaction dump profiles, and the online customization procedure, are discussed in the
Abend-AID for CICS Installation and Customization Guide.
Temporary transaction dump profiles override any specifications made in permanent
transaction dump profiles. They are created and maintained from CICS using a CICS
transaction, and are only active for the life of the CICS region in which they are created,
or until you stop Abend-AID for CICS. Modifications made to the temporary transaction
dump profile are dynamic (become effective immediately).
Specifications made in transaction dump profiles (both temporary and permanent)
control the following:
• Suppressing duplicate dumps.
Note: A duplicate transaction dump is one that has the same abend code, abending
program name, abending program offset, and transaction ID. You can
include APPLID and job name as criteria for identifying duplicate dumps if
your site sets their corresponding global options to Y.
• Capturing an IBM dump in addition to, or instead of, an Abend-AID for CICS dump.
You can also choose to just write a directory entry for the dump but not capture it.
• Capturing the last 3270 screen image associated with the abend.
• The extent of the CICS trace captured (complete, abending task only, or none).
These specifications can be made using a variety of criteria, including abend code,
program name, transaction, terminal, NETNAME, operator ID, user ID, APPLID, local
CICS SYSID, or a combination of criteria.
Note: Several of the actions controlled by transaction dump profiles have corresponding
transaction dump global options. If a transaction dump profile option
contradicts a transaction dump global option, the transaction dump profile
option overrides the transaction dump global option.
A sample Temporary Tran Dump Profile screen is shown in Figure A-2 on page A-4.
Note:
Although Figure A-2 shows temporary transaction dump profile entries, the
default transaction dump profile entry that you will see when you initially access
A-4
Abend-AID for CICS User’s Guide
the screen is blank. This means that, by default, nothing is considered an
exception condition, and transaction dumps are processed for all abends
according to the options specified in the transaction dump global options
member assigned to each CICS region, unless there is an entry for the abend in
the permanent transaction dump profile.
Figure A-2. Temporary Tran Dump Profile Screen


Abend-AID ---------- Temporary Tran Dump Profile --------- ROW 000001 OF 000002
Press PF1 for more information about dump profiles and using this screen.
_______________________________________________________________________________


A Add a New Entry
I Insert a Condition Statement
D Delete 

AND/
Supp AA/CICS IBM Entry L3270 CICS
Resource Operator Literal
OR
Dups Dump
Dump Only Image Trace
-------------------------------------------------------------------------
_ ABCODE
EQ
ASRA
AND
Y
Y
N
N
Y
NONE
_ PROGRAM
NE
MYPGM
-------------------------------------------------------------------------
_ PROGRAM
EQ
MYPGM2
N
Y
Y
N
N
TASK
-------------