HPlogo MPE/iX Intrinsics Reference Manual > Chapter 10 Command Definitions (QUIT-ZSIZE)

SETDUMP

MPE documents

Complete PDF
Table of Contents
Index

Edition 7 E0701 ♥
Edition 7 E0300
Edition 6 E0195

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 DEBUG, HPDEBUG, HPRESETDUMP, HPSETDUMP, RESETDUMP, STACKDUMP
CommandsDEBUG, RESETDUMP, SETDUMP
Manuals MPE/iX System Debug Reference Manual
MPE/iX Commands Reference Manual




SENDMAIL


SETJCW