System Debug Reference Manual (32650-90888)

Chapter 4 85
System Debug Command Specifications :-Exit
B (break)
pin
|
@
The process identification number (PIN) of the process for which the
breakpoint is to be set. If omitted, the breakpoint is set for the current
process. The character "@" can be used to set a global breakpoint at which
all processes stop.
count Count
has a twofold meaning: it specifies a break every
n
th time the
breakpoint is encountered, and it is used to set permanent/temporary
breakpoints. If
count
is positive, the breakpoint is permanent. If
count
is
negative, the breakpoint is temporary and is deleted as soon as the process
breaks at it. For example, a
count
of 4 means break every fourth time the
breakpoint is encountered; a
count
of -4 means break on the fourth time,
and immediately delete the breakpoint. If
count
is omitted, +1 is used,
which breaks every time, permanently.
loud
Either LOUD or QUIET.IfQUIET is selected the debugger does not print out
a message when the breakpoint is hit. This is useful for performing a
command list a great number of times before stopping without being
inundated with screen after screen of breakpoint messages. These
keywords may be abbreviated as desired. The default is LOUD.
cmdlist
A single Debug command or a list of Debug commands that are executed
immediately when the breakpoint is encountered. Command lists for
breakpoints are limited to 80 characters. (If this is too few characters,
write a macro and have the command list invoke the macro.)
Cmdlist
has
the form:
CMD1
{ CMD1; CMD2; CMD3; ... }
NM Code Examples
$nmdebug > loadinfo
nm PROG GRADES.DEMO.TELESUP SID = $115
parm = #0 info = ""
nm GRP XL.DEMO.TELESUP SID = $118
nm USER XL.PUB.SYS SID = $f4
nm SYS NL.PUB.SYS SID = $a
cm SYS SL.PUB.SYS
Show the list of loaded files and the space into which they are loaded.
$nmdebug > b PROGRAM+270
added: NM [1] PROG 115.00006a8c PROGRAM+$270
Set a breakpoint at the procedure PROGRAM plus an offset of $270. This corresponds to a
statement in the outer block of the program being debugged. The name and offset were
determined by looking at the statement map produced by the Pascal compiler (all language
compilers produce similar maps). The expression evaluator found the procedure PROGRAM
in the program file.
$nmdebug > b 6a90
added: NM [2] PROG 115.00006a90 PROGRAM+$274
Break in the program file at offset $6a90. Remember that when only an offset is specified