Tracepoint Set Command (PLBDBUG)

The Tracepoint Set command sets the given variable in the tracepoint table. Once set, the program execution will be interrupted and the debugger entered if the variable changes or when it is equivalent to the specified {value}. The format for the TP command is:

TP {DataLabel}[={value}]

Note the following:

1. The debugger stops at the line following the statement that caused the variable to changed or the variable was equivalent to {value}.

2. As many as five (5) tracepoints may be active at any given time.

3. The Trace Point operation can be used for PL/B variable types of DIM, FORM, and INTEGER only. For arrays, any element of the array may be used as the watch variable by giving the appropriate indices. The indices may be constants or numeric variables in the program. If the index is given as a numeric variable, its value is calculated at the time the TP command is given and that array element is the one that is used for subsequent checking.

4. A trace point window that shows the current variable value is presented at the top of the source window when trace points are currently active.

Examples:

TP S$CMDLIN

This command causes a debugger break when the S$CMDLIN variable changes.

TP S$CMDLIN="test"

This command causes a debugger break when the S$CMDLIN variable value is equal to "test".

See Also: PLBDBUG Commands, PLBDBUG