Filter
Top Products
556 Chapter 7
Command Definitions S-SO
SETDUMP
SETDUMP
Arms the system debug facility for a process abort. (Native Mode)
Syntax
SETDUMP[ DB [ ,ST [ ,QS]]][;ASCII] [ ;DEBUG="commands"]
Parameters
DB This parameter is ignored.
ST This parameter is ignored.
QS This parameter is ignored.
ASCII This parameter is ignored.
"commands" A string of system debug commands surrounded by quotation marks. Refer
to the DEBUG command in this chapter.
Operation Notes
This command enables the stackdump facility for any process created later under the
current session or job. If the call is armed (enabled), and the process aborts, SETDUMP
executes the system debug commands given in the "commands" parameter.
If no commands are specified, a default command string is used to produce a stacktrace and
register dump.
If the process is interactive, it subsequently enters the system debugger to wait for further
commands. If it is not interactive, the process simply terminates instead of entering the
debugger.
Any combination of the four strings (DB, ST, QS, or ASCII) is parsed without error in
MPE/iX, but they have no effect on the functional behavior of the commands. The
"commands" string, preceded by the DEBUG keyword, is interpreted as a series of system
debug commands and is sent to the system debugger that way.
The "commands" parameter may contain a maximum of 255 characters.
NOTE The DB, ST, QS, and ASCII parameters are retained for compatibility reasons.
These parameters are ignored.
Use
This command may be issued from a session, job, program, or in BREAK. Pressing Break
has no effect on this command.