Command
	issub

Purpose
	Submits (posts) a file (document) to the internet.

Aliases
	issubmit, issub, iss, isput, ispost

Syntax
	issub [ <options> ] <name> [ <server_file>
	                                   [
	                                           [ <parm_name>=<parm_value> ]
	                                           [ <parm_name>=<parm_value> ]
					           ...
	                                   
	                                   ]
	                           ]

Options
	-b	The server file (document) is binary. Without this option, the file or
		document is submitted in text form.

	-w	Data being submitted/posted is in raw format. Without this option, the posted
		data will be formatted before sending it to the server. With this option,
		the data will be sent as it is. This option is useful for posting XML and
		other documents.


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 and connected to
		a server with the iscon 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_file>	Name of the file to submit or post. The file needs to be relative to the root directory on
		the server. If this argument is not specified, "/" will be assumed, which is the default
		file served by that server.

		This argument should not include "http://", "www", ".com", etc. The name needs to
		be relative to the server's root directory.

		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.

	Parameters to the server are passed as <parm_name> and <parm_value> separated by an equal sign.

	<parm_name>	Name of a parameter.

	<parm_value>	Value of the parameter.

		Each parameter (<parm_name>=<parm_value>) 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 document returned by the server is written here.

Stream Error
	Any errors are listed here.

Description
	This command submits or posts a file or a document using an internet session. The session must have
	already been started with the isstart command, and connected to a server with the iscon command.

	The submitted file or document can be text or binary. Usually, it is a text file.
	Examples of text files are files in the following formats.

	.html	Hypertext Markup Language
	.csv	Comma Separated Values
	.txt	Text
	.asp	Active Server Pages
	.css	Cascaded Style Sheet
	.js	Java Script
	.pl	Perl script
	.vbs	Visual Basic Script
	etc.

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

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

Valid Examples

	In these examples, we will assume that your mail server is "http://mail.yourfavoritesite.com".
	The dafault page on this site is "welcome.php", which has a form in which you want to enter
	your email address and password. The names of these input fields are "email" and "password"
	respectively.

	isstart "mail"
	iscon "mail" "http://mail.yourfavoritesite.com"
	issub "mail" "/welcome.php" "email=you@yourfavoritesite.com" "password=yourpassword"

	The above will retrieve the page that your mail server shows after logging in.


	Many servers track sessions with a session id. If the server generates a session id,
	and expects it to be returned in all requests in the format "sessionid=KJ0pOqBB53",
	you can extract and supply it in the ispost command as follows.

	var str content
	isstart "mail"
	iscon "mail" "http://mail.yourfavoritesite.com" > $content
	# Extract the session id parameter in the form "sessionid=KJ0pOqBB53".
	var str sessionIdParameter
	stex -c "]^sessionid=^" $content > null
	stex "]^\"^" $content > $sessionIdParameter
	# $sessionIdParameter now contains the parameter in the form "sessionid=KJ0pOqBB53".
	issub "mail" "/welcome.php" $sessionIdParameter "email=you@yourfavoritesite.com" "password=yourpassword"


Invalid Examples
	isstart "accesslog"
	issub "accesslog" "/dailylog.html" "login=yourlogin" "password=yourpassword"

	Will produce an error. Session "accesslog" is not connected to a server.

	
	isstart "accesslog"
	iscon "accesslog" "http://www.myserver.com"
	issub "/dailylog.html" "login=yourlogin" "password=yourpassword"

	Will produce an error. There is no session named "/dailylog.html". If the intent is to submit
	the file "/dailylog.html" using the session "accesslog", use the following command instead.

	issub "accesslog" "/dailylog.html" "login=yourlogin" "password=yourpassword"


See Also
IS
isstart
isend
iscon
isdiscon
isret
isheadret
isheadsub
issave
stex
var