Download User Guide GUI

Visual Data ApS
Page 18
The Source Code window
This window displays the source code that is applicable to the dump. You can change the contents of this
window by selecting a different entry within the “Subroutine” drop-down menu of the Source Selection toolbar
or by dragging a source code block from the drawing window. (See The Drawing Window section)
The left side of this window has a colorcoded status bar indicating whether the
absolute and displayed source code is valid
for this dump. (See Validity color codes)
You can click on this status bar to receive a
description of the validity status.
If this bar is G
G
R
E
E
N
GR
RE
EE
EN
N, you are free to use the
complete set of Symbolic Debugging
functions within this window. If the bar is
not, you are responsible for determining
whether the absolute and source code
relates to the dump that you are viewing.
Symbolic Debugging
When the status bar is G
G
R
E
E
N
Y
E
L
L
O
W
GR
RE
EE
EN
N or Y
YE
EL
LL
LO
OW
W,,, you can click on any variable, define, or parameter within the
source code and its value will be displayed in a small box adjacent to the tag you click on. This will quickly
provide you with many answers related to the status of processing shortly before the dump occurred. These
values are presented in octal, decimal, ascii, and fieldata.
Pop-up Menu Functions
There are many helpful functions that you can perform via the Pop-up menu of the Source Code window. A
description of these follows:
When the status bar is G
G
R
E
E
N
GR
RE
EE
EN
N, you can Walk the program call stack (WalkBack). Here you can symbolically
follow each forward call taken by the processing. Walk this path forwards or backwards routine-by-routine from
the very first call from the ICP until you end in the aborting subroutine. (See The Program Call Stack
(WalkBack)).
When the status bar is G
G
R
E
E
N
GR
RE
EE
EN
N, you can Walk the jump stack for all contingency type aborts. Here you will be
able to view the contents of the entire Jump Stack symbolically – never having to look at a single octal address.
After selecting this option, step-by-step you will be moved between the lines of code that have executed just
prior to the abort occurring.
“Go to Last ACB call”, “Go to Abort address”, “Go to FCSS I/O error”, and “Go to X11 return address” all
provide quick ways of going directly to the source code line where an important event occurred related to this
dump. Again, you will be able to view this location symbolically without having to do any address manipulation.
Go to Address and Go to Line Number are quick ways for you to view source code at a particular location.
“Return to Caller” and “Go to Forward Call” allow you to move one step backwards or forwards in the
“Program Call Stack (WalkBack)” from the present location - enabling you to return to the calling routine or
move forward to the next forward call. (See The Program Call Stack (WalkBack)).
“Show MASM code” lets you view the actual MASM code that is generated by the compiler for the source code
you are viewing. By selecting this option, the window will expand into having each source line displayed with the