HP 3000 Manuals

SETDUMP [ MPE/iX Intrinsics Reference Manual ] MPE/iX 5.0 Documentation


MPE/iX Intrinsics Reference Manual

SETDUMP 

NM and CM callable.

Arms a call to the system debugger from a process abort.

Syntax 
_____________________________________
|                                   |
|             I16V                  |
|     SETDUMP(flags);               |
_____________________________________

            

Parameters 

flags                 16-bit unsigned integer (required) 

                      This parameter is for backward compatibility with
                      MPE V/E systems only.  Any value passed in this
                      parameter is ignored, but a full stack trace is
                      always generated.

Operation Notes 

If the process aborts, Debug is called with a command string that results
in a full stack trace of the CM and NM data stacks and a dump of the NM
registers.  This output is sent to the standard list device.

If the process that aborts is being run from a job, the process
terminates after the stack trace and register dump are performed.  If the
process is being run from a session, after the stack trace and register
dump have completed, Debug stops to accept interactive commands with I/O
performed at the user terminal, provided the following conditions are
met:

   *   The abort did not occur while in system code.

   *   The process entered the abort code through a native mode interrupt
       (typically caused by arithmetic and code-related traps).

When Debug accepts interactive input, the user is free to enter any Debug
command.  The user may choose to resume the process or have it terminate.

If the abort is from a stack overflow, the command list is ignored, and a
stack trace is sent to the standard list device, and the process
terminates.  No interactive debugging is allowed.

The HPSETDUMP intrinsic is a more flexible version of this intrinsic.

Condition Codes 

CCE (2)               Request granted.

CCG (0)               Request denied.  The abort stack analysis facility
                      was already enabled before the SETDUMP call.

CCL (1)               Not returned.

Related Information 

Intrinsics            HPRESETDUMP, HPSETDUMP, RESETDUMP, STACKDUMP

Commands              SETDUMP

Manuals               MPE/iX System Debug Reference Manual (32650-90013)



MPE/iX 5.0 Documentation