Previous Topic: Dump Viewer CommandsNext Topic: Report Categories


CA SymDump System Reports

During dump capture, CA SymDump System communicates with CA SYSVIEW (or Server) to collect information about the dumping address space. This information is stored in the reports data set, the smaller of the two data sets created for each dump. When the dump is loaded, the reports are displayed in the dump tree in the Formatted Reports folder, grouped by the type of information they provide and listed alphabetically within each group by report title.

Using the OPTLIB, you can customize your dump captures to include any of the reports available from CA SYSVIEW. Most of these reports are listed in the appendix Report Categories which lists the reports by group with a brief description of each. For a detailed description of the contents of these reports, including field-by-field explanations, refer to the CA SYSVIEW (or Server) User Guide.

In addition to these reports, CA SymDump System offers the following additional reports:

By default, each of these reports also appears in the Favorites folder. These reports are only available to CA SymDump System users and are documented in this appendix.

This section contains the following topics:

CICS Task Storage Summary

CICS Kernel Error Report

CICS Message Help Report

CICS Summary Report

CICS Trace Dialog

Abend Summary Report

CICS Task Storage Summary

The CICS Task Storage Summary is generated for CICS dumps when the #CICSAXS command appears in the OPTLIB member during dump capture. This report summarizes all of the storage allocated for each active task at the time of the dump. The summary shows the storage address and length, the subpool name and DSA type, and the first sixteen bytes of data at the storage address. Additionally, if the leading or trailing crumple zone has been overlaid, a “storage violation” indicator is displayed (in the StgV column) to show this.

This is a sample Task Storage Summary:

CA SymDump System V9.1 --------- Task Storage Summary ----------- Line 1 of 14 Command ===>                                                   Scroll ===> CSR  ------------------------------------------------------------------------------- CICS Task Storage Summary                                                       ------------------------------------------------------------------------- Lvl 3 TaskNo  Address   Length    DSANm  StgV  Subpool   +8       +C       +10      + 000004  00046000  00000440  CDSA         M0000004  00B46EC4 C6C8C5C9 E4E24040 4 000005  00049000  00000440  CDSA         M0000005  00B46EC4 C6C8C5C9 E4E24040 4 000007  1CC85000  000005D0  ECDSA        C0000007  00B46EC4 C6C8C5C9 E4E24040 4 000019  1C436840  00000620  ECDSA        C0000019  06086EE9 D5C1C3F2 00000000 0 000019  1C436440  00000400  ECDSA        C0000019  00006EE9 D5C1C3F1 C7F0F0F1 9 000019  1C436000  00000440  ECDSA        C0000019  00B46EC4 C6C8C5C9 E4E24040 4 000018  1C438000  00000440  ECDSA        C0000018  00B46EC4 C6C8C5C9 E4E24040 4 000028  001C4000  00000440  UDSA         B0000028  00B46EC4 C6C8C5C9 E4E24040 4 000028  1CD20330  000000A0  EUDSA        U0000028  0000021C 0000025C 0000028C F 000028  1CD20300  00000030  EUDSA        U0000028  6EE3E2C9 D6C14040 00100000 C 000028  1CD20000  00000300  EUDSA        U0000028  000002E8 00000000 00000000 0 000028  1CC84000  000001B0  ECDSA        C0000028  FFFFFFFF FFFFFFFF FFFFFFFF F 000039  001C0440  00000380  UDSA   StgV  B0000039  00000367 00000000 00000000 0 000039  001C0000  00000440  UDSA         B0000039  00B46EC4 C6C8C5C9 E4E24040 4

CICS Kernel Error Report

The CICS Kernel Error Summary is generated for CICS dumps when the #CICSKER command appears in the OPTLIB member during dump capture. This report summarizes the last CICS kernel errors that occurred in the CICS region. The summary shows the system and CICS error code, the program and the offset where the error occurred, the pointer to the DFHKERRD control block, and the date and time of the error.

When this report is generated, the DFHKERRD address for each kernel error is also listed in the CICS Control Blocks folder under the subfolder Kernel Errors. These control blocks are also auto-mapped for your convenience.

The following is a sample CICS Kernel Error Summary:

CA SymDump System V9.1 ------- Kernel Errors ------------------- Line 1 of 13  Command ===>                                                   Scroll ===> CSR  -------------------------------------------------------------------------------  CICS Kernel Error Summary  ------------------------------------------------------------------------- Lvl 3  Error     Module    Offset  Type                         DFHKERRD  Error#  Date  0C7/AKEA  ASMDEMO   019C    Program Check         0C61E110  000013  2009/03/21  ---/ASRA  DFHSRP    03C2    Abend Percolate       0C61DF68  000012  2009/03/20  0C7/AKEA  COBDEMO   1B8C    Program Check         0C61DDC0  000011  2009/03/20  ---/ASRA  DFHSRP    03C2    Abend Percolate       0C61DC18  000010  2009/03/20  0C7/AKEA  ASMDEMO   019C    Program Check         0C61DA70  000009  2009/03/20  ---/ASRA  DFHSRP    03C2    Abend Percolate       0C61D8C8  000008  2009/03/20  0C7/AKEA  COBDEMO   1B8C    Program Check         0C61D720  000007  2009/03/20  ---/ASRA  DFHSRP    03C2    Abend Percolate       0C61D578  000006  2009/03/20  0C7/AKEA  ASMDEMO   019C    Program Check         0C61D3D0  000005  2009/03/20  ---/ASRA  DFHSRP    03C2    Abend Percolate       0C61D228  000004  2009/03/20  0C7/AKEA  PL1DEMO   1A74    Program Check         0C61D080  000003  2009/03/20  ---/ASRA  DFHSRP    03C2    Abend Percolate       0C61CED8  000002  2009/03/20  0C7/AKEA  COBDEMO   1B8C    Program Check         0C61CD30  000001  2009/03/20  -------------------------------------------------------------------------------

CICS Message Help Report

The CICS Message Help report is generated for CICS dumps when the #CICSMSG command appears in the OPTLIB member during dump capture. You can also create this report dynamically from the dump viewer using the CMSG command. This report describes the reason for the CICS message, dump code or transaction abend code and in many cases recommends an action.

To view this report, the CADVCMSG DD must allocate the DFHCMACD member of the SDFHMSGS library for CICS when the viewer is started.

The following is a sample CICS Message Help report:

CA SymDump System V9.1 --------- CICS Message Help -------------- Line 1 of 43 Command ===>                                                   Scroll ===> CSR  ------------------------------------------------------------------------------- CICS Message Help for DFHSM0103                                                 ------------------------------------------------------------------------- Lvl 2                                                                                            DFHSM0103   APPLID  A STORAGE VIOLATION (CODE                                             X'CODE' ) HAS BEEN DETECTED BY THE STORAGE                                     VIOLATION TRAP. TRAP IS NOW INACTIVE.                                                                                                                 EXPLANATION:  A storage violation has been detected by the                      storage violation trap, which may be enabled via the CHKSTSK                    or the CHKSTRM system initialization parameters or via the                      CSFE transaction.  The code X' code ' is the exception                          trace point ID which uniquely identifies the type of storage                    violation detected.                                                                                                                                             SYSTEM ACTION:  CICS disables the storage violation trap.                       An exception entry (X' code ' in the message) is made in                        the trace table.  A system dump is taken, unless you have                       specifically suppressed dumps in the dump table.                                                                                                       F1=HELP      F2=SPLIT     F3=END       F4=DUMP      F5=RFIND     F6=MAP         F7=UP        F8=DOWN      F9=SWAP     F10=LEFT     F11=RIGHT    F12=RETRIEVE

CICS Summary Report

The CICS Summary report is generated for CICS dumps when the #CICSSUM command appears in the OPTLIB member during dump capture. This report identifies the CICS system data areas, the currently dispatched task, and displays all of the storage areas owned by each of the active tasks.

When this report is generated, each of the task-level control blocks is added to the CICS Control Blocks folder under the subfolder Task Control Areas. These control blocks are also auto-mapped for your convenience.

The following is a sample CICS Summary report:

CA SymDump System V9.1 --------- CICS Summary ------------------ Line 1 of 148 Command ===>                                                   Scroll ===> CSR  ------------------------------------------------------------------------------- CICS Summary Report for A04IC9N6                                                ------------------------------------------------------------------------- Lvl 3                                                                                 ******** CICS Areas *********                                                                                            +0       +4       +8       +C          CSA      at 0004DE20 for 0000204 bytes:  00000248 0000D0A0 1C39B0E8 9C7CD7FE  . COPFL    at 0004D648 for 0000588 bytes:  00000000 00000000 1C494A00 00000000  . SIT      at 9C0C16B0 for 0000850 bytes:  E702E753 00000000 08500400 00000000  X CWA      at 000C1000 for 0000400 bytes:  00000000 00000000 00000000 00000000  . TCT      at 00051D80 for 0000600 bytes:  0006973C 00069810 00051D8C 8004DE20  .                                                                                 Current TCA at 0005A680 for task #0039 (STGV).                                                                                                                 **** Active Task Summary ****                                                                                                                                   ---------------------------------------------------                             | Task #0039  Tran STGV  Term G001  User CICSUSER  |                             | Date 07/22/2009 at 10.11.07                      |                             ---------------------------------------------------                              F1=HELP      F2=SPLIT     F3=END       F4=DUMP      F5=RFIND     F6=MAP         F7=UP        F8=DOWN      F9=SWAP     F10=LEFT     F11=RIGHT    F12=RETRIEVE 

CICS Trace Dialog

The CICS Trace Dialog is available for CICS dumps when the #CICSTRA command appears in the OPTLIB member during dump capture. You can also create this report dynamically from the dump viewer using the CTRACE command. Use this interactive dialog to view the CICS internal trace table, formatted by the CICS trace formatter.

To view this report, the CADVCICS DD must allocate a concatenation of the SDFHLOAD and SDFHLINK libraries for your CICS release when the viewer is started. If you use multiple CICS releases, you can concatenate the libraries for multiple releases.

The CICS Trace dialog enables you to view the internal trace in any of the formats provided by the CICS trace formatter program. This includes abbreviated, short, and full trace formats. The dialog also provides filters that let you to customize the view by selecting only the entries that interest you, and line commands that allow you to zoom in for full details on individual entries.

When the dialog is first appears, the unfiltered trace table is displayed in the abbreviated format, and the filters are disabled, as shown here:

CA SymDump System V9.1 --------- Trace ------------------------ Line 1 of 6600 Command ===>                                                   Scroll ===> CSR  ------------------------------------------------------------------------------- CICS - AUXILIARY TRACE FROM 01/04/01 - APPLID A04IC9N6        6,600 ENTRIES      VIEW ABBREV  FILTERS OFF  SHOW ON   COLUMNS "OR" OFF                                      TASK  TCB   DM ID   MOD   DATA                                        .         *     *     *  *    *     *                                          ------------------------------------------------------------------------- Lvl 3  . =00001= 00053 QR    DS 0002 DSAT  ENTRY CHANGE_PRIORITY                       . =00002= 00053 QR    DS 0003 DSAT  EXIT  CHANGE_PRIORITY/OK                    . =00003= 00053 QR    AP F001 XCP   EXIT  WAIT                                  . =00004= 00053 QR    AP 00E1 EIP   EXIT  SUSPEND               OK              . =00005= 00053 QR    AP 00E1 EIP   ENTRY SUSPEND                               . =00006= 00053 QR    AP F000 XCP   ENTRY WAIT                                  . =00007= 00053 QR    DS 0002 DSAT  ENTRY CHANGE_PRIORITY                       . =00008= 00053 QR    DS 0003 DSAT  EXIT  CHANGE_PRIORITY/OK                    . =00009= 00053 QR    AP F001 XCP   EXIT  WAIT                                  . =00010= 00053 QR    AP 00E1 EIP   EXIT  SUSPEND               OK              . =00011= 00053 QR    AP 00E1 EIP   ENTRY SUSPEND                               . =00012= 00053 QR    AP F000 XCP   ENTRY WAIT                                  . =00013= 00053 QR    DS 0002 DSAT  ENTRY CHANGE_PRIORITY                       . =00014= 00053 QR    DS 0003 DSAT  EXIT  CHANGE_PRIORITY/OK   

Control Fields

The control fields are located in the information area at the top of the dialog. These fields are described here:

VIEW

Switches the view for the entire report. Specify either ABBREV (for abbreviated), SHORT or FULL. If you have altered the view for an individual entry, that entry is not affected by this value until it is reset.

FILTERS

Specify OFF to display the entire unfiltered trace table, or ON to display only those entries matching the filter criteria.

SHOW

Specify ON to display the filters, and OFF to suppress them. This does not affect the trace entries displayed.

COLUMNS "OR"

When filters are active (FILTERS ON), this value determines how the filtering criteria are evaluated. When OFF is specified, only those trace entries that match an entire row of your filtering criteria display. When ON is specified, any entry that matches at least one value from each column displays.

Filter Entries

Each filter entry consists of the following six values:

TASK

The task ID of the CICS task from which the entry originated.

TCB

The CICS TCB ID for the TCB from which the entry originated.

DM

The two-character ID of the domain which wrote the entry.

ID

The four-digit trace point identifier used to differentiate between the various trace entries that originate from the same CICS domain.

MOD

The CICS module from which the trace entry originated, excluding the leading DFH characters.

DATA

Any value from the data portion of the trace entry, including data that is not displaying in the currently selected view. In other words, you can use a data filter that matches data only displayed in the full format, even if your current view is abbreviated.

You can add as many filtering rows as can fit on your screen, but the display is not scrollable. To add or remove a row, use the following line commands in the command column at the far left side of the filter entries:

D

Deletes a row.

I

Inserts a new blank row.

R

Replicates a row.

You can specify a wild card value ("*") in any column to indicate that any value should match. A row of filtering values containing all wild cards will match every CICS trace entry. You cannot specify a prefix value by appending a wild card character to the end of a value, such as "D*". Wild card values can only be specified as "*" to indicate "match any".

A blank entry in any column will not match any values. Blanking out one column does not cause that column to be ignored, it causes the column to not match any trace entries. Therefore, when Columns "OR" is OFF, blanking out a column serves to disable the entire row.

Trace Entries

Each trace entry appears in the format defined by the VIEW control field, unless that entry was reformatted using one of the following line commands:

A

Display the entry using the abbreviated view.

F

Display the entry using the full view.

R

Reset any overriding view for this entry.

S

Display the entry using the short view.

Help

From within the CICS Trace dialog, type HELP on the command line and press ENTER to display this information online. From any other display within the dump viewer, type HELP AUXTRACE.

Abend Summary Report

The Abend Summary report is generated when the #SUMMARY command appears in the OPTLIB member during dump capture. This report displays information about the abending or dumping task, including the completion code, TCB address, and the registers and PSW at the time of the error.

When this report is produced, the following built-in equates are also created when the dump is loaded:

The following is a sample Abend Summary report:

CA SymDump System V9.1 --------- Abend Summary ------------------ Line 1 of 19 Command ===>                                                   Scroll ===> CSR  ------------------------------------------------------------------------------- Job: MIKED530   System: XAE1       Asid: 00B3                                   ------------------------------------------------------------------------- Lvl 3 Abend Summary for SM0102                                                                                                                                        DFHSM0102 A04IC9N6 A storage violation (code X'030B') has been detected by modu                                                                                 PIDS/565501800 LVLS/530 MS/DFHSM0102 RIDS/DFHSMGF PTFS/UQ52744 PRCS/0000030B                                                                                    PSW at time of error:        078D2000 9BFEF5F0      DFHSIP  +AC970                                                                                              TCB address:                 007CF850                                                                                                                           Registers at time of error:                                                                                                                                        Reg 0  = 000000B8  PSA+B8             Reg 8  = 1C0B67D8  E-PVT                  Reg 1  = 1CC435A0  E-PVT              Reg 9  = 1CC4362C  E-PVT                  Reg 2  = 1C0B67D8  E-PVT              Reg 10 = 1CC4362C  E-PVT                  Reg 3  = 9BFEDDA8  DFHSIP+EDDA8       Reg 11 = 1CC42C87  E-PVT    Reg 4  = 1CC434A0  E-PVT              Reg 12 = 0005A680  PVT                    Reg 5  = 1BFEEDA7  DFHSIP+EEDA7       Reg 13 = 1CC434A0  E-PVT                  Reg 6  = 1BFEFDA6  DFHSIP+EFDA6       Reg 14 = 007D2828  JSTCB-3E8              Reg 7  = 1CC42904  E-PVT              Reg 15 = 00000000  PSA                  -------------------------------------------------------------------------------                F1=HELP      F2=SPLIT     F3=END       F4=DUMP      F5=RFIND     F6=MAP         F7=UP        F8=DOWN      F9=SWAP     F10=LEFT     F11=RIGHT    F12=RETRIEVE