/sys$common/syshlp/DBG$HELP.HLB  —  DEBUG  SET  MARGINS
    Specifies the leftmost and rightmost source-line character
    position at which to begin and end display of a source line.

                                   NOTE

       This command is not available in the VSI DECwindows Motif for
       OpenVMS user interface to the debugger.

    Format

      SET MARGINS  rm

                   lm:rm

                   lm:

                   :rm

1  –  Parameters

 lm

    The source-line character position at which to begin display of
    the line of source code (the left margin).

 rm

    The source-line character position at which to end display of the
    line of source code (the right margin).

2  –  Description

    The SET MARGINS command affects only the display of source lines.
    It does not affect the display of other debugger output, as from
    an EXAMINE command.

    The SET MARGINS command is useful for controlling the display
    of source code when, for example, the code is deeply indented
    or long lines wrap at the right margin. In such cases, you can
    set the left margin to eliminate indented space in the source
    display, and you can decrease the right margin setting (from its
    default value of 255) to truncate lines and prevent them from
    wrapping.

    The SET MARGINS command is useful mostly in line (noscreen) mode.
    In line mode, the SET MARGINS command affects the display of
    source lines resulting from a TYPE, EXAMINE/SOURCE, SEARCH, or
    STEP command, or when a breakpoint, tracepoint, or watchpoint is
    triggered.

    In screen mode, the SET MARGINS command has no effect on
    the display of source lines in a source display, such as the
    predefined display SRC. Therefore it does not affect the output
    of a TYPE or EXAMINE/SOURCE command, since that output is
    directed at a source display. The SET MARGINS command affects
    only the display of any source code that might appear in an
    output or DO display (for example, after a STEP command has
    been executed). However, such source-code display is normally
    suppressed if you enable screen mode by pressing PF1-PF3, because
    that sequence issues the SET STEP NOSOURCE command as well as SET
    MODE SCREEN to eliminate redundant source display.

    By default, the debugger displays a source line starting at
    character position 1 of the source line. This is actually
    character position 9 on your terminal screen. The first eight
    character positions on the screen are reserved for the line
    number and cannot be manipulated by the SET MARGINS command.

    If you specify a single number, the debugger sets the left margin
    to 1 and the right margin to the number specified.

    If you specify two numbers, separated with a colon, the debugger
    sets the left margin to the number on the left of the colon and
    the right margin to the number on the right.

    If you specify a single number followed by a colon, the debugger
    sets the left margin to that number and leaves the right margin
    unchanged.

    If you specify a colon followed by a single number, the debugger
    sets the right margin to that number and leaves the left margin
    unchanged.

    Related commands:

       SET STEP [NO]SOURCE
       SHOW MARGINS

3  –  Examples

    1.DBG> SHOW MARGINS
      left margin: 1 , right margin: 255
      DBG> TYPE 14
      module FORARRAY
         14:        DIMENSION IARRAY(4:5,5), VECTOR(10), I3D(3,3,4)
      DBG>

      This example displays the default margin settings for a line of
      source code (1 and 255).

    2.DBG> SET MARGINS 39
      DBG> SHOW MARGINS
      left margin: 1 , right margin: 39
      DBG> TYPE 14
      module FORARRAY
         14:        DIMENSION IARRAY(4:5,5), VECTOR
      DBG>

      This example shows how the display of a line of source code
      changes when you change the right margin setting from 255 to
      39.

    3.DBG> SET MARGINS 10:45
      DBG> SHOW MARGINS
      left margin: 10 , right margin: 45
      DBG> TYPE 14
      module FORARRAY
         14: IMENSION IARRAY(4:5,5), VECTOR(10),
      DBG>

      This example shows the display of the same line of source code
      after both margins are changed.

    4.DBG> SET MARGINS :100
      DBG> SHOW MARGINS
      left margin: 10 , right margin: 100
      DBG>

      This example shows how to change the right margin setting while
      retaining the previous left margin setting.

    5.DBG> SET MARGINS 5:
      DBG> SHOW MARGINS
      left margin: 5 , right margin: 100
      DBG>

      This example shows how to change the left margin setting while
      retaining the previous right margin setting.
Close Help