MPE/iX Intrinsics Reference Manual (32650-90905)

604 Chapter10
Command Definitions (QUIT-ZSIZE)
SETDUMP
SETDUMP
NM and CM callable.
Arms a call to the system debugger from a process abort.
Syntax
I16V
SETDUMP(
flags );
Parameters
flags 16-bit unsigned integer (required)
This parameter is for backward compatibility with MPE V/E systems only.
Any value passed in this parameter is ignored, but a full stack trace is
always generated.
Operation Notes
If the process aborts, Debug is called with a command string that results in a full stack
trace of the CM and NM data stacks and a dump of the NM registers. This output is sent to
the standard list device.
If the process that aborts is being run from a job, the process terminates after the stack
trace and register dump are performed. If the process is being run from a session, after the
stack trace and register dump have completed, Debug stops to accept interactive
commands with I/O performed at the user terminal, provided the following conditions are
met:
• The abort did not occur while in system code.
• The process entered the abort code through a native mode interrupt (typically caused by
arithmetic and code-related traps).
When Debug accepts interactive input, the user is free to enter any Debug command. The
user may choose to resume the process or have it terminate.
If the abort is from a stack overflow, the command list is ignored, and a stack trace is sent
to the standard list device, and the process terminates. No interactive debugging is
allowed.
The HPSETDUMP intrinsic is a more flexible version of this intrinsic.
Condition Codes
CCE (2) Request granted.
CCG (0) Request denied. The abort stack analysis facility was already enabled
before the SETDUMP call.
CCL (1) Not returned.