home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / World_Of_Computer_Software-02-385-Vol-1of3.iso / d / duser110.zip / DUSER.DOC < prev    next >
Text File  |  1992-07-23  |  8KB  |  219 lines
  1.                        ▀▀▀▀▀▀▀▀ ▀▀▀▀▀▀   ▀▀▀▀▀▀▀
  2.                           ▀▀    ▀▀   ▀▀     ▀▀▀
  3.                           ▀▀    ▀▀   ▀▀▀   ▀▀▀
  4.                           ▀▀    ▀▀   ▀▀   ▀▀▀
  5.                           ▀▀    ▀▀▀▀▀▀   ▀▀▀▀▀▀▀
  6.  
  7.                 [The DeAdZoNe Utilities for RemoteAccess]
  8.  
  9.    ┌─────────────────────────────────────────────────────────────────┐
  10.    │                              D-UseR                             │
  11.    │                                                                 │
  12.    │               Replacement User list for RemoteAccess            │
  13.    │                                                                 │
  14.    │                    Version 1.10c  July 23, 1992                 │
  15.    │                                                                 │
  16.    │               (C) Copyright James FitzGibbon 1992               │
  17.    │                                                                 │
  18.    │                        All Rights Reserved                      │
  19.    └─────────────────────────────────────────────────────────────────┘
  20.  
  21.  
  22. Description
  23. ═══════════
  24.  
  25.   D-UseR is a program that replaces the built-in User List for RemoteAccess
  26.   BBS's.  D-UseR will create bulletins using either the users' real names
  27.   or their handles.
  28.  
  29.   D-UseR provides a listing of the user's name ( or handle ), their
  30.   location, their last date called, the number of messages they have
  31.   posted, the number of calls they have made, and the number of
  32.   uploads/downloads the user has made.
  33.  
  34.  IMPORTANT: D-UseR 1.10 is written for RemoteAccess 1.10/1.11 and will not
  35.             work properly on prior versions of RA.
  36.  
  37.  
  38. How much does it cost?
  39. ══════════════════════
  40.  
  41.   This utility is FREE!  If you like it you can continue to use it
  42.   for as long as you like free of charge!
  43.  
  44.   If you do decide to use it, I would be excited to hear from you !!
  45.   I encourage you to send me a postcard at the address listed below (see
  46.   the end of this text file). It will cost you practically nothing, and
  47.   will let me know you're enjoying the program. It will also give me
  48.   incentive to keep improving the program and make it even better!
  49.  
  50.  
  51. How to Use D-UseR:
  52. ══════════════════
  53.  
  54.   There are two ways to run D-UseR : once a day in your nightly maintenance
  55.   routine, or each time the selction is chosen from the menu.
  56.  
  57.   In the Nightly Batch file would be as follows:
  58.  
  59.       Command line options are as follows:
  60.  
  61.  
  62.        DUSER [options]
  63.  
  64.        [options]   /H    Tells D-UseR to use handles instead of real names.
  65.                          By default D-UseR uses real names when it generates
  66.                          the top users bulletins. If you want to use handles
  67.                          instead, specify this option.
  68.  
  69.                    /S    Tells D-UseR to include the SysOp's name in the
  70.                          header part of the bulletin. By default, the sysop's
  71.                          name is not included.
  72.  
  73.                    /?    Brings up a help screen showing a summary of the
  74.                          available options.
  75.  
  76.   Through a Menu Choice requires that you make a separate menu in RaConfig.
  77.   This Menu should be called something like DUSER, and contains three
  78.   entries :
  79.  
  80.         1 - Call DUSER as a type 7 or 15 exit
  81.         2 - Display the D_USER textfile to the user
  82.         3 - Return to the menu from whence you came
  83.  
  84.   All of these options should be tagged as automatic.  Replace your Current
  85.   "User List" command function with a gosub to the menu "DUSER".  Everything
  86.   else will take care of itself.
  87.  
  88.  
  89. Examples:
  90.  
  91.         DUSER            would create a user list bulletin using real
  92.                          names, excluding the sysop from the user list, and
  93.                          excluding the sysop's name from the header.
  94.  
  95.  
  96.         DUSER /H         would create a user list bulletin the same as in
  97.                          the above example, but this time using handles
  98.                          instead of real names.
  99.  
  100.  
  101.   ** D-UseR will handle up to *14000* users in the users file. If this
  102.      number is exceeded D-UseR will abort with an error message.
  103.      However, seeing as how the largest bulletin board system in North
  104.      America has only 9000 users, I do not forsee a problem.  This number
  105.      is of course dependant on your available system memory (RAM).
  106.  
  107.   ** D-UseR will automatically exclude users who have been locked out
  108.      (i.e. security level 0) and users that have the "Hidden" bit set.
  109.  
  110.  
  111. Exclusion List
  112. ══════════════
  113.  
  114.   D-UseR supports an exclusion list which allows you to specify up to
  115.   100 users which you do not want included in the bulletins. This is
  116.   useful if you have users (or co-sysops) which you want to "hide" from
  117.   the bulletins.
  118.  
  119.   In order to use this feature you must create a plain ASCII text file
  120.   called DUSER.CTL and simply list the name or handle of the user which
  121.   you want excluded (one entry per line). If D-UseR detects this file,
  122.   it will automatically use it, so no command line switches are
  123.   required.
  124.  
  125.   D-UseR will search for the exclusion file in three steps :
  126.  
  127.       1 - In the directory pointed to by the RA environment variable.
  128.       2 - In the directories in your PATH statement.
  129.       3 - In the current directory.
  130.  
  131.   * It is not necessary to specify both a user's real name and their
  132.     handle as separate entries, one or the other will suffice.
  133.  
  134.   * The entries in DUSER.CTL are *not* case sensitive, so if you have
  135.     "John Smith" in your DUSER.CTL file, and the users name is actually
  136.     spelt "JoHn SmItH", the name will still be properly excluded.
  137.  
  138.   * If you have more than 100 entries in DUSER.CTL, D-User will only use
  139.     the first 100 entries.  D-User notifies you when it is using the
  140.     exclusion file, and also how many users it excluded from the bulletins.
  141.  
  142.      Example of DUSER.CTL:
  143.  
  144.              John Smith
  145.              Jane Smith
  146.              The Punisher
  147.  
  148.  
  149. RemoteAccess Files:
  150. ═══════════════════
  151.  
  152.   D-UseR will search for the RemoteAccess files it needs in three steps.
  153.  
  154.         1 - In the directory specified by the RA environment variable.  You
  155.             should already have this variable set to point to your main RA
  156.             directory, but if not other methods are used to find the
  157.             configuration files required.
  158.         2 - In the directories specified in your PATH statement in
  159.             Autoexec.bat.
  160.         3 - In the current directory that D-UseR is being executed from.
  161.  
  162.   If the files cannot be found after this, D-UseR will abort with an
  163.   appropriate error message.
  164.  
  165.   These methods should handle any setup that you have.  If you cannot
  166.   get any of these methods to work, please let me know and I will
  167.   try to accomodate for them in the next release.
  168.  
  169.  
  170.  
  171.  
  172. Bulletins Created:
  173. ══════════════════
  174.  
  175.   D-UseR creates the following bulletins in your RA textfile path as
  176.   configured in RaConfig.
  177.  
  178.                          D_USER.ANS  ( Ansi bulletin )
  179.                          D_USER.ASC  ( Ascii bulletin )
  180.  
  181.  
  182. Legal Disclaimer
  183. ════════════════
  184.  
  185.   No warranty for this utility is either expressed or implied. The author
  186.   shall not be held liable for any direct or consequential damage which
  187.   arises from the use of this utility. While the program has been tested
  188.   extensively, I make no gaurantees it will work properly on your
  189.   system.
  190.  
  191.   Note: D-UseR does *not* write to the USERS.BBS or USERSXI.BBS files at any
  192.         time.
  193.  
  194.  
  195. Suggestions always welcome!
  196. ═══════════════════════════
  197.  
  198.   If you have any suggestions for improvement or wish to report any bugs,
  199.   you can reach me through my BBS:
  200.  
  201.                The Flight Deck BBS
  202.                (416) 299-1164
  203.                James FitzGibbon - SysOp
  204.                TeleNet Canada: 20:22/11
  205.                X-Net: 40:43/7
  206.                TOCnet: 50:51/2
  207.                F-Net: 110:112/0
  208.  
  209.   or by writing to:
  210.  
  211.               James FitzGibbon
  212.               38 Seamist Crescent
  213.               Scarborough, Ontario
  214.               M1V 3K4
  215.               CANADA
  216.  
  217.  
  218. ═══════════════════════════════════════════════════════════════════════ end
  219.