HPlogo 900 Series HP 3000 Computer Systems: MPE/iX Intrinsics Reference Manual > Chapter 4 Command Definitions

SETDUMP

» 

Technical documentation

Complete book in PDF
» Feedback

 » Table of Contents

 » Index

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)

Feedback to webmaster