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

/NOPUSH

/POP

/PUSH

/REFRESH

/REMOVE

/SIZE:n

DEBUG DISPLAY — VMS 5.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

/CLEAR/DYNAMIC/GENERATE/HIDE/MARK_CHANGE
/NODYNAMIC/NOMARK_CHANGE/NOPOP/NOPUSH/POP
/PUSH/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 Clears the display(s)

     /[NO]DYNAMIC Automatically adjusts the display window

     /GENERATE Regenerates an automatically generated display

     /HIDE Hides a display behind all others

     /[NO]MARK_CHANGE Highlights changes

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

     /[NO]PUSH Pushes a display behind all others

     /REFRESH Refreshes the entire screen

     /REMOVE Removes a display

     /SIZE:n Sets the size of a display

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

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

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

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