Space announcement This documentation space provides the same content as before, but the organization of the content has changed. The content is now organized based on logical branches instead of legacy book titles. We hope that the new structure will help you quickly find the content that you need.

Issuing an Abend-AID for CICS Snap Dump (Code Debug CICS)

Related Topics

Quick Reference

Installation and Configuration Guide

Advanced Configuration Guide

Getting Started

Abend-AID for CICS is an abend analysis tool that intercepts calls to the dump control program and produces a diagnostic report. The report explains where an abend occurred, why it happened, and how it can be fixed. To get this information, you must issue a snap dump request.

  1. To issue a snap dump, type 1 in the COMMAND field of the Abend-AID for CICS Interface Menu (7).
  2. Press Enter. A snap dump is taken for the ASRA abend, and Abend-AID for CICS is automatically invoked to create the report for this abend. The Diagnostic Summary of the Abend-AID for CICS report appears as shown in Diagnostic Summary Screen(following figure).

Important

If the report file is set up to suppress duplicate reports and the current snap is deemed a duplicate and suppressed, Abend-AID will not return a report number to Code Debug. This will cause the report file directory to be displayed instead of the current report. From the directory screen, you may use Abend-AID’s masking facilities to filter the reports that are displayed.

The Diagnostic Summary gives detailed diagnostics about the trapped abend. The paragraph at the top of the screen identifies the abend code (ASRA), program name (CWDEMC), abending transaction (XCCC), terminal, and user ID. Additional paragraphs provide a detailed analysis of the abend.

Abend-AID for CICS Diagnostic Summary Screen

  Abend-AID --------------- Diagnostic Summary --------- Row 000001 of 000059
 COMMAND ===>                                                SCROLL ===> CSR

 An ASRA abend occurred in program CWDEMC.  The abending transaction was
 XCCC running at terminal 4383 for user ID ACMEJET0.

 Analysis of error

 The Multiply instruction in error is located at offset 0015F6 in program
 CWDEMC.

 The A-Operand is located at displacement 005D70 in a USER31 storage area.

 The operand is shown below:

 4020A330 00000000525C

 The B-Operand is located at displacement 005B70 in a USER31 storage area.

 The operand is shown below:

 4020A130 5B5B

 Entry=6498600(ACMEC123)  Code=ASRA      ACMEC222    AssistMenu=PF24   More...

3. Press PF8 to scroll through the report. A report example is shown in following figure.

Diagnostic Summary Screen (continued)

  Abend-AID ----------------- Diagnostic Summary -------- Row 000015 of 000059
 COMMAND ===>                                                SCROLL ===> CSR

 Analysis of error

 The operand is shown below:

 4020A130 5B5B

           * #

 THE ABOVE FIELD IS IN ERROR

  # = INVALID SIGN, * = INVALID DIGIT
 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).

 Next Sequential Instruction

 The next sequential instruction to be executed in program CWDEMC in
 procedure                                was at offset 000015FC.
 Entry=6498600(ACMEC123)  Code=ASRA      ACMEC222    AssistMenu=PF24   More...

The Abend-AID for CICS report contains additional information that can be directly accessed by entering the section’s number or name in the COMMAND field.

4. To display a menu of the report sections, press PF6. A report menu appears as shown in following figure

Abend-AID for CICS Report Menu

  Abend-AID ------------------------ Report Menu ---------------------------
 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

 Entry=6498597(H01AC123)  Code=AEIM      H01AC222    AssistMenu=PF24

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*