System Feature
	IS - Internet Session

Purpose
	Connect and communicate with internet servers.

Aliases
	None

Syntax
	See syntax for individual IS commands.

Options
	See options for individual IS commands.

Arguments
	See arguments for individual IS commands.

Stream Input	
	See help pages on individual IS commands.

Stream Output
	See help pages on individual IS commands.

Stream Error
	See help pages on individual IS commands.

Description
	IS or Internet Session is a mechanism to automate internet tasks.

	Usually, one uses a web browser to perform one or more tasks manually over the internet.
	Examples of these tasks are - viewing a web page, preforming an internet search for
	one or more keywords, checking and reading web-based email, downloading data, viewing pictures,
	uploading pictures, logging in to a web site, etc.

	These tasks, when done manually, require one to interact manually - viewing, reading,
	clicking, typing, etc. . biterScripting provides a way to automate all of these tasks.
	And, it does so using a mechanism called - Internet session.

	An Internet Session is identified by its name. Session names have the same syntax restrictions as
	variable names. Also, similar to variable names, session names are case-sensitive. There can
	only be one session by one name at any time (per biterScripting instance).

	A session typically goes thru the following sequence of commands.

	isstart	- start a session
	iscon	- connect the session to an internet server
	isret	- retrieve a document from the connected server
	issub	- submit a form to the connected server
	.
	.
	.
	Further internet activity
	.
	.
	.
	isdiscon	- disconnect the session from the connected server
	isend	- end the session

	All internet session commands begin with the letters "is". We will describe these commands briefly here.
	For details on these commands, please see the help pages for individual commands.

	The isstart command starts a session and assigns it a name. The following is an example.

	isstart "email" "Email Session" "biterScripting"

	The above command starts a session, assigns it the name of "email", assigns it the description
	"Email Session" and specifies that the user agent is "biterScripting". The session name and
	session description have only local significance. The user agent is sometimes used by internet
	servers to determine how and which web pages they will serve.

	The iscon command connects a session to an internet server. The following is an example.

	iscon "email" "http://www.emailserver.com"

	The above command connects the session "email" with the internet server at "http://www.emailserver.com".
	The server must be specified starting with "http://" or "https://". If the connection is successful,
	this command will retrieve the default document served by the server and list its contents in
	stream output.

	The isret command retrieves a document from the server. The following is an example.

	isret "email" "/login_page.html"

	The above command will retrieve the file "/login_page.html" from the server. This is called
	the server file. The server file must be specified relative to the root address on the server.
	It should not contain "http://www.emailserver.com".

	The issub command submits a form to the server. We will assume that the server file
	"/login_page.html" retrieved above has a form in it, where one would enter login and
	password. We will further assume that the fields into which this information is entered, are
	called "login" and "password". In that case, the next appropriate command to issue will be
	the following.

	issub "email" "/login_page.html" "login=joe" "password=brazil"

	The above command will submit (or post) the page "/login_page.html" with "joe" for login
	and "brazil" for password. This command will then show, in the stream output, the document
	served by the server next. The stream output of this command will thus be different depending
	on whether the login information was correct or not.

	After this one can then do more activity with the server - retrieving and submitting more server files,
	saving pictures and other media files from the server to local computer, etc. . 

	When all intended activity with this server is done, one will then issue the isdiscon command.
	The isdiscon command disconnects a session from the server. The following is an example.

	isdiscon "email"

	Finally, the isend command ends this session. The following is an example.

	isend "email"



	biterScripting does not impose a limit on how many internet sessions one can have.
	However, the internet connection, networking hardward, networking software and operating system
	may impose a limit.

	The power of internet sessions comes from the fact that one can parse the retrieved server
	files, using automated editor commands. See the help page on edit for details.

	This power further comes from the fact that any and all arguments to is commands can be
	specified using constants, variables, function calls, inline commands, operators or
	expressions containing one or more of these.


Restrictions
	A session by a session name must have been started with the isstart command,
	before issuing the iscon command for that session.

	A session by a session name must have been connected to a server with the iscon command,
	before issuing commands such as isret, issub, issave for that session.

	The computer must be connected to the internet for any of these commands to succeed.


Valid Examples
	See help pages on individual IS commands.

Invalid Examples
	See help pages on individual IS commands.

See Also
var
edit
isstart
isend
iscon
isdiscon
isret
issub
isheadret
isheadsub
issave