PRODUCT






Home









Free Download








Installation Instructions





FAQ





FAQ








Ask A Question





LEARN SCRIPTING





Overview








Lesson 1








2


3


4


5








Exam





SAMPLE SCRIPTS





Computer








Internet








Administrators








Developers








Data








Miscellaneous





HELP / DOCUMENTATION





Commands








Automated Internet








Automated Editors








Sample Scripts








Precompiled Functions








System Features






  Help Page - IS

( Some help pages may not display correctly in html because those help pages may have sample code
in them, part of which may be mis-interpreted as html tags.

All help pages, including this help page, are available in biterScripting with the help command. )




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 be multiple sessions connected over internet at the same time. 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

2008-2013, biterScripting.com. All rights reserved.
biterScripting, biterScript, biterBrowser, biterMobile, biterScripting.com, FVA (Forward Variable Assignment) are trademarks of biterScripting.com. Is it biterScripting-compatible ? is a service mark of biterScripting.com. Explorer, Unix, Windows are trademarks, service marks or other forms of intellectual property of their respective owners.