ERRDUMP



ERRDUMP

     Allows a user to dump either the process or system error stack to
     whatever depth is specified.

SYNTAX

     ERRDUMP [errorstackdepth][;sys]


PARAMETERS

Errorstackdepth          The number of error stack messages to be
                         printed.  If the actual error stack size is
                         less than the errorstackdepth than all messages
                         on the error stack will be 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 error stack,
                         then CIERR 9155 will be printed and the error
                         stack will not be dumped.

                         If an errorstackdepth value is 0 is entered,
                         then no error stack messages will be printed
                         and no error or warning will be issued.

                         An errorstackdepth value of -1 will dump the
                         entire error stack.  -1 is the default value.

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 will
                         dumped.


OPERATION

     The ERRDUMP command allows the use to dump either the process or
     the system error stack to whatever depth is specified.  If the
     depth specified is greater than the number of errors on the error
     stack, then all errors on the stack will be dumped without any
     warnings or errors.

     If the user specifies an errorstackdepth outside of the boundaries
     of the error stack then a CIERR 9155 will be printed and the error
     stack will not be dumped.


EXAMPLE(S)

      To obtain a dump, enter

      ERRDUMP

      The system responds

      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

      The system responds

      THE STATUS OF THE TIME ENTRY IS NON-ACTIVE. TUE,FEB 9,1988,1218

ADDITIONAL INFORMATION

Variables: HPERRDUMP