FrontDoor Statistics Generator(tm) (C)Copyright 1996 Scott Hall ----------------------------------------------------------------------------- ----------------------------------------------------------------------------- 0. Index ----------------------------------------------------------------------------- 1. NetMailWare!?!? 2. AGREEMENT 3. Requirements 4. What the hell is FDStat? 5. What are all those numbers and stuff? 6. FDStat's FD Major Events Log 7. Switches 8. Future Enhancement 9. Thanks!! 10. COPYRIGHT 11. Version History with Fixes and changes documented. 12. Bug reports ----------------------------------------------------------------------------- 1. NetmailWare!?!? ----------------------------------------------------------------------------- This program is NetmailWare. Which means that you are free to use it as long as you wish for FREE! If you do plan on using this program all I would like is a Netmail message. I want to see how far this program gets and how popular it is/will be (if at all :) ). My address is Scott Hall at FidoNet 3:712/393 or shall@idx.com.au for e-mail. If you are impressed at getting this program for free then please consider a donation to a animal shelter or humanitarian organisation. ----------------------------------------------------------------------------- 2. AGREEMENT ----------------------------------------------------------------------------- FrontDoor Statistics Generator and FDSTAT is a Trade Mark owned by Scott Hall. This program is (C)Copyright 1996 Scott Hall. I grant permission for any person or company to use any of this program of portions thereof for any purpose EXCEPT WHERE the subsequent product: a) is not available to the public free of charge. b) is called "FrontDoor Statistics Generator" or "FDSTAT" If you use this program, or portions thereof, you accept the above condions. This program is running on my system and seems quite safe BUT this program may have bugs. This program only reads your FrontDoor log files and NEVER touches any other FrontDoor system files. YOU USE THIS PROGRAM AT YOUR OWN RISK!! I can not be held responsible for any loss, injury or death cause by using this program. You agree to pay all the costs of any damages and not hold me responsible for any loss, injury or death caused by this program. You aggree to send me a netmail message. Use of this program constitutes agreement to these conditions mentioned above. ----------------------------------------------------------------------------- 3. Requirements ----------------------------------------------------------------------------- * A FrontDoor log to read. * All options in FD menu Mailer>Log set to "Yes". * FD environment variable set to FrontDoor directory ----------------------------------------------------------------------------- 4. What the hell is FDStat? ----------------------------------------------------------------------------- Might it be easier to run the program to find out that? If so try the program first.... geeze!! :) A program should self be explainatory don't you think? OK, so hopefully you have seen the nice and informative display. If not then (Oh No!) you have seen an error message. Follow the programs instructions or fix the error and try again. If this doesn't fix the problem send me a message (See bottom of this file). ----------------------------------------------------------------------------- 5. What are all those numbers and stuff? ----------------------------------------------------------------------------- The screen is divided into 6 windows and 3 information lines at the bottom of the screen. PROCESSING WINDOW Here you can watch (if you are quick!) what part of the FD (FrontDoor) Log is being processed at that moment. INCOMING/OUTGOING POLLS This display uses 2 windows. The columns of information/statistics of these 2 windows are: : / / / NB: One of the "modem speeds" is SCR. If you use the scripting facility within FrontDoor then modem CONNECT messages are not recorded in the FD.LOG. Therefore no connect speed can be obtained by this program. Therefore the statistic for scripted connections are shown under the SCR value. Another "modem speed" is shown as "Tot" this is short for Total. This row shows totals for all the other modem speeds except CPS rates. The CPS rate in the Total row is an avarage. CALLERS Statistics on what Baud rates applied to human callers that FD passed onto your BBS. Successful Connects = Successfully connected human callers Failed = Calls that were not successful (assumed to be failed human callers) Rejects = Human callers rejected during NU (No Users) event. ie. Event>Behaviour>"Allow User during Event" was set to 'No' FILE TRANSFERS Statistic on the type of files sent. TX = Transmitted or sent files. RX = Recieved files. DDn = Count echomail bundles with the file extension in the format. . eg 1FC233D0.MO1 (in this MO = Monday) PKT = Netmail Packets TIC = Tick files Other = any other type of file sent (perhaps File Attached Netmail). Pollers = Total time spent receiving and sending files when you were polled. Polling = Total time spent receiving and sending files when you were polling. $ = Phone costs as per FDNODE.CTL (which bears no resemblence to our real phone bill costs here in Australia because we don't have timed calls.. so Telstra tells us anyway!) ERRORS Pollers = Errors encountered whilst another system was polling you. Polling = Errors encountered whilst your system was was polling another. RX Files = Errors encountered whilst receiving a file from another system. TX Files = Errors encountered whilst sending a file to another system. Pwords = Password session errors encountered. Others = any other error not covered by the above. INFORMATION LINES The third last line shows the begin and end dates of the log being processed. The second last line shows the last error message found and on the extreem right is where "Writing..." (ie BBS Screens or statistics to major events log), "Completed!" or "ABORTED!" (ie. Esc key was detected) is displayed. Occasionally you may see a dark grey T or D, these indicate FDSTAT is time slicing so that other programs get a share of the CPU. T = General (ie OS/2, Windows, Windows95), D = DesqView 2.00 or greater. The last line shows what log is being processed and where "major events" are being written to (See next section). ----------------------------------------------------------------------------- 6. FDStat's FD Major Event Log (MEL) ----------------------------------------------------------------------------- FDStat writes all major events found in FD Log to FDSTAT.LOG* In this file will be found errors, polling and poller events with simplified info. If you got FDStat to work before why not look in you FD Log directory and examine FDSTAT.LOG? * This file name may be changed see "Switches" below. ----------------------------------------------------------------------------- 7. Switches ----------------------------------------------------------------------------- FDStat has 6 switches/parameters. FDStat [/LOG={ [Path] Log File}] [/OUT={ [Path] Output File }] [/BBS={BBS Screen Path}] [/NODE={Node}] [/NoPause] [/NoBeep] /LOG= is used to specify the path & file name of the FD log to be processed. If /LOG is not used it will default to FD.LOG in the FD directory. If only a file name is supplied it will look for it in the FD directory. If a full path and file name is supplied it will process that log file." *Note*: to use the current directory use /OUT=.\{filename} /OUT= is used to direct the output to a path & filename. If /OUT is not used it will default to FDSTAT.LOG in the FD directory (See /NODE). If only a file name is supplied it will place it in the FD directory. If a full path and file name is supplied it will place the output there. *Note*: to use the current directory use /OUT=.\{filename} /BBS= Causes BBS style FDSTAT.ANS/ASC/ASL screens from statistics screen to be placed in the supplied directory. (See /NODE) ie. /BBS=C:\BBS\SCREENS\ /NODE= is used to modify the the filenames FDSTAT.LOG and FDSTAT.ANS/ ASC/ASL (BBS Screens) to include a node number." ie /NODE=1 will produce FDSTAT1.xxx Other names not modified. *Note*: Node number can only be 2 aphanumeric characters long. *Note*: /NODE could be used to keep multiple days worth of logs and BBS screens for a multinode BBS by using the /NODE=dn where d = day number and n = node number. Thereby FDSTATdn.LOG and FDSTATdn.ASC/ANS/ASL are produced. /NoPause means that the program will not pause and wait for you /NP to acknowledge the error message found in the FD log being processed. /NoBeep is used to stop the program from beeping when an an error /NB message was found in the FD log being processed. /TS= is used to modify how often time slices are given back to your multitasker. Lower number = more often, default is 9. 0 = no time slicing, force generic time slicing for DOS networking TSRs by giving a non-zero value. This program auto-detects Windows, Windows95, OS/2 and DESQview. --------------------------------------------------------------------------- 8. Future Enhancements --------------------------------------------------------------------------- Depends on feedback. --------------------------------------------------------------------------- 9. Thanks!!! --------------------------------------------------------------------------- Thanks to: * David "If you can't make it work atleast make it look good!" Greene for his help with this program. * The áETA Team: Charlie Smith, Mark Ellis, Jeff Schrunk, Tom Van Overbeke, Mark "Crazy Horse", Alex Zamorano, Ryan Frank, Kees Wiegel, James Ducan, Andrew Blume, Mike Jabour, John Bodoni, Danny Walters, Jeremy Idol, Sander Braaksma. Thanks a lot! * All others who have sent mail. --------------------------------------------------------------------------- 10. COPYRIGHT --------------------------------------------------------------------------- FDStat is Copyright 1995-1996 Scott Hall FrontDoor Statistics Generator is Copyright 1995-1996 Scott Hall FrontDoor is Copyright 1989-1994 Joaquim Homrighausen. TICK is Copyright 1988-1992 Barry Geller. ...but only one is completely free! :) --------------------------------------------------------------------------- 11. Version History --------------------------------------------------------------------------- See the file FDSTAT.HIS --------------------------------------------------------------------------- 12. Bug Reports --------------------------------------------------------------------------- Send bug reports, praise, hate mail, flames, bombs, flowers, money etc. to: Scott Hall FidoNet: 3:712/393 E-mail: shall@idx.com.au (this one first) WWW: http://www.idx.com.au/~shall --------------------------------------------------------------------------- The End Finally... don't you just love writting doco? How was the spelling? ---------------------------------------------------------------------------