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 - issub

( 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. )




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 string. 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 string. 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 string. 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

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.