The Starting and Restarting the Workplace Shell technique can also be used when a source level debugger is needed. Follow the same steps as outlined in that section, but instead of simply invoking PMSHELL, invoke the debugger, as follows:

   IPMD PMSHELL

The debugger initializes, but the Workplace Shell does not start running. The steps to be followed are:

• Select the Startup option from the File pull-down menu, as shown in the following figure:

• Select the Debug program initialization option, as shown in the following figure:

• Select the Load Occurence option from the Breakpoints pull-down menu, as shown in the following figure:

• Enter a breakpoint by specifying the name (but not the path) of the DLL, for example, DOG.DLL. Then, select the Set push button, as shown in the following figure:

• Set any other breakpoints you wish at this time. Select the OK push button when finished.

• Select the Run option from the Breakpoints pull-down menu, as shown in the following figure:

The Workplace Shell will then initialize (very slowly) and the debugger will stop when one of the specified breakpoints is reached.

Debugging a Workplace Shell application using IPMD will be much the same as debugging a PM application. Remember that if you manually enter the name of a class or instance variable into IPMD, you must prefix the name with somThis instead of using the underscore ( _ ) macro. In the sample code fragment illustrated in the following figure, to manipulate the _hIcon variable in IPMD, use somThishIcon instead of _hIcon (selecting _hIcon with the mouse works as expected).

/****************************************************//*  Method: wpclsInitData                           */
/*                                                  */
/*  This sample shows how to initialize class data  */
/ *  associated with MyDataBase.                    */
/****************************************************/

SOM_Scope void SOMLINK MyDataBaseM_wpclsInitData(M_MyDataBase *somSelf)
{
  /* M_MyDataBaseData *somThis = M_MyDataBaseGetData(somSelf); */
  M_MyDataBaseMethodDebug("M_MyDataBase","MyDataBaseM_wpclsInitData");

  hModule = _clsQueryModuleHandle(somSelf);

  _hIcon = WinLoadPointer(HWND_DESKTOP, hModule, ID_WINDOW);

  parent_wpclsInitData(somSelf);
}