home *** CD-ROM | disk | FTP | other *** search
/ Otherware / Otherware_1_SB_Development.iso / amiga / comms / bbs / dlgsysop.lha / dlgsysop.doc < prev    next >
Text File  |  1991-05-23  |  9KB  |  196 lines

  1. Ron Shaw Fido 1:374/7 - Programmers World - 407 639-9123 DUAL HST v32bis
  2.  
  3. DlgSysop is the beginning of this series of utilities for BBS programs.
  4.  
  5. PLUGS:
  6. Available now ExpDlg 1.0 (PD), converts Amiexpress accounts to Dialogue,
  7. but this one the user has to call once to Dialogue (eliminates dead accounts).
  8.  
  9. Another util is DlgExp1.01, which converts user accounts from/to
  10. Dialogue/Amiexpress and builds file listings for Amiexpress.
  11. With DlgExp1.01, you can move or update user accounts from Dialogue
  12. to Amiexpress or visa versa. You may specify ratio's, conferences, etc.
  13. and edit user accounts (Dialogue of AmiExpress).
  14.  
  15. DlgUser 1.0 (PD). Allows the sysop to change, add to, or subtract from a users
  16. uploaded bytes or files (offline). Where as the current version of Dialogue
  17. does not display the actual uploaded/downloaded bytes, to get an exact
  18. figure, you can use DlgUser passing 0 as a parameter.
  19.  
  20. If you are interested in any of them (some are pd), call the BBS or Email me
  21. at 1:374/7 (most are posted on other boards with my last 2 years od AmiExpress
  22. utils which are being currently updated to work with the new version.
  23.  
  24.  
  25. On to DlgSysop.
  26. I found the need to determine user handles, ratios, System total, search
  27. for users by handles, access levels etc.
  28. Of course everyone running a BBS at one time or another would like to know
  29. what access level a user has, or who all has access at or over a specific level.
  30. well DlgSysop does it & much more.
  31. And to get info on a user, I had to logon the BBS and type the users ENTIRE name.
  32. Not now I don't!
  33. I can do this and more from cli without going into Dlg!
  34.  
  35. With DlgSysop, you can OFF OR ONLINE:
  36.  Find One specific user by his handle or name, or a group of users using Wild Cards.
  37.  Find All (or wild card activated) users above, below or at a specific access level.
  38.  Display all Message areas with set max # of msgs, access levels and more.
  39.  is the area Fido? NewMail? Does it use handles? Signatures? AutoAccess?
  40.  DlgSysop lets you know.
  41.  Display all File areas with access levels and other itesm.
  42.  
  43. I can go on & on but I wanna get back to work on this and other utils.
  44.  
  45.  
  46. Typing DlgSysop Username displays information on that user (if he exists).
  47.  
  48. You may type in multiple names such as,
  49.    "DlgSysop username1 username2 username3 username4 ...."
  50.  
  51. Of course if the users name has a space you must enclose the entire name in
  52. quotes such as .. "DlgSysop "User name One" username2 "User name3", get it?
  53.  
  54. And you can use a wild card.
  55.   "Typing DlgSysop A* B* C*" displays all users whos names begin with A B & C.
  56.  
  57.   Typing DlgSysop "Joe Smoe" Ro*   Displays Joe Smoe's account and all users
  58.  who's names begin with Ro. Told yah it was simple. Then there is the wildcard
  59.  '?' which replaces any one character.
  60.   DlgSysop R?T  replaces the ? with a,b,c,d,etc.
  61.  
  62. Typing DlgSysop by its'self displays a quick option guide.
  63.  
  64.  
  65. Useage examples:
  66. Say a user is online, you aren't, but you would like info on him.
  67. type "DlgSysop username" and BINGO! there it in front of your face.
  68. And if you add the word "USERALL" to the environmental variable (DLGUTIL),
  69. you get even more info. Add the word "USERPW" & you display his password too.
  70.  
  71. Another example is to use DlgSysop as a menu item, Arexx util, or DLGbatch
  72. file. call it with DlgSysop "%ALIAS" and it will show the user online his
  73. info including the EXACT number of bytes he has available for downloading.
  74. You may also add the -u -m flags to show him the file and message areas you
  75. have available or add his level to the args and it will only show the ones
  76. he has access to. Its up to you to use your imagination.
  77.  
  78. Want a hardcopy of all your file & msg areas? Use DlgSysop >ram:tmp -f -m,
  79. then send that file to the printer. Or add more options for complete info
  80. on your BBS including a complete list of users with info.
  81. Wanna really know how many users you have? DlgSysop will give you that info
  82. too! Plus total upload/downloaded Bytes & files.
  83. Since Dialogue users accounts are all directories, there is a possibility
  84. that you could have directories (or files) in your USER: dir that are not
  85. actually accounts. If you are like me, I don't want em there & wanna
  86. be notified
  87.  
  88. if they exist, well DlgSysop tells yah, so you can move or delete em.
  89.  
  90. Current environmental Variables:
  91.    COLOR - setting this variable displays pertinent user info in a different
  92.           color so it jumps out at yah (catches your eye).
  93.           (I suggest turning this one off when you want a print out)
  94.  USERALL - For more complete user info such as last time on, number of
  95.            messages read, etc. add the word "USERALL" to the dlgutil env.
  96.            DlgSysop defaults to a 2 line display of each user, with the most
  97.            pertinant info displayed, of course if you need more, use the
  98.            env variable.
  99.   USERPW - Most sysops don't need to know a users password and you sure
  100.            wouldn't want it displayed if you use DLgsusop as a menu item
  101.            to show all your users, message, and file areas, so it defaults
  102.            to off.
  103.  
  104. Environmental variables are set in one string, with a space between each.
  105. DlgSysop looks for the env variable dlgutil (case doesn't matter).
  106. so to set em all, use this SetEnv dlgutil="color userpw userall"
  107. It's so simple, mine is in my startup-sequence. And Since DlgSysop uses an env
  108. variable with online arguments instead of reading a config file, it's
  109. quicker (for you 68000 users).
  110.  
  111. Current Flags:
  112.  -u  Will kick you out a list of all users and other info including total users.
  113.      Total uloads/download - bytes and files, etc.
  114.  
  115.  -m  Displays all Message bases with other info.
  116.  
  117.  -f  Displays all the File Areas with other info.
  118.  
  119.  -a  (user name) (user name) etc. will search for aliases instead of user names.
  120.  
  121.  -L  This may seem hard to undestand but it's really very simple. I put it in
  122.      uppercase so you could tell it was an 'L' but all of em can be typed either
  123.      upper pr lower case (how many times did I say that?). Anyways The L option
  124.      stands for level - A users access LEVEL. and you can use either the '-' minus,
  125.      or the '+' after the 'L' option, or none. Here's how it works.
  126.      Using the - tells DlgSysop you want users at and below the number after
  127.      the minus, a '+' plus, tells DlgSysop you want users at and above the number
  128.      after the plus. Using neither the '-' or the '+' signals DlgSysop to only
  129.      display users at the number level directly after the 'L' Heres some examples.
  130.  
  131.      Say I want a list of all users with an Access level of 50. Here's what I type
  132.      DlgSysop -L50
  133.  
  134.      Say I want users at access level 50 and below
  135.      DlgSysop -L-50
  136.  
  137.      Say I want users at access level 50 and above
  138.      Dlgsysop -L+50
  139.  
  140.      Simple as hell ain't it?
  141.  
  142.  
  143. OTHER EXAMPLES:
  144.  
  145. Typing "DlgSysop username username username "
  146.  
  147. will give you infornation on those 3 users. The amount of info you get is
  148. dependent on the environmental word USERALL, if set maximum info on the
  149. user will be displayed (except for his password which can be obtained by
  150. adding the USERPW to the env setting).
  151.  
  152. You want all users names beginning with R and access level at 50 of above?
  153. Type "DlgSysop R* -l+50"
  154.  
  155. Wanna see all the file areas too?
  156. Type "dlgSysop R* -l+50 -f"
  157.  
  158. Multiple arguments are supported as well as not having to type in a
  159. specific case.
  160.  
  161. Wild cards are the * and the ?. The '?' matches one character such as
  162. 'S?Sop'
  163. DlgSysop R?ock   will find users Rick, Rock, Rack, etc.
  164. dlgSysop R*      will find all user names beginning with the letter R,
  165.                 wheather its upper or lower case.
  166.  
  167.  
  168. Well there is a lot more to DlgSysop, but since this is a Kinda demo,
  169. you will find some items inactive. If you wanna get in on the first release
  170. of this util which is available now, contact me for details.
  171.  
  172.  
  173. Ron Shaw
  174. 1713 Dixon Blvd. #139
  175. Cocoa,Fl. 32922
  176. Programmers world Fido 1:374/7 407 639-9123
  177. And request it by name.
  178.  
  179.  
  180. BTW, I know these docs are lacking. My intention is to get back to work on
  181. the utils, not to spend my time proof reading or writing docs for Demo
  182. versions of software that I release. The Docs you get with the program are
  183. adequate to use with this software (I am a hardware/software engineer not a doc
  184. writer)- Sorry bout that. But DlgSysop is so simple to use that only
  185. someone that never used an Amiga could get stuck! I would suggest copying
  186. this util to either your Dlg: or c: directory.
  187.  
  188. Want quick usage? type DlgSysop by itsself.
  189.  
  190. More features being added.
  191.  
  192. Most of my BBS & programming pals know I always write acknowledgements in my
  193. programs, the added file ack.txt are them. Some users down load my utils just
  194. to read the wierd things I have to say. If you are one, you should enjoy ack.txt
  195. if not, who give a shit! (I had fun saying that & writing the ack,txt).
  196.