NET/MASTER Management Services (MS) Command Reference Manual
DEBUG BREAKPOINT
NonStop NET/MASTER MS Commands
2–32 115412 Tandem Computers Incorporated
{ VAR | VBL }=
variable-name
specifies a variable name. NCL sets a breakpoint on access to a variable.
Note You must omit the leading ampersand (&) from the variable name.
You cannot place a breakpoint on a global variable, a system variable, or a
mapped data object (MDO) variable.
When a variable breakpoint is triggered, a message is sent and suspension
occurs at the next loss of control. NCL may send several breakpoint messages
relating to variable access before suspension occurs. Suspension normally
occurs on the next statement.
NCL issues a breakpoint message even if the variable is shared out of the
scope in which you set the breakpoint.
When NCL suspends execution after variable access, it displays a message
distinguishing between read, write, and delete operations. (A delete operation
occurs when a null value is assigned to a variable.) If a variable is dropped,
with the DROP verb, any breakpoint on a variable results in a debug message
and suspension. Assigning a null value to a variable does not drop the
variable.
TYPE
specifies the access method on which to set a breakpoint on the variable.
ACCESS
sets a breakpoint for either read access or write access on the variable.
READ
sets a breakpoint for read access only on the variable.
WRITE
sets a breakpoint for write access only on the variable. Write access
includes deleting the value of the variable.
Considerations
The default authority level of this command is 0.
You can enter this command from any NCL procedure, except the INIT NCL
procedure, by using either the CMD core statement or the INTCMD verb.
You can set more than one breakpoint in an NCL process at any of the specified
code positions. You can set only one breakpoint on a statement. You cannot set a
breakpoint on a line in a source file, that is, where a single statement continues
over more than one line using the statement continuation character (,).