SETDUMP [ MPE/iX Commands Reference Manual Volume I ] MPE/iX 5.0 Documentation
MPE/iX Commands Reference Manual Volume I
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.
Example
To arm the stackdump/debug facility, enter:
SETDUMP
Related Information
Commands DEBUG, RESETDUMP
Manuals System Debug Reference Manual (32650-90013)
MPE/iX 5.0 Documentation