DEBUG



DEBUG

     Instructs MPE/iX to enter the system debugger.  You must
     have privileged mode (PM) capability to use this command.

SYNTAX

     DEBUG [COMMANDS]


PARAMETERS

COMMANDS            A series of system debugger commands to be executed
                    before the debugger prompt is displayed. The string
                    may be up to 255 characters long.  No delimiters
                    or keywords needed to pass these commands
                    to the debugger.  If the CONTINUE command is not
                    part of the commands string, you are left in DEBUG
                    after the execution of the commands.


OPERATION

     The DEBUG command enters the system debugger.  An optional
     parameter, "commands", defines a string of system debugger
     commands that will be executed at the time that the debugger
     is invoked, before the debugger prompt is displayed.

     If the CONTINUE command is not part of the "commands" string, you
     will be left in debug after the execution of those commands.  The
     command:

     DEBUG BS R2;C

     leaves you in the debugger.

     If the first command in the string contains a command that returns
     the user to the command interpreter, that command will be executed.
     any remaining commands will be pushed onto a command stack. Another
     invocation of the DEBUG command will execute the commands saved on
     the stack.  If you invoke DEBUG X;Y;Z and the command X returns
     control to the CI, then DEBUG A;B;C will execute the commands
     A;B;C;Y;Z.

     This command may be issued from a session, program, or in
     break.  It may not be issued from a job.  Pressing [BREAK]
     has no effect on this command.


EXAMPLE(S)

     Produce a stack trace and return to the Command Interpreter.

     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)


Commands:   RESETDUMP, RUN, SETDUMP

Manuals :   System Debug Reference Manual (32650-90013)