3.7.1. Options

DM3Insight can run in one of the following modes:

• Local Client - Directly communicates with drivers on the same system.
• Server (Application / Service) - Accepts trace/dump commands from a remote system and forwards them to the driver.
• Remote Client - Communicates with a Server from a remote system to send trace/dump commands.

Instructions for using these modes are provided in the following sections:

• Local Mode
• Remote Mode

Local Mode

This is the simplest mode of operation where the application is running on the host system (the system that has DM3 boards). No command line parameters are required.

1. Execute the application with the following command: DM3Insight. The DM3Insight GUI appears (Figure 8).

Figure 8. DM3Insight GUI

2. Select the options you want:
   • Board - choose a specific board or all boards
   • Message Queue - choose from Message Out, In, and Orphan
   • Stream Queue - choose from Stream Out, In, and Orphan
   • Events - Add, Done, Timeout, and Cancel
3. To start capturing message / stream traffic, click the Start Trace button.
4. To view the data, run DebugView (see Section 3.5, "DebugView").
5. To dump the queues, click the Dump button.

Remote Mode

The application is run in server mode on the host system if it requires having a GUI running on a remote system. Some command line parameters are required. These are explained as required in the procedure, but summarized here:

Parameter	Description
-h or -?	Show all command line parameters
-cr	Run as Server in application mode
-ci	Install and run as Server in service mode
-cu	Uninstall Server service
-p<Port>	TCP/UDP port to use for Remote operation. Default is 5000
-t	Enable printing of driver / application error messages

(If you don't specify the -cr, -ci, or -cu parameter, the application runs in Local Mode.)

1. From the host system, execute the application with the following command line: DM3Insight -cr

   The DM3Insight: Remote window (Figure 9) appears.

Figure 9. DM3Insight: Remote

DM3Insight is now running in Server mode and waiting for an incoming connection

2. Now run DM3Insight on a remote system without any command line parameters.
   1. From the System Menu (click on the System Menu icon or press Alt+Space), select the Connect option. The DM3Insight: Connect window appears (Figure 10).

Figure 10. DM3Insight: Connect

2. Fill in the name or IP address of the host system (see Figure 10). If you need to browse for the host system, click the button with the three dots to the right of the place in which you type text (Figure 10). The Browse for Computer screen appears (Figure 11).
3. Browse to find the name or IP address of the host system.

Figure 11. Browse for Computer

If the connection is successful, you'll see the name of host system on the title bar of the GUI (Figure 12).

Figure 12. DM3Insight GUI - Host System

3. Now you can control tracing or dump the queues just like in Local Mode, but in this case the GUI is running in Remote Client Mode. Select the options you want.
4. From the Remote system, connect DebugView to the host system. You may need to run DebugView in client mode on the host system.
5. Once you have made a successful connection, you can run DM3Insight in server mode as a service. Run DM3Insight on the host system with the following command line parameters:

   DM3Insight -ci

   After doing this, you will not have to bother running DM3Insight on the host system as Server again, even if you reboot the system.

6. To uninstall DM3Insight service use the following parameter:

   DM3Insight -cu

Click here to contact Dialogic Customer Engineering