Table of Contents

Debugging a connector

When you have finished configuring all necessary settings, you can start debugging.

  1. Open the protocol Visual Studio solution.

  2. In the C# editor, set the necessary breakpoints.

  3. In the DIS menu, select Tool Windows > DIS Inject to open the DIS Inject window.

  4. Select the Protocol tab.

  5. Open the large selection box at the top of the window, and select an element that uses the exact same protocol as the one you are currently editing.

  6. In the QAction list:

    1. Go to the row of which the QAction ID matches that of the QAction you have opened.

    2. If necessary, in the Project column, select another QAction project.

    3. Click the green plus to replace (i.e., inject) the element's QAction.dll file (compiled in Release mode) with its counterpart found in the QAction project (compiled in Debug mode).

  7. Click the Attach button.

    This will rebuild all selected QAction projects, upload these to the Agent and inject these. Finally, it will attach the Microsoft Visual Studio Debugger to the DataMiner SLScripting process(es).

  8. In the DIS Inject window, click the yellow lightning bolt to manually trigger a QAction by simulating a change of the parameter selected in the Trigger ID box (in case of a dynamic table parameter, use the Trigger Key box to specify the table row).

    Note
    • Instead of clicking the yellow lightning bolt, you can also open DataMiner Cube, connect to the DataMiner Agent to which DIS is connected, and perform an action in the user interface that triggers the QAction you are debugging.
    • When a QAction refers to another QAction in a DllImport attribute, then that referenced QAction will now also automatically be injected when you debug a protocol in DIS.
Tip

Debugging is often not possible for third-party libraries. dotPeek can serve as a handy tool to overcome this.

Advanced search syntax