DosDumpProcess (Enable/Disable ProcessDump)

DosDumpProcess allows an application:

• to enable or disable dynamically the Process Dump Facility.

• to force a process dump for a given process.

Syntax

     APIRET APIENTRY DosDumpProcess(ULONG Flag, ULONG Drive, PID pid);32-bit code Example using CSet/2

Parameters

Flag

Doubleword field that may take one of the following values:

• DDP_DISABLEPROCDUMP 0x00000000L)
disable process dumps

• DDP_ENABLEPROCDUMP 0x00000001L)
enable process dumps to be taken to a file in the root directory of a drive specified by the Drive parameter.

• DDP_PERFORMPROCDUMP 0x00000002L)
Drive
Doubleword containing the ASCII value of the drive letter to which the PDUMP.nnn dump files will be written when DDP_ENABLEPROCDUMP is specified. For DDP_DISABLEPROCDUMP this parameter is ignored.
pid
Doubleword containing the process Id of the process to be dumped.

This option is valid only with DDP_PERFORMPROCDUMP. If zero is specified for Pid then the current process is dumped.

Returns.

Return Code.

DosDumpProcess returns the following values:

• NO_ERROR

  87

  ERROR_INVALID_PARAMETER
  303
  ERROR_INVALID_PROCID

  Remarks.

  When Process dump is enabled a dump file is written whenever a ring 3 process traps. The file takes a name PDUMP.nnn where nnn is incremented sequentially (staring from 000) for each successive dump.

  The directory to which PDUMP.nnn will be written is always the root directory of Drive.

  C Language prototype definitions for the DosDumpProcess may be found under RAS API Prototypes.

  The content of a Process Dump comprises register information at time of trap, system control blocks (TCB, TSD, PTDA, MTE, SMTE, OTE, VMAR, VMOB, LTD) that describe the state of the process at the time of error, ring 0 and ring 3 stack data for the trapping process.

  See the Process Dump Formatter section of the Dump Formatter User Guide for information on formatting Process Dumps.

  Note:

  DDP_PERFORMPROCDUMP is not available in some early releases of OS/2 V2.11

  ---

  [Back: DosForceSystemDump (Force a System Stand Alone Dump)]
  [Next: DosSuppressPopUps (Suppress Trap Exception Pop-Up Messages)]