Library /sys$common/syshlp/dbg$help.hlb DEBUG, SET, MODULE, Description  *Conan The Librarian (sorry for the slow response - running on an old VAX)

    Symbol records must be present in the RST if the debugger is to
    recognize and properly interpret the symbols declared in your
    program. The process by which the symbol records of a module are
    loaded into the RST is called setting a module.

    At debugger startup, the debugger sets the module containing
    the transfer address (the main program). By default, dynamic
    mode is enabled (SET MODE DYNAMIC). Therefore, the debugger sets
    modules (and images) automatically as the program executes so
    that you can reference symbols as you need them. Specifically,
    whenever execution is suspended, the debugger sets the module
    and image containing the routine in which execution is suspended.
    In the case of Ada programs, as a module is set dynamically, its
    related modules are also set automatically, by default, to make
    the appropriate symbols accessible (visible).

    Dynamic mode makes accessible most of the symbols you might need
    to reference. If you need to reference a symbol in a module that
    is not already set, proceed as follows:

    o  If the module is in the current image, use the SET MODULE
       command to set the module where the symbol is defined.

    o  If the module is in another image, use the SET IMAGE command
       to make that image the current image, then use the SET MODULE
       command to set the module where the symbol is defined.

    If dynamic mode is disabled (SET MODE NODYNAMIC), only the module
    containing the transfer address is set automatically. You must
    set any other modules explicitly.

    If you use the SET IMAGE command to establish a new current
    image, all modules previously set remain set. However, only the
    symbols in the set modules of the current image are accessible.
    Symbols in the set modules of other images are temporarily
    inaccessible.

    When dynamic mode is enabled, memory is allocated automatically
    to accommodate the increasing size of the RST. If dynamic mode
    is disabled, the debugger automatically allocates more memory as
    needed when you set a module or an image. Whether dynamic mode
    is enabled or disabled, if performance becomes a problem as more
    modules are set, use the CANCEL MODULE command to reduce the
    number of set modules.

    If a parameter in a SET SCOPE command designates a program
    location in a module that is not already set, the SET SCOPE
    command sets that module.

    For information specific to Ada programs, type Help
    Language_Support Ada.

    Related commands:

       (SET,SHOW,CANCEL) IMAGE
       SET MODE [NO]DYNAMIC
       (SHOW,CANCEL) MODULE