Command
	isdiscon

Purpose
	Disconnects an internet session (IS) from a server.

Aliases
	isdisconnect, isdiscon, isdis

Syntax
	isdiscon [<options>] <name>

Options
	None.

Arguments
	<name>	This is the name of the internet session, also called session. A session
		by this name must have been already started with the isstart command and
		must have been already been connected to a server.

		This argument can be supplied using a constant, variable, expression, function call,
		inline command, or a combination of these, all resulting into a single value of type str.
		If a constant is used, it should be enclosed in double quotes.


Stream Input	
	Ignored.

Stream Output
	None.

Stream Error
	Any errors are listed here.

Description
	This command disconnects an internet session to a server. The session must have
	already been started with the isstart command and connected with the iscon command.

	Once a session is connected, it needs to be disconnected using the isdiscon command, when you are done
	with the server. Leaving too many sessions connected, may degrade performance, and may even result in
	failure to connect new sessions. All connected sessions will be disconnected automatically when
	biterScripting exits.
	
Restrictions


Valid Examples
	isstart "accesslog"
	iscon "accesslog" "http://www.yourfavoritesite.com"
	isdiscon "accesslog"

	The above will start a session called "accesslog", connect it to the server
	"http://www.yourfavoritesite.com", then disconnect the session.

	isstart "download"
	var str list
	set $list=""http://www.site1.com\nhttp://www.site2.com\nhttp://www.site3.com"
	while ($list <> "")
	do
	    var str site ; lex "1" $list > $site
	    iscon "download" $site
	    isret "logfile.txt" >> "C:/logfile.txt"
	    isdiscon "download"
	done
	isend "download"

	The above will connect to sites site1.com, site2.com and site3.com one by one, retrieve the
	file logfile.txt from each server, and append the retrieved files from all servers to
	file "C:/logfile.txt".


Invalid Examples
	isdiscon

	Will produce an error. The session name is not specified.

	var str sessionname
	set $sessionname=""
	isdiscon $sessionname

	Will produce an error. The session name is empty.

	int i
	isdiscon $1

	Will produce an error. $i does not result in a value of type str.

See Also
IS
isstart
isend
iscon
isret
issub
isheadret
isheadsub
issave
var