home *** CD-ROM | disk | FTP | other *** search
/ ftp.wwiv.com / ftp.wwiv.com.zip / ftp.wwiv.com / pub / HATCH / NETM101.ZIP / NETMETER.DOC < prev    next >
Text File  |  1996-08-04  |  11KB  |  247 lines
  1. ┌─────────────────────────────────────────────────────────────────────────────┐
  2. │─══────══──══════──════════──══───────══──══════──════════──══════──═══════──│
  3. │─═══───══──══─────────══─────═══─────═══──══─────────══─────══──────══────══─│
  4. │─════──══──══─────────══─────════───════──══─────────══─────══──────══────══─│
  5. │─══─══─══──══════─────══─────══─══─══─══──══════─────══─────══════──═══════──│
  6. │─══──════──══─────────══─────══──═══──══──══─────────══─────══──────══───══──│
  7. │─══───═══──══─────────══─────══───═───══──══─────────══─────══──────══────══─│
  8. │─══────══──══════─────══─────══───────══──══════─────══─────══════──══────══─│
  9. │                                                                             │
  10. │                              NetMeter v1.01                                 │
  11. │                     Copyright (c) 1996 by Cris McRae                        │
  12. │                            All Rights Reserved                              │
  13. │                                                                             │
  14. └─────────────────────────────────────────────────────────────────────────────┘
  15.  
  16. ┌─────────────────────────────────────────────────────────────────────────────┐
  17. │░░░░ INTRODUCTION ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
  18. └─────────────────────────────────────────────────────────────────────────────┘
  19.  
  20. NetMeter is a WWIV utility that keeps track of the number of posts going to
  21. and through your system.  It keeps logs on a daily and monthly basis.
  22.  
  23. This can be useful for systems that hub for an area, or for servers, that want
  24. to determine how much post traffic is going through their system.  Or how much
  25. post traffic is going to systems that you connect to.
  26.  
  27. NetMeter is a NETWORK1 preprocessor.  It has built-in compression support, so
  28. you can continue to use network compression if you are doing so.
  29.  
  30. ┌─────────────────────────────────────────────────────────────────────────────┐
  31. │░░░░ REQUIREMENTS ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
  32. └─────────────────────────────────────────────────────────────────────────────┘
  33.  
  34.   ■ WWIV v4.23 or higher
  35.  
  36. ┌─────────────────────────────────────────────────────────────────────────────┐
  37. │░░░░ INSTALLATION ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
  38. └─────────────────────────────────────────────────────────────────────────────┘
  39.  
  40. To install NetMeter v1.01, you must unzip NETM101.ZIP to your main WWIV BBS
  41. directory.  Here is what should be included in the archive:
  42.  
  43.     NETMETER.DOC - NetMeter v1.01 documentation file
  44.     NETMETER.EXE - NetMeter v1.01 executable file
  45.     REGISTER.TXT - NetMeter v1.01 registration form
  46.     FILE_ID .DIZ - File description
  47.  
  48. You should rename NETWORK1.EXE to NETWRK1.EXE.  Then rename NETMETER.EXE to
  49. NETWORK1.EXE.
  50.  
  51. ┌─────────────────────────────────────────────────────────────────────────────┐
  52. │░░░░ CONFIGURATION (WWIV.INI) ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
  53. └─────────────────────────────────────────────────────────────────────────────┘
  54.  
  55. The configuration information for NetMeter is located in WWIV.INI.  If this
  56. file already exists, NetMeter will append it's configuration info to the end
  57. of the file.  Otherwise, it will create it.
  58.  
  59. Here is a sample WWIV.INI entry for NetMeter:
  60.  
  61. [NetMeter]
  62. TRAFFIC_LOG                 =Yes
  63. DAYS_LOGGED                 =7
  64.  
  65. An explanation of each line follows:
  66.  
  67. TRAFFIC_LOG:
  68. ~~~~~~~~~~~
  69. NetMeter keeps a few types of detailed log files.  It can track the number
  70. of posts made on all sub types that pass through your system.  It can also
  71. track the number of posts (and total K) going to systems that connect with
  72. your system.  You may enable this option for specific networks, and not
  73. others.
  74.  
  75. Examples:
  76.  
  77.     TRAFFIC_LOG = Yes
  78.  
  79.          -or-
  80.  
  81.     TRAFFIC_LOG[XYZnet] = Yes
  82.     TRAFFIC_LOG[ABCnet] = Yes
  83.  
  84. More information about traffic logging is in the "TRAFFIC LOGGING" section.
  85.  
  86. DAYS_LOGGED:
  87. ~~~~~~~~~~~
  88. This is used in conjunction with the TRAFFIC_LOG option.  This allows you to
  89. specify the number of daily logs to keep.  You may specify different amounts
  90. for different networks, or one global value.
  91.  
  92. Examples:
  93.  
  94.     DAYS_LOGGED = 7
  95.  
  96.          -or-
  97.  
  98.     DAYS_LOGGED[XYZnet] = 7
  99.     DAYS_LOGGED[ABCnet] = 14
  100.  
  101. ┌─────────────────────────────────────────────────────────────────────────────┐
  102. │░░░░ TRAFFIC LOGGING ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
  103. └─────────────────────────────────────────────────────────────────────────────┘
  104.  
  105. NetMeter is capable of tracking the amount of traffic on all subs your system
  106. processes.  Two types of tracking are done.  The first simply keeps track of
  107. the number of posts on all sub types.  The second keeps track of the amount
  108. of posts going to systems that connect directly to your system.
  109.  
  110. NetMeter writes the traffic information to log files once a day.  It does this
  111. the first time it runs after midnight.  It does not update the log files every
  112. time it runs.
  113.  
  114. NetMeter stores the tracking information in .DAT files located in your network
  115. data directories.  The files it currently maintains are:
  116.  
  117.     CONDmmdd.DAT - Connect info for the current day
  118.     SUBDmmdd.DAT - Sub info for the current day
  119.     CONMmmyy.DAT - Connect info for the current month
  120.     SUBMmmyy.DAT - Sub info for the current month
  121.  
  122. The .LOG files NetMeter generates follow the same naming convention as the
  123. .DAT files above.
  124.  
  125. ┌─────────────────────────────────────────────────────────────────────────────┐
  126. │░░░░ PROGRAM AUTHENTICITY ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
  127. └─────────────────────────────────────────────────────────────────────────────┘
  128.  
  129. NetMeter has been archived with PKWARE's PKZIP 2.04g using Authenticity
  130. Verification.  When you unzip the archive, you should see "-AV" displayed
  131. after every file name.  When completed, a message that looks like this will
  132. be displayed:
  133.  
  134. Authentic files Verified!   # KRK282
  135. Cris McRae
  136.  
  137. If this authenticity statement is not displayed, or the authenticity code is
  138. not "KRK282", then you have a copy of NetMeter that has been tampered with.
  139. Do >not< use any of the files contained within a tampered archive, as they
  140. may contain viruses, trojans, or other harmful things.
  141.  
  142. ┌─────────────────────────────────────────────────────────────────────────────┐
  143. │░░░░ REGISTRATION ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
  144. └─────────────────────────────────────────────────────────────────────────────┘
  145.  
  146. NetMeter is shareware.  This gives the user an opportunity to evaluate the
  147. program before actually registering the software.  If, after a 30 day period,
  148. you wish to continue to use NetMeter, you are required to register your copy
  149. of NetMeter with the author.  To register, please fill out REGISTER.TXT and
  150. send it to:
  151.  
  152.     Cris McRae
  153.     P.O. Box 1351
  154.     Burbank, CA  91507
  155.  
  156. Registration is $10.00 US per copy of NetMeter.
  157.  
  158. Note:  Registration system used is REGKEY.
  159.  
  160. ┌─────────────────────────────────────────────────────────────────────────────┐
  161. │░░░░ COPYRIGHT/LICENSE ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
  162. └─────────────────────────────────────────────────────────────────────────────┘
  163.  
  164. This document and the program files ("the software") are copyrighted by the
  165. author.  The copyright owner hereby licenses you to use the software given
  166. these restrictions:
  167.  
  168.     ■ The software shall be supplied in its original, unmodified form, which
  169.       includes this documentation;
  170.  
  171.     ■ The software may not be included or bundled with other goods or
  172.       services;
  173.  
  174.     ■ No fee is charged; an exception is granted to non-profit user's
  175.       groups, which are permitted to charge a small fee (not to exceed $5)
  176.       for materials, handling, postage, and general overhead.  No other
  177.       organization is permitted to charge any amount for distribution of
  178.       copies of the software or documentation, or to include copies of the
  179.       software or documentation with sales of their own products.
  180.  
  181. The software and documentation are Copyright (c) 1996 by Cris McRae
  182.  
  183. ┌─────────────────────────────────────────────────────────────────────────────┐
  184. │░░░░ DISCLAIMER ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
  185. └─────────────────────────────────────────────────────────────────────────────┘
  186.  
  187. The author makes no warranties, expressed or implied, as to the quality or
  188. performance of this program.  Your use of this program constitutes your
  189. release of the author from liability or litigation for any indirect or
  190. consequential damages arising from the use of this program or its associated
  191. files.
  192.  
  193. In no event will the author be liable to you for any damages, including any
  194. lost profits, lost savings or other incidental or consequential damages
  195. arising out of your use or inability to use the program, or for any claim by
  196. any other party.
  197.  
  198. ┌─────────────────────────────────────────────────────────────────────────────┐
  199. │░░░░ REVISIONS ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
  200. └─────────────────────────────────────────────────────────────────────────────┘
  201.  
  202. Version 1.00 (02/04/96)
  203.   ■ Initial release
  204.  
  205. Version 1.01 (08/04/96)
  206.   ■ Added a return errorlevel if NetScan encounters a problem so that the BBS
  207.     does not go into an infinite loop calling NetScan over and over.
  208.   ■ Fixed bug in logging that caused the data for the last day of a month to
  209.     be added to the monthly info for the following month.
  210.     (Bug found by Calvin)
  211.   ■ Fixed bug that caused multiple SUBS.LST ping responses (type 20-1) to get
  212.     stripped from packet.
  213.  
  214. ┌─────────────────────────────────────────────────────────────────────────────┐
  215. │░░░░ CREDITS ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
  216. └─────────────────────────────────────────────────────────────────────────────┘
  217.  
  218. NetMeter is Copyright (c) 1996 by Cris McRae
  219. WWIV is Copyright (c) 1988-1995 by Wayne Bell
  220. PKZIP is Copyright (c) 1989-1993 by PKWARE Inc.
  221. REGKEY is Copyright (c) 1992 by Brian Pirie
  222. IniFile Class is Copyright (c) 1993-1995 by Matt Hucke
  223.  
  224. Thanks to Frank Reid for suggesting I write this program, and coming up with
  225. the name.
  226.  
  227. If you have any comments or questions about this program, you can reach me
  228. at the following network addresses:
  229.  
  230.     TerraNET : 1@1
  231.     WWIVnet  : 1@3809
  232.     IceNET   : 1@8857
  233.     WWIVLink : 1@18857
  234.     Internet : cris@bluethun.com
  235.                jafo@silicon.net
  236.  
  237. If you are a sysop on one of the above WWIV networks, you may also subscribe
  238. to my support sub.  The sub name is "JAFO's Software Support".  The sub type
  239. is JAFOSUP.  This sub is also gated to many other networks by other sysops.
  240.  
  241. You may also call my BBS system:
  242.  
  243.                   Blue Thunder BBS
  244.                         USR 28.8 V.34 Dual Standards
  245.                    Open 24 Hours
  246.                    (818)848-4101
  247.