Museum

Home

Lab Overview

Retrotechnology Articles

⇒ Online Manual

Media Vault

Software Library

Restoration Projects

Artifacts Sought

Related Articles

Examples

Parameters

Qualifiers

/CLEAR

/DYNAMIC

/GENERATE

/HIDE

/MARK_CHANGE

/NODYNAMIC

/NOMARK_CHANGE

/NOPOP

/NOPROCESS

/NOPUSH

/POP

/PROCESS

/PUSH

/REFRESH

/REMOVE

/SIZE:n

/SUFFIX

DEBUG DISPLAY — VMS C_3.0

     Displays a specified screen display or list of screen displays on
     the  terminal  screen.   With the proper qualifiers, this command
     can also be used to remove displays from the screen or to refresh
     the  entire  screen  contents.   Normally, the DISPLAY command is
     used to display a screen display on top  of  any  other  displays
     that occupy the same window on the terminal screen.  It makes the
     specified display fully visible.  However, this command can  also
     be  used  to  change  the  display's screen window, to change its
     maximum size in lines, or to change its kind or command list.

 Format:

      DISPLAY [/qualifier...] [disp-name [AT wspec] [dkind]
                              [, disp-name [AT wspec] [dkind]...]]

Additional information available:

ExamplesParametersQualifiers

Examples

     ! Put the source display at the top half and the output display
     ! at the bottom half of the screen.
     !
     DBG> DISPLAY SRC AT H1; DISPLAY OUT AT H2

     ! Put the source display about in the middle of the screen.
     ! Starting at line 4, 8 lines long and starting at column 20,
     ! 30 columns wide.
     !
     DBG> DISP SRC AT (4,8,20,30)

     ! Remove the instruction display.
     !
     DBG> DISP/REMOVE INST

     ! Refresh the screen.
     !
     DBG> DISP/REFRESH

     ! Make display OUT_X specific to the visible process (process 2)
     ! and put the display at window S4.
     !
     DBG_2> DISPLAY/PROCESS OUT_X AT S4

Parameters

 disp-name

     The name of the screen display to be displayed.

 wspec

     The name of the screen window at which  this  display  is  to  be
     positioned  if the position is being changed.  This may also be a
     window  specification  of  the  form   (start-line,   line-count,
     start-column,  column-count).  If wspec is omitted, the display's
     screen position is not changed.

 dkind

     The new display  kind,  if  the  kind  is  being  changed.   This
     parameter can have the same values as on the SET DISPLAY command:
     OUTPUT,    SOURCE,    SOURCE    (debug-cmd-list),    INSTRUCTION,
     INSTRUCTION(debug-cmd-list), DO (debug-cmd-list), or REGISTER.

Qualifiers

Additional information available:

/CLEAR/DYNAMIC/GENERATE/HIDE/MARK_CHANGE
/NODYNAMIC/NOMARK_CHANGE/NOPOP/NOPROCESS
/NOPUSH/POP/PROCESS/PUSH/REFRESH/REMOVE/SIZE:n
/SUFFIX

/CLEAR

     Clears the entire contents of the specified screen displays.

/DYNAMIC

     Specifies that the display is to automatically adjust its  window
     dimensions  proportionally  when  you change the screen height or
     width with a SET TERMINAL command.  This is the default  behavior
     for all displays.

/GENERATE

     Regenerates the contents of  the  specified  screen  displays  if
     those displays are automatically generated displays.

/HIDE

     Hides the specified screen displays under any other displays that
     occupy  the same region on the terminal screen.  The effect is to
     make visible any displays that were  occluded  by  the  specified
     displays.  This has the same effect as the /PUSH qualifier.

/MARK_CHANGE

     Specifies that any changed lines of a DO(debug-cmd-list)  display
     are  marked  each time the display is automatically updated.  The
     marking is done by highlighting each line of  the  display  which
     has  a  different  textual content this time compared to the last
     time the display was updated.  This qualifier is useful when  you
     want  changed variables in an automatically updated display to be
     highlighted on change.  This qualifier is not applicable to other
     kinds of displays.

/NODYNAMIC

     Specifies that a display  is  not  to  automatically  adjust  its
     window dimensions when you change the screen height or width with
     a SET TERMINAL command.

/NOMARK_CHANGE

     Specifies that changed lines of a DO(debug-cmd-list) display  are
     not  marked  when  the  display  is  automatically updated.  This
     qualifier cancels the effect of an earlier /MARK_CHANGE qualifier
     for  the specified displays.  This qualifier is not applicable to
     other kinds of displays.

/NOPOP

     Does not pop the specified screen displays to the  front  of  the
     other  displays.   This  qualifier preserves the pasting order of
     all the displays.  This  has  the  same  effect  as  the  /NOPUSH
     qualifier.

/NOPROCESS

     Note:   This  qualifier  applies  to  a  multiprocess   debugging
     configuration (when DBG$PROCESS has the value MULTIPROCESS).

     Causes the specified display to always  be  associated  with  the
     visible process, which may change during program execution.  This
     is the default behavior.

/NOPUSH

     Does not push or hide the specified  screen  displays  under  any
     other  displays.   This  qualifier preserves the pasting order of
     all the displays.   This  has  the  same  effect  as  the  /NOPOP
     qualifier.

/POP

     Pops the specified screen displays to  the  front  of  all  other
     displays  that  occupy  the  same  region on the terminal screen.
     This is the default action of the DISPLAY command.

/PROCESS[=(process-spec)]

     Note:   This  qualifier  applies  to  a  multiprocess   debugging
     configuration (when DBG$PROCESS has the value MULTIPROCESS).

     Causes the specified display to be process specific --  that  is,
     the  specified  display  is  associated  only  with  a particular
     process.   The  contents  of  a  process-specific   display   are
     generated  and  modified in the context of that process.  You can
     make any display process specific, except for the PROMPT display.

     /PROCESS=(process-spec)  causes  the  specified  display  to   be
     associated  with  the  specified  process.   You must include the
     parentheses.  Use any of the following process-spec forms:

     [%PROCESS_NAME] process-name    The VMS process name, if that
                                     name contains no spaces or
                                     lowercase characters[1].

     [%PROCESS_NAME] "process-name"  The VMS process name, if that
                                     name contains spaces or lowercase
                                     characters. You can also use
                                     apostrophes (') instead of
                                     quotation marks (").

     %PROCESS_PID process_id         The VMS process identification
                                     number (PID, a hexadecimal number).

     %PROCESS_NUMBER process-number  The number assigned to a process
     (or %PROC process-number)       when it comes under debugger control.
                                     Process numbers appear in a
                                     SHOW PROCESS display.

     process-group-name              A symbol defined with the
                                     DEFINE/PROCESS_GROUP command to
                                     represent a group of processes.

     %NEXT_PROCESS                   The next process in the debugger's
                                     circular process list after the
                                     visible process.

     %PREVIOUS_PROCESS               The previous process in the
                                     debugger's circular process list
                                     before the visible process.

     %VISIBLE_PROCESS                The process whose stack, register
                                     set, and images are the current
                                     context for looking up symbols,
                                     register values, routine calls,
                                     breakpoints, and so on.
     _______________________________________________________
     [1]The process name can include the asterisk wildcard
     character (*)

     /PROCESS causes the specified display to be associated  with  the
     process  that  was  the  visible process when the DISPLAY/PROCESS
     command was executed.   If  you  do  not  specify  /PROCESS,  the
     current  process-specific  behavior  (if  any)  of  the specified
     display remains unchanged.  See also /SUFFIX.

/PUSH

     Pushes the specified screen displays  under  any  other  displays
     that  occupy  the same region on the terminal screen.  The effect
     is to make  visible  any  displays  that  were  occluded  by  the
     specified  displays.   This  has  the  same  effect  as the /HIDE
     qualifier.

/REFRESH

     Refreshes the terminal screen.  If you specify this qualifier, do
     not specify command parameters.

/REMOVE

     Marks the specified display as being removed.  A removed  display
     does  not appear on the screen unless explicitly requested with a
     later DISPLAY command.  Although a removed display is not visible
     on the screen, the display and its contents are preserved.

/SIZE:n

     Changes the maximum size of the display to be n  lines  of  text.
     If more than n lines are written to the display, the oldest lines
     are lost as new lines are added.  If this qualifier  is  omitted,
     the maximum size is not changed.

/SUFFIX[=process-identifier-type]

     Note:   This  qualifier  applies  to  a  multiprocess   debugging
     configuration (when DBG$PROCESS has the value MULTIPROCESS).  Use
     this qualifier only directly after a display name.

     Appends a process-identifying suffix  to  a  display  name.   The
     suffix  denotes  the  visible  process.   This  qualifier is used
     primarily  in  command   procedures   when   specifying   display
     definitions   or  key  definitions  that  are  bound  to  display
     definitions.  Use any of  the  following  process-identifier-type
     keywords:

        PROCESS_NAME     The display-name suffix is the VMS process name.

        PROCESS_NUMBER   The display-name suffix is the process number
                         (as shown in a SHOW PROCESS display).

        PROCESS_PID      The display-name suffix is the VMS process
                         identification number (PID).

     If  you  specify  /SUFFIX  without  a  process-identifier-   type
     keyword,  the  process  identifier type used for the display-name
     suffix is, by default, the same  as  that  used  for  the  prompt
     suffix (see SET PROMPT/SUFFIX).  See also /[NO]PROCESS.

Typewritten Software • bear@typewritten.org • Edmonds, WA 98026