DBG$HELP.HLB  —  DEBUG  DEPOSIT  Description
    You can use the DEPOSIT command to change the contents of any
    memory location or register that is accessible in your program.
    For high-level languages the command is used mostly to change the
    value of a variable (an integer, real, string, array, record, and
    so on).

    The DEPOSIT command is like an assignment statement in most
    programming languages. The value of the expression specified to
    the right of the equal sign is assigned to the variable or other
    location specified to the left of the equal sign. For Ada and
    Pascal, you can use ":=" instead of "=" in the command syntax.

    The debugger recognizes the compiler-generated types associated
    with symbolic address expressions (symbolic names declared in
    your program). Symbolic address expressions include the following
    entities:

    o  Variable names. When specifying a variable with the DEPOSIT
       command, use the same syntax that is used in the source code.

    o  Routine names, labels, and line numbers.

    In general, when you enter a DEPOSIT command, the debugger takes
    the following actions:

    o  It evaluates the address expression specified to the left of
       the equal sign, to yield a program location.

    o  If the program location has a symbolic name, the debugger
       associates the location with the symbol's compiler-generated
       type. If the location does not have a symbolic name (and,
       therefore, no associated compiler-generated type) the debugger
       associates the location with the type longword integer by
       default. This means that, by default, you can deposit integer
       values that do not exceed 4 bytes into these locations.

    o  It evaluates the language expression specified to the right of
       the equal sign, in the syntax of the current language and in
       the current radix, to yield a value. The current language is
       the language last established with the SET LANGUAGE command.
       By default, if you did not enter a SET LANGUAGE command, the
       current language is the language of the module containing the
       main program.

    o  It checks that the value and type of the language expression
       is consistent with the type of the address expression. If
       you try to deposit a value that is incompatible with the type
       of the address expression, the debugger issues a diagnostic
       message. If the value is compatible, the debugger deposits the
       value into the location denoted by the address expression.
Close Help