:DEBUG command [ System Debug Reference Manual ] MPE/iX 5.0 Documentation
System Debug Reference Manual
:DEBUG command
PRIVILEGED MODE
Enters Debug from the CI. Syntax
:DEBUG [commands]
Parameters
commands A series of Debug commands to be executed before the
Debug prompt is displayed. The string may be up to 255
characters long. All text on the command line following
:DEBUG is passed unaltered to Debug. Note that the
commands should not be quoted.
Discussion
The :DEBUG command enters Debug directly from the session CI. Optional
Debug commands may be entered on the command line, and they will be
executed before the Debug prompt is displayed.
If the optional commands contain a Debug command that returns the user to
the CI, any further commands are left pending on Debug's command stack.
The next time Debug is entered, any pending commands are executed before
the Debug prompt is displayed. If no commands were specified, Debug
displays its prompt and waits for the user to enter interactive commands.
This command is ignored in a job.
Example
The example below calls Debug to produce a stack trace and return to the
CI.
:debug trace;c
DEBUG XL A.00.00
HPDEBUG Intrinsic at: a.006b4104 hxdebug+$130
PC=a.006b4104 hxdebug+$130
* 0) SP=40221c58 RP=a.006b8e7c exec_cmd+$73c
1) SP=40221ac8 RP=a.006ba41c try_exec_cmd+$ac
2) SP=40221a78 RP=a.006b8638 command_interpret+$274
3) SP=40221620 RP=a.006bae5c xeqcommand+$1d0
4) SP=40221210 RP=a.006b7604 ?xeqcommand+$8
export stub: 7d.000068dc main_ci+$94
5) SP=40221178 RP=7d.00007420 PROGRAM+$250
6) SP=40221130 RP=7d.00000000
(end of NM stack)
:
MPE/iX 5.0 Documentation