This section discusses how to navigate through the dump index and the dump tree displays using the CA SymDump System viewer provided for TSO/ISPF.
This section contains the following topics:
If CA SymDump System was added to your TSO/ISPF applications menu, select the corresponding menu item to launch the viewer interface.
If the menu item was not added, execute member DVSAMPL in the CA SymDump System CLIST library (yourhlq.CCPICLS0) to launch the viewer interface, as shown in this example:
====> ex 'yourhlq.ccpicls0(dvsampl)'
The viewer interface begins with a display of the available dumps retrieved from your active dump index. If dump capture is initialized on the system you are viewing, then the active dump index name is retrieved from the resident options table (CADVTABL) that was loaded when dump capture was initialized. Otherwise the options table is loaded from disk, and the name of your dump index is retrieved from there.
Note: The number of index entries in the dump index menu always displays on the message line when you first enter the viewer.
The following is a dump index display:
CA SymDump System V9.1 --------- Dump Index ---------------------- Line 1 of 9 Command ===> Scroll ===> CSR CADV400I Dump index contains 9 entries Index Dsname: CAI.DUMPIX -------------------------------------------------------------------------- Lvl 1 Cmd System Asid JobName Program Offset Comp Date Time . XE44 0155 DAVSC01T TESTDRVR 0000D3C S=0C4 2009/07/12 10.25.57 . XAE1 01FA MIKED530 DFHSIP 00AC970 SM0103 2009/07/11 16.08.53 . XAE1 0045 MIKEDIVP CADVIVP 0000196 S=0C7 2009/07/11 16.01.01 . XE44 0155 DAVSC01T TESTDRVR 0000D3C S=0C4 2009/07/11 11.15.05 . XE44 0155 DAVSC01T TESTDRVR 0000D3C S=0C4 2009/07/08 14.20.19 . XAD1 00A1 MIKED410 DFHSIP 0028EFA MT0001 2009/07/08 07.32.55 . XAE1 0088 CARAC130 DFHSIP 00AB530 SM0102 2010/01/04 13.27.11 . XE44 007F DAVSC01A COB0C7 00002B4 S=0C7 2009/04/10 12.18.16 . XE44 009B CARAC120 COBDEMO 0001B8C AP0001 2009/03/31 16.40.52 -------------------------------------------------------------------------------- F1=HELP F2=SPLIT F3=END F4=DUMP F5=RFIND F6=MAP F7=UP F8=DOWN F9=SWAP F10=LEFT F11=RIGHT F12=RETRIEVE
The fields on the dump index are as follows:
Lets you enter commands in this field.
Displays the System ID of the system on which the dump was captured.
Displays the address space ID for the job that created the dump.
Displays the name of the job that created the dump.
Displays the name of the program in control at the time of the dump.
Displays the program offset of the last instruction executed.
Displays the completion code for the abended task.
Displays the date on which the dump was captured.
Displays the time at which the dump was captured.
Displays the ID of the owner of the job that created the dump.
Displays the ID that has locked the dump data set to prevent deletion.
Indicates whether or not the storage index has been built.
Displays the name of the reports data set for this dump capture.
Displays the name of the storage data set for this dump capture.
The level number shown in the upper right corner of the display indicates how many display levels are active. When you enter the END command, the display terminates and the active display at the previous level is redisplayed. The Dump Index display is always level one.
You can control the dump index display by entering line commands in the Cmd column at the left of the display and pressing ENTER. These line commands allow you to delete dumps, lock dumps to prevent deletions and unlock them to undo a lock. You can select a dump to view or you can view the electronic notepad provided with each dump.
Commands entered on the command line (or PF keys) allow you to scroll the display, find an entry, get help, sort the list, select a dump by data set name, or switch to a different dump index.
Use the following line commands in the Cmd fields at the left of the Dump Index display.
Deletes a dump and removes it from the dump index.
Locks a dump with your user ID to prevent deletion.
View or edit the Notepad for the selected dump.
Selects a dump for viewing.
Unlocks a previously locked dump.
Remove a dump index entry without deleting the data sets.
Use the following commands on the command line at the top of the Dump Index display. For detailed descriptions of these commands, see the appendix Dump Viewer Commands.
Scroll display to the bottom.
Request help for a CICS message or dump code.
Scroll display down.
Find a string in the output display.
Request help for a command, message or topic.
Scroll display to the left.
Edit the electronic notepad for a dump by data set name.
Display the options in effect.
Print all or part of the Dump Index display.
Repeat a previous find command.
Scroll display to the right.
Select a dump for viewing by data set name.
Select a different dump index file.
Sort the output display on any column header.
Request the current product status.
Scroll display to the top.
Scroll display up.
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.1 --------- 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.
Use the following commands on the command line at the top of the Dump Tree display. For detailed descriptions of these commands, see the appendix Dump Viewer Commands.
Deletes an item from the dump tree.
This applies only to items in the Viewed Storage folder.
Format (either MAP or Disassemble) the selected item.
Rename an item in the dump tree.
This applies only to items in the Viewed Storage folder.
Select an item for viewing.
Expand an item to expose its subordinate items in the tree.
Collapse an item to hide its subordinate items from view.
Toggle between expanded and collapsed.
Explode an item, that is, expand the item and its subordinate items recursively.
Use the following commands on the command line at the top of the Dump Tree display. For detailed descriptions of these commands, see "Dump Viewer Commands".
Scroll display to the bottom.
Request help for a CICS message or dump code.
Format the CICS auxiliary trace.
Format dump storage using the disassembler.
Scroll display down.
Delete a previously equated symbol.
Display dump storage.
Associate a symbol with a dump address.
Find a string in the output display.
Request help for a command, message or topic.
Scroll display to the left.
Display a list of available maps.
Load a member from the map library.
Map dump storage using a loaded map.
Edit an Electronic Notepad for the selected dump.
Display the options in effect.
Print all or part of the Dump Tree display.
Repeat previous find command.
Scroll display to the right.
Display the current product status.
Display all equated symbols.
Scroll display to the top.
Scroll display up.
Both the Favorites and Formatted Reports folders contain reports that were produced during the dump capture. In Formatted Reports, reports are grouped in subfolders by type based on the command used to generate each report. These groups, which are predetermined and cannot be altered, are described in the appendix Report Categories in this guide. Within each subfolder, reports are listed alphabetically by title.
The following display shows the report categories for a CICS dump:
CA SymDump System V9.1 --------- Dump Tree --- ------------------- Line 8 of 22 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 . | -Formatted Reports . + | | -CICS History . + | | -CICS Resources . + | | -CICS System Status . + | | -CICS Storage . + | | -CICS System Definitions . + | | -MVS Address Space . + | | -MVS Data sets . + | | -MVS Devices . + | | -MVS History . + | | -MVS Storage . + | | -MVS System Definitions . + | -Loaded Programs . | -Viewed Storage Areas . + | -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
Use either the + or / line commands to expand the subfolders, thereby displaying the list of reports in that category as shown next:
CA SymDump System V9.1 --------- Dump Tree --- ------------------- Line 8 of 22 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 . | Formatted Reports . + | | CICS History . + | | CICS Resources . + | | CICS System Status . + | | CICS Storage . + | | CICS System Definitions . - | | MVS Address Space . | | | Abend Summary . | | | Allocated Data sets . | | | Allocated Data sets . | | | Enqueues . | | | Job Output . | | | Loaded Modules . | | | Symbols . | | | Task Library . | | | Task Summary . | | | Timers . + | | MVS History . + | | MVS System Definitions --------------------------------------------------------------------------------
Select a report for display by placing an S in the Cmd column.
The Abend Summary report in the MVS Address Space folder contains a brief summary of the abend or dump, including the PSW and registers at the time of the error. For most batch abends or dumps, this report provides a good starting point, because it provides the basic information needed to start diagnosing the problem.
The following is an Abend Summary report:
CA SymDump System V9.1 --------- Abend Summary --- --------------- Line 1 of 19 Command ===> Scroll ===> CSR -------------------------------------------------------------------------------- Job: MIKED530 System: XAE1 Asid: 01FA ------------------------------------------------------------------------- Lvl 3 Abend Summary for SM0103 DFHSM0103 A04IC9N6 A storage violation (code X'0932') has been detected by the PIDS/565501800 LVLS/530 MS/DFHSM0103 RIDS/DFHSMCK PTFS/ESA530 PRCS/00000932 PSW at time of error: 078D2000 95DEF5F0 DFHSIP +AC970 TCB address: 007D0598 Registers at time of error: Reg 0 = 000000B8 PSA+B8 Reg 8 = 15EB67D8 E PVT Reg 1 = 16A42680 E PVT Reg 9 = 16A4270C E PVT Reg 2 = 15EB67D8 E PVT Reg 10 = 16A4270C E PVT Reg 3 = 95DEDDA8 DFHSIP+EDDA8 Reg 11 = 16A41D67 E PVT Reg 4 = 16A42580 E PVT Reg 12 = 0005C680 PVT Reg 5 = 15DEEDA7 DFHSIP+EEDA7 Reg 13 = 16A42580 E PVT Reg 6 = 15DEFDA6 DFHSIP+EFDA6 Reg 14 = 007E1540 JSTCB 2F8 Reg 7 = 16A419E4 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
For CICS dumps, a summary of the CICS environment is also provided in the CICS Summary report, located in the CICS System Status folder.
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 1619B0C0 965C8A1E . COPFL at 0004D648 for 0000588 bytes: 00000000 00000000 16294A00 00000000 . SIT at 95EC16B0 for 0000850 bytes: E702E753 00000000 08500400 00000000 X CWA at 000C1000 for 0000400 bytes: 00000000 00000000 00000000 00000000 . TCT at 00051D80 for 0000600 bytes: 0006B73C 0006B810 00051D8C 8004DE20 . Current TCA at 0005C680 for task #0037 (STGV). **** Active Task Summary **** --------------------------------------------------- | Task #0037 Tran STGV Term G001 User CICSUSER | | Date 07/11/2009 at 16.08.53 | --------------------------------------------------- F1=HELP F2=SPLIT F3=END F4=DUMP F5=RFIND F6=MAP F7=UP F8=DOWN F9=SWAP F10=LEFT F11=RIGHT F12=RETRIEVE
Also available in the CICS System Status folder for CICS dumps is the CICS Message Help report, which documents the reason for the dump.
CA SymDump System V9.1 --------‑ CICS Message Help --------------- Line 1 of 43 Command ===> Scroll ===> CSR -------------------------------------------------------------------------------- CICS Message Help for DFHSM0103 -------------------------------------------------------------------------- Lvl 3 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
While viewing any report, you can enter other dump viewer commands (see "Dump Viewer Commands") to view storage, add data to your keep window, update your electronic notepad, and so on. These commands create a new display level, leaving the report display active but not visible. When you end the new display level, you are returned to the report display.
Ending the report display (using the END command or PF key) returns you to the dump tree display.
The Loaded Programs folder appears next in the dump tree. This folder contains an entry for each load module found in the captured dump.
CA SymDump System V9.1 --------- Dump Tree --------------------- Line 9 of 112 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 . | Loaded Programs . 00A92FA8 | | CADDSPAI . 00B63670 | | CADSSVC . 0A771000 | | CAIRIMC . 00B42178 | | CAIXL232 . 009D7368 | | CAIXL722 . 00B1D4A0 | | CAJENJE0 . 0A2C3FF0 | | DFSRRC00 . 000063AF | | DRIVER1 . 000236A0 | | IEFIIC . 00C2C328 | | IEFSMFIE . 00C24388 | | IEFUTL F1=HELP F2=SPLIT F3=END F4=DUMP F5=RFIND F6=MAP F7=UP F8=DOWN F9=SWAP F10=LEFT F11=RIGHT F12=RETRIEVE
The programs are listed alphabetically by module name. The Address column contains the entry point address of the loaded program. You can view any program using a storage dump format, or format any program using the built‑in disassembler.
Enter an S in the Cmd column next to any program entry to select the entry you want to view in dump format. This invokes the DUMP command for the entry point address.
The following is a dump view of a loaded program:
CA SymDump System V9.1 --------- Dump --- ------------------------ Line 1 of 96 Command ===> Scroll ===> CSR -------------------------------------------------------------------------------- Jobname MIKED530 System XAE1 Asid 01FA Userid MIKED Start 00031020 Symbol CEECCICS -------------------------------------------------------------------------- Lvl 3 Address Offset +0 +4 +8 +C * * 00031020 +0000000 47F0F014 00C3C5C5 00000000 00000928 *.00..CEE........* 00031030 +0000010 47F0F001 90ECD00C 18BF41A0 BFFF4190 *.00...}.........* 00031040 +0000020 AFFF1851 58405000 58804000 41400021 *..... &... .. ..* 00031050 +0000030 19844780 B4884140 00201984 4780B42E *.d...h. ...d....* 00031060 +0000040 4140001E 19844780 B3A64140 001F1984 *. ...d...w. ...d* 00031070 +0000050 4780B3EA 41400022 19844780 B5A84140 *..... ...d...y. * 00031080 +0000060 00141984 4780B2AE 41400015 19844780 *...d..... ...d..* 00031090 +0000070 B3584140 00461984 4780B520 4140003C *... ...d..... ..* 000310A0 +0000080 19844780 B4CC4140 00321984 4780B26A *.d..... ...d...¦* 000310B0 +0000090 4140000A 19844780 B0C64140 000B1984 *. ...d...F. ...d* 000310C0 +00000A0 4780B1E4 41400050 19844780 B5645880 *...U. .&.d......* 000310D0 +00000B0 500441F0 0010D203 8000B8A8 58ED000C *&..0..K....y....* 000310E0 +00000C0 980CD014 07FE5840 500C50D0 40045880 *q.}.... &.&} ...* 000310F0 +00000D0 001058E0 800018D4 5840E004 58804144 *...\...M. \.....* 00031100 +00000E0 12884770 B11658E0 800012EE 4780B116 *.h.....\........* F1=HELP F2=SPLIT F3=END F4=DUMP F5=RFIND F6=MAP F7=UP F8=DOWN F9=SWAP F10=LEFT F11=RIGHT F12=RETRIEVE
Place an F in the Cmd column next to any program entry to produce a formatted display of that program using the built‑in disassembler.
The following is a formatted view of a loaded program:
CA SymDump System V9.1 --------- Disassem ---------------------- Line 1 of 427 Command ===> Scroll ===> CSR -------------------------------------------------------------------------------- Jobname MIKED530 System XAE1 Asid 01FA Userid MIKED Start 00031020 Symbol CEECCICS -------------------------------------------------------------------------- Lvl 3 Address Offset Label Opcod Operands Hex 00031020 +0000000 B 20(,R15) 47F0 F014 00031024 +0000004 DS XL12 00C3C5C500000000 0003102C +000000C 00000928 00031030 +0000010 B 1(,R15) 47F0 F001 00031034 +0000014 STM R14,R12,12(R13) 90EC D00C 00031038 +0000018 LR R11,R15 18BF 0003103A +000001A LA R10,4095(,R11) 41A0 BFFF 0003103E +000001E LA R9,4095(,R10) 4190 AFFF 00031042 +0000022 LR R5,R1 1851 00031044 +0000024 L R4,0(,R5) 5840 5000 00031048 +0000028 L R8,0(,R4) 5880 4000 0003104C +000002C LA R4,33 4140 0021 00031050 +0000030 CR R8,R4 1984 00031052 +0000032 BE 1160(,R11) 4780 B488 00031056 +0000036 LA R4,32 4140 0020 F1=HELP F2=SPLIT F3=END F4=DUMP F5=RFIND F6=MAP F7=UP F8=DOWN F9=SWAP F10=LEFT F11=RIGHT F12=RETRIEVE
While viewing program storage, you can enter other dump viewer commands (see "Dump Viewer Commands") to view other storage, locate data in core, add data to your keep window, update your electronic notepad, and so on. These commands create a new display level, leaving the program display active but not visible. Ending the new display level returns you to the program display.
Ending the program display (using the END command or PF key) returns you to the dump tree display.
The Viewed Storage folder is next in the dump tree. Initially, this folder contains no data. Entries are added after executing one of the following commands:
An entry is only added to the Viewed Storage folder when the storage address does not correspond to an existing item in the dump tree, including:
The purpose of the Viewed Storage folder is to allow easy recall of previously viewed dump storage, even across dump viewing sessions.
The following is an expanded dump tree showing viewed storage:
CA SymDump System V9.1--------- Dump Tree ---------------------- Line 1 of 10 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 . + | Formatted Reports . + | Loaded Programs . | Viewed Storage Areas . 16A42680 | | R1 . 15D42E0C | | DFHSIP+18C . 000470D4 | | EIB+4 . + | 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
New storage entries are added to the top of the storage list so that they can be retrieved more easily. The Address field contains the address of the storage, and the Description field contains a comment that describes the storage.
If the storage location can be mapped to an offset within a known program, control block, or user‑defined equate, the description field provides that entity name and offset.
If you prefer to enter your own description for a viewed storage item, enter an R in the Cmd column next to the storage entry in the dump tree. You are prompted for a new name, up to 32 characters, to describe that storage. Your new name replaces the existing description in the dump tree and is saved with that storage item in your profile.
The following screen shows a prompt for a rename:
CA SymDump System V9.1 --------- Dump Tree --------------------------- 1 of 10 Command ===> Scroll ===> CSR -------------------------------------------------------------------------------- System XAE1 +----------------------------------------+ MIKED JobName MIKED53 | | 16.08.53 Program DFHSIP | Enter a new name for this address: | SM0103 ---------------- | | ------------- Lvl 2 Cmd Address | ===> R1 | . | | . + +----------------------------------------+ . + | Formatted Reports . + | Loaded Programs . | Viewed Storage Areas R 16A42680 | | R1 . 15D42E0C | | DFHSIP+18C . 000470D4 | | EIB+4 . + | 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
To view any storage item in the Viewed Storage folder, enter either S (for standard dump format) or F (to format using the mapper or built‑in disassembler) in the Cmd column.
While viewing storage, you can enter other dump viewer commands to view other storage, locate data in-core, add data to your keep window, and update your electronic notepad. These commands will create a new display level, leaving the original storage display active but not visible. Ending the new display level returns you to the original storage display.
Note: For more information about the dump viewer commands, see "Dump Viewer Commands."
Ending the storage display (using the END command or PF key) returns you to the dump tree display.
The control blocks are at the end of the dump tree. There may be two separate control block folders in the dump tree, one for OS Control Blocks and the other for CICS Control Blocks.
The OS Control Block folder is built dynamically when the dump is selected for viewing. It contains many key OS control blocks that you might need to reference during your dump viewing session.
The control blocks in this folder are displayed in their own hierarchical tree structure, which shows the parent‑child relationship between control blocks and identifies control block chains.
The following screen shows expanded OS Control Blocks:
CA SymDump System V9.1 --------- Dump Tree --------------------- Line 9 of 699 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 . | OS Control Blocks . 00FA9D00 | | -ASCB . 00FAAFE0 | | -ASVT . 007FDE90 | | -ASXB . 00FCA2C0 | | -CVT . 0201D230 | | -GDA . 00FD2130 | | -IOCOM . 00FCAA38 | | -JESCT . 007FDD14 | | -JSCB . 00F8B5B8 | | -LCCA . 7FF16EA0 - | | -LDA . 00AFA008 | | -LPAQ Chain . 00AFA008 | | | -CDE Program=RTBETSMM . 009CDA08 | | | -CDE Program=IGGPOST0 F1=HELP F2=SPLIT F3=END F4=DUMP F5=RFIND F6=MAP F7=UP F8=DOWN F9=SWAP F10=LEFT F11=RIGHT F12=RETRIEVE
The Address column lists the base address for the control block. The Description field provides the name of the control block and possible additional information to help identify the structure.
Each control block is automatically associated with a map name that is used by default to map the structure. OS control block maps are provided with the standard installation and are loaded automatically when a dump is selected for viewing.
The CICS Control Block folder is also built dynamically when a CICS dump is selected for viewing. It contains many key CICS control blocks that you may need to reference during your dump viewing session.
The CICS control blocks identified during the dump load is dependent on the reports generated at dump capture time. Many of the CICS control blocks are identified by post‑processing the formatted reports to consolidate the control block addresses in a single place.
CICS control blocks are categorized in subfolders as shown next:
CA SymDump System V9.1 --------- Dump Tree ----------------------- Line 1 of 96 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 . + | Formatted Reports . + | Loaded Programs . + | Viewed Storage Areas . + | Control Blocks . | CICS Control Blocks . + | | CICS System Areas . + | | Directory Elements . + | | Domain Anchors . + | | Files . + | | Programs . + | | Task Areas . + | | Transactions . + | | Transient Data Queues F1=HELP F2=SPLIT F3=END F4=DUMP F5=RFIND F6=MAP F7=UP F8=DOWN F9=SWAP F10=LEFT F11=RIGHT F12=RETRIEVE
Expand any of these subfolders to display the list of control blocks:
CA SymDump System V9.1 --------- Dump Tree ----------------------- Line 1 of 96 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 . + | | CICS System Areas . + | | Directory Elements . + | | Domain Anchors . + | | Files . | | Kernel Errors . 0C032D30 | | | KERR=0C7/AKEA Module=STGVIOLA+01A6 . 0C032ED8 | | | KERR= /ASRA Module=DFHSRP+3E12 . 0C033080 | | | KERR=0C7/AKEA Module=DFHAPLI1+FFFF . 0C033228 | | | KERR= /???? Module=DFHEPC+0596 . 0C0333D0 | | | KERR= /???? Module=DFHEPC+0596 . 0C033578 | | | KERR= /???? Module=DFHEPC+0596 . + | | Programs . + | | Transactions . + | | Transient Data Queues F1=HELP F2=SPLIT F3=END F4=DUMP F5=RFIND F6=MAP F7=UP F8=DOWN F9=SWAP F10=LEFT F11=RIGHT F12=RETRIEVE
The Address column lists the base address for the control block. The Description field provides the name of the control block and possible additional information to help identify the structure.
Each control block is automatically associated with a map name that is used by default to map the structure. CICS control block maps are provided with the standard installation for all of the supported CICS releases. CICS maps are loaded automatically when a CICS dump is selected for viewing.
Both OS and CICS control blocks are displayed the same way, using either the F line command to format the storage with labels or the S line command for a standard dump display.
All control blocks identified in the dump tree are also auto‑mapped which allows the storage area to be mapped automatically using the MAP command without specifying a map name. For more information about automatic control block mapping, see "Advanced Techniques".
To format a control block using its predefined map, enter an F in the Cmd column next to that control block.
The following screen shows a formatted control block:
CA SymDump System V9.1 --------- Map --------------------------- Line 1 of 222 Command ===> Scroll ===> CSR -------------------------------------------------------------------------------- Jobname MIKED530 System XAE1 Asid 01FA Userid MIKED Start 00FA9D00 Symbol ASCB -------------------------------------------------------------------------- Lvl 3 Address Offset Label Opcod Operands Hex Char 00FA9D00 +0000000 ASCB DSECT 0XL384 00FA9D00 +0000000 ASCBEGIN DS 0D 00FA9D00 +0000000 ASCBASCB DC CL4'ASCB' C1E2C3C2 ASCB 00FA9D04 +0000004 ASCBFWDP DS A 00FA9B80 .... 00FA9D08 +0000008 ASCBBWDP DS A 00FA9E80 .... 00FA9D0C +000000C ASCBLTCS DC A(0) 00000000 .... 00FA9D10 +0000010 ASCBSUPC DS 0D 00FA9D10 +0000010 ASCBSVRB DS A 007FD5A0 ."N. 00FA9D14 +0000014 ASCBSYNC DC F'81070' 00013CAE .... 00FA9D18 +0000018 ASCBIOSP DC A(0) 00000000 .... 00FA9D1C +000001C ASCBWQLK DS 0XL4 00FA9D1C +000001C ASCBR01C DC XL2'0000' 0000 .. 00FA9D1E +000001E ASCBWQID DC H'0' 0000 .. 00FA9D20 +0000020 ASCBSAWQ DS A 1171B088 ...h ASCBURRQ EQU X'80' F1=HELP F2=SPLIT F3=END F4=DUMP F5=RFIND F6=MAP F7=UP F8=DOWN F9=SWAP F10=LEFT F11=RIGHT F12=RETRIEVE
The formatted display shows the control block with all of its individual fields separated.
You can display a control block using a standard dump view by placing an S in the Cmd column next to the control block item.
The following screen shows an unformatted control block:
CA SymDump System V9.1 --------- Dump ---------------------------- Line 1 of 96 Command ===> Scroll ===> CSR -------------------------------------------------------------------------------- Jobname MIKED530 System XAE1 Asid 01FA Userid MIKED Start 00FA9D00 Symbol ASCB -------------------------------------------------------------------------- Lvl 3 Address Offset +0 +4 +8 +C * * 00FA9D00 +0000000 C1E2C3C2 00FA9B80 00FA9E80 00000000 *ASCB............* 00FA9D10 +0000010 007FD5A0 00013CAE 00000000 00000000 *."N.............* 00FA9D20 +0000020 1171B088 00050000 000300FF 00000000 *...h............* 00FA9D30 +0000030 7FF16EA0 C0000000 15C3F100 00000000 *"1>.{....C1.....* 00FA9D40 +0000040 000000C2 0D1B1F40 B7E95C9A 65DE9781 *...B... .Z*...pa* 00FA9D50 +0000050 000141DE 807FDC88 B7E35351 00000000 *.....".h.T......* 00FA9D60 +0000060 007FFE88 FFFF0100 00000000 007FDE90 *.".h........."..* 00FA9D70 +0000070 D9B900C0 00000010 1194E1F0 007FE0A8 *R..{.....m~0."\y* 00FA9D80 +0000080 00000042 1171B088 00000000 40000000 *.......h.... ...* 00FA9D90 +0000090 02716180 026FEA08 00000300 00000000 *../..?..........* 00FA9DA0 +00000A0 00000000 00000000 00000000 00000000 *................* 00FA9DB0 +00000B0 00FA113C 00000000 00000000 00000000 *................* 00FA9DC0 +00000C0 00000007 0000141D 000000E7 1BD26980 *...........X.K..* 00FA9DD0 +00000D0 00000000 00000000 00000000 00000000 *................* 00FA9DE0 +00000E0 007FE950 FFFFFFFF 00000000 00000000 *."Z&............* F1=HELP F2=SPLIT F3=END F4=DUMP F5=RFIND F6=MAP F7=UP F8=DOWN F9=SWAP F10=LEFT F11=RIGHT F12=RETRIEVE
While viewing a control block, you can enter other dump viewer commands (see "Dump Viewer Commands") to view other storage, locate data in core, add data to your keep window, update your electronic notepad, and so on. These commands create a new display level, leaving the control block display active but not visible. Ending the new display level returns you to the control block display.
Ending the control block display (using the END command or PF key) returns you to the dump tree display.
Each individual user of the dump viewer on TSO/ISPF gets a unique profile member in the ISPF profile data set. The profile member contains general options for the user, such as PF key settings. The profile member also contains up to twenty entries (called slots) used to store state information about dump data sets that were viewed. Each slot is associated with a dump by the name of the reports data set.
When a user selects a dump data set for viewing for the first time, a new slot is allocated for that dump data set in the user's profile. Each user can keep profile information for up to 20 dumps concurrently. If all of the slots are used, the one with the oldest date of last reference is recycled.
A dump slot in the profile contains information required to restore the viewing environment to its most recent state. The state information includes:
When a viewing session is ended, information is stored in the appropriate profile slot. When the same dump is selected again for viewing, the last viewing state is restored automatically.
The profile member also contains up to 20 slots for electronic notepad data. These slots are separate from the state information but are managed in exactly the same way. Each individual user can keep notes for up to 20 dumps, and the slots are associated with the dump by the dsname of the reports data set.
Both state data and notes data for a dump are limited to a maximum length of 32 KB. Once this limit is reached, no additional data can be stored in the profile slot.
|
Copyright © 2014 CA Technologies.
All rights reserved.
|
|