Previous Topic: Documentation ChangesNext Topic: Customizing Dump Capture


Introduction

CA SymDump System is a system dump capture and view facility for z/OS. It provides easy-to-use system dump diagnostic and management capabilities that helps systems programmers resolve system abends and manage dump captures and retentions.

CA SymDump System automatically captures system dumps and displays the dump information in an easy-to-read format, while adding comprehensive abend diagnostic information for system abends in both test and production environments.

CA SymDump System captures system dumps from any job, with specific environmental information for z/OS, CICS, MQSeries, JES2, DB2, IMS, CA Datacom, and CA Roscoe Interactive Environment. Detailed reports, formatted storage areas, and formatted control blocks help systems programmers quickly diagnose and correct problems.

Each installation can easily control which dumps are captured by including or excluding specific abend codes, userids, or job names. Dumps are compressed and stored individually in separate data sets, with a single dump index identifying where each dump has been written.

The dump viewer provides end users with easy dump identification, simplified dump selection, and a powerful viewing environment.

Comprehensive dump management capabilities allow sites to determine which dumps to display or delete, and when to suppress duplicate dumps. Additionally, sites can define dump purge defaults to control how long dumps are retained.

This section contains the following topics:

Who Should Use This Guide

Dump Capture

Dump Data Sets

The Dump Index

Capturing Reports

Viewing Captured Dumps

Options Table

Supported Environments

Who Should Use This Guide

This Administration Guide is intended for CA SymDump System administrators and users. It provides detailed conceptual information, supplemental installation information, and detailed descriptions of how to use the features and functions of the product.

Dump Capture

CA SymDump System provides an automated facility for capturing information during selected system dumps. When a system dump occurs that matches your selection criteria, CA SymDump System generates and saves diagnostic reports that can be viewed or printed later to assist in problem determination and resolution. A snapshot of the storage in the dumping address space is also captured. The captured reports and storage are written to separate dynamically created dump data sets, which are logged as a single dump capture in a dump index file for later retrieval.

Dump capture is initialized on any system using the Resource Initialization Manager (CAIRIM) component of CA Common Services. At any time after initialization, use CAIRIM to change or disable dump capture.

Dump Data Sets

CA SymDump System creates two dump data sets for each dump capture. The first contains diagnostic reports generated during the capture. The data set for this report is a variable-length sequential file in a compressed, proprietary format that can only be read by the CA SymDump System dump viewer. The second contains a standard IBM formatted system dump, compatible with IBM's Interactive Problem Control System (IPCS) and the CA SymDump System dump viewer.

The CA SymDump System options table controls data set naming conventions, space allocations, and DASD location. As each dump data set is created, it is automatically logged into a centralized dump index file, which can be used later for retrieving dumps for viewing.

Your security profiles must permit create, update and read access for the high-level qualifier selected for your dump data sets for all users on systems where dump capture is active.

The Dump Index

CA SymDump System uses an index file to maintain a record of all captured dumps. The dump index file is a VSAM fixed-length relative-record data set (RRDS). A single dump index file can simultaneously manage up to 4,000 dump data sets. You can keep a separate dump index file for each system or share a single dump index file across systems. You can change your active dump index file at any time on any system.

The dump index file is defined by IDCAMS and is initialized using the CA SymDump System index utility program, CADVIDXU. The utility also permits batch access to view or update the contents of any dump index file, and batch maintenance functions. You can use the index utility to delete dump data sets that have reached a certain age, or to produce a list of dumps captured for a specific job or user ID.

Your security profiles must permit both update and read access to the dump index file for all users on systems where the dump index file is used.

Capturing Reports

CA SymDump System uses the CA SYSVIEW (or Server) technology to generate diagnostic reports during dump capture. Output from any CA SYSVIEW (or Server) command can be captured and written to the dump data set for later viewing. Using report control statements in the CA SymDump System OPTLIB library, you can control exactly which reports are produced for each type of dump. For a complete description of all available report commands, see the CA SYSVIEW (or Server) Administration Guide. CA SymDump System communicates with CA SYSVIEW (or Server) using the GSS component of CA Common Services. You must install GSS before capturing or viewing dumps. For more information about using GSS, see Installation Guide.

Viewing Captured Dumps

Dumps can be viewed using the:

Note: For more information on the Eclipse Interface see the Installation Guide .

Regardless of which index file is currently active, you can select dumps from any dump index file. The content of the selected dump index file is displayed as a selection list that includes details about each captured dump. This enables you to locate the desired dump easily before selecting it for viewing.

Once you have selected a dump to view, the numerous diagnostic reports and the enhanced viewing of the address space simplify the path to diagnosis.

Options Table

The options table, CADVTABL, controls both dump capture and dump viewing. On systems where the capture component is installed, this table exists as a resident load module and is available to both the capture and view facilities. On systems where dump capture is not installed, the options table is loaded from the CA SymDump System executable library.

The options table enables you to control the following:

You can modify the options table at any time, but changes do not take effect for dump capture options until the dump capture facility is reinitialized. This is accomplished using the CAIRIM procedure as described in the Installation Guide.

Supported Environments

CA SymDump System supports the capture of any system dump on z/OS. Enhanced reporting is available for special environments such as CICS, DB2, IMS, MQSeries and CA Datacom.

Viewing is supported on TSO/ISPF or from your Eclipse-based GUI.