Command
	iscon

Purpose
	Connects an internet session (IS) to a server.

Aliases
	isconnect, iscon, isc

Syntax
	iscon [<options>] <name> <server> [ <login> [ <password> ] ]

Options
	None.

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

		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.

	<server>	The session will be connected to this server. This argument needs to begin
		with http:// or https://. Also, it should not end with a slash (/).

		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.

	<login>	This login or user name will be supplied to the server when the connection is made.
		Use this argument when a server does not allow anonymous connection.

		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.


	<password>	This password will be supplied to the server when connection is made. Use this
		argument when a server does not allow anonymous connection and requires a password.

		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
	The default document served by the server is written here.

Stream Error
	Any errors are listed here.

Description
	This command connects an internet session to a server. The session must have
	already been started with the isstart command.

	Once a session is connected, you can use the various IS commands to exchange data with the server.
	For example, Command isret is used to retrieve a web page from the server. Command issub is used to
	submit a web form. Command issave is used to save a binary (or text) document from
	the server to the local system.

	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.

	Once an internet session is started, it can be used to go from server to server. For example,
	you can connect to one server, fetch some data from that server,
	disconnect from that server, then connect to another server and send the fetched data to that server.
	There is no limit on how many such servers a session can go thru.

	Further, biterScripting does not impose a limit on how many connected sessions you can have at one time.
	However, a limit may be imposed by your operating system, the networking hardware, networking software
	or the bandwidth availability. When the limit is reached, any attempt to make a new connection will
	result in an error.
	
Restrictions
	The session must have been started with the isstart command.

	Your system must be connected to the internet for this command to succeed.


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

	Will start a new session named "accesslog" and connect it to "http://www.yourfavoritesite.com".

	isstart "dailycheck"
	iscon "dailycheck" "http://www.dailycheck.com" "Acc032" "pet_dog"

	Will start a new session named "dailycheck" and connect it to server "http://www.dailycheck.com".
	The login "Acc032" and password "pet_dog" will be supplied to the server for the connection.

	var str server
	set $server="http://www.emailserver.com"
	isstart "hourly"
	while (true)
	do
	    iscon "hourly" $server "Acc032" "pet_dog"
	    # Exchange data and documents with the server.
	    isdiscon "hourly"
	    sleep (60*60)
	done
	isend "hourly"

	The above script will connect hourly to server "http://www.emailserver.com".

Invalid Examples
	iscon "session1"

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

	var str server
	set $server=""
	iscon "session1" $server

	Will produce an error. The server name is empty.

	int i
	iscon "session1" $i

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

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