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

/POP

/NOPOP

/PUSH

/NOPUSH

/REFRESH

/REMOVE

/SIZE:n

DEBUG DISPLAY — MicroVMS 4.6

     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  debug  command
     list.

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

Additional information available:

ExamplesParametersQualifiers

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

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

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

     /CLEAR             Clear the display(s)

     /[NO]DYNAMIC               Automatically   adjust   the   display
     window

     /GENERATE          Regenerate an automatically generated display

     /HIDE              Hide a display behind all others

     /[NO]MARK_CHANGE   Highlight changes

     /[NO]POP           Pop a display to the front of all others

     /[NO]PUSH          Push a display behind all others

     /REFRESH           Refresh the entire screen

     /REMOVE            Remove a display

     /SIZE:n            Set the size of a display

/CLEAR

     Clear the entire contents of the specified screen displays.

/DYNAMIC

     Set this display to automatically adjust  its  window  dimensions
     proportionally  when  a  SET  TERMINAL  command  is  issued.   By
     default, all user-defined and  predefined  displays,  except  the
     register displays, adjust their dimensions automatically.

/GENERATE

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

/HIDE

     Hide 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

     Mark changed lines of a DO(debug-cmd-list) display 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

     Set  this  display  not  to  automatically  adjust   its   window
     dimensions  when  a  SET TERMINAL command is issued.  By default,
     only the register display maintains  its  window  dimensions  and
     location when the screen height or width are changed.

/NOMARK_CHANGE

     Do not mark changed lines of a DO(debug-cmd-list) display.   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.

/POP

     Pop 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.

/NOPOP

     Do 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.

/PUSH

     Push 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.

/NOPUSH

     Do 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.

/REFRESH

     Refresh the terminal screen.  If this qualifier  is  present,  no
     other parameters may be present on the DISPLAY command.

/REMOVE

     Mark the displays as being removed, meaning that they will not be
     shown  on  the  terminal  screen unless explicitly requested with
     later DISPLAY commands.  A removed display is not visible on  the
     screen, but the display and its contents are preserved.

/SIZE:n

     Change 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.

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