home *** CD-ROM | disk | FTP | other *** search
/ Media Share 9 / MEDIASHARE_09.ISO / bbs / newusr14.zip / NEWUSERS.DOC < prev    next >
Text File  |  1993-04-15  |  10KB  |  228 lines
  1. ---------------------------------------------------------------------------        
  2.       NEWUSERS v1.4     Copyright (c) 1993 by Bryan J. Nylin
  3.                         Written and compiled in QuickBASIC v4.5
  4. ---------------------------------------------------------------------------
  5.  
  6. NEWUSERS is a utility designed for TriBBS sysops to create a bulletin
  7. showing the newest users to call the BBS.  It is compatible with 
  8. TriBBS v3.3 and has been tested with TriBBS v4.0 (beta 2)
  9.  
  10. This software is SHAREWARE.  You are granted permission to distribute
  11. the NEWUSR14 archive freely, provided all the original files are kept 
  12. together, and only a nominal fee is charged.  The files in this archive 
  13. should be:
  14.  
  15.         NEWUSERS.DOC      This documentation file.
  16.         NEWUSERS.REG      Registration/order form
  17.         NEWUSERS.EXE      Executable program.
  18.         NEWUSERS.CFG      Configuration file
  19.         FILE_ID.DIZ       Program description for BBS posting.
  20.  
  21. The result of McAffee's VALIDATE program on NEWUSERS.EXE is as follows:          
  22.  
  23.                   File Name:  NEWUSERS.EXE
  24.                        Size:  66,704
  25.                        Date:  4-15-1992
  26.         File Authentication:
  27.              Check Method 1 - 0268
  28.              Check Method 2 - 08BC
  29.  
  30. If any of these numbers do not match, you have an invalid archive that
  31. might be infected with a virus.  Delete the archive and contact the
  32. person or BBS you received it from.
  33.  
  34. This SHAREWARE program is distributed with the concept that if you find
  35. it useful and continue to use it beyond a 30-day free trial period, you
  36. must send in the $10 registration fee (discounts available when registering
  37. multiple copies and/or additional utilities at the same time).
  38.  
  39. To help you evaluate the program, no features have been left out of this 
  40. shareware release.  See the file NEWUSERS.REG for the order form.
  41.  
  42.  
  43. INSTALLATION INSTRUCTIONS:
  44. -------------------------------------------------------------------------
  45. Step 1.         IF YOU HAVE NEVER INSTALLED THIS BEFORE:
  46.                 Extract the files from the distribution archive into 
  47.                 your BBS utilities directory. (I use \BBS\UTIL)
  48.  
  49.                 IF YOU ARE UPGRADING FROM A PREVIOUS VERSION:
  50.                 Do not extract the .CFG file since this will overwrite
  51.                 your configuration.  If you are upgrading from v1.0 to
  52.                 v1.4, you will have to run "NEWUSERS UPGRADE" to upgrade
  53.                 the .DAT file to v1.4 format.  You will also need to
  54.                 add the line "dir=" to your .CFG file (see below).
  55.                 IT IS NOT NECESSARY TO "UPGRADE" FROM v1.1 to v1.2 or 1.3!
  56.                 
  57. Step 2.         Make your utilities directory the default (CD \BBS\UTIL)
  58.  
  59. Step 3.         Edit NEWUSERS.CFG to match your system configuration.
  60.                 Each line is documented in a section below.
  61.  
  62. Step 4.         Run NEWUSERS with the /R parameter to reset the datafile.
  63.                 This will create NEWUSERS.DAT in the utilities directory.
  64.  
  65. Step 5.         Edit your TriBBS BETWEEN.BAT file to include NEWUSERS.
  66.                 Example:
  67.                 ---------->File starts Here<-------------
  68.                 cd\bbs\util
  69.                 NEWUSERS
  70.                 cd\bbs\tribbs
  71.                 ---------->File ends Here<-----------------
  72.  
  73. Step 6.         You are done!  The next time a caller logs off and 
  74.                 BETWEEN.BAT is executed, the bulletin is updated.
  75.  
  76.  
  77.  
  78.  
  79. CONFIGURATION FILE
  80. -------------------------------------------------------------------------
  81. The sample file NEWUSERS.CFG included in this archive looks like this:
  82.  
  83. ---------->File starts Here<-------------
  84. bbs=Jet City Connection
  85. log=C:\BBS\TRIBBS\MWORK\CALLERS.LOG
  86. dir=C:\BBS\TRIBBS
  87. max=15
  88. ansi=C:\BBS\TRIBBS\DISPLAY\BULLET7.ANS
  89. ascii=C:\BBS\TRIBBS\DISPLAY\BULLET7.BBS
  90. ---------->File ends Here<-----------------
  91.  
  92. Each line starts with a TAG and an equal sign.  These must be typed
  93. correctly in order for the NEWUSERS program to recognize them.  It is
  94. not case sensitive, however.  Each tag is explained as follows:
  95.  
  96.         bbs=    Name of the BBS you want to appear at top of bulletin.
  97.  
  98.         log=    File name of caller log to read.  NEWUSERS looks only at
  99.                 the last caller in the log file and creates the bulletin
  100.                 only if the caller was new.                             
  101.                 
  102.         dir=    Main TriBBS directory.  Uses this to find MWORK\USERS.DAT
  103.  
  104.         max=    Maximum number of lines to print in the bulletin.  A
  105.                 '15' here would indicate to only print the last 15
  106.                 new users.
  107.                 
  108.         ansi=   File name and path of the ANSI bulletin to create.
  109.  
  110.         ascii=  File name and path of the ASCII bulletin to create.
  111.  
  112.  
  113.  
  114. COMMAND LINE PARAMETERS:
  115. --------------------------------------------------------------------------
  116. Usage:  NEWUSERS [/f] [/r] [/?] [/HELP]
  117. Where:  /f      Forces bulletin output even if last caller was not new.
  118.         /r      Resets datafile
  119.  
  120. Explanation:
  121.  
  122.         /F      Normally, the program only generates the bulletin when
  123.                 the last caller was a new user.  This switch will force
  124.                 the output regardless of that fact.
  125.  
  126.         /R      This switch will cause NEWUSERS.DAT to be cleared out
  127.                 before looking at the log file.
  128.  
  129.  
  130. NEWUSERS.DAT Layout
  131. --------------------------------------------------------------------------
  132. This is a straight forward ASCII file.  It was programmed this way for
  133. easy access by the sysop in case it is necessary to edit out a name from
  134. the new user list.  Generally speaking, you can delete records from this
  135. file without causing any problems, any empty space will be taken up the
  136. next time NEWUSERS runs.  You must BE CAREFUL TO DELETE WHOLE RECORDS.
  137. One record consists of:
  138.  
  139.         Line 1          John Doe        User Name
  140.         Line 2          01/08/92        Date of first call
  141.         Line 3          2400            Baud rate
  142.         Line 4          Kent, WA        City calling from
  143.  
  144. Empty records are stored as "Empty, 00/00/00, 0, Nowhere" and are easily 
  145. identifiable.  If you add or delete from this file, make sure you work 
  146. with a GROUP OF 4 LINES ONLY.  If you don't, odd results will happen and 
  147. you will probably have to run NEWUSERS /R to reset the datafile.
  148.  
  149.  
  150. DESCRIPTION OF OPERATION
  151. --------------------------------------------------------------------------
  152. If NEWUSERS detects that the last caller was a new user, it will open
  153. the NEWUSERS.DAT file and add the name, date, and baud rate for this call. 
  154. The program looks in USERS.DAT to find where they are calling from.
  155. If the number of records in NEWUSERS.DAT exceeds that specified by the
  156. "max=" tag in NEWUSERS.CFG, the oldest record will be scrolled off the
  157. list.
  158.  
  159. VERSION HISTORY
  160. --------------------------------------------------------------------------
  161. v1.4    Released 4-15-93.
  162.       - Fixed bug relating to searching the DOS PATH.
  163.  
  164. v1.3    Released 3-27-93
  165.       - Fixed bug where program would hang system if it couldn't get 
  166.         access to the log file.
  167.       - Fixed bug where it wouldn't create a .DAT file (/R) the first time.
  168.  
  169. v1.2    Released 2-15-93
  170.       - Fixed bug caused by long logons where program could not find last
  171.         caller's log entry.
  172.       - Added support for searching DOS PATH for .CFG, .KEY, and .DAT files
  173.       - Enhanced file locking for multinode systems.  Requires DOS 3.0 or
  174.         higher and SHARE.EXE to be loaded.
  175.       - Tested on TriBBS v4.0 beta #2
  176.  
  177. v1.1    Released 1-29-93
  178.       - Added "city calling from" column to output.
  179.       - Added registration code support
  180.       - Upgrading from v1.0 requires first-time "NEWUSERS UPGRADE" to
  181.         update .DAT file, and addition to .CFG file of "dir=" line.
  182.  
  183. v1.0    Initial release 1-9-93
  184.  
  185.  
  186. DISCLAIMER
  187. --------------------------------------------------------------------------
  188. This software and accompanying materials are distributed "AS IS" and 
  189. without warranty, expressed or implied.  No implied warranty exists
  190. for merchantability and/or fitness for any particular purpose.  Under 
  191. no circumstances shall anyone involved in the creation, production, or
  192. sale of this product be liable for direct, indirect, consequential, or
  193. special damages arising out of any use of this product.
  194.  
  195. Use of this software beyond the initial 30 day evaluation period is
  196. strictly prohibited.
  197.  
  198. Once this software is registered, any unauthorized distribution of your 
  199. personalized registration code and/or the registration .KEY file will 
  200. invalidate your registration key for all releases of this product, and
  201. no product support will be given.
  202.  
  203.  
  204. TECHNICAL SUPPORT
  205. --------------------------------------------------------------------------
  206.         
  207.         Support questions can be left, and latest version downloaded
  208.         from the author's BBS near Seattle, WA:
  209.  
  210.         Jet City Connection BBS, (206)839-8843, v.32bis, Fido 1:343/140
  211.  
  212.         Messages can also be addressed to Bryan Nylin at:
  213.                 
  214.                 FidoNet 1:343/140
  215.                 CompuServe 71441,1420
  216.                 
  217. ---------------------------------------------------------------------------
  218.  
  219. This SHAREWARE program is distributed with the concept that if you find
  220. it useful and continue to use it beyond a 30-day free trial period, you
  221. must send in the $10 registration fee (discounts available when registering
  222. multiple copies and/or additional utilities at the same time).
  223.  
  224. To help you evaluate the program, no features have been left out of this 
  225. shareware release.  See the file NEWUSERS.REG for the order form.
  226.  
  227. ---------------------------------------------------------------------------        
  228.