System Debug Reference Manual (32650-90888)
82 Chapter4
System Debug Command Speciļ¬cations :-Exit
B (break)
Limitations, Restrictions
none
B (break)
Debug only
Privileged Mode: BA, BAX, BS
Break. Sets a breakpoint.
Syntax
B
logaddr
[:
pin
|
@
] [
count
] [
loud
] [
cmdlist
] Program
BG
logaddr
[:
pin
|
@
] [
count
] [
loud
] [
cmdlist
] Group library
BP
logaddr
[:
pin
|
@
] [
count
] [
loud
] [
cmdlist
] Account library
BLG
logaddr
[:
pin
|
@
] [
count
] [
loud
] [
cmdlist
] Logon group lib
BLP
logaddr
[:
pin
|
@
] [
count
] [
loud
] [
cmdlist
] Logon account lib
BS
logaddr
[:
pin
|
@
] [
count
] [
loud
] [
cmdlist
] System library
BU
fname logaddr
[:
pin
|
@
] [
count
] [
loud
] [
cmdlist
] User library
BV
virtaddr
[:
pin
|
@
] [
count
] [
loud
] [
cmdlist
] Virtual address
BA
cmabsaddr
[:
pin
|
@
] [
count
] [
loud
] [
cmdlist
] Absolute CST
BAX
cmabsaddr
[:
pin
|
@
] [
count
] [
loud
] [
cmdlist
] Absolute CSTX
The various forms of the BREAK command are used to set process-local and global
(system-wide) breakpoints. Only users with privileged mode (PM) capability are allowed to
set global breakpoints. Users without PM capability may only specify PINs that are
descendant processes (any generation) of the current PIN.
Setting a breakpoint for another process is implemented such that it appears the target
process set the breakpoint itself. Therefore, when the target process encounters the
breakpoint, it enters Debug with its output directed to the LDEV associated with the
target process.
If a breakpoint is set in CM code that has been translated by the Object Code Translator
(OCT), Debug automatically sets a NM breakpoint in the closest previous corresponding
translated code node point. If more than one CM breakpoint is set within a given node,
only one NM breakpoint is set; however, a counter is incremented so the number of
corresponding CM breakpoints can be tracked. If a NM breakpoint is set in translated
code, no corresponding CM emulated breakpoint is set. Refer to appendix C for a
discussion of CM object code translation, node points, and breakpoints in translated CM
code.