Customizing Dump Capture › Selecting Diagnostic Reports

Selecting Diagnostic Reports

When a dump is captured, the reports data set is populated with information about your system and the dumping address space as defined by your installation. CA SYSVIEW (or Server) produces most report information but some reports are provided exclusively for CA SymDump System users.

Report generation during dump capture is controlled using a list of commands located in the OPTLIB control file. The OPTLIB members are distributed with CA SymDump System, but are customized and maintained outside the control of SMP/E. Within each OPTLIB member is a list of commands used to control report generation during dump capture. Report production during a dump capture is determined primarily by which OPTLIB member is selected at the time of the dump.

During a dump capture, the OPTLIB member is selected as follows:

• If a CADVOPT DD is defined in the JCL, control statements for report generation are retrieved from the CADVOPT DD, which must allocate an OPTLIB member or any sequential file with LRECL=80 containing control statements for report generation. The use of in-stream commands in the CADVOPT DD is also permitted.
• If no CADVOPT DD exists in the JCL, control statements for report generation are retrieved from the library defined in the OPTLIB= option in CADVTABL. If a member exists in that library whose name exactly matches the abend or dump code (examples are S0C7, U1234, AP0001, or AICA), that member is selected. Otherwise, member CICS is used for CICS system dumps, and member DEFAULT is used for all others dumps.

Within each member, control statements must begin in position one with each statement having the following syntax:

<title>command

title is optional and, if present, defines the report title, as it appears in the dump viewer when the report is displayed. title must be enclosed in less than and greater than signs (< >) and must start in position one.

Note: Reports having a title starting with an exclamation point (!) appear in the Favorites folder during dump viewing. For more information about the Favorites folder, see the chapter "Viewing Dumps from TSO/ISPF."

command refers to any CA SYSVIEW (or Server) command (or command list). These commands are described in the CA SYSVIEW Administration Guide.

Additionally, command can refer to any of the following CA SymDump System commands:

• #SUMMARY (Abend/Dump Summary)
• #CICSSUM (CICS Summary)
• #CICSKER (CICS Kernel Error Summary)
• #CICSAXS (CICS Task Storage Summary)
• #CICSTRC (CICS Trace)
• #CICSMSG (CICS Message Help)

These commands and the reports they produce are described in the appendix "CA SymDump System Reports."

An asterisk (*) in position one denotes a comment and is ignored during dump capture.