home *** CD-ROM | disk | FTP | other *** search
/ Beijing Paradise BBS Backup / PARADISE.ISO / software / BBSDOORW / DUSER200.ZIP / DUSER.TXT < prev    next >
Encoding:
Text File  |  1993-03-12  |  10.5 KB  |  276 lines
  1.                          ======== ======   =======
  2.                             ==    ==   ==     ===
  3.                             ==    ==   ===   ===
  4.                             ==    ==   ==   ===
  5.                             ==    ======   =======
  6.  
  7.                    =======================================
  8.                    The DeAdZoNe Utilities for RemoteAccess
  9.                    =======================================
  10.  
  11.                                    D-UseR
  12.               ANS/ASC Userlist Bulletin Generator for RemoteAccess
  13.                          Version 2.00g   March 11, 1993
  14.                      (C) Copyright James FitzGibbon 1992-93
  15.                               All Rights Reserved
  16.  
  17.  
  18. What is it?
  19. -----------
  20.  
  21.   D-UseR is a program that replaces the built-in User List for RemoteAccess
  22.   BBS's.  D-UseR will create bulletins using either the users' real names
  23.   or their handles.
  24.  
  25.   D-UseR provides a listing of the user's name ( or handle ), their
  26.   location, their last date called, A calculated ratio of posted messages
  27.   per call, and the number of uploads and downloads they have made.
  28.  
  29.  
  30. Features
  31. --------
  32.  
  33.     * Creates both an Ansi and Ascii version of the D_USER bulletin file,
  34.       ready to be used with RA's type 45 menu option.
  35.  
  36.     * Built-in Menu Configuration makes setting up D-UseR a snap.  For first
  37.       time installations, as much information as possible is taken from your
  38.       CONFIG.RA file.
  39.  
  40.     * Custom Colour Configuration lets you select your choice of colour for
  41.       each item in the bulletin.  Full background/foreground colours are
  42.       supported.
  43.  
  44.     * D-UseR will optionally include the SysOp's name in the bulletin header.
  45.  
  46.     * Configurable use of Handles or Real Names
  47.  
  48.     * D-UseR automatically excludes locked out users ( security level 0 ),
  49.       users who are pending deletion ( i.e have been deleted but will not be
  50.       removed from your userfile until you perform a pack ).
  51.  
  52.     * You have the option to include or exclude the SysOp from the bulletins,
  53.       and to honour the "Hidden" Attribute in the RA Userfile.
  54.  
  55.     * Supports an external "bad user" file, which allows you to exclude
  56.       up to 100 userscertain users from the userlist.
  57.  
  58.  
  59.  IMPORTANT: D-UseR v2.00 is written for RemoteAccess 2.00/gamma-1 and will
  60.             not work properly on prior versions of RA.  Although I don't
  61.             expect Andrew Milner to change the structures when the shareware
  62.             version of RA comes out, it may be necessary to release an update
  63.             if any changes that affect D-UseR are made.
  64.  
  65.  
  66. How much does it cost?
  67. ----------------------
  68.  
  69. This utility is FREE!  If you like it you can continue to use it for as long as
  70. you like free of charge!
  71.  
  72. If you do decide to use it, I would be excited to hear from you !!  I encourage
  73. you to send me a postcard at the address listed below (see the end of this text
  74. file), or a message via netmail. It will cost you practically nothing, and will
  75. let me know you're enjoying the program. It will also give me incentive to keep
  76. improving the program and make it even better!
  77.  
  78.  
  79. Configuration
  80. -------------
  81.  
  82. To configure D-UseR, type:
  83.  
  84.                DUSER /C
  85.  
  86. This will bring up the configuration screen.  Following is a description
  87. of the available options :
  88.  
  89.  
  90. SysOp Name          The name of the SysOp of the system.  This is used in the
  91.                     header, and by the sysop include/exclude feature.
  92.  
  93. BBS Name            The name of the BBS system.
  94.  
  95. Path to USERS.BBS   The path where D-UseR will look for your USERS.BBS file.
  96.                     This is your RA messagebase directory.
  97.  
  98. Textfile path       Path where D-UseR will create the D_USER.ANS and
  99.                     D_USER.ASC bulletins.
  100.  
  101. Use Handles         Setting this to YES will force D-UseR to use handles
  102.                     instead of real names in the bulletins.
  103.  
  104. Include SysOp in    Setting this to YES will include the SysOp in the userlist
  105.   Bulletins         bulletins.  Note that the setting of the "Honour Hidden
  106.                     Attribute" switch and the use of the external "bad user"
  107.                     file override this setting.
  108.  
  109. Include SysOp in    Setting this to YES will add a line to the bulletin
  110.   Header            header containing the name of the SysOp as defined in item
  111.                     [A] of the configuration screen.
  112.  
  113. Use Exclusion File  Setting this to YES will make D-UseR search for the file
  114.                     DUSER.BAD.  If found, it will compare all user names and
  115.                     handles against this file, and reject any matching users.
  116.  
  117. Honour Hidden       Setting this to YES will make D-UseR honour the "hidden"
  118.   Attribute         attribute in the userfile.  This is helpful for excluding
  119.                     Guest accounts without putting them into the exclusion
  120.                     file.
  121.  
  122. Custom Colour       Choosing this option will bring up the colour
  123.   Configuration     Configuration screen.  Here you can choose the foreground
  124.                     and background colours for different bulletin items.
  125.                     Foreground items are limited to colours 0-15 and
  126.                     background items are limited to colours 0-7.
  127.  
  128.     * If the RA environment variable is set, D-UseR will try to read the
  129.       "SysOp Name", "BBS Name", "Path to USERS.BBS" and "Textfile Path"
  130.       directly from the CONFIG.RA file.
  131.  
  132.     * Whenever presented with an input prompt, hitting enter on a blank line
  133.       will retain your previous selection.
  134.  
  135.  
  136. Generating Bulletins
  137. --------------------
  138.  
  139. In order to generate the userlist bulletins, run D-UseR with the /G switch :
  140.  
  141.           DUSER /G
  142.  
  143.    *   D-UseR will handle up to *10000* users in the users file. If this
  144.        number is exceeded D-UseR will abort with an error message.
  145.  
  146.    *   You can either generate the userlist bulletins once per night, through
  147.        a nightly batch file, or every time the option is chosen from the menu.
  148.        To run D-UseR from a menu, create a new menu which consists of three
  149.        menu lines :
  150.  
  151.             1 - Call DUSER as a type 7 or 15 exit
  152.             2 - Display the D_USER textfile to the user
  153.             3 - Return to the menu from whence you came
  154.  
  155.  
  156. Exclusion List
  157. --------------
  158.  
  159. D-UseR supports an exclusion list which allows you to specify up to 100 users
  160. which you do not want included in the bulletins. This is useful if have users
  161. (or co-sysops) which you want to "hide" from the bulletins.
  162.  
  163. In order to use this feature you must create a plain ASCII text file called
  164. DUSER.BAD and simply list the name or handle of the user which you want excluded
  165. (one entry per line). You must also enable "Exclusion File Checking" in the
  166. configuration menu.
  167.    
  168.    *   It is not necessary to specify both a user's real name and their handle
  169.        as separate entries, one or the other will suffice.
  170.    *   The entries in DUSER.BAD are *not* case sensitive, so if you have "John
  171.        Smith" in your DUSER.BAD file, and the user's name is actually spelt
  172.        "JoHn SmItH", the name will still be properly excluded.
  173.    *   If you have more than 100 entries in DUSER.BAD, D-UseR will simply
  174.        ignore any entries above #100.
  175.    
  176.            Example of DUSER.BAD:
  177.    
  178.                      John Smith
  179.                      Jane Smith
  180.                      The Punisher
  181.    
  182.  
  183. Location of Files
  184. -----------------
  185.  
  186. D-UseR can be run from any directory.  On your first time configuration, the
  187. configuration file DUSER.CFG will be created in the current directory.  During
  188. bulletin generation, D-User will search for necessary files ( DUSER.CFG and
  189. DUSER.BAD ) first in the directory where the executable is stored (not
  190. necessarily the current directory), and then in directories specified in
  191. your path statement.  To speed up the process, keep your DUSER.EXE, DUSER.CFG
  192. and DUSER.BAD files in the same directory.
  193.  
  194.    * D-UseR does *not* write to any RemoteAccess files at any time.
  195.  
  196.    * During your first time configuration, D-UseR will try to grab as much as
  197.      it can from your CONFIG.RA file, but only if the RA environment variable
  198.      has been set to point to the directory CONFIG.RA is in.
  199.  
  200.  
  201. Bulletins Created
  202. -----------------
  203.  
  204. D-UseR creates the following bulletins in the directory you have specified
  205. as the Textfiles directory:
  206.  
  207.                 D_USER.ANS      (Ansi bulletin)
  208.                 D_USER.ASC      (Ascii bulletin)
  209.  
  210.        
  211. Legal Stuff and Disclaimer
  212. --------------------------
  213. "D-UseR" refers to the executables and documentation in the original
  214. distribution archive. D-UseR is copyrighted material by the author, James
  215. FitzGibbon. All rights are reserved.  The author grants you a licence to
  216. use this software free of charge.
  217.  
  218. The program is provided "as is", without warranty or guarantee of any kind,
  219. either expressed or implied, as to its quality or performance. The author will
  220. not be held liable to you or anyone for any direct, indirect, incidental or
  221. consequential damages, including but not limited to any lost profits, or lost
  222. savings which may result from the use or inability to use this program.
  223.  
  224. The author is in no way obligated to provide future versions of this software.
  225.  
  226. Your use of the program constitutes your agreement to these terms and to this
  227. disclaimer.
  228.  
  229. All mentioned products are copyrighted by and trademarks of their respective
  230. holders.
  231.  
  232.  
  233. Credits
  234. -------
  235.  
  236. Thanks to Victor Magdic for getting me started in Turbo Pascal programming,
  237. and for letting me release D-UseR under The DeAdZoNe utilities label.  Also
  238. thanks to Nathan Locklin and Jonathan Rapoport for beta testing D-UseR on
  239. their systems.
  240.  
  241.  
  242. Updates
  243. -------
  244.  
  245. Please see the enclosed file DEADZONE.TXT for information on how to obtain the
  246. latest version of D-UseR.
  247.  
  248.        
  249. Suggestions always welcome!
  250. ---------------------------
  251.  
  252. If you have any suggestions for improvement or wish to report any bugs, you can
  253. reach me via netmail:
  254.        
  255.        The Flight Deck BBS
  256.        James FitzGibbon
  257.        FidoNet: 1:250/302
  258.        IMEX 89:480/222
  259.        NaNet 41-65-20 (81:416/520)
  260.  
  261.  
  262.        or by writing to:
  263.        
  264.        James FitzGibbon
  265.        300 Alton Towers Circle #903
  266.        Scarborough, Ontario
  267.        M1V 4X9
  268.        CANADA
  269.  
  270.        (please note that the above address is not valid until April 10th,
  271.        1993.  If you have correspondance to send me, please hold it until that
  272.        time to avoid having it returned by the current tenants of the above
  273.        address)
  274.        
  275. ------------------------------------------------------------------ end
  276.