226 Chapter 3
Command Definitions C-E
ERRDUMP
ERRDUMP
Allows a user to dump either the process or system error stack to a specified depth. (Native
Mode)
Syntax
ERRDUMP[ errorstackdepth] [ ;SYS]
NOTE This command follows the optional MPE/iX command line syntax. Refer to
"Optional Format for MPE/iX Commands" at the beginning of this chapter.
Parameters
errorstackdepth The number of error stack messages to be printed. If the actual error stack
size is less than the errorstackdepth then all messages on the error stack are
printed with no warnings or errors.
The process error stack currently runs from zero to sixteen. The system
error stack currently runs from zero to one hundred and twenty-seven. If
the errorstackdepth specified is beyond the boundaries of the process error
stack, the process error stack is not dumped, and CIERR 9155 is
displayed, as follows:
INVALID PROCESS STACK DEPTH;
EXPECTED A VALUE 0 - 16 (CIERR 9155)
If the errorstackdepth specified is beyond the boundaries of the system error
stack, (specified with SYS) the system error stack is not dumped, and
CIERR 9156 is displayed, as follows:
INVALID SYSTEM STACK DEPTH;
EXPECTED A VALUE 0 - 127 (CIERR 9156)
An errorstackdepth value of 0 dumps the entire error stack. The default
value is 0.
SYS The SYS option specifies that the system error stack is to be dumped. If the
SYS option is not used, then the process error stack is dumped.
Operation Notes
The ERRDUMP command allows the user to dump either the process or the system error
stack to a specified depth. If the depth specified is greater than the number of errors on the
error stack, then all errors on the error stack are dumped without any warnings or errors.
If the user specifies an errorstackdepth outside of the boundaries of the error stack, an error
message is displayed and the error stack is not dumped.
