System Debug Reference Manual (32650-90888)

Chapter 3 51

System Debug Interface Commands and Intrinsics

Debug Interfaces

3 System Debug Interface Commands

and Intrinsics

Debug may be invoked directly through an integrated set of commands and intrinsics. All

MPE V intrinsics are supported. In addition, several new intrinsics have been added to

enhance the functionality of MPE/iX and take advantage of the new debugger. The

commands and intrinsics allow you to enter the debugger from three different paths:

• Directly from a command interpreter (CI) command in a session.

• From a program through an intrinsic call.

• From the system during an abnormal process termination (a process abort).

Many of the commands and intrinsics that make up the system debugger interface also

allow you to specify an optional character string containing Debug commands . If supplied,

this string is passed to Debug for execution as part of debugger initialization.

The MPE/iX commands and intrinsics allow you to do the following:

• Enter Debug from a program or in a session directly from the CI.

• Generate stack trace upon demand from within a program.

• Execute a deﬁned series of Debug commands from a session, job, or program.

• Arm a call to Debug to take place during the process abort sequence.

• Disarm the call to Debug during the process abort sequence.

The Debug commands and intrinsics are described in the following sections. For additional

information, refer to the MPE/iX Commands Reference Manual and the MPE/iX

Intrinsics Reference Manual.

Debug Interfaces

Debug may be invoked directly or indirectly: directly from the CI of a session, or from an

intrinsic call within a program; indirectly through arming a call to Debug in the case of a

process abort.

The MPE/iX CI commands are identical to the MPE V commands, with the exception that

the user may specify an optional command string to be passed to Debug when it is invoked.

The following is a list of the available MPE/iX CI commands and their syntax:

DEBUG [

commands

]

SETDUMP [DB [,ST

[,QS[;ASCII[;DEBUG="

commands

RESETDUMP