HPlogo MPE/iX Commands Reference Manual: HP 3000 MPE/iX Computer Systems > Chapter 3  Command Definitions C-E

ERRDUMP

» 

Technical documentation

Complete book in PDF
» Feedback

 » Table of Contents

 » Index

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
Feedback to webmaster