DosForceSystemDump (Force a System Stand Alone Dump)

DosForceSystemDump allows an application to initiate a stand-alone system dump.

Syntax

     APIRET APIENTRY DosForceSystemDump(ULONG reserved);
32-bit code Example using CSet/2

Parameters

reserved

Reserved doubleword field that is set to 0L.

Returns.

There is no return from this API.

Remarks.

There is no return from this API. The system is halted abruptly and a stand-alone dump is initiated. After the stand-alone dump process has completed the system must be re-booted.

No shut down activity is performed when this API is called. File system buffers are not written to disk, cache is not flushed and files are not closed. Data loss may result.

DosForceSystemDump is equivalent to using the Ctrl-Alt-Numlock-Numlock key sequence.

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

To format a system dump see The Dump Formatter User Guide.

For related information see:

• TRAPDUMP CONFIG.SYS command

• CREATEDD command in the OS/2 Command Reference

---

[Back: New STDA Format]
[Next: DosDumpProcess (Enable/Disable ProcessDump)]