home *** CD-ROM | disk | FTP | other *** search
/ Beijing Paradise BBS Backup / PARADISE.ISO / software / BBSDOORW / USERUTL5.ZIP / USERUTIL.DOC < prev    next >
Text File  |  1993-07-04  |  10KB  |  249 lines
  1. USERUTIL Ver-1.50
  2. July 3, 1993
  3. Written by - Dan Shore - SysOp
  4.              THE SHORELINE BBS
  5.                301-946-2771 (Public Node)
  6.                301-946-4202 (Registered Users Only)
  7.  
  8.  
  9.  
  10. What is USERUTIL?
  11. ----------------
  12.  
  13. UserUtil is a program to assist in the maintenance of user information
  14. within all your user files (conferences, sub-boards, etc.).  The program
  15. came of existence, when a SysOp was looking for a program to globally
  16. change the security levels of users in a single users file.  After that
  17. little program was written, a SysOp friend of mine wanted to be able
  18. to update information about all the users in one file to another.  Then
  19. another SysOp friend, needed another part added, and voila, the birth
  20. of UserUtil!
  21.  
  22.  
  23. UserUtil Configuration File
  24. ---------------------------
  25.  
  26. The configuration file for UserUtil is called USERUTIL.CFG
  27. and must reside in the same directory as the USERUTIL program.
  28.     ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  29.  
  30. The layout of the file is:
  31.  
  32. Line 1 :  Path/Name of ConfMail.Def
  33. Line 2 :  Path/Name of Main User file
  34. Line 3 :  Path/Name of Verified Phone Number File (CallBack Door)
  35. Line 4 :  Field in Verified log where the UserName starts
  36. Line 5 :  List of words to determine if UserName is 2 or 3 parts
  37.            (ie.  Dan Shore, John Doe Jr., Sam Young....)
  38.  
  39. Example:
  40.  
  41.         c:\rbbs\confmail.def
  42.         c:\rbbs\user\users
  43.         c:\rbbs\callback\verified.log
  44.         2
  45.         Sun Mon Tue Wed Thu Fri Sat
  46.  
  47.      ** [ Please use full paths to the filenames! ] **
  48.  
  49.  
  50. If the above example you are telling UserUtil the path and name of
  51.  
  52.         1. The ConfMail.Def Filename
  53.         2. The Mail Users Filename
  54.         3. The verified phone number Filename
  55.         4. The second field in the log is the start of the Username
  56.            using the example below to illustrate
  57.  
  58.            Sample Log Entry:
  59.  
  60.            301-572-6584 SCOTT PALMER Tue Jun 09 13:57:30 1992
  61.                 ^         ^     ^     ^   ^  ^      ^     ^
  62. Field #-->      1         2     3     4   5  6      7     8
  63.  
  64.            [ Note that fields are seperated by spaces ]
  65.  
  66.         5. Words to exclude as three part usernames with each
  67.            word seperated by a space and you can use up to
  68.            50 words on this line.
  69.  
  70. Note with the 5th entry, that UserUtil will ALSO exclude a third part name
  71. if the word it encounters has any character that is not between a-z,
  72. A-Z, or has a period (.) as part of the name.
  73.  
  74. The words I have used in my example are due to my callback door putting
  75. the day of the week that the user used the callback door right after the
  76. callers name.  These words are CASE SENSITIVE!!!
  77.  
  78.  
  79. ** IMPORTANT NOTE **
  80.    --------------
  81. If you do not use a callback verifier, then you need only have the
  82. first TWO LINES in your configuration file.  The 3rd through the 5th
  83. lines are optional.  If you do have a callback verifier and wish to
  84. use this feature of UserUtil, then you MUST have lines 3 & 4 with
  85. line 5 being optional.
  86.  
  87.  
  88.  
  89. What does each Menu Choice do?
  90. ------------------------------
  91.  
  92. Choice A: ADD/UPDATE EXISTING USER TO USER FILE(S)
  93.  
  94. This choice is really two seperate items.  First, you can ADD a user from
  95. an existing file up to five (5) other user files.  Second, you can UPDATE
  96. a users information from one user file (most likely your MAIN user file)
  97. to ALL other user files.
  98.  
  99. The first item will set up the user in the 5 chosen user files with the same
  100. information that was in the source file.  You will be prompted if you wish
  101. to change the security level and the registration date in the destination
  102. file(s).
  103.  
  104. The second item will update user information from a source file (again, most
  105. likely the MAIN user file) to either up to five (5) other file(s) or ALL
  106. other user files.  You will again be prompted for changing security level
  107. and registration date.  The program then gets the user from the source file
  108. and checks to see if he/she exists in the destination file(s) and updates
  109. according to your specifications.
  110.  
  111.  
  112.  
  113. Choice B: ADD NEW USER TO A USER FILE
  114.  
  115. This choice will allow you to add a username to one user file.  The
  116. user is added just like RBBS adds a user when your choose 5 from the
  117. sysop menu (5 is the standard, you may be using something else).  You
  118. will be prompted for the same information as RBBS does, but without
  119. having to be logged on to the BBS.
  120.  
  121.  
  122.  
  123. Choice C: UPDATE INFORMATION FROM ONE FILE TO ANOTHER
  124.  
  125. This choice will allow you to enter in a source file, and one destination
  126. file to update users.  It will also prompt you if you wish to change
  127. the users password, security level, city/state, and registration date or
  128. just update it from the source.  The program will then search the source
  129. file and see if he/she exists in the destination file and update information
  130. accordingly.
  131.  
  132.  
  133. Choice D: GLOBAL USER SECURITY LEVEL CHANGE
  134.  
  135. This choice lets you choose a user file, enter in the security level to
  136. search for and what is the new security level to change it to.
  137.  
  138.  
  139. Choice E: EXIT
  140.  
  141. I believe this choice is self-explantory..but if in doubt try it out, live
  142. on the edge!!
  143.  
  144.  
  145. Choice F: EDIT A USER'S BANK TIME
  146.  
  147. This choice lets you edit Bank Time in any user file.
  148.  
  149.  
  150. Choice G:  REMOVE CALLBACK DOOR VERIFIED USER ENTRY IF USER
  151.            DOES NOT EXIST IN MAIN BBS USER FILE.
  152.  
  153. The program will read the verified phone number file that you listed in
  154. the configuration file and check to see if username(s) still exist in
  155. the MAIN BBS Users File.  UserUtil will create two files when this
  156. choice is made.  If your verified user file is called VERIFIED.LOG
  157. then UserUtil will create (in the same directory as your original file):
  158.  
  159.                VERIFIED.NEW - New listing of callback usernames
  160.                               who exist in the main users file
  161.  
  162.                VERIFIED.DEL - List of callback usernames that
  163.                               were in VERIFIED.LOG but were
  164.                               not written to VERIFIED.NEW
  165.                               (These are the removed names)
  166.  
  167.  
  168. Miscellaneous
  169. -------------
  170.  
  171. With the testing that the program has gone through already, there has not
  172. been any reported problems with corrupted user files.  But as always, WITH
  173. ANY PROGRAM, if you are going to make a change to any user file(s), you
  174. should either back them up, or copy them somewhere so they can be restored.
  175.  
  176.  
  177. Warranty & Disclaimer:
  178. ---------------------
  179.  
  180. THIS PRODUCT IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND,
  181. INCLUDING ANY WARRANTY OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR
  182. PURPOSE.  THE ENTIRE RISK AS TO THE RESULTS AND PERFORMANCE OF THE
  183. PROGRAM IS ASSUMED BY YOU.  FURTHERMORE, I THE AUTHOR DO NOT WARRANT,
  184. GUARANTEE, OR MAKE ANY REPRESENTATIONS REGARDING THE USE OF OR THE
  185. RESULTS OF THE USE OF THE PROGRAM, OR THAT THE PROGRAM WILL RUN WITHOUT
  186. ERROR, AND YOU RELY ON THE PROGRAM AND RESULTS SOLELY AT YOUR OWN RISK.
  187. I THE AUTHOR CANNOT ACCEPT RESPONSIBILITY FOR SYSTEM DAMAGE, LOSS OF
  188. PROFIT, OR ANY OTHER SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES
  189. RESULTING FROM THE USE OR INABILITY TO USE THIS PRODUCT.
  190.  
  191.  
  192. Distribution/Registration
  193. -------------------------
  194.  
  195. This program is being distributed as FREEWARE.  Please enjoy the program,
  196. distribute it to your fellow SysOps, and I hope that it helps make your life
  197. easier as a SysOp with the maintenance of your system.
  198.  
  199. If you encounter any problems with the program you can leave me a message
  200. on my BBS, or leave a messgae in the RBBS conference on RIME, or the
  201. RBBS-PC conference on RBBS NET, and I will be more than glad to look at
  202. the problem and correct it.
  203.  
  204. If you find that you have an excess amount of cash lying around and
  205. feel compelled to send me some money for it, then by all means please do.
  206. If you don't wish to send it to me, then donate it to your favorite
  207. charity as I am sure they can use it.
  208.  
  209. This archive is ZIPPED with PKZIP's -AV stamp.  If you don't get a stamp
  210. that has #MMJ131  THE SHORELINE BBS, then you might be getting a hacked
  211. version and I would recommend again using it.  (Remember that some BBS's
  212. re-zip their files and that also removes the -AV stamping)  You can
  213. always call my BBS and get an -AV stamped version.
  214.  
  215. All my programs are downloadable for first time callers in Personal Downloads.
  216.  
  217.  
  218.                         Dan Shore - SysOp
  219.                         THE SHORELINE BBS
  220.                     DGS Systems Group (Wonder)
  221.                            301-946-2771
  222.                      3/12/24/9600/14.4k v.32bis
  223.  
  224.                       Fido Address: 1:109/458
  225.                       RIME Address: SHORELINE
  226.  
  227.  
  228. Home of the following fine programs:
  229. -----------------------------------
  230. (TESTFIL3.ZIP)   TestFile - Date checking of uploaded files
  231.                             (Included in RBatch Distribution
  232.                              package)
  233. (USERUTL5.ZIP)   UserUtil - User file Maintenance Utility
  234. (NOUPS12.ZIP)    NoUps    - Bulletin of Users with 0 U/L's
  235.  and...
  236. (RBTCH225.ZIP)   RBatch   -  Batch Uploading, HS/Link & BiModem Interface.
  237.                              Local file posting ability for SysOp's, it
  238.                              will process FILE_ID.DIZ, DESC.SDI and .DOZ
  239.                              files.  It will also process .TIC files, and
  240.                              has too many options to list.
  241. (DELUSER.ZIP)    DelUser  -  Utility that will purge users from users file
  242.                              based on date.  This date can be any number of
  243.                              days ago, and not just in months like RBBS does.
  244.                              SysOp can be prompted for deletes of each user
  245.  
  246.  
  247. -== [ This list as of 7/3/93 ] ==-
  248.  
  249.