Command
	isstart

Purpose
	Starts a new internet session (IS).

Aliases
	isstart, isst

Syntax
	isstart [<options>] <name> [ <description> [ <agent> ] ]

Options
	-e	This session requires explicit disconnection and ending. Without this option, the session
		will be disconnected and ended automatically as and when necessary. For example, if a second
		isstart command is issued with this session, the previous session will be ended
		before starting a new session with the same name. With this option, explicit calls to
		commands isdiscon and isend are required.

Arguments
	<name>	This is the name of the internet session, also called session. Session names are
		case-sensitive.

		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.

	<description>	The new session will be associated with this description. Description makes it easier
		to distinguish between sessions.

		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.

	<agent>	The new session will be associated with this agent. The agent describes your computing and
		networking platform to the 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.

		Internet servers often log and use the agent when processing internet requests. For example,
		they may send different versions of the same web page, depending on the value of <agent>.


Stream Input	
	Ignored.

Stream Output
	None.

Stream Error
	Any errors are listed here.

Description
	This command starts a new internet session.

	Once a session is started, you can use the various IS commands with that session. For example,
	command iscon is used to connect the session to an internet server. Command isret is used to
	retrieve a web page. Command issub is used to submit a web form. Command issave
	is used to save a binary (or text) document from the internet to the local system.

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


Valid Examples
	isstart "accesslog" "Automatic daily download of access log from my web site" "Mozilla/4.0"

	Will start a new session, assign it the name "accesslog", assign it the description
	"Automatic daily download of access log from my web site" and assign it the agent
	"Mozilla/4.0" .

	(Some of these terms may be trademarks, service marks or other forms of intellectual property
	of their respective owners.)

	isstart "s1"

	Will start a new session, assign it the name "s1" and no description and no agent.

	var str s
	set $s = "accesslog"
	isstart $s

	Will start a new session named "accesslog" and no description and no agent.

Invalid Examples
	int i
	isstart $i

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

	isstart "Automatic daily download of access log from my web site"

	This is not quite invalid. It will start a session with the name
	"Automatic daily download of access log from my web site" . If the intent is to use this string
	as the session description, use the following instead.

	isstart "daily_download" "Automatic daily download of access log from my web site"

See Also
IS
isend
iscon
isdiscon
istet
issub
isheadret
isheadsub
issave
var