HP 3000 Manuals

MPE/iX Commands Reference Manual Volume I

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.

Use 

This command may be issued from a session, job, program, or in BREAK.
Pressing Break has no effect on this command.

Examples 

To obtain an error stack dump, enter:

     ERRDUMP 

A sample system response is:

     TYPE MANAGER; THE END-OF-FILE HAS BEEN DETECTED.
     FILE SYSTEM MESSAGE 1023.

Another example specifies that the system error stack be dumped:

     ERRDUMP 1;SYS 

A sample system response is:

     THE STATUS OF THE TIME ENTRY IS NON-ACTIVE.
     TUE, FEB 9, 1988, 12:18

MPE/iX 5.0 Documentation