Purpose

DosForceSystemDump initiates a stand-alone dump. The system terminates abruptly without shutdown as soon as the dump is inititated.

Syntax

#define INCL_DOSMISC
#include  os2.h>

APIRET APIENTRY DosForceSystemDump

(ULONG reserved)

Parameters

reserved(ULONG) input

Returns

ulrc (APIRET) returns

Return Code.

DosForceSystemDump returns the following value

87

ERROR_INVALID_PARAMETER

Related Functions

• DosDumpProcess

• DosSysTrace

Example Code

int main(int argc, char *argv[], char *envp[]){
   APIRET rc;

   rc=DosForceSystemDump(0L);   /* will kill the system with a system dump */
                                /* does not return unless an error occurs */

   printf("DosForceSystemDump returned %u\n",rc);

   return rc;
}

---

[Back] [Next]