DosForceSystemDump

Description

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

Return Code

ulrc (APIRET) returns

DosForceSystemDump returns the following value

• 87 ERROR_INVALID_PARAMETER

Linkage Definition:

IMPORTS DosForceSystemDump = DOSCALLS.444 

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;
}

Related Functions

• DosDumpProcess
• DosSysTrace