The enqueue_message() function is useful if you want to process an ACK message that is received by a channel. For example, suppose that you have defined a channel named ack1 that is sending messages to an application. If you want to add the ACK message received by ack1 to the queue for channel ack2, do the following:

• In the Destination component for your ack1 channel, ensure that the ACK verification list box has Any ACK message selected.
• If you have defined a custom VMD file for processing ACK messages received by ack1, add the following Global Inbound Script to this VMD file:

from ifware.iguana import *

enqueue_message(value, "ack2")

In the Global Inbound Script, value is a global variable that contains the ACK message.

• If you have not defined a custom VMD file to process ACK messages, make a copy of the default ack_verify.vmd file (located in the directory in which Iguana is installed). Then, in your channel, edit the ACK VMD path field to refer to your copied file. Edit the copied file to add the Global Inbound Script shown above.

Now, when a message is sent by ack1, the ACK message that is returned by the receiving application is added to the message queue for channel ack2. It is then treated like any other incoming message to that channel.

	While enqueue_message() is normally used to send messages, it can send any text you like. The only limitation is that the channel to which the text is being sent must be able to properly handle it.

	New Feature in Iguana 4.5 enqueue_message() was added to version 4.5 of Iguana.