===============================================================
          SofTrack Timed Reporting Script For WEB
               By Vern Graner CNE/CNA/MCP
                 Integrity Software Inc.
                   Nov 26, 2002 V0.2b
===============================================================

This archive contains a collection of files that will allow you
to create SofTrack reports on a scheduled basis and send those
reports to a web server if desired. When set up properly, these
files can create a number of different reports and send them to
multiple web servers via FTP as often as you deem necessary.

This "kit" is a good starting point for creating your own
advanced automated reports for SofTrack and making them
available to people without requiring the intervention of
the administrator. It is NOT shipped to function without
modification! You will need to examine each file and modify
the specifics (server names, reports preferred, web server
names etc) before use.

NOTE: The use of this system assumes a working knowledge of FTP
commands, the Windows Scheduling Agent (or the Windows NT4 "AT"
command) and DOS Batch file programming. If you are unclear on
any of these concepts, you may need to have your network
administrator assist you in setup and configuration. You may also
contact vern graner (the author) at vgraner@softwaremetering.com
for assistance. :)

=== Contents of the Archive: ===

README.TXT-	The file you are reading now

webreport.htm-	An example web report file

weblog.txt-	An example log of the web reporting status. To be
                used for troubleshooting or to check to see if the
                report was generated as expected.

ftp-up.cmd-	A list of commands fed to the FTP command to push
                your report to the web server.

footer.txt-	A file that is appended to the raw report to create
                a properly formatted HTML document

header.txt-	A file that is pre-pended to create the begining of
                a properly formatted HTML document

wreport.bat-	the file used to generate the web report (this is
                the one your scheduling agent should point to)

(Files not included in this archive, but required for it to work:)

ST2K_RPT.EXE-	This is the command line reporting tool for SSA's
                on Windows servers

SOFTDRPT.EXE-	This is the command line reporting tool for SSA's
                on Novell servers

=== Installation steps: ===

0. Decompress this archive

   Once you have decompressed the archive, copy all the files
   together into a folder on the machine that will be doing the
   scheduled task. This machine should be logged in to the network
   and be capable of running reports. Verify this to be the case
   before you begin by running at least one report by hand with
   the command line tool! :)

1. Modify the WREPORT.BAT

   YOU will need to start by modifying this file to include the
   proper switches for the command line SOFTRACK report generator.
   To see the options, it would be best to type the command
   (ST2K_RPT.EXE or SOFTDRPT.EXE) on a command line with "-?" to
   see a list of commands. Once you have sucessfully create a
   report in this manner, modify the WREPORT.BAT to use the
   switches. You may choose to copy the WREPORT.BAT file to
   multiple names and have each one run a different report on
   a different server and send the results to a different web
   page. Modify to taste. :)

2. Modify the FTP-UP.CMD file

   This file is actually "fed" to the command line FTP. Each line
   is sent to the FTP command and interpreted in sequence. NOTE:
   This file will contain the USername and Password for the FTP
   account so you need to thnk about security (i.e. place the
   file in a directory only administrators have access to).

3. Created a schedule task to run the WREPORT.BAT

   If you are going to run this unattended, you will need to have
   a machine that will start the script at the time you want it
   to run. If you have a Windows 2000 server, it is a relatively
   simple task to place this command into the Scheduling Agent on
   that server. If you have an NT4 server, you may use the AT
   command to cause this to run. If you have a Novell server, then
   you will need to specify a workstation to run this task. A
   Windows 9x/ME/2K/XP station can use the Scheduling Agent and
   NT4 workstation has the "AT" command. These services are very
   well documented so specific examples are omitted here. If you
   need help setting up the scheduler, contact me and I will try
   and help you get it set up. :)

4. Review the WEBLOG.TXT for errors/details

   One you have the script scheduled, you may review the WEBLOG.TXT
   to see how the script is working and to see if there are any
   errors from previous runs. Once the system is functioning well,
   you may choose to alter the form and function of the WEBLOG.TXT
   in the folloing manner:

   A-Remove the line from the WREPORT.BAT file that
     creates the WEBLOG.TXT. Do this if you do not
     need/want reports on if/when the unattented
     report ran.

   B-Replace the ">>" redirector with a single ">"
     redirector. This will cause the WEBLOG.TXT to be
     overwritten every time the file runs. This allows
     you to see the most recent result of the file run

   C-REM out the line so no WEBLOG.TXT is created at all.

=== Conclusion ===

Thats about it for this project. It should give you a good starting
place for creating your own automated SofTrack reports. Good Luck! :)

--
*===========================================================*
| Vern Graner CNE/CNA/MCP      |                            |
| Senior Systems Engineer      | "When requesting Technical |
| Integrity Software           | Support, there is no such  |
| 1 (512) 372-8991 X611        | thing as too much detail!" |
| vgraner@softwaremetering.com |                   -- VLG   |
| www.softwaremetering.com     |                            |
*===========================================================*


