Working with Dumps › Dump/Trace Selection List › Symbolic Listings

Symbolic Listings

Multiple symbolic listings can exist for an abending program. It is important to use the symbolic listing that matches the program captured in the dump—get the correct symbolic listing.

• For COBOL and PL/I programs that are link‑edited immediately after the command‑level stub, CA SymDump for CICS automatically finds the matching symbolic listing, if one exists. CA SymDump for CICS searches through all of your symbolic files (defined in the IN25OPTS module) to find the program listing whose date and time match the date and time of the load module for which the dump was generated.
• For Assembler programs, and for those COBOL and PL/I programs for which CA SymDump for CICS cannot find a matching listing, CA SymDump for CICS displays the following Symbolic Version List.

  ‑‑‑‑‑‑‑‑‑‑‑‑‑ CA SymDump for CICS  V9.1   ‑ Symbolic Version List ‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑
   COMMAND ===>
   Program = ASMDEMO        Load Module  Date/Time = 00/00/0000 00:00:00           
      File ID    Date        Time    Language     Comments                        
    _ PROTSYM  03/01/2000  11.12.59  ASM        LATEST VERSION                    
    _ OLDSYM   11/12/1999  10.29.31  ASM                                          
  
  
          S ‑ Select which Symbolic file to use                                    
  ‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑
    PFKEYS:  1 Help      2           3 No file   4           5           6         
             7           8           9          10          11          12         
  

The Symbolic Version List lists all symbolic files containing listings for the program you are debugging.

You can select a list using the following procedure.

Follow these steps:

1. Type S to the left of the symbolic file containing the listing you want to use and press Enter. CA SymDump for CICS displays the Display Selection menu using the listing you identified when you examined the program listing online.
2. Press PF3, if none of the versions are correct. CA SymDump for CICS displays the Display Selection menu and informs you that symbolic information is not available for this program.

Note: CA SymDump for CICS displays the Symbolic Version List even if it finds only one symbolic listing. If you know the listing does not match your program version, you can debug without symbolics.

You can also recompile or reassemble the program with the appropriate post‑processor program to get an up‑to‑date symbolic listing before examining the dump.