SETDUMP [ MPE/iX Intrinsics Reference Manual ] MPE/iX 5.0 Documentation
MPE/iX Intrinsics Reference Manual
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.
Related Information
Intrinsics HPRESETDUMP, HPSETDUMP, RESETDUMP, STACKDUMP
Commands SETDUMP
Manuals MPE/iX System Debug Reference Manual (32650-90013)
MPE/iX 5.0 Documentation