HTTPD Extension for Visual DialogScript

Version: 1.7.5.2001
Copyright © 2000 PGWARE
All rights reserved


Description:
This is an extension that provides an http daemon (webserver) to your visual dialogscript applications. Within minutes you can start up a webserver from your local machine. Set the default path and port and your ready to go. The extension will also trigger events when someone connects and requests a document, as well as when a user disconnects from the server. Httpd servers usually connect multiple times to retrieve images and disconnect many times after receiving images/files and all of this information is provided. This extension is shareware and will not work when the script is compiled until a valid serial number is supplied. eg. external vdshttpd,<serial number>

Commands:
[+] HTTPD DEFAULTDIR,<directory>
[+] HTTPD DEFAULTDOC,<filename>
[+] HTTPD DEFAULTPORT,<port>
[+] HTTPD EVENTS,<mode>
[+] HTTPD OFF
[+] HTTPD ON


[ Command Explanation ] :

[-] HTTPD DEFAULTDIR,<directory>

This command sets the directory where the webserver should look for html files. By default it checks the same directory the script is in. If the directory does not exist then it will be set back to the current working directory. This allows for multiple accounts to be setup if you so choose where each different account has a different directory of files.

<directory> - this is the directory of files you want to be viewable by your httpd webserver. You should use something like 'c:\windows\'.



[-] HTTPD DEFAULTDOC,<filename>

This command sets the filename to look for in the directory specified by HTTPD DEFAULTDIR. Most webservers use the default 'index.html' as well as this extension. This file should exist or your clients will view a 404 error page. It should only be a filename, not a full path.

<filename> - this is the filename to use as the default document. The webserver will try to locate this file and send it back to the client machine. By default the filename is 'index.html'.



[-] HTTPD DEFAULTPORT,<port>

This command sets the httpd webservers port to use. By default the port is 80. You should only use numeric numbers for the port parameter. If the port is already open no notification is sent to you and the webserver will not function.

<port> - this is the port number to use. It should be a port that is not already open on your machine and is a numeric number. By default port 80 is used by most webservers.



[-] HTTPD EVENTS,<mode>

This command allows you to turn events on or off. By default events are OFF. The use of events allows your application to know when a document has been requested and when a connection has be disconnected. The use of such information is good for statistical log purposes.

<mode> - there are two modes to choose from to modify how events are handled
   NO - no events are generated
   YES - events are generated
   look below to see which events are generated



[-] HTTPD OFF

This command turns the httpd webserver off. Any client machine that is connected will no longer be able to view files from your machine.



[-] HTTPD ON

This command turns the httpd webserver on. Your machine is now accessible to anyone connected to the internet via your IP address and all files in the HTTPD DEFAULTDIR are also accessible.





Functions:
[+] @HTTPD(DEFAULTDIR)
[+] @HTTPD(DEFAULTDOC)
[+] @HTTPD(DEFAULTPORT)
[+] @HTTPD(CLIENTS)


[ Function Explanation ] :

[-] @HTTPD(DEFAULTDIR)

This function returns the directory that the httpd webserver is currently configured to use.



[-] @HTTPD(DEFAULTDOC)

This function returns the default document the httpd webserver is currently configured to use.



[-] @HTTPD(DEFAULTPORT)

This function returns the default port the httpd webserver is currently configured to use.



[-] @HTTPD(CLIENTS)

This function returns the current number of clients connected to your httpd webserver.





Events:
[+] HTTPDCONNECT
[+] HTTPDDISCONNECT
[+] HTTPDGETDOCUMENT
[+] HTTPDPOSTDOCUMENT


[ Event Explanation ] :

[-] HTTPDCONNECT

This event occurs when a request to a document has been made. Depending if the user has already connected this event may not be triggered. The event usually occurs when a refresh has been made in the browser to the requested document. The command HTTPD EVENTS,ON must be used inorder for this event to occur.



[-] HTTPDDISCONNECT

This event occurs when a disconnection to the httpd webserver has been made. Multiple connections are made when images are retrieved and instantly disconnected once the file has been downloaded to the client machine. These connections are made by the HTTPDGETDOCUMENT event rather then the HTTPDCONNECT event. The command HTTPD EVENTS,ON must be used inorder for this event to occur.



[-] HTTPDGETDOCUMENT

This event occurs when a get request has been made to download a page and its corresponding images/files. This event will be triggered numerous times depending on the number of graphics/files available. The command HTTPD EVENTS,ON must be used inorder for this event to occur.



[-] HTTPDPOSTDOCUMENT

This event occurs when a post request has been made. The command HTTPD EVENTS,ON must be used inorder for this event to occur.





Registration:
This extension is shareware it must be registered within 28 days or you must remove the extension and any application that uses it. Once you register you will receive a personal serial code which will unlock the extension so you can distribute it with your applications. Registering costs $10.00 US Dollars and can be purchased online at [ http://www.reg.net/product.asp?ID=7616 ].



Support:
Please note that only registered users are provided with support. However bug fixes will be made as they are found. Report bugs to [ support@vdsworld.com ].



Copyright © 2001 PGWARE / All rights reserved.