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.

A client executable uses the MessageProcessor object to communicate with an Iguana channel. This object defines the connect method, which establishes a connection to an Iguana channel. This object also generates the events that enable your client executable to communicate with the channel.

The connect method requires three parameters:

• The location of your Iguana server;
• The port that the Iguana client executable communication server is using (which is normally 6123);
• The name of the channel component (which is <name>.source1, where <name> is the name of your channel).

	To configure your client executable to use a port other than 6123, edit the RpcPort attribute in the ChannelConfiguration.xml file, then restart the Iguana service.

The events generated by the MessageProcessor object when a client executable is sending messages are:

• OnMessageRequest, which is triggered when the Iguana channel requests a message;
• OnMessageRequestCompleted, which is triggered when the Iguana channel has successfully processed a message that was sent by the OnMessageRequest event handler;
• OnShutdownRequest, which is triggered when the Iguana channel is stopped.

For examples of how to use the MessageProcessor object to send messages, see the VB.NET and C#.NET examples that are included in this section.

	For more information about MessageProcessor and the other components of the client executable API, see the iNTERFACEWARE.IGC namespace documentation.