home *** CD-ROM | disk | FTP | other *** search
/ Beijing Paradise BBS Backup / PARADISE.ISO / software / BBSDOORW / ECHOREPT.ZIP / ECHOREPT.DOC < prev    next >
Encoding:
Text File  |  1993-12-12  |  3.5 KB  |  98 lines
  1. ECHOREPT -- Incoming echo traffic reporter for Gecho
  2. by Tom Almy, Fidonet 1:105/290, Internet tom.almy@tek.com
  3. Copyright 1993 by Thomas Almy.
  4.  
  5. ECHOREPT is a free program, which comes with source code in C. You
  6. may modify it, and do anything you want with it. Use it at your own
  7. risk.
  8.  
  9. ECHOREPT is based on the program GMS, but is easier to use, and
  10. produces simpler output. I wrote it because I wanted reports on a
  11. revolving basis -- for example, the last 7 days rather than during the
  12. current week.
  13.  
  14. To use, place ECHOREPT in your path, then run it as follows after every
  15. gecho toss:
  16.  
  17.    gecho toss
  18.    echorept
  19.  
  20. The ECHOREPT program normally deletes the summary.log file after running.
  21. If you are using GMS at the same time, then use the following commands:
  22.    
  23.    gecho toss
  24.    copy %ge%\summary.log temp.log
  25.    gms  <any gms arguments>
  26.    copy temp.log %ge%\summary.log
  27.    erase temp.log
  28.    echorept
  29.  
  30. ECHOREPT can also keep separate tabulations for individual Gecho groups or
  31. combinations of groups. To create a record file for an individual group
  32. or groups specify the group letters (capitalized) after a hyphen as the
  33. first command line argument. For instance, to record groups A and C
  34. as a separate tabulation:
  35.  
  36.    echorept -AC
  37.  
  38. The summary.log file is not deleted in this case, allowing multiple
  39. tabulations to be kept, even involving some of the same groups. The
  40. data is kept in a file netrep2.XYZ where XYZ are the first three groups
  41. named. It is important that the group combinations be specified consistantly,
  42. and that the first three be unique.
  43.  
  44.    To record groups A, B, and C separately, and B and C in combination, you
  45. could use the following batch program sequence:
  46.  
  47.    gecho toss
  48.    echorept -A
  49.    echorept -B
  50.    echorept -C
  51.    echorept -BC
  52.    erase %ge%\summary.log
  53.  
  54. ECHOREPT requires the correct setting of the GE environment variable.
  55. ECHOREPT creates and modifies a data file in the directory that it is
  56. run from. ECHOREPT is configured to handle over 5000 areas, and
  57. deletes dropped areas after they have had no traffic in thirty days.
  58. If groups are specified, the limitations apply to individual groups,
  59. expanding capacity even further.
  60.  
  61. To create reports, give the report file name(s) as arguments. There
  62. are four reports. If insufficient arguments are given, only those
  63. arguments provided will produce reports. To not produce a specific
  64. report, give the name "nul". Besides "nul", the names must be unique.
  65.  
  66. Reports are made from the general tabulation. To generate reports from
  67. a group tabluation, specify the group names in the first argument after
  68. a hyphen. In this case there can be four additional arguments after the
  69. group argument.
  70.  
  71. echorept rep1.asc        -- produce the first report as rep1.asc
  72. echorept rep1.asc rep2.asc rep3.asc rep4.asc  -- produce all 4 reports
  73. echorept nul rep2.asc    -- produce only the second report.
  74. echorept -BC nul rep2bc.asc -- produce second report based on tabulation
  75.                                of groups B and C created with "echorept -BC"
  76.  
  77. The first report shows today's traffic, since last midnight.
  78.  
  79. The second report shows traffic in the last seven days, and the totals for
  80. that period.
  81.  
  82. The third report shows traffic in the last four weeks.
  83.  
  84. The fourth report shows total traffic in 30 days.
  85.  
  86.  
  87. Enjoy!
  88.  
  89. Tom
  90.  
  91. REVISION HISTORY ==
  92.  
  93. 12/93 -- Added ability to tabulate by groups.
  94.  
  95. 6/93 -- Changed to dynamically allocate memory using a "huge" array to
  96.   increase number of echo areas to limit by memory size. Fixed bug with
  97.   having second argument in SET GE string.
  98.