This documentation page describes a feature of version 3.3 of Iguana. In Iguana 4.0 and later, client executables are called plugins. See Writing a Plugin for more information on plugins in Iguana 4.0 and later.

Now that you have created the channel and the client executable, you can test the client executable to make sure it works. To test the client executable, use the HL7 Simulator to send this test message to the channel and the client executable.

To test the client executable:

• Start the channel that you created in Creating the Channel.
• Open the HL7 Simulator application. (To access it, click Start, then Programs, iNTERFACEWARE, HL7 Analytical Tools and HL7 Simulator.)

• In the Host field, type localhost.
• In the Port field, type the port you specified for the LLP Listener source component of your channel.
• Create a file that contains this test message.
• In the Message File field, type or browse for the location of the file containing the test message.

Now that your channel and the HL7 Simulator are set up, you can start the client executable. The easiest way to do this is to reopen Visual Studio and, from the Debug menu, select Start Without Debugging. A console window appears, displaying the output from the client executable:

	If you start the client executable before you have started the channel, you will see an error:

• In the HL7 Simulator, click Start. The Simulator sends the test message, which triggers an OnMessageReceived event in your client executable. The event handler writes the test message to the application console window:

• In the Iguana Dashboard, click Stop to stop your channel. The client executable window indicates that the client executable is being stopped:

• Press any key to close the client executable.
• In Iguana, click the Logs tab to view the logging information for this channel:

Here, you can see that the test message has been successfully sent to the channel, and from the channel to the client executable.

	Once you have successfully tested your client executable, and are convinced that it is working properly, you should configure your channel to automatically start the client executable when the channel is started. To do this, edit the channel configuration and change the value of the Iguana starts executable list box to true. This list box is located in the To Client Executable destination component of the channel configuration. See To Client Executable for more details.