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
QS
ASCII
"
commands
"
This parameter is ignored.
This parameter is ignored.
This parameter is ignored.
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.
556 Chapter 7
Example
To arm the stackdump/debug facility, enter:
SETDUMP
Related Information
Commands
Manuals
DEBUG
,
RESETDUMP
System Debug Reference Manual
Command Definitions S-SO
SETDUMP
Chapter 7 557
