home *** CD-ROM | disk | FTP | other *** search
/ Beijing Paradise BBS Backup / PARADISE.ISO / software / BBSDOORW / RGWEEDER.ZIP / RGWEEDER.DOC < prev    next >
Encoding:
Text File  |  1993-01-13  |  7.0 KB  |  152 lines
  1.  
  2.                                 RGWeeder v3.0
  3.  
  4.                    Copyright (c) 1992-1993, Donovan C. Young
  5.  
  6.  
  7.      RGWeeder is a utility used to remove unwanted users from your
  8. RENEGADE BBS user files.  Given the proper parameters, it will scan your
  9. entire USERS.DAT and completely remove any users that match your
  10. qualifications.  This includes deleting all email messages to and from
  11. said user as well as removing any messages the system has waiting for
  12. them (ie. SHORTMSG.DAT).
  13.  
  14.      To delete a user from the user file, RGWeeder will simply mark that
  15. user as deleted (and NOT purge any of thier information - however, as
  16. far as RENEGADE is concerned, the user no longer exists and will be
  17. overwritten by the next new user), it is done this way purposely.  It
  18. may happen that you delete a user in error... if you were using a
  19. program the completely purges the user (overwriting thier information
  20. with garbage) you would have little choice but to recover them from a
  21. backup copy of your user file (if you HAVE a backup!).  Using this
  22. method, you simply need to edit thier user NUMBER (RENEGADE won't find
  23. thier name/handle anymore) and UNdelete them.
  24.  
  25.      RGWeeder will NOT delete ANY user with thier protection from
  26. deletion flag set (AR flag 4), nor will it EVER delete user number 1 (it
  27. doesn't even LOOK at it, so specifing an acs string like 'u1' won't have
  28. any effect).  I feel that if you want user number 1 deleted, you can do
  29. that manually.  :)
  30.  
  31.      Now, before you start, I would HIGHLY recommend that you make
  32. backups (as you should with ANY program that modifies your RENEGADE
  33. system files!) - you never know when you might make a mistake, and end
  34. up deleting EVERYONE!  Now that that is said, and out of the way, let's
  35. start!
  36.  
  37. Syntax:
  38.  
  39.      RGWEEDER < days | acs > [ /V /A /L=<filename> /Y /D<#> ]
  40.  
  41.      RGWeeder has several command line parameters (or options, if you
  42. will) that dictates how it will perform.  The first, and most important
  43. of which, you MUST supply as RGWeeder will not run without it!  You must
  44. specify either a number value (ie. 30, 45, etc) -OR- any VALID RENEGADE
  45. ACS string (NOTE - if you don't specify a number, RGWeeder assumes the
  46. parameter is an ACS string, type carefully!).
  47.  
  48. <Required Parameters>
  49.  
  50.      <days>:   The number is the number of days since thier LAST LOGON
  51.                (ex. 30 would delete all users that haven't called for
  52.                AT LEAST 30 days).
  53.  
  54.   -OR-
  55.  
  56.      <acs>:    This is any valid RENEGADE acs string (ie. fD, !s20,
  57.                !s20fD!u345, etc).  Any users that match this acs string
  58.                will be deleted.
  59.  
  60.  
  61. [Optional Parameters]
  62.  
  63.      /V
  64.           This sets VERBOSE mode ON.  Normally, RGWeeder operates in a
  65.           "stealth" mode where it will only display users that have been
  66.           deleted, using this option, it will display EACH user as it is
  67.           processed and tell you thier status (OK, Already Deleted, or
  68.           DELETED).
  69.  
  70.      /A
  71.           Turns ON confirmation.  RGWeeder normally does its work based
  72.           solely on either the <days> or <acs> parameters, and deletes
  73.           users that match.  With this option, RGWeeder will STOP before
  74.           it deletes a user and wait for you to answer with either 'Y',
  75.           'N', 'A', or 'Q'.  Y means 'YES, Delete this user', N means
  76.           'NO do NOT delete this user', A means 'Allways delete users,
  77.           and don't ask anymore', and Q means 'Quit scanning and exit'.
  78.  
  79.      /L=<filename>
  80.           Normally RGWeeder will log all its activity to RENEGADE's
  81.           SYSOP.LOG, however, using this option and supplying a filename
  82.           (NO PATH!), RGWeeder will instead use that name as the log
  83.           file (it will place this file in your current RENEGADE LOGS
  84.           directory).
  85.  
  86.      /O   RGWeeder has a built in feature that checks the last time it
  87.           was ran with the current system date.  Since its posible to
  88.           have a problem with the system date being incorrect, this is
  89.           done to insure that if you are using the <days> parameter,
  90.           RGWeeder doesn't falsely report ALL your users as be INACTIVE!
  91.           (most computers reset thier system clock to 12:00am 1-1-80
  92.           after a failure). Normally, RGWeeder will stop and ask you to
  93.           hit either yes or no to continue, but with this option,
  94.           RGWeeder will simply continue as if the date check never
  95.           failed.  Use this option with care!
  96.  
  97.      /D<#>
  98.           As with the option above, this is used with the internal date
  99.           checking feature to tell RGWeeder how many days between runs
  100.           it should consider as an ERROR.  By default, this value is 30
  101.           days.  Specifing a number (in place of the '<#>') tells
  102.           RGWeeder to use this number instead (ie. /D5 = report an error
  103.           if it's been more than five days since RGWeeder was last run).
  104.  
  105.  
  106. Internal Date Checking:
  107.  
  108.      RGWeeder has a built in feature that checks the current system date
  109. against the date it was last run (it keeps this information in a file
  110. called RGWEEDER.DAT in your DATA dir).  If the number of days since it's
  111. last run is greater than 30 (or the number specified with the /D
  112. option), it will bring up a message telling you this and asking you if
  113. you wish to continue.  If you get this message, please be SURE the date
  114. is correct before pressing 'Y'.  If you are unsure for ANY reason, hit
  115. 'N'.  NOTE - the first time you run RGWeeder, it will give you this
  116. message due to the fact that it couldn't find the data file holding the
  117. last run date - this is normal and for your own protection, just answer
  118. 'Y' if you are sure the system date is correct.
  119.  
  120.      Note of ACS strings:  RGWeeder supports all the current ACS string
  121. commands with the exception of a few.  It won't check conferences, nor
  122. will it check baud rate (among a couple of other minor ones that I
  123. really don't see anyone using anyway).  If you run accross an ACS string
  124. that you wish to use and isn't supported, just drop me a note at the
  125. address listed below, or via my BBS (see below).
  126.  
  127. Please report any suggestions, bugs, comments or gripes to me either via
  128. a note in the mail (USnail), netmail @FIDO 1:133/809 or:
  129.  
  130.                Cyberdyne Systems BBS:   1 (404) 668-9804
  131.  
  132.  
  133.  
  134.         RGWeeder is being released under the SHAREWARE concept, ie. you
  135.         may use RGWeeder freely for a trail period (not to exceed 30
  136.         days), after which time you must either register your copy by
  137.         mailing the REGISTER.TXT form along with a check or money order
  138.         for $10.00, or discontinuing its use.
  139.  
  140.                 Mail your registration to:
  141.  
  142.                            Cyberdyne Systems
  143.                          6900 Roswell Road H-2
  144.                            Atlanta, GA 30328
  145.  
  146.         Make your check or money order payable to Donovan C. Young.
  147.  
  148.         Registration of this utility will make you elilible for
  149.         discounts on future Cyberdyne Systems / Renegade Utility
  150.         releases.
  151.  
  152.