System Debug Windows [ System Debug Reference Manual ] MPE/iX 5.0 Documentation
System Debug Reference Manual
Chapter 6 System Debug Windows
System Debug offers a powerful and efficient set of screen-oriented
"windows," which allow dynamic visual monitoring of the program
environment.
The System Debug windows are initially disabled, but can be easily
toggled on (WON) and off (WOFF). Users can continue to use all normal
interactive commands while the windows are displayed.
The following windows are provided by System Debug:
* The register window (R) displays the current CM register values
* The general register window (GR) displays the current NM general
register values.
* The special register window (SR) displays the current values of a
collection of special NM registers (including the space registers).
* The program window (P) tracks the program counter in the current mode
(NM or CM). Current executing instructions are displayed and
breakpoints are flagged. For convenience, the program window for one
mode can also be accessed from the other mode with the fully
qualified name (CMP or NMP).
* The frame window (Q) highlights the most recent CM stack marker. By
default, this window displays addresses as unsigned DB-relative
values. The user may choose to have addresses displayed relative to
DB, Q, S, DL, or the DST base. Addresses may be displayed as signed
or unsigned values. For details on these options, see the QM
command. This window may also be aimed at any valid DST to which the
user has access.
* The stack window (S) tracks the current CM top of stack. By default,
this window displays addresses as unsigned DB relative values. The
user may choose to have addresses displayed relative to DB, Q, S, DL
the DST base. Addresses may be displayed as signed or unsigned
values. For details on these options, see the SM command. This
window may also be aimed at any valid DST to which the user has
access.
* A group window (G) is a special window within which the user can
custom-define individual user windows (UW). These user windows
(subwindows) can be "aimed" at parameters, variables, data blocks,
and so on. Up to three group windows can be defined.
* A virtual window (V) displays data at a native mode virtual address.
Up to eight virtual windows are available.
* The memory window (Z) displays data at a native mode real address.
* The ldev window (L) displays the contents of secondary storage at the
specified disk address expressed as a logical device (LDEV) and byte
offset.
* A text window (TX) displays information in a text file. Up to three
text windows are available.
* The command window provides space for the user to type interactive
commands.
Each mode (CM and NM) may have a different set of windows enabled. When
one switches from mode to mode, the windows change to reflect the current
mode. Note that there is only one set of windows; the user may easily
specify which windows are enabled in a given mode. This means that
virtual window #1 in CM is the same window as virtual window #1 in NM.
Each mode may have any combination of windows displayed together at one
time. The only restriction is the number of lines available on the
screen. There are 24 lines available for windows. The last two lines
are reserved for the command window (where commands are entered and
output is displayed). This leaves a maximum of 22 lines for additional
windows. Any lines not used by other windows are automatically assigned
to the command window. If an attempt is made to expand an existing
window, add a new window, or enable an existing window for which there
are insufficient free lines on the screen, System Debug will display an
error message.
MPE/iX 5.0 Documentation