HP 3000 Manuals

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