Previous Topic: Commands

Next Topic: Line Commands

The Dump Tree

When a dump is selected, the dump data set is loaded and the dump tree is built. The dump tree is a hierarchical view of the information available for the selected dump. In this view, tree branches (called folders) can be expanded or collapsed to display only the desired data, enabling you to drill down into an area of interest while ignoring data that you consider less helpful.

The Dump Tree includes folders for formatted reports generated at capture time, programs that were loaded at the time of the dump, and various types of control blocks.

A Viewed Storage Areas folder is also provided. This folder initially contains no data, but is populated as you view the dump. It contains a list of other storage areas that you viewed using the various storage display commands. Storage areas already defined in the dump tree, such as known control blocks or loaded programs, are never added to this branch.

To provide access to dump storage for viewing, CA SymDump System requires access to CA SYSVIEW (or Server). This access is facilitated by the GSS component of the CA Common Services, and is referred to in this document as SYSVIEW Services. If the necessary GSS address space is not running, SYSVIEW Services will not be available, and only the reports formatted during the dump capture can be viewed. Similarly, if GSS is not running at the time of the dump, no reports can be formatted during the dump capture.

Use the STATUS command to determine whether or not SYSVIEW Services are available at any time. If SYSVIEW Services are not available when the dump viewer is started, a warning displays whenever you select a dump for viewing.

The following is a dump tree:

CA SymDump System V9.0 --------- Dump Tree  ---------------------- Line 1 of 12 Command ===>                                                   Scroll ===> CSR  -------------------------------------------------------------------------------- System    XAE1            Asid      01FA            UserId    MIKED             JobName   MIKED530        Date      2009/07/11      Time      16.08.53          Program   DFHSIP          Offset    000AC970        Code      SM0103            -------------------------------------------------------------------------- Lvl 2 Cmd  Address   Description                                                     .               Job=MIKED530                                                    .               |  Favorites                                                     .               | |  Abend Summary                                               .               | |  CICS Message Help                                           .               | |  CICS Summary                                                .               | |  Task Storage Summary                                        .               | |  Trace                                                       .             + |  Formatted Reports                                             .             + |  Loaded Programs                                               .               |  Viewed Storage Areas                                          .             + |  OS Control Blocks                                             .             + |  CICS Control Blocks                                          --------------------------------------------------------------------------------                                                                                  F1=HELP      F2=SPLIT     F3=END       F4=DUMP      F5=RFIND     F6=MAP         F7=UP        F8=DOWN      F9=SWAP     F10=LEFT     F11=RIGHT    F12=RETRIEVE

Folders are tree entities that cannot be displayed but may contain displayable subordinate items.

These entries are:

Job=xxxxxx

Favorites

Formatted Reports

Loaded Programs

Viewed Storage Areas

Control Blocks

CICS Control Blocks

In the hierarchical view, a plus sign (+) next to an item in the tree indicates that the item owns one or more subordinate items and can be expanded to display the subordinate items. Enter a plus sign (+) in the Cmd column next to the entry to expand an item to expose its subordinate items in the tree. Enter an exclamation point (!) in the Cmd column to explode an item, that is, expand the item and its subordinate items recursively until none of the subordinate items are hidden.

A minus sign (‑) next to an item indicates that the item is currently expanded and can be collapsed by entering a minus sign (‑) in the Cmd column.

Use the forward slash (/) line command to toggle between expanded and collapsed views.

The Favorites folder is initially expanded to display its content consisting of a special group of reports created during the dump capture. Reports appear in this folder only if they were selected as favorites in the OPTLIB member used to control the report generation for the dump capture. A report is selected as a favorite only when its title starts with an exclamation point (!). In the previous sample, five reports were selected as favorites.

The Formatted Reports folder contains all of the reports created when the dump was captured, including those selected as favorites. For more information about this folder, see Viewing Reports.

The Loaded Programs group folder contains an entry for each load module that was found in the captured dump. For further information about this folder, see Viewing Programs.

The Viewed Storage Areas folder is a recall area for otherwise uncategorized storage areas that you have viewed since the dump was captured. For further information about this folder, see Viewing Storage.

The OS Control Blocks folder contains all of the key z/OS control blocks that you may need to locate during your dump viewing session. For more information about this folder, see Viewing Control Blocks.

The CICS Control Blocks folder contains all the key CICS control blocks you may need to locate during your dump viewing session, and only appears if the selected dump was produced by CICS. For more information about this folder, see Viewing Control Blocks.