/sys$common/syshlp/TPUHELP.HLB  —  SET(DEBUG)
  SET(DEBUG)

     Controls the behavior of a debugger program.  Using SET(DEBUG), you can
     select a user-written debugger, set and clear breakpoints, enable and
     disable single-step execution, and deposit values into global
     variables, local variables, and parameters.

  Syntax

     SET (DEBUG [, keyword1] [,string1 | ,range | ,buffer | ,program | keyword2])

                                          OR

     SET (DEBUG, string2, value)

  Parameters

     keyword1             The valid keywords are ON, OFF, and PROGRAM.

                          ON - Causes a debugger to do single-step
                          debugging.  Each time the line number in a TPU
                          program changes, the debugger is invoked.

                          OFF - disables single-step debugging.  This is the
                          default value.

                          PROGRAM - indicates that a user-written debugger
                          program will be used.

     string1              A string or an expression evaluating to a string
                          that is the name of a program.  If you use this
                          built-in in the form
                          SET (DEBUG, ON, 'procedure_name'), the debugger is
                          invoked each time the procedure 'procedure_name'
                          is called.  If you use this built-in in the form
                          SET (DEBUG, OFF, 'procedure_name'), the debugger
                          removes the breakpoint that was set for the
                          procedure 'procedure_name'.  If you use the
                          built-in in the form
                          SET (DEBUG, PROGRAM, 'procedure_name'), the
                          user-written debugger called 'procedure_name' is
                          designated as the debugger for the current
                          debugging session.

     range                An expression evaluating to a range containing a
                          program or procedure.  If you use this built-in in
                          the form SET (DEBUG, ON, 'range_name'), the
                          debugger is invoked each time the procedure
                          'range_name' is called.  If you use this built-in
                          in the form SET (DEBUG, OFF, 'range_name'), the
                          debugger removes the breakpoint that was set for
                          the procedure 'range_name'.  If you use the
                          built-in in the form
                          SET (DEBUG, PROGRAM, 'range_name'), the
                          user-written debugger called 'range_name' is
                          designated as the debugger for the current
                          debugging session.

     buffer               An expression evaluating to a buffer containing a
                          program or procedure.  If you use this built-in in
                          the form SET (DEBUG, ON, 'buffer_name'), the
                          debugger is invoked each time the procedure
                          'buffer_name' is called.  If you use this built-in
                          in the form SET (DEBUG, OFF, 'buffer_name'), the
                          debugger removes the breakpoint that was set for
                          the procedure 'buffer_name'.  If you use the
                          built-in in the form
                          SET (DEBUG, PROGRAM, 'buffer_name'), the
                          user-written debugger called 'buffer_name' is
                          designated as the debugger for the current
                          debugging session.

     program              An expression evaluating to a program.  If you use
                          this built-in in the form
                          SET (DEBUG, ON, 'program_name'), the debugger is
                          invoked each time the program 'program_name' is
                          called.  If you use this built-in in the form
                          SET (DEBUG, OFF, 'program_name'), the debugger
                          removes the breakpoint that was set for the
                          program 'program_name'.  If you use the built-in
                          in the form SET (DEBUG, PROGRAM, 'program_name'),
                          the user-written debugger called 'program_name' is
                          designated as the debugger for the current
                          debugging session.

     keyword2             The only valid keyword is ALL.  You can only use
                          this keyword if you used OFF in place of keyword
                          1.  The statement SET (DEBUG, OFF, ALL) clears all
                          procedures of breakpoints.

     string2              An expression evaluating to a string that is the
                          name of a variable or parameter.

     value                A value of any data type in TPU.  You can only
                          use this parameter if you specified a string2 as
                          the first parameter.  The statement
                          SET (DEBUG, string2, value) deposits the value
                          into the global variable, local variable, or
                          parameter named by string2.
Close Help