home *** CD-ROM | disk | FTP | other *** search
/ ftp.wwiv.com / ftp.wwiv.com.zip / ftp.wwiv.com / pub / HATCH / NETANL10.ZIP / NETANLYZ.DOC < prev    next >
Text File  |  1996-07-14  |  9KB  |  216 lines
  1. ┌────────────────────────────────────────────────────────────────────────────┐
  2. │                                                                            │
  3. │                              NetAnalyze v1.0                               │
  4. │                     Copyright (c) 1996 by Cris McRae                       │
  5. │                            All Rights Reserved                             │
  6. │                                                                            │
  7. │                      A WWIV Network Analysis Program                       │
  8. │                                                                            │
  9. └────────────────────────────────────────────────────────────────────────────┘
  10.  
  11. ┌────────────────────────────────────────────────────────────────────────────┐
  12. │░░░░ INTRODUCTION ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
  13. └────────────────────────────────────────────────────────────────────────────┘
  14.  
  15. NetAnalyze was born because I needed something to do detailed analysis on the
  16. TerraNET data files I maintain as the Network Coordinator.
  17.  
  18. NetAnalyze finds every possible problem with the CONNECT.* files for both
  19. regular and group style WWIV networks.  Every Network Coordinator needs to use
  20. this software.  There is no NC that is perfect.  Every NC has inadvertently
  21. messed up the CONNECT files on their network.
  22.  
  23. What types of problems can occur in CONNECT files?  There are three major
  24. problems:
  25.  
  26. 1)  A system in the CONNECT file does not have a corresponding entry in a
  27.     BBSLIST file.
  28. 2)  A system has no connection to the rest of the network.
  29. 3)  System A is listed as having a connection to System B, but B has no
  30.     listed connection to A (dangling connect).
  31.  
  32. These three problems are detected by NetAnalyze.  These are the ONLY problems
  33. to my knowledge that can exist in the CONNECT files.
  34.  
  35. ┌────────────────────────────────────────────────────────────────────────────┐
  36. │░░░░ USAGE ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
  37. └────────────────────────────────────────────────────────────────────────────┘
  38.  
  39. You should place NETANLYZE.EXE in your main WWIV directory.
  40.  
  41. To run NetAnalyze, use the command-line shown below:
  42.  
  43.      NETANLYZ .#
  44.  
  45. The .# parameter is used to specify which network to analyze.  It uses the
  46. same (# - 1 in INIT) convention that all WWIV network programs use.
  47.  
  48. You should run NetAnalyze manually prior to sending out any updates.  This
  49. will enable you to correct any existing problems before propagating those
  50. problems across the entire network.
  51.  
  52. ┌────────────────────────────────────────────────────────────────────────────┐
  53. │░░░░ PROGRAM OUTPUT ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
  54. └────────────────────────────────────────────────────────────────────────────┘
  55.  
  56. Below is a sample of the output generated by NetAnalyze.  An analysis was done
  57. on IceNET.  An explanation follows.  The output for non-group networks will
  58. look slightly different (no CONNECT.### files are listed).
  59.  
  60. NetAnalyze v1.0: Analyzing IceNET...
  61.  
  62. Isolated systems:
  63.  
  64. @3106
  65. @9930
  66.  
  67. CONNECT Entries for Unknown Systems:
  68.  
  69. CONNECT.0  :  @5801
  70.  
  71. Missing/Invalid CONNECT Entries:
  72.  
  73. CONNECT.4  :  @1017 <> @2904
  74. CONNECT.4  :  @2942 <> @2934
  75. CONNECT.9  :  @9930 <> @9919
  76.  
  77. Isolated Systems:
  78. ~~~~~~~~~~~~~~~~
  79. The first section indicates which systems are completely isolated from the
  80. rest of the network.  No mail may be sent to those systems.  Isolated systems
  81. are not always a major problem.  Connects are sometimes lost, and it may take
  82. a little while to find a new connect.
  83.  
  84. CONNECT Entries for Unknown Systems:
  85. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  86. This section lists entries for systems that have no BBSLIST entry.  If a
  87. system is not listed in the BBSLIST files for a network, chances are that
  88. system is not actually in the network.  It is very easy to delete a system
  89. from the BBSLIST files and forget to delete all their entries in the
  90. CONNECT files (especially in CONNECT.0).
  91.  
  92. Missing/Invalid CONNECT Entries:
  93. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  94. This last section is the fun part.  It lists all the broken connections in
  95. the CONNECT files.  These are the hardest to detect (most NCs will not be
  96. able to find these problems without someone telling them there is a problem).
  97. These problems are also usually very easy to correct.  Either remove the
  98. connect entirely, or add the appropriate entry in the CONNECT.* file to
  99. complete the connection (every connect has two pieces, and one is broken).
  100.  
  101. To explain one of the lines from the output (@2942 <> @2934), let us look
  102. at the actual CONNECT.4 lines:
  103.  
  104. @2934   1017
  105. @2942   4550 2934
  106.  
  107. It is now obvious that the connection is not complete.  It should look like
  108. one of the following:
  109.  
  110. @2934   1017 2942
  111. @2942   4550 2934
  112.  
  113.       -or-
  114.  
  115. @2934   1017
  116. @2942   4550
  117.  
  118. ┌────────────────────────────────────────────────────────────────────────────┐
  119. │░░░░ PROGRAM AUTHENTICITY ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
  120. └────────────────────────────────────────────────────────────────────────────┘
  121.  
  122. NetAnalyze has been archived with PKWARE's PKZIP 2.04g using Authenticity
  123. Verification.  When you unzip the archive, you should see "-AV" displayed
  124. after every file name.  When completed, a message that looks like this will
  125. be displayed:
  126.  
  127. Authentic files Verified!   # KRK282
  128. Cris McRae
  129.  
  130. If this authenticity statement is not displayed, or the authenticity code is
  131. not "KRK282", then you have a copy of NetAnalyze that has been tampered with.
  132. Do >not< use any of the files contained within a tampered archive, as they
  133. may contain viruses, trojans, or other harmful things.
  134.  
  135. ┌────────────────────────────────────────────────────────────────────────────┐
  136. │░░░░ COPYRIGHT/LICENSE ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
  137. └────────────────────────────────────────────────────────────────────────────┘
  138.  
  139. This document and the program files ("the software") are copyrighted by the
  140. author.  The copyright owner hereby licenses you to use the software given
  141. these restrictions:
  142.  
  143.     ■ The software shall be supplied in its original, unmodified form, which
  144.       includes this documentation;
  145.  
  146.     ■ The software may not be included or bundled with other goods or
  147.       services;
  148.  
  149.     ■ No fee is charged; an exception is granted to non-profit user's
  150.       groups, which are permitted to charge a small fee (not to exceed $5)
  151.       for materials, handling, postage, and general overhead.  No other
  152.       organization is permitted to charge any amount for distribution of
  153.       copies of the software or documentation, or to include copies of the
  154.       software or documentation with sales of their own products.
  155.  
  156. The software and documentation are Copyright (c) 1996 by Cris McRae
  157.  
  158. ┌────────────────────────────────────────────────────────────────────────────┐
  159. │░░░░ FREEWARE ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
  160. └────────────────────────────────────────────────────────────────────────────┘
  161.  
  162. NetAnalyze is freeware.  There is no registration fee.  It may be used freely
  163. on any network.
  164.  
  165. ┌────────────────────────────────────────────────────────────────────────────┐
  166. │░░░░ DISCLAIMER ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
  167. └────────────────────────────────────────────────────────────────────────────┘
  168.  
  169. The author makes no warranties, expressed or implied, as to the quality or
  170. performance of this program.  Your use of this program constitutes your
  171. release of the author from liability or litigation for any indirect or
  172. consequential damages arising from the use of this program or its associated
  173. files.
  174.  
  175. In no event will the author be liable to you for any damages, including any
  176. lost profits, lost savings or other incidental or consequential damages
  177. arising out of your use or inability to use the program, or for any claim by
  178. any other party.
  179.  
  180. ┌────────────────────────────────────────────────────────────────────────────┐
  181. │░░░░ REVISIONS ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
  182. └────────────────────────────────────────────────────────────────────────────┘
  183.  
  184. Version 1.0 (07/14/96)
  185.   ■ Initial release
  186.  
  187. ┌────────────────────────────────────────────────────────────────────────────┐
  188. │░░░░ CREDITS ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
  189. └────────────────────────────────────────────────────────────────────────────┘
  190.  
  191. NetAnalyze is Copyright (c) 1996 by Cris McRae
  192. WWIV is Copyright (c) 1988-1995 by Wayne Bell
  193. WWIVnet Software is Copyright (c) 1988-1995 by Wayne Bell
  194. PKZIP is Copyright (c) 1989-1994 by PKWARE Inc.
  195.  
  196. If you have any comments or questions about this program, you can reach me
  197. at the following network addresses:
  198.  
  199.     TerraNET : 1@1
  200.     WWIVnet  : 1@3809
  201.     IceNET   : 1@8857
  202.     WWIVLink : 1@18857
  203.     Internet : jafo@silicon.net
  204.                cris@bluethun.com
  205.  
  206. If you are a sysop on one of the above WWIV networks, you may also subscribe
  207. to my support sub.  The sub name is "JAFO's Software Support".  The sub type
  208. is JAFOSUP.  This sub is also gated to many other networks by other sysops.
  209.  
  210. You may also call my BBS system:
  211.  
  212.                               Blue Thunder BBS
  213.                        USR 33.6 V.34+ Dual Standards
  214.                                Open 24 Hours
  215.                                (818)848-4101
  216.