home *** CD-ROM | disk | FTP | other *** search
/ Crawly Crypt Collection 1 / crawlyvol1.bin / bbs / stats153 / statsgen.doc < prev    next >
Text File  |  1993-12-26  |  39KB  |  688 lines

  1.  
  2.                ///Turbo Board & FoReM Statistics Generator
  3.                ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  4.  
  5.                               Dec 26 1993
  6.  
  7.                               Version 1.63
  8.  
  9.                   Written by Paul Civati and Paul Baker
  10.  
  11.                         Written in GFA Basic 3.5E
  12.  
  13.                 ------------------ o -------------------
  14.  
  15. Statistics Generator is a program designed to run in the LOGOFF.BAT and
  16. DAILY.BAT of bulletin boards running Turbo Board and FoReM.  The program
  17. creates text files to go in the bulletins/database section.  These files
  18. will then be available to users so they can see daily and  ongoing call
  19. statistics, activity statistics, barchart usage, continuous usage and a
  20. sysop specified amount of lastcallers.
  21.  
  22. The program gets it's information from the TURBO.LOG or FOREM.LOG depending
  23. which system you run and has it's own pointer which it uses to search TURBO.LOG
  24. or FOREM.LOG, this increases speed as it only searches from the last pointer
  25. position.  The program looks for it's configuration file and TURBO.LOG or
  26. FOREM.LOG in the current directory.  It has a  built in error routine that
  27. should display an error number and pause before quitting, preventing lockups.
  28.  
  29.  
  30. This archive should contain:
  31.  
  32. STATSGEN.PRG  -  The main program
  33. STATSGEN.CFG  -  A sample configuration file
  34. STATSGEN.DOC  -  Your reading it
  35. STATSGEN.UPD  -  Any additional update information
  36. STATSGEN.BYP  -  Example user bypass file
  37. STATFILE.CFG  -  Example Extra paths to search or ingnore for downloads
  38. STATSGEN.LT   -  Example lastcaller text
  39. STATSGEN.DT   -  Example daily text
  40. STATSGEN.OT   -  Example ongoing text
  41. STATSGEN.GT   -  Example activity text
  42. STATSGEN.BT   -  Example barchart text
  43. STATSGEN.CT   -  Example continuous text
  44. STATSGEN.FIL  -  Example most popular downloads text
  45.  
  46.   There are several configuration options that the Sysop can change:
  47.  
  48.   * Which output files you want to produce, a lastcaller list will always be
  49.     produced but you may also choose to produce daily, ongoing, activity
  50.     barchart, continuous statistics , top XX downloads or all 7 if you wish.
  51.   * Bypass Level: Users with a equivilent or a higher level won't be added.
  52.   * Number of entries to be displayed: Number of logons to be displayed in
  53.     the output file.  As soon as a user logs off their name will be added to
  54.     the bottom and the very top name deleted.
  55.   * Number of entries to be displayed in the ongoing statistics.
  56.   * Status text applying to different access levels.
  57.   * Whether to produce doors activity in the activity statistics.
  58.   * If producing doors activity in the activity statistics what the highest
  59.     doors level to be included in the doors activity statistics is.
  60.   * Ability to include stats from multiple FDOORSx.DAT files.
  61.   * Bypass Users: An unlimited number of usernames can be specified, these
  62.     users will not be added to any of the statistics produced.
  63.  
  64.  
  65.  
  66. An example showing the type of lastcaller information produced is shown below:
  67.  
  68. Caller:              Called on:                 Off:       Baud:     Status:
  69. =======              ==========                 ====       =====     =======
  70. New User             Sep  7, 1991 at  1:23 AM    1:47 AM   300     * ID UnSaved
  71. Paul Civati          Sep  8, 1991 at  1:52 AM    1:59 AM   Local $   Sysop
  72. Bill Miller          Sep  9, 1991 at 12:37 PM   12:43 PM   19200  >  Level 3
  73. Test User            Sep 10, 1991 at  1:08 PM    1:39 PM   1200    * New User
  74.  
  75.  
  76. The program will also indicate certain information, a '*' will show that it is
  77. the users first call, a '>' will show that the user has dropped carrier and
  78. not logged off with either the 'G' or 'OFF' options.  'Local' shows that the
  79. user has logged on from the BBS computer keyboard rather than remotely via a
  80. modem.  It will also show 'ID UnSaved' if a new user logs on and decides not to
  81. save their user account for future calls.  A '$' sign will show that the user
  82. entered or tried to enter Sysop mode.
  83.  
  84.  
  85. An example showing the type of daily statistics data produced is shown below:
  86.         _____________________________________________________________
  87.         |                                                           |
  88.         |             ** Yesterdays Callers Analysis **             |
  89.         |                                                           |
  90.         |===========================================================|
  91.         | Logon Time:  Logoff Time:  Call Duration:  Daily Percent: |
  92.         |-----------------------------------------------------------|
  93.         |  10:55 PM     11:05 PM       10 minutes         8.93%     |
  94.         |  11:11 PM     11:16 PM        5 minutes         4.46%     |
  95.         |  11:18 PM     11:19 PM        1 minutes         0.89%     |
  96.         |  11:22 PM     11:59 PM       37 minutes        33.04%     |
  97.         |  12:00 AM     12:08 AM        8 minutes         7.14%     |
  98.         |  12:38 AM     12:45 AM        7 minutes         6.25%     |
  99.         |   1:23 AM      1:35 AM       12 minutes        10.71%     |
  100.         |   7:26 AM      7:58 AM       32 minutes        28.57%     |
  101.         |  12:47 PM     12:47 PM        0 minutes            0%     |
  102.         |===========================================================|
  103.         |  Total Percentage Useage.......................... 0.08%  |
  104.         |  Percentage Time No Calls........................ 99.92%  |
  105.         |===========================================================|
  106.         |  Total Time Board Used...................... 112 minutes  |
  107.         |  Average Call Duration.................... 12.44 minutes  |
  108.         |===========================================================|
  109.         |  Total Number of Calls.......................... 9 calls  |
  110.         |___________________________________________________________|
  111.  
  112.  
  113.  
  114. An example showing the type of ongoing statistics data produced is shown below:
  115.   _____________________________________________________________________________
  116.   |                                                                           |
  117.   |                      ** Ongoing BBS Usage Analysis **                     |
  118.   |                                                                           |
  119.   |===========================================================================|
  120.   |  Date Run:    Percentage Useage:  Online Time:  Average Call:  Tot Calls: |
  121.   |---------------------------------------------------------------------------|
  122.   | -- Blank --              0%           0 mins         0 mins      0 calls  |
  123.   | -- Blank --              0%           0 mins         0 mins      0 calls  |
  124.   | -- Blank --              0%           0 mins         0 mins      0 calls  |
  125.   | -- Blank --              0%           0 mins         0 mins      0 calls  |
  126.   | -- Blank --              0%           0 mins         0 mins      0 calls  |
  127.   | -- Blank --              0%           0 mins         0 mins      0 calls  |
  128.   | -- Blank --              0%           0 mins         0 mins      0 calls  |
  129.   | -- Blank --              0%           0 mins         0 mins      0 calls  |
  130.   | -- Blank --              0%           0 mins         0 mins      0 calls  |
  131.   | -- Blank --              0%           0 mins         0 mins      0 calls  |
  132.   | -- Blank --              0%           0 mins         0 mins      0 calls  |
  133.   | Sep  5, 1991         48.17%         732 mins     25.28 mins     14 calls  |
  134.   | Sep  6, 1991         34.24%         158 mins     02.83 mins     42 calls  |
  135.   | Sep  7, 1991         68.19%          94 mins     15.15 mins      6 calls  |
  136.   | Sep  8, 1991         53.86%         295 mins     35.18 mins     22 calls  |
  137.   |___________________________________________________________________________|
  138.  
  139.  
  140.  
  141. An example showing the activity statistics produced:
  142.       ______________________________________________________________
  143.       |                                                            |
  144.       |            ** Yesterdays Activity Statistics **            |
  145.       |                                                            |
  146.       |============================================================|
  147.       |                  ~ General BBS Activity ~                  |
  148.       |------------------------------------------------------------|
  149.       |                                                            |
  150.       |  Total Number of Callers.............................. 22  |
  151.       |  Total Time used by Callers.................. 349 minutes  |
  152.       |  Percentage of Available Caller Time used............ 24%  |
  153.       |                                                            |
  154.       |  Total Number of Door Executions....................... 1  |
  155.       |  Number of Callers Executing a Door.................... 1  |
  156.       |  Percent of Callers Executing Doors................... 4%  |
  157.       |                                                            |
  158.       |  Total Number of Messages Entered...................... 3  |
  159.       |  Number of Callers Entering a Message.................. 2  |
  160.       |  Percent of Callers Entering Messages................. 9%  |
  161.       |                                                            |
  162.       |  Total Number of Emails Entered........................ 5  |
  163.       |  Number of Callers Entering an Email................... 5  |
  164.       |  Percent of Callers Entering an Email................ 22%  |
  165.       |                                                            |
  166.       |  Total Number of Database Files Received............... 7  |
  167.       |  Number of Callers Receiving Database Files............ 3  |
  168.       |  Percent of Callers Receiving Database Files......... 13%  |
  169.       |                                                            |
  170.       |  Total Number of Caller Uploads........................ 1  |
  171.       |  Number of Callers Uploading........................... 1  |
  172.       |  Percent of Callers Uploading......................... 4%  |
  173.       |                                                            |
  174.       |  Total Number of Caller Downloads..................... 22  |
  175.       |  Number of Callers Downloading........................ 12  |
  176.       |  Percent of Callers Downloading...................... 54%  |
  177.       |                                                            |
  178.       |  Total Number of Caller Surveys Completed.............. 0  |
  179.       |  Number of Callers Entering Surveys.................... 0  |
  180.       |  Percent of Callers Entering Surveys.................. 0%  |
  181.       |                                                            |
  182.       |  Total Number of Times BBS List Viewed................. 1  |
  183.       |  Number of Callers Viewing BBS List.................... 1  |
  184.       |  Percent of Callers Viewing BBS List.................. 4%  |
  185.       |                                                            |
  186.       |============================================================|
  187.       |                    ~ Doors Activity ~                      |
  188.       |------------------------------------------------------------|
  189.       |  Door:                           Accesses:    Percentage:  |
  190.       |  ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~  |
  191.       |  Drag Racing ........................ 1 ........ 100%      |
  192.       |  Kold_war <New> ..................... 0 .......... 0%      |
  193.       |  Ship of Death ...................... 0 .......... 0%      |
  194.       |  Assassin ........................... 0 .......... 0%      |
  195.       |  Movie .............................. 0 .......... 0%      |
  196.       |  Arcade - Small games ............... 0 .......... 0%      |
  197.       |                                                            |
  198.       |============================================================|
  199.       |                   ~ Board Rate Usage ~                     |
  200.       |------------------------------------------------------------|
  201.       |         Speed:         Calls:         Percentage:          |
  202.       |         ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~          |
  203.       |           300 ........... 0 .............. 0%              |
  204.       |          1200 ........... 0 .............. 0%              |
  205.       |          2400 .......... 17 ............. 77%              |
  206.       |          9600 ........... 0 .............. 0%              |
  207.       |         19200 ........... 5 ............. 22%              |
  208.       |                                                            |
  209.       |============================================================|
  210.       |                ~ Download Protocol Usage ~                 |
  211.       |------------------------------------------------------------|
  212.       |      Protocol:                 Usage:    Percentage:       |
  213.       |      ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~       |
  214.       |      ASCII / Xon-Xoff .......... 0 .......... 0%           |
  215.       |      Compuserve B .............. 0 .......... 0%           |
  216.       |      Fmodem .................... 0 .......... 0%           |
  217.       |      SEAlink ................... 0 .......... 0%           |
  218.       |      Xmodem .................... 0 .......... 0%           |
  219.       |      Ymodem / Xmodem 1K ........ 0 .......... 0%           |
  220.       |      Ymodem Batch .............. 2 .......... 9%           |
  221.       |      Ymodem G Batch ............ 3 ......... 13%           |
  222.       |      Zmodem ................... 15 ......... 68%           |
  223.       |      Atari 8 Bit Xmodem ........ 0 .......... 0%           |
  224.       |      Jekyll .................... 2 .......... 9%           |
  225.       |                                                            |
  226.       |============================================================|
  227.       |                ~ Computer Type Activity ~                  |
  228.       |------------------------------------------------------------|
  229.       |  Computer Type:               Total Calls:    Percentage:  |
  230.       |  ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~  |
  231.       |  Other ............................ 0 ............ 0%      |
  232.       |  IBM PC / Compatible .............. 0 ............ 0%      |
  233.       |  Atari 8 Bit ...................... 0 ............ 0%      |
  234.       |  Commodore C-64 ................... 0 ............ 0%      |
  235.       |  DEC VT-100 (Other VT-100) ........ 0 ............ 0%      |
  236.       |  DEC VT-52  (Other VT-52) ......... 0 ............ 0%      |
  237.       |  IBM with VT-100 .................. 0 ............ 0%      |
  238.       |  Any other ANSI Terminal .......... 0 ............ 0%      |
  239.       |  Apple II ......................... 0 ............ 0%      |
  240.       |  Apple Macintosh .................. 1 ............ 4%      |
  241.       |  Atari/Mega  ST/E  TT ............ 20 ........... 90%      |
  242.       |  IBM PC/AT & Compatibles .......... 1 ............ 4%      |
  243.       |  Commodore Amiga .................. 0 ............ 0%      |
  244.       |____________________________________________________________|
  245.  
  246.  
  247. An example showing the type of barchart usage percentage produced:
  248.  
  249. -*> PLEASE NOTE <*-
  250.  
  251. Incoming mailers (if you make turbo call the mailer by using MAILER.BAT)
  252. are also included in the graph , this was changed to try and give a truer
  253. picture of when the BBS was busy.
  254.  
  255.  
  256. %age                       ** BBS Percentage Usage **
  257. 100  |                                                                  ##
  258.  95  |                                                                  ##
  259.  90  |                                                                  ##
  260.  85  |                                                                  ##
  261.  80  |                     ##                                           ##
  262.  75  |      ##             ##                            ##             ##
  263.  70  |      ##             ##                            ##             ##
  264.  65  |      ##          ## ##                            ##             ##
  265.  60  |      ##          ## ##             ##             ##             ##
  266.  55  |      ##          ## ##             ##             ##             ##
  267.  50  |   ## ##          ## ##             ##             ##             ##
  268.  45  |   ## ##          ## ##             ##             ##             ##
  269.  40  |   ## ## ##       ## ##             ##             ##             ##
  270.  35  |## ## ## ##       ## ##          ## ##             ##             ##
  271.  30  |## ## ## ##    ## ## ##          ## ##             ##             ##
  272.  25  |## ## ## ##    ## ## ##          ## ## ##          ##             ##
  273.  20  |## ## ## ##    ## ## ##       ## ## ## ##       ## ## ##       ## ##
  274.  15  |## ## ## ## ## ## ## ##       ## ## ## ##       ## ## ##       ## ##
  275.  10  |## ## ## ## ## ## ## ##    ## ## ## ## ##       ## ## ##       ## ## ##
  276.   5  |## ## ## ## ## ## ## ##    ## ## ## ## ##       ## ## ##       ## ## ##
  277.   0  |## ## ## ## ## ## ## ##    ## ## ## ## ##       ## ## ##       ## ## ##
  278.      +------------------------------------------------------------------------
  279. Hour: 00 01 02 03 04 05 06 07 08 09 10 11 12 13 14 15 16 17 18 19 20 21 22 23
  280.  
  281.  
  282. An example showing some of the continuous output produced:
  283.  
  284.           ______________________________________________________
  285.           |                                                    |
  286.           |            ** Continuous Usage Totals **           |
  287.           |                                                    |
  288.           |====================================================|
  289.           |  Total Number of Days Running................ 165  |
  290.           |----------------------------------------------------|
  291.           |                                                    |
  292.           |  Total Number of Callers.................... 4066  |
  293.           |  Total Number of Door Executions............. 253  |
  294.           |  Total Number of Messages Entered............ 600  |
  295.           |  Total Number of Email Entered............... 515  |
  296.           |  Total Number of Database Files Received..... 868  |
  297.           |  Total Number of Caller Uploads.............. 365  |
  298.           |  Total Number of Caller Downloads........... 3229  |
  299.           |  Total Number of Caller Surveys Completed..... 46  |
  300.           |  Total Number of Time BBS List Viewed........ 335  |
  301.           |____________________________________________________|
  302.  
  303.  
  304. An Example of the Top XX Downloads output
  305.  
  306.                ______________________________________________
  307.                |       Top 20 most Popular Downloads        |
  308.                |============================================|
  309.                |       Filename    |   Times Downloaded     |
  310.                |--------------------------------------------|
  311.                |   1 GUARDIAN.LZH  |            5           |
  312.                |   2 TURBO602.LZH  |            5           |
  313.                |   3 W9_374.ZIP    |            4           |
  314.                |   4 NEOSECRT.ZIP  |            4           |
  315.                |   5 FBILLV20.ZIP  |            4           |
  316.                |   6 W9_375.ZIP    |            3           |
  317.                |   7 MT_QWK9B.LZH  |            3           |
  318.                |   8 FAM_TREE.LZH  |            3           |
  319.                |   9 P_STREAM.LZH  |            3           |
  320.                |  10 W9373U.LZH    |            2           |
  321.                |  11 B_ON.PRG      |            2           |
  322.                |  12 MIKNET13.ZIP  |            2           |
  323.                |  13 JHARDUTI.ARC  |            2           |
  324.                |  14 SABRWULF.LZH  |            2           |
  325.                |  15 FAXCLASS.ZIP  |            2           |
  326.                |  16 CLODHOP.LZH   |            2           |
  327.                |  17 AV375.LZH     |            2           |
  328.                |  18 CONVERT.LZH   |            2           |
  329.                |  19 UNARJST.LZH   |            2           |
  330.                |  20 CVRT2DEM.LZH  |            2           |
  331.                |____________________________________________|
  332.  
  333. An example of the Top XX Downloaders Table
  334.  
  335.                ________________________________________
  336.                |          Top 20 Downloaders          |
  337.                |======================================|
  338.                |           Name          | Downloads  |
  339.                |--------------------------------------|
  340.                | David Craig             |    174     |
  341.                | Nigel Brookes           |    138     |
  342.                | Paul Civati             |    134     |
  343.                | Kevin Osborne           |    125     |
  344.                | Wayne Barnes            |    100     |
  345.                | Simon King              |     95     |
  346.                | Richard Lim             |     93     |
  347.                | Olusola.o.a.ogundimu    |     83     |
  348.                | Terry T, Jones          |     73     |
  349.                | Colin Bruce             |     70     |
  350.                | Paul Jackson            |     70     |
  351.                | Roy Lake                |     68     |
  352.                | Barry O'neil            |     67     |
  353.                | Bryan Jennison          |     64     |
  354.                | Darren Hook             |     63     |
  355.                | Richard Holdaway        |     62     |
  356.                | Richard Thomas          |     62     |
  357.                | Steve Morse             |     59     |
  358.                | Keith Frisby            |     57     |
  359.                | Lefteris Xanthoudakis   |     56     |
  360.                |______________________________________|
  361.  
  362.  
  363. The Top XX uploaders / message leavers and Callers Table are of the
  364. same format as the Top Downloaders Ouput
  365.  
  366. Configuring and Setting up Statistics Generator:
  367. ------------------------------------------------
  368.  
  369. The different data is produced by passing on the command line different
  370. switches to the program.
  371.  
  372.  
  373. An outline of the different switches and their useage:
  374. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  375.  
  376. Run 'L' in your LOGOFF.BAT & optionally a combination of the below 2 switches:
  377.  
  378. O : Creates STATSGEN.DAT/STATSDOR.DAT/STATSCNT.DAT datafiles for DOGBC switches
  379. H : Output Handles instead of Real Names (Turbo V2 ONLY)
  380.  
  381. Run any combination of the below 6 switches in your DAILY.BAT:
  382.  
  383. D : Daily Stats. Output     (Needs STATSGEN.DAT/STATSDOR.DAT/STATSCNT.DAT)
  384. O : Ongoing Stats. Output   (Needs STATSGEN.DAT/STATSDOR.DAT/STATSCNT.DAT)
  385. G : General Activity Output (Needs STATSGEN.DAT/STATSDOR.DAT/STATSCNT.DAT)
  386. B : Barchart Usage Output   (Needs STATSGEN.DAT/STATSDOR.DAT/STATSCNT.DAT)
  387. C : Continuous Usage Output (Needs STATSGEN.DAT/STATSDOR.DAT/STATSCNT.DAT)
  388. P : Popular Downloads Table (Needs STATFILE.DAT)
  389.  
  390. To produce lastcaller information just pass 'L' to the program, if you are
  391. planning to use the daily and/or ongoing and/or activity and/or barchart
  392. and/or continuous options and/or Popular Downloads as well an 'O' must be
  393. added so that the lastcaller data will be also outputed to other files
  394. called STATSGEN.DAT, STATSDOR.DAT, STATSCNT.DAT and STATFILE.DAT for use
  395. with the 'D', 'O', 'G', 'B', 'C' and 'P' switches.
  396.  
  397. Please note that you CAN NOT create the STATSGEN.DAT or STATSDOR.DAT files
  398. manually, you must use the 'O' switch in your LOGOFF.BAT to create them
  399. automatically.
  400.  
  401. The information for the continuous statistics is held in the STATSCNT.DAT file,
  402. this data will be added and stored in this file until it is deleted by the
  403. sysop and a new one is created, therefore resetting the data.  The output file
  404. shows the total number of days the continuous statistics have been running.
  405.  
  406. Turbo V2 Sysops ONLY, if you are using handles on your system, by adding the
  407. parameter H onto the end of your command line in the LOGOFF.BAT, StatsGen will
  408. search TPAS.DAT for the users handle and place that in the logon list instead.
  409.  
  410. Now that Turbo 2.1.x has changed the way the logfile is outputed, StatsGen has
  411. been re-written to read that type of logfile.  This means that as the handles
  412. (if enabled) are outputed to TURBO.LOG, StatsGen will no longer need to read
  413. the TPAS.DAT for verson 2.1.x and higher.  The code is still compatible with
  414. all previous versions... 1.0, 2.0.x and 2.1.x
  415.  
  416. The 'LO' switches are designed to be run AFTER logoff, so do not run the
  417. program from sysop mode unless you have previously logged off or you have not
  418. logged on at all.  An error 26 will occur if you do as the program searches
  419. for the text 'Off at' or 'Hangup at', therefore if you havn't logged off the
  420. pogram will not find this text in the log file.
  421.  
  422. To produce the daily data you must pass 'D' to the program and if you want to
  423. produce the ongoing data you must pass 'O' to the program, 'G' creates the
  424. general activity data, 'B' produces the barchart usage statistics and 'C'
  425. creates the continuous usage data, 'DOGBC' togther will produce all 5.
  426.  
  427. The logon list data must be created at every logoff so as an example if you
  428. wanted to produce a lastcaller and also produce daily/ongoing data you would
  429. put something like 'D:\STATSGEN.PRG LO' in your LOGOFF.BAT
  430.  
  431. Then when you want to create the daily/ongoing/activity/barchart/continuous
  432. output files you would run something like 'D:\STATSGEN.PRG DOGBC' in your
  433. batch file DAILY.BAT
  434.  
  435. If the program is run without any switches a list of the available switches
  436. and the relevent .BAT files will be shown, you can then just press a key to
  437. exit or the program will automatically exit after 30 seconds or so.
  438.  
  439. The program also requires its own configuration file, STATSGEN.CFG, this can
  440. either be edited/created with a text editor or with the internal generator of
  441. Statistics Generator.  If you run Statistics generator without a configuration
  442. file present it will create one, asking you to input data.  When entering
  443. output filenames and paths, a fileselector will be brought up if no filename
  444. and path is entered, this will enable you to use the fileselector to change
  445. the output filename and path, which may be easier.  You can edit an existing
  446. STATSGEN.CFG by passing 'EDIT' to the program on the command line, it can also
  447. be edited with a text editor if you wish, the format is shown below.
  448.  
  449. One of the features described below is bypassing, those are options that can
  450. be run all of the time, if you just want to bypass one user once then you can
  451. do that when the program is running from the LOGOFF.BAT and is running the 'L'
  452. and/or 'O' switches.  As soon as the program runs just hit the space bar and it
  453. should bypass, if successful is will say "User Bypassed...".
  454.  
  455. If you want to bypass a certain set of users then you just have to create an
  456. ASCII text file containing their names.  This file should be in the same
  457. directory as StatsGen and be called STATSGEN.BYP, his text file must contain
  458. the names of the users you want to be bypassed, one per line.  These names
  459. must be their REAL names (not their handles if you are running Turbo 2 and
  460. have handles switched on), they can be upper, lower or mixed case and, it
  461. doesn't matter as StatsGen will match that to the username found.
  462.  
  463. The program also allows you to add yur own text to the bottom of any of the
  464. four files produced, this is an option and will only work if the files exist
  465. in the same directory as the program.  If you do not wish the text to be
  466. appended to the output files then just delete the relevent files.  When the
  467. program runs it will also display a status line showing the progress as it
  468. scans the logfile, this will show one "." for every bit of information found,
  469. whether that is a door, msg entered, email entered, download, upload, etc.
  470.  
  471.  
  472. The text is found in the ASCII text files as follows:
  473.  
  474. STATSGEN.LT for lastcaller output
  475. STATSGEN.DT for daily output
  476. STATSGEN.OT for ongoing output
  477. STATSGEN.GT for general activity output
  478. STATSGEN.BT for barchart usage output
  479. STATSGEN.CT for continuous usage output
  480.  
  481.  
  482. Below is the format of an example configuration file showing what the different
  483. lines of the file are for, you should edit the example file included in the
  484. archive for your own BBS setup or use the 'EDIT' option as explained above:
  485.  
  486.  1:  0                       Log pointer
  487.  2:  20                      Number of entries to be shown in lastcaller list
  488.  3:  15                      Number of entries to be shown in the ongoing stats
  489.  4:  32768                   Bypass level
  490.  5:  D:\DATA\CFG\FDOORS.DAT  Path to your Fdoors.dat file
  491.  6:  32766                   Maximum level of doors to display in general stats
  492.  7:  D:\DATA\DB\DB001.010    Output file and path for logons list
  493.  8:  D:\DATA\DB\DB001.011    Output file and path for daily statistics
  494.  9:  D:\DATA\DB\DB001.012    Output file and path for monthly statistics
  495. 10:  D:\DATA\DB\DB001.013    Output file and path for activity statistics
  496. 11:  D:\DATA\DB\DB001.014    Output file and path for barchart statistics
  497. 12:  D:\DATA\DB\DB001.015    Output file and path for continuous statistics
  498. 13:  D:\DATA\DB\DB001.016    Output File for Most Popular Files
  499. 14:  10                      Number of files to show (e.g. Top 10)
  500. 15:  30                      Number of days to keep records of downloads
  501. 16:  D:\DATA\DB\DB001.017    Output File for Top XX Downloaders
  502. 17:  Top 20 Downloaders      Title for the Top Downloaders
  503. 18:  20                      Number of Downloaders to Show
  504. 19:  D:\DATA\DB\DB001.018    Output file for Top XX Uploaders
  505. 20:  Top 20 Uploaders        Title for the Top Uploaders
  506. 21:  20                      Number of Uploaders to show
  507. 22:  D:\DATA\DB\DB001.019    Output File for Top XX Message Leavers
  508. 23:  Top 20 Message Leavers  Title for Top Message Leavers
  509. 24:  20                      Number of Message leavers to show
  510. 25:  D:\DATA\DB\DB001.020    Output file for Top BBS Callers
  511. 26:  Top 20 BBS Callers      Title for Top Callers
  512. 27:  20                      Number of Callers to show
  513. 28:  Custom                  Other levels status text
  514. 29:  9                       Number of status levels
  515. 30:  0,New User              Status level 1
  516. 31:  1,Level 1               Status level 2
  517. 32:  2,Level 2               Status level 3
  518. 33:  3,Level 3               Status level 4
  519. 34:  4,High Level            Status level 5
  520. 35:  5,Special               Status level 6
  521. 36:  7,Vis Sysop             Status level 7
  522. 37:  99,Co-Sysop             Status level 9
  523. 38:  32767,Sysop             Status level 10
  524.  
  525. Line 1 is the pointer, before running the program for the FIRST time this
  526. should be set to 0, from then on it should NEVER be altered as the program
  527. sets it as it uses it.
  528.  
  529. Line 2 tells the program how many entries to display in the output file, when
  530. a new entry is added to the bottom of the file the one at the very top will be
  531. deleted.  This has the effect that new entries will be added and the oldest
  532. will scroll off the top, contstantly displaying the number of entires as set
  533. in the configuration.  When changing the number of entries, the output file
  534. should be deleted and the program will create a new one as it will when you
  535. run it for the first time.  When it has created this file it will add the
  536. latest logon information to the bottom, the rest of the entries will be blank.
  537. So if you set the configuration file for 20 entries then when you run the
  538. program for the first time the output file will contain the title, 19 blank
  539. lines then another line, the latest user information.
  540.  
  541. Line 4 is the bypass level, any users who have an access level equvilent to
  542. this or higher will not be added to the output file.
  543.  
  544. Line 5 is the path to your Fdoors.Dat file for the activity statistics, if you
  545. do not wish to include doors activity in the activity statistics then set this
  546. as 'NO'.  If you add or delete any doors from your FDOORS.DAT file and you
  547. have doors enabled for your activity statistics then you MUST delete
  548. STATSDOR.DAT afterwards, this is so that the doors in the FDOORS.DAT tie up
  549. with the doors data in the STATSDOR.DAT, after it has been deleted statistis
  550. generator will create a new STATSDOR.DAT for the new FDOORS.DAT file.  If you
  551. have multiple FDOORSx.DAT files then make this the path to your FDOORS1.DAT
  552. file, eg. D:\FDOORS1.DAT, StatsGen will automatically search for any more that
  553. exist in the same path, eg. StatsGen would next search for D:\FDOORS2.DAT,
  554. D:\FDOORS3.DAT, etc and would stop when no more exist.  You MUST do as with
  555. the above single FDOORS.DAT file and delete your STATSDOR.DAT file if you
  556. change/add/delete ANY entries from ANY of your FDOORSx.DAT files.
  557.  
  558. Line 6 is the maximum access level of doors to display.  Any doors contained
  559. in the FDOORSx.DAT with an access level which is higher than this will not be
  560. shown in the doors section (if enabled) of the general activity statstics.
  561. This could be useful for stopping the listing of a doors program which only
  562. co-sysops have access to.
  563.  
  564. Line 7 is the output filename and path for the logons data.
  565.  
  566. Line 8 is the output file and path for the daily statistics if you wish to
  567. use this option.
  568.  
  569. Line 9 is the output file and path for the monthly statistics if you wish to
  570. use this option.
  571.  
  572. Line 10 is the output file and path for the activity statistics if you wish to
  573. use this option.
  574.  
  575. Line 11 is the output file and path for the activity statistics if you wish to
  576. use this option.
  577.  
  578. Line 12 is the output file and path for the continuous statistics if you wish
  579. to use this option.
  580.  
  581. Line 13 is the output file and path for the Top XX Downloaded Files if you
  582. wish to use this option, if not then leave it blank.
  583.  
  584. Line 14 is the number of files to show in the text file in line 13
  585. (10 = Top 10 Downloads etc), files with the same number of downloads are
  586. shown in 'date last downloaded' order with the more recent downloads at the
  587. top of the list. , Leave a blank filename if you don't want this feature.
  588.  
  589. Line 15 is the number of days to keep records of downloaded files , after
  590. this number of days the file STATFILE.DAT wraps so you get a continuous
  591. record of currently popular files ,rather than just a static one only
  592. showing the files downloaded the most since the BBS was started.
  593.  
  594. Line 16 - 27 are of the format of  Path for the output , title to be used
  595. for the box and number of users to show , they are pretty self explanatory.
  596.  
  597. If you do not wish to have a particular table produced thenjust leave the
  598. path for the file blank (Press Cancel whilst on the dialogue box when using
  599. the parameter EDIT)
  600.  
  601. Line 28 is the status text to be displayed under the status part in the title
  602. line.  This is the text that will be used if the current users access level
  603. doesn't match any of the specified ones in the config file.
  604.  
  605. Line 29 is the number of different status levels you want to display, the
  606. number of status lines after this line MUST match the number entered here.
  607.  
  608. Lines 30-??  are the different status levels, there MUST be the same number of
  609. these as specified in line 11.  Each of these lines must contain a number and
  610. the corresponding status text to be displayed seperated by a comma.  So you
  611. can set the program to display different status text for the different access
  612. levels that your users might have.
  613.  
  614. Configuring STATFILE.CFG
  615. ========================
  616.  
  617. STATSGEN will search the log for downloads & check the paths against those
  618. download areas listed in your CONFIG.DAT (Turbo V2 Only), if not from these
  619. areas the file will be ignored.
  620.  
  621. Non Turbo V2 bbs can restrict the paths that files are to be listed from
  622. by creating a STATFILE.CFG file, this also allows V2 sysops to add files
  623. downloaded from database areas to the list.
  624.  
  625. The file is just a list a list of paths that you either want or don't want
  626. to be included in your list , the basic list for non V2 sysops will be the
  627. name of each of your download areas and is of the following format , paths
  628. you don't wish to include should start with a minus sign.
  629.  
  630. \MAGAZINE\
  631. -\BBS\
  632.  
  633. any downloaded file from e:\turbo\magazine\ d:\magazine\ etc etc etc will be
  634. included , whereas any file from c:\bbs\ f:\forem\dload\bbs\ will be
  635. ignored
  636.  
  637. The reason for the \ on either end is so if e:\turbo\files\magazine.txt is
  638. downloaded then it won't be confused with a valid download and ignored.
  639.  
  640. This program has been tested on Turbo Board ST versions 1 & 2 upto 2.2.1 and
  641. seems to work quite well, although I make no claim or warranty that the
  642. program is bug free or error free, it is the understanding that you run the
  643. program at your own risk.
  644.  
  645. This program is free to be distributed as long as no profits are made from it
  646. whatsoever and it is distributed with all files intact and in its original
  647. state.  Thanks to Paul Baker for beta testing the program on his BBS, giving me
  648. ideas and GFA help for the barchart output and the top XX downloads code.
  649. Any comments, bug reports, suggestions, donations, etc would be gratefully
  650. received, contact me in Email.
  651.  
  652. This program is postcardware, please send me a postcard from your home country
  653. telling me you are using it and any problems or ideas for the program, it is
  654. interesting to know how many people are finding my program useful and are using
  655. it, it also motivates me to make updates, fix bugs and add new features!
  656.  
  657. Thanks go to all beta testers, people who have reported bugs, suggested new
  658. features, and those who have made donations...
  659.  
  660. Paul Baker,Paul Simmonds,Daron Brewood,Jerry Bechard,Al Petersen,Steve Caple.
  661.  
  662.  
  663. ===============================================================================
  664.      Versions after 1.30 now work with all versions of FoReM up to 2.8W2!
  665. ===============================================================================
  666.  
  667. To due lack of money, being 17 and at college I don't currently run a BBS of
  668. my own (would like to!) but can be contacted at one of the below addresses,
  669. although I prefer mail directed to one of my point addresses:
  670.  
  671. Paul S Civati               @ The Tavern BBS
  672. 36 Sunnymede Avenue,          FidoNet 2:440/108
  673. Carshalton,                   NeST 90:102/140
  674. Surrey,                       TurboNet 100:1011/0
  675. SM5 4JF,                      UK +44-81-445-6514
  676. England.                      24 Hours
  677.  
  678. Paul Civati @ FidoNet 2:254/108.1, NeST 90:102/142 & TurboNet 100:1011/0.1
  679.  
  680. A word from our sponsor:
  681.  
  682. I have changed the version Paul Civati gave me last by quite a bit , if he
  683. can't help ,then yuu can contact me instead.
  684.  
  685. Paul Baker (sysop of the Tavern BBS)
  686.  
  687. ===============================================================================
  688.