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