The HTTP request also handles two additional parameters for starting and stopping channels: ChannelAction and ChannelName. ChannelAction could be one of four values:

To start, stop, start all or stop all channels:

• Copy the following line and paste it into your web browser's address bar:

http://localhost:6543/status.html?UserName=admin&Password=password&ChannelAction=channelaction&ChannelName=TestChannel

• Replace localhost with the hostname of the machine Iguana is listening on (localhost is the default hostname).
• Replace 6543 with the port that Iguana is listening on. 6543 is the default port.
• Replace UserName=username and Password=password with your actual user name and password.
• Replace ChannelAction=channelaction with one of the four values described in the above table.
• Replace ChannelName=TestChannel with the name of the channel you want to start or stop.

	Note that the ChannelName parameter does not have to be specified when using the StartAll and StopAll channel actions.

This URL starts or stops the specified channel or channels, and returns the status of your Iguana server at the moment that the start or stop operation was performed. This status may not be updated to include your start or stop operation, as Iguana may require a few moments to update its status. To confirm that your channels are started or stopped properly, copy the following line and paste it into your web browser's address bar:

	http://localhost:6543/status.html?UserName=admin&Password=password&Format=format

• As before, replace localhost with the hostname of the machine Iguana is listening on (localhost is the default hostname).
• Replace 6543 with the port that Iguana is listening on. 6543 is the default port.
• Replace UserName=username and Password=password with your actual user name and password.
• Replace Format=format with either xml or text, depending on which format you want the status information in. If Format is not specified, the default format is text.

The status returned should indicate that the channel or channels that you have specified are now started or stopped.

An example of the returned status, in text format, is shown below:

20060925144605, 7, 2, 5
347, 191, 156, 0
"LLP_MF_one", "on", "From Message Filter", "on", "LLP Client", "on", 1, 1, 0
"MF_one_LLPa", "off", "LLP Listener", "off", "To Message Filter", "off", 2, 0, 0
"MF_one_FILEa", "error", "From Message Filter", "off", "LLP Client", "error", 83, 90, 0
"MF_one_DB", "off", "From Message Filter", "off", "To Database", "off", 20, 64, 0
"MF_one_LLPb", "...", "LLP Listener", "...", "To Message Filter", "off", 83, 0, 0
"MF_one_LLPc", "on", "From File", "on", "To Message Filter", "on", 1, 0, 0
"LLP_DB", "off", "From Message Filter", "off", "LLP Client", "off", 1, 1, 0

	If you attempt to use the same URL to start or stop a channel more than once, you might not get the results that you expect. This is because some web browsers save recently performed HTTP GET operations in a browser cache. (An HTTP GET operation is a URL that contains parameters and values that are supplied as part of the web address. In this example, the parameters are UserName, Password, ChannelAction, ChannelName and Format.) For example, suppose that you have a channel named foo123, and you stop it using this URL: http://localhost:6543/status.html?UserName=admin&Password=password&ChannelAction=Stop&ChannelName=foo123&Format=text If you start channel foo123 from the Dashboard and re-use the URL shown above to attempt to stop it again, the channel will not be stopped if the URL is contained in the browser's cache. If your browser is experiencing this problem, add an unused parameter to the URL and set it to a unique value: http://localhost:6543/status.html?UserName=admin&Password=password&ChannelAction=Stop&ChannelName=foo123&Format=text&rand=23872 If you supply a different unique value each time you use the URL, you will ensure that the channel is stopped. Note that this problem only occurs if you are specifying this URL within a browser. If you are supplying this URL from an application, you will not experience this problem.