Attaching the Debugger to the Process

To attach the Visual Studio .NET debugger to the Microsoft Identity Integration Server 2003 service process, perform the following steps.

1. Ensure the current version of the extension class library is copied to the Extensions folder under the Microsoft Identity Integration Server 2003 installation folder.
2. Open the extension project in Visual Studio .NET.
3. Insert any required breakpoints.
4. Select Debug, and then Processes from the Visual Studio .NET menu. The Processes window, which looks similar to the following figure, is displayed. The processes, displayed in the Available Processes list, may vary.

   

5. In the Processes window, make the following settings:
   • Set Transport: to Default.
   • Set Name: to the Microsoft Identity Integration Server 2003 server computer name.
   • Clear the Show system processes check box.
   • Select the Show processes in all sessions check box.
6. In the Available Processes list, select a process and press the Attach button. The Attach to Process dialog box, similar to the following figure, is displayed.
   • For rules extensions, select miiserver.exe. The extension must be configured to run in-process.
   • For connected data source extensions, select miiserver.exe if running in-process or dllhost.exe if running out-of-process.

   

7. In the Choose the program types that you want to debug list, select the Common Language Runtime check box and clear all other check boxes. This step is important because it affects what happens when the debugger is stopped or detached. If Native is selected, the Microsoft Identity Integration Server 2003 server process will have to be terminated to stop debugging.
8. Press OK in the Attach to Process dialog box. The Processes window now looks similar to the following figure.

   

9. In the Processes window, set When debugging is stopped to Detach from this process.
10. Press the Close button in the Processes window. The debugger is now attached to the miiserver.exe process.

Detaching the Debugger

When debugging is complete, the debugger is detached from the process by selecting Debug - Stop Debugging in the Visual Studio .NET menu.