amStats v.80b readme.html

amStats is a set of Active Server Page scripts that report current web server information such as: current sessions, sessions for the day, average sessions, and much more. amStats' unique feature is the ability to transmit this information to cell phones, pagers, and PDAs that are WAP (Wireless Access Protocol) compatible.

amStats is designed to run on Microsoft's Internet Information Server (IIS) and Personal Web Server (PWS) on Windows 95, 98, 2000, and NT. Through the use of the global.asa file, amStats keeps track of server statistics and displays it with active server pages (ASP). To access amStats via hand held device, simply point the device's browser to the proper page (amstatswml.asp) on your server and view the results. You do not need to load any server DLLs, COM objects, or NT services. Everything is handled through your global.asa file. amStats does not use session variables (which can be wasteful) and uses very little system resources.

Installation

Step 1: Unzip and copy the amStats files to you web server. There are four files included in this zip file:
With the exception of global.asa, which must be placed in the root directory, all of these files should be placed in the same directory on the server. See the section 'Operational Information' below for additional information.

Step 2: Look for a global.asa file in the root directory of your web server. If one does NOT exist, simply rename the changes_to_global.asa file to global.asa and it will function properly. If a global.asa file already exists, you will have to copy the following selections into that file.

NOTE: Please make a backup of your existing global.asa file before you make any changes to it.

Select ALL of the following text and paste it into the application_OnStart section of global.asa.

Select ALL of the following text and paste it into the session_OnStart section of global.asa.

Select ALL of the following text and paste it into the session_OnEnd section of global.asa.

Operational Information

All of the statistics except 'Total Sessions Logged' are stored by the server in application variables which allows for efficient use of system resources. These statistics will be reset if the server is restarted or when changes are made to global.asa. The statistics will start when an asp page is accessed for the first time. The session log and session counter log (named amstats.log and amcounter.log by default) are ascii text files and are not reset until done so by the user. To reset these logs, simply delete them from your server (or rename them) and new ones will be created when the server is reset. NOTE: You must have write permissions in the log file directory (root, by default) in order for the logging functions to work. An error will occur if you do not have write permissions in this directory. To disable logging, set the variable 'vUseLogFile' to 'no' in the application_OnStart section of global.asa. These log files should be located in the same directory as the other amStats files. If using a directory other than the root directory, set vLogFile and vCounterFile to the path and filename of the log files.
Check acmemalicron.com for updates to this product.