Command
	issave

Purpose
	Saves current contents of an internet session (IS) to a local file.

Aliases
	issave, issav

Syntax
	issave [ <options> ] <name> <local_file>


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

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.

	<local_file>	Name of the file on the local computer to save to. The <local_file> can be specified
		either in full path name or relative to the current 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.


Stream Input	
	Ignored.

Stream Output
	None.

Stream Error
	Any errors are listed here.

Description
	This command saves the contents last retrieved by an internet session to the local computer. The session must have
	already been started with the isstart command, and connected to a server with the iscon command.

	The retrieved file or document can be text or binary. 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.

	Examples of binary files are files in the following formats.

	.jpg	Joint Photographic Experts Group
	.mpeg	Motion/Moving Picture Experts Group
	.xls	Excel
	.doc	Word
	.wav	Waveform (Audio)
	etc.

	(The above terms may be trademarks, service marks or other forms of intellectual property
	of their respective owners.)
	
	For downloading text documents that require no special dialog with a server, you can simply use
	the repro command, such as the following.

	repro "http://www.yourfavoritesite.com/index.html" > "C:/Test/index.html"

	The above command will save file index.html from the server to the local file "C:/Test/index.html".
	When the input file name supplied to the repro command begins with "http://", the repro command
	assumes that the file is on the internet. It will then connect to the internet, and acquire that
	file. In other words, the repro command will do the dialog with the server for you - you would not
	have to explicitly write the commands isstart, iscon, issave, isdiscon, and isend.
	
	
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"
	ispost "mail" "/welcome.php" "email=you@yourfavoritesite.com" "password=yourpassword"

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


	issave "mail" "C:/maillist.html"

	will save the contents retrieved from the server to file C:/maillist.html.


	isstart "pic"
	iscon "pic" "http://pics.yourfavoritesite.com"
	isret -b "pic" "/Zebra.jpg"
	issave -b "pic" "C:/Zebra.jpg"

	Will save the picture Zebra.jpg from the server to local file C:/Zebra.jpg.


	isstart "movie"
	iscon "movie" "http://movies.yourfavoritesite.com"
	isret -b "movie" "/Movie of the month.mpg"
	issave -b "movie" "C:/Movie of the month.mpg"

	Will save the movie in file "Movie of the month.mpg" from the server in your C:/ drive.


Invalid Examples
	isstart "accesslog"
	issave "accesslog" 

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

	
	isstart "accesslog"
	iscon "accesslog" "http://www.myserver.com"
	issave "accesslog" "C:/dailylog.txt"

	This is not quite an error, but probably does not do what you intended. If you want
	to save the file dailylog.txt from the server to your local computer, you must first
	retrieve that file. The following sequence will be more appropriate.

	isstart "accesslog"
	iscon "accesslog" "http://www.myserver.com"
	isret "accesslog" "dailylog.txt"
	issave "accesslog" "C:/dailylog.txt"


See Also
IS
isstart
isend
iscon
isdiscon
isret
issub
isheadret
isheadsub
repro
var