SHAPIEXCEPTIONHANDLER

This command disables or enables the registration of the exception handler in the PMSHAPI.DLL module.

Syntax.

     SET SHAPIEXCEPTIONHANDLER=ON|OFF

Parameters

ON

This is the default setting. The shell API DLL exception handler is enabled and normal error recovery takes place whenever a user PM application or the desktop traps.
OFF
The shell API DLL exception handler is disabled. No additional error recovery provided by the shell takes place when a user application or the desktop traps.

Notes:

Exception handler registration only occurs during PMSHAPI.DLL initialisation. Therefore, a change to the specification of SHAPIEXCEPTIONHANDLER will require the system to be rebooted.

The Shell API DLL exception handler will attempt to clean up an application's PM resources.

Under certain circumstances application traps can be pervasive. Either the default error recovery is too efficient to allow the trap to be intercepted or analysed, or the trap recurses to a more serious problem, from which it is also difficult to determine the underlying cause. SHAPIEXCEPTIONHANDLER may be used under these circumstances to allow the problem to be intercepted closer to the point of occurrence.

SHAPIEXCEPTIONHANDLER may be used with TRAPDUMP to force a system dump at the point of failure.

Hangs in the shell during initialisation may be the result of a re-cursive trap. SHAPIEXCEPTIONHANDLER may be used to intercept this condition.

Since it if difficult to determine whether a potential shell problem involves PMSHELL.EXE or PMSHAPI.DLL then it is recommended to use SHAPIEXCEPTIONHANDLER with SHELLEXCEPTIONHANDLER.

---

[Back: SCKILLFEATUREENABLED]
[Next: SHELLEXCEPTIONHANDLER]