home *** CD-ROM | disk | FTP | other *** search
/ ftp.wwiv.com / ftp.wwiv.com.zip / ftp.wwiv.com / pub / BBS / NSTAT14.ZIP / NETSTAT.DOC < prev    next >
Text File  |  1994-11-22  |  6KB  |  144 lines
  1.             ╓────────────────────────────────────────────────╖
  2.             ║   NETSTAT v1.4 Last Mail Run & Import/Export   ║
  3.             ║         Statistics Bulletin Generator          ║
  4.             ║     Copyright (C) 1992-94 by Kevin Cummins     ║
  5.             ╙────────────────────────────────────────────────╜
  6.  
  7. WHAT IT IS:
  8. ───────────
  9. NETSTAT creates ASCII and ANSI bulletins for your network mail runs to
  10. provide your users with up-to-date info of the last date/time and number of
  11. messages imported and exported. NETSTAT can display info for up to a total
  12. of 5 Networks, and is designed to be used in conjunction with the GOODRUN
  13. utility, also included with this archive.
  14.  
  15. NETWORK SOFTWARE SUPPORTED:
  16. ───────────────────────────
  17. This version of NETSTAT supports POSTLINK, PCRELAY, TNET, JNET, & SHILOH.
  18.  
  19. (Can also be used with non-supported net-types, see config file)
  20.  
  21. IN COMPARISON:
  22. ──────────────
  23. Other utilities of this type that I have seen read a file that Postlink or
  24. PcRelay creates called LASTTIME.TXT. I chose another method, because
  25. LASTTIME.TXT records a successful run even if -1- message is imported, or
  26. actually -0- I suppose in the case of Postlink.
  27.  
  28. My definition of 'Success' is when a REASONABLE number of messages are
  29. received and posted to the BBS. Hence, the reason for GOODRUN. GOODRUN is a
  30. utility that runs prior to NETSTAT, that distinguishes between good and bad
  31. runs based on filesize (a 'Reasonable' one that you specify).
  32.  
  33. INSTALLATION:
  34. ─────────────
  35. Installation can be accomplished by following the 5-step procedure outlined
  36. below.
  37.  
  38. 1. Edit the file 'NETSTAT.CFG'. Additional notes are found in the config
  39.    file.
  40.  
  41. 2. Copy files NETSTAT.EXE and NETSTAT.CFG to each of your network mail
  42.    directories. These should be the ones specified in NETSTAT.CFG.
  43.  
  44. 3. Copy file GOODRUN.EXE to a directory in your 'PATH'.
  45.  
  46. 4. Edit your mail run batch files to do something similar to the example
  47.    given below.
  48.  
  49. 5. <Optional> Go to each directory now containing NETSTAT, and execute.
  50.    (Execution notes are found below) This will initialize the datafile for
  51.    each directory, and also assure you that everything is set up properly.
  52.    If you have something not quite right, hopefully NETSTAT will complain
  53.    and give you a helpful error message. You may bypass this, however, as
  54.    NETSTAT will just insert some bogus numbers that will be overwritten the
  55.    first time that NETSTAT is later executed in that directory via your
  56.    batch files.
  57.  
  58. The following is an example of how to use GOODRUN & NETSTAT in your mail
  59. run batch file. This is obviously a Postlink run, and my download file is
  60. referenced as 'D1390.ZIP'. This is only a portion of the batch file,
  61. starting immediately after the download:
  62.  
  63. --------------------------------------
  64. CD\POSTLINK
  65.  
  66. GOODRUN D1390.ZIP 25
  67.      IF ERRORLEVEL 2 GOTO ERROR2
  68.      IF ERRORLEVEL 1 GOTO ERROR1
  69.      IF ERRORLEVEL 0 GOTO ERROR0
  70.  
  71. :ERROR2
  72. rem File Not Found!
  73. GOTO CONTINUE
  74.  
  75. :ERROR1
  76. rem File Size Too Small!
  77. GOTO CONTINUE
  78.  
  79. :ERROR0
  80. rem File Size Greater than 25K, So run POSTLINK/NETSTAT.
  81. POSTLINK CALLER.CFG /CONTINUE
  82. NETSTAT 1
  83. GOTO END
  84.  
  85. :CONTINUE
  86. POSTLINK CALLER.CFG /CONTINUE
  87. GOTO END
  88.  
  89. :END
  90. --------------------------------
  91.  
  92. OK, if you did everything correctly, nothing more should be required, and
  93. you should have a successful installation!
  94.  
  95. EXECUTION:
  96. ──────────
  97. NETSTAT execution consists of simply typing 'NETSTAT' plus one command line
  98. parameter on the command line, or more likely in a batch file as in the
  99. above example. The parameter is the number of the net as listed in the
  100. configuration file. NETSTAT searches the .log file specified in the config
  101. file for imports and exports on today's date. If set up correctly with
  102. GOODRUN, NETSTAT should never report -0- imports, because it should not
  103. have even run after an empty or absent mail packet!
  104.  
  105. REGISTRATION:
  106. ─────────────
  107. Registration fee for NETSTAT is only $3. Complete and mail the provided
  108. registration form. As soon as your form is received, your registration will
  109. be processed and a file made available for you to download from Crimson
  110. Cross. Inside will be your registration number and instructions.
  111.  
  112.  
  113.  
  114. ADDITIONAL NOTES:
  115. ─────────────────
  116. GOODRUN returns an errorlevel to be used in your mail run batch file, that
  117. would allow you to bypass running NETSTAT if the filesize requirement you
  118. set up is not met. Please read the documentation for GOODRUN, to make sure
  119. you know how it works, and how to make it work for you.
  120.  
  121. NETSTAT uses the current system time and date when creating the bulletins.
  122. So, NETSTAT needs to be run immediately following your import procedure in
  123. your mail run batch file. And, since it does read the current system date and
  124. time, using the GOODRUN utility is almost a must so that you don't get false
  125. results in your bulletins.
  126.  
  127. One final suggestion....if you would like execution time to be minimal,
  128. routine packing of your network log file is recommended. The larger that
  129. file grows, the longer execution time will be.
  130.  
  131. I hope this explanation has been comprehensive enough, but if something has
  132. been overlooked, or you have questions, comments, or requests for
  133. additional network software support by NETSTAT I can be reached at the
  134. BBS number listed below.
  135.  
  136. I will be happy to include other network software types in future versions
  137. of NETSTAT if at all possible.
  138.  
  139.   Crimson Cross BBS                I can also be reached on RIME,
  140.   USR Dual Standard 28.8           and PhiloeNet Networks.
  141.   Harrisburg, Ill.
  142.   618-253-3608                       RIME  Node id: ->CCBBS
  143.   Kevin Cummins, Sysop
  144.