home *** CD-ROM | disk | FTP | other *** search
/ ftp.wwiv.com / ftp.wwiv.com.zip / ftp.wwiv.com / pub / BBS / CEL202R.ZIP / CEL202-4.ZIP / USER_260.ZIP / USEREDIT.DOC < prev   
Text File  |  1994-04-17  |  18KB  |  551 lines
  1.   ---------------------------------------
  2.   Celerity v2.xx        User Editor v2.60
  3.   Written by: Sicko              04/17/94
  4.   ---------------------------------------
  5.  
  6.  This heres' a quick user editor I put together.
  7.  This Utility can be used with v2.xx of Celerity.
  8.  
  9.  
  10. ┌───────────────────────────────────────┐
  11. │  License, Warranty and Disclaimer     │
  12. └───────────────────────────────────────┘
  13.  
  14. I'll keep this part short and sweet, and dispense with the legal-ese:
  15.  
  16.    License: You are allowed to use CUE for 30 days, after which you
  17.        must either register CUE or stop using it completely. CUE
  18.        registration is a license for your use of CUE; I retain
  19.        ownership of the software. A single registration applies to a single
  20.        SYSOP, regardless of the number of computers used in the
  21.        system. If you run two or more distinct BBS systems on the same
  22.        computer(s) (with different SYSOP names), you ARE required to have
  23.        two or more CUE registrations.
  24.  
  25.    Warranty: There isn't one. The only thing I'll guarantee is that
  26.        CUE will take up disk space, and will disappear when deleted.
  27.  
  28.    Disclaimer: I'm not responsible for anything bad that happens. CUE
  29.        works here, but I cannot be held responsible for it not working on
  30.        your computer or doing any damage to hardware or software.
  31.  
  32.    Use at own risk! I've tested it on my system and have had no problems,
  33.    but this doesn't mean you WONT. Use common sense when using utilities
  34.    that update a possibly "shared" database. Since this utility does update
  35.    your user database, make sure the BBS is "down". I cannot predict what
  36.    will happen if you start editing the user base while someone is on your
  37.    board. Make a back-up of your user base before using this utltity (duh.)
  38.  
  39. If these aren't agreeable with you, then the best thing to do is delete CUE
  40. right now. I'll do my best to help any user (registered or not) that wants to
  41. use CUE, and I'll act on bug reports quickly, but I simply cannot and will
  42. not be responsible for anything bad, like lost data, disk crashes, or whatever
  43. else you can think of.
  44.  
  45.   Please review the register.frm file.
  46.  
  47.  
  48.  
  49.  
  50.  
  51. Features:
  52.  
  53. o Windowed display of users
  54. o Full Screen Editor
  55. o Can search for users in many ways. (look at the current menu for the
  56.                                       possible choices)
  57. o Delete Users.
  58. o Validate users.
  59. o What else do ya want?
  60. o Sorting and packing the user base by:
  61.          Ascending:  Handle, Realname, Area Code and User Id.
  62.         Descending:  Ditto.
  63.  
  64.  
  65.  
  66.  -----
  67.  NOTES
  68.  -----
  69.  
  70. You can pass the path to your setup.dat file and a UserId to start editing
  71. with in the command line:
  72.  
  73. f:> f:\celerity\user.exe f:\node1\setup.dat 2
  74.  
  75. From EXTERN.DAT
  76.  
  77. Edit User Online,f:\celerity\utils\user.exe,%S %U
  78. Edit Users,f:\celerity\utils\user.exe,%S
  79.  
  80.  
  81. -----------
  82. How to use:
  83. ----------
  84.  
  85. Hit ALT-F1 for HELP!
  86.  
  87. When at a list box you may search for an item/user/whatever by typing
  88. what you are looking for. THe cursor will be moved to the item that
  89. matches the characters entered.
  90.  
  91.  
  92. From The First User Editing Screen:
  93.  
  94. Alt-F1 : Help
  95.  
  96. Alt-D  : Delete User
  97.  
  98. Alt-V  : Validate User
  99.  
  100.    F2  : Goto Second User Editing Screen.
  101.  
  102.    F3  : Goto Third User Editing Screen.
  103.  
  104.    F4  : Goto forth User Editing Screen.
  105.  
  106.  
  107. ----------
  108. More Info:
  109. ----------
  110.  
  111.  The options to search for a user will allow you to edit all users that
  112.  contain the entered search string within their handle. ie if I searched for
  113.  "si" or "SI" I would be able to edit Sicko, SIMPLE, Silver DOOD, etc.
  114.  (case is irrelavant).
  115.  
  116.                                    -=-
  117.  
  118.  P.S. I don't professes to be a great "Pascal" programmer nor ever care to
  119.        be one, and I have no aestetic abilities whatsoever so this thing
  120.        will be ugly till the end of humaity.
  121.  
  122.                                    -=-
  123.  
  124. Full Screen User Base Editor Fuctions:
  125.  
  126.       Left-arrow, Ctrl-S : Move left 1 character in a field, previous field.
  127.      Right-arrow, Ctrl-D : Move right 1 character in a field, next field.
  128.  Ctrl-Left-arrow, Ctrl-A : Move left 1 word, jump to previous field.
  129. Ctrl-Right-arrow, Ctrl-F : Move right 1 word, jump to next field.
  130.           HOME, Ctrl-Q/S : Cursor to beginning of field.
  131.            END, Ctrl-Q/D : Cursor to end of field.
  132.              DEL, Ctrl-G : Delete character at cursor.
  133.    Bksp,Ctrl-H,Ctrl-Bksp : Delete character to left of cursor.
  134.                   Ctrl-Y : Delete entire field.
  135.        Ctrl-END,Ctrl-Q/Y : Delete from cursor to end of field.
  136.                Ctrl-HOME : Delete from beginning of field to cursor.
  137.                   Ctrl-T : Delete word to right of cursor.
  138.                      INS : Toggle insert mode.
  139.          Ctrl-R,Ctrl-Q/L : Restore original contents of field.
  140.             ENTER,Ctrl-M : Accept contents and move to next field.
  141.         Up-arrow, Ctrl-E : Move cursor up 1 field.
  142.       Down-arrow, Ctrl-X : Move cursor down 1 field.
  143.              TAB, Ctrl-I : Move to next field.
  144.                Shift-TAB : Move to previous field.
  145.       Ctrl-PgUp,Ctrl-Q/R : Move to first field on screen.
  146.     Ctrl-PgDown,Ctrl-Q/C : Move to last field on screen.
  147.                     PgUp : Edit previous file in list.
  148.                   PgDown : Edit next file in list.
  149.                      ESC : Exit.
  150. Ctrl-ENTER,Ctrl-K/D,Ctrl-K/Q : Save & Exit.
  151.  
  152.  
  153.                                     -=-
  154.  
  155.  
  156.  You should consult your Celerity Docs/ and record structures for more
  157.    in-depth explanations of some of the fields that can be changed using
  158.    this program. Some values are not accepted by Celerity, but I've tried
  159.    to prevent as much of this from happening as possible. Experiment.
  160.  
  161.    Remember ratios are what they say 0-100. Don't enter numbers that
  162.    are exeptionally large, for Celerity may report these numbers as negative.
  163.  
  164.  
  165.  If you have any problems/suggestions you can reach me via private e-mail
  166.   on Celerity-Net or on any of the "Sysop" Celerity-Net bases or on
  167.  
  168.                -The BoG  (312)
  169.                -Sicko
  170.  
  171.  
  172.                               -= History =-
  173.  
  174.  4/18/92 = 1.0 & 1.1 (why not?)  Added a scroll bar to the main menu.
  175.  
  176.  4/27/92 Added some more options and added alot of the editable user fields
  177.           to the main edit screen. Got part of the reverse search logic in
  178.           but not fully implemented. (Next release)
  179.  
  180.  
  181.  4/29/92 Fixed problem the Main & transfer level, both enterable fields
  182.           on screen where editing the same field. (whoops)
  183.  
  184. -5/10/92 Added backwards searching on the Expiration Date Edit option.
  185.  
  186. -6/2/92  Added backwards searching to all edit functions.
  187.  
  188. -7/7/92  Added editing of range of user levels.
  189.  
  190.         The backwards searching is a little goofy at the very end of the
  191.         user base. The problem is known, just to busy to fix it. <- FIXED.
  192.  
  193. 8/17/92  Version 1.6
  194.  
  195.         I ferget what I added to this one, this is basically a release to
  196.         get the status screens to reflect the current version of Celerity.
  197.  
  198.  
  199. 9/12/92  Version 1.7
  200.  
  201.         Revamped the whole thing. See how ya like it and get back to me.
  202.         Byter tells me that v1.42 will change the user message base access,
  203.         so until that version comes out I will not touch it.
  204.  
  205.  
  206. 10/25/92 Version 1.8
  207.  
  208.         Added a bunch of new search options. Modded the look a little.
  209.         Added the user note to the list box.
  210.  
  211.  
  212. 01/10/93 Version 1.9
  213.  
  214.         Added alot of stuff.
  215.  
  216.         Play around with it. There are list boxes for access, sysops flags
  217.          and such, then there are also screens that display most of the
  218.          information contained in the list boxes. I put it on screens so
  219.          people could page through a bunch of users and see the info on the
  220.          screen w/o having to change user then highlight the access list
  221.          box, etc....
  222.  
  223.         - More to come....
  224.  
  225.  
  226. 01/11/93 2.0
  227.  
  228.         Converted to the v2.0 user record structure, and added a buttload
  229.         of stuff.
  230.  
  231.         To run this from the F5 menu add this to your external.dat file
  232.  
  233.         User Editor,C:\Celerity\user.exe,%S
  234.  
  235.         or if you want to edit the user thats online
  236.  
  237.         Edit Online User,C:\Celerity\User.exe,%S %U
  238.  
  239.         ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  240.         NOTICE THERE IS NO   ,  inbetween %S & %U
  241.  
  242.         Since Celerity doesn't pass the %U as it is right now I will
  243.         fix it whenever it is passed correctly.
  244.  
  245.         Made the search criteria entry fields a little nicer. If you
  246.         enter blanks or press ESC on most items it will exit out.
  247.  
  248.         Alt-F1 is the help key.
  249.  
  250. 2/14/93
  251.  
  252. *       You can now delete users by pressing Alt-D when editing the user.
  253.  
  254.         Use that user base packer (when its updated for 2.0 that is)
  255.  
  256.         Move the fax and data numbers to the first editing screen.
  257.  
  258.         The scroll-box is now updated when you change information, ie:
  259.         handle, levels, usernote.
  260.  
  261.         Added searching by sysop/xfer/user flags.
  262.  
  263.         Fixed the UserId on screens 2 & 3 to display the correct number.
  264.  
  265.         Added a status bar at the bottom indicating the number of users
  266.         that match search criteria.
  267.  
  268. 2/15/93
  269.         Fixed a bug where it was not saving both digits of the users
  270.         colors.
  271.  
  272. *       Added quick-validate option. Hit Alt-V from the first edit user
  273.         screen. If the setup.dat file was not found you are not allowed
  274.         to validate anyone. The path to setup.dat is passed via the
  275.         command line, so you may want to write a batch job with one line
  276.         in it, similar to:
  277.  
  278.         c:\celerity\util\user.exe c:\node1\
  279.  
  280.         This will run the editor and pass the path to the setup.dat file.
  281.  
  282.         Still waiting for the info-forms to be completed so I can add
  283.         info-form viewing to the user editor.
  284.  
  285.         When SETUP.EXE is updated with all the new 2.0 info, I will
  286.         rewrite the quick validate to grab all necessary fields.
  287.  
  288. 2/21/93
  289.  
  290.         Since this utility will be run from inside Celerity I am reducing
  291.         any unnecessary code and functionality. When this utility is
  292.         run from inside Celerity the following steps are taken:
  293.  
  294.         1. Celerity must write-out the current users recrod.
  295.         2. Celerity must shell to dos.
  296.         3. Celerity must run this util
  297.         4. This util will read the setup.dat file
  298.         5. You do your thing.
  299.         6. The program exits
  300.         7. Celerity is reloaded into memory.
  301.  
  302.         This is not a fast process. If you have the memory for it I suggest
  303.         putting user.exe into a ram drive.
  304.  
  305.         Reduced redudant code.
  306.  
  307.  
  308. 3/29/93
  309.  
  310.         Added searching to list boxes.
  311.  
  312.         Cleaned-up some stuff.
  313.  
  314.  
  315. 4/24/93
  316.  
  317.         Updated the User records.
  318.  
  319. 5/3/93
  320.  
  321.         Incorporated sorting of the user base. I don't know if Byter
  322.         has finished the changes to the way he handles users accounts yet.
  323.         Check with Byter before sorting your user base.
  324.         Don't use this, cause Celerity still uses the position in the
  325.         userfile of the user for certain functions, ie notes to users
  326.         when they login and other places.
  327.  
  328.  
  329.  
  330.  
  331.   *************************************************************************
  332.    Backup your userbase and use that file to learn how to use this utility
  333.   *************************************************************************
  334.  
  335. 7/1/93
  336.  
  337.   Whelps, there seems to have been a bug that caused the editor to crash
  338.   if you called it from Celerity 2.0's external utilities menu. No one
  339.   told me so I never fixed it until now.
  340.  
  341.  
  342. 7/3/93
  343.  
  344.   It still looks like Byter is passing a 0 for the %U parameter from the
  345.   external celerity menu. hmmmmm
  346.  
  347.   Byter pointed out that you could not jump from the 3rd editing screen to
  348.   the second and back and forth. You can now jump to any editing screen from
  349.   any other editing screen.
  350.  
  351. 7/5/93
  352.  
  353.   I surprised no one caught this one. When editing user flags, it would
  354.   flip the wrong ones after the 13th or so. Fixed this.
  355.  
  356. 7/8/93
  357.  
  358.   There were two transfer area sysop flags, actually one was flipping the
  359.   now unused special access flag. Fixed that.
  360.  
  361.   Someone discovered that if you deleted a user it put all HIGH values and
  362.   made it look like the user and user file was screwed. The record is garbage
  363.   true, but the file is fine. I fixed it so that it now moves LOW values
  364.   to the user record when you delete it.
  365.  
  366.   Sorting now does not change records #0 or #1, both are required to be
  367.   kept in the same location for Celerity to operate.
  368.  
  369.   A person reported that he sorted his user base and got all these blanks
  370.   at the top of the user file, OF COURSE YOU WILL! Those are dead users,
  371.   and blanks will be moved to the top.
  372.  
  373.   Got rid of the blinking cursor when viewing help screens.
  374.  
  375.   Byter suggested that I add numbers to the F3 screen for easier editing,
  376.   done.
  377.  
  378.   Added the F4 screen to display all the sysop/user flags in one screen.
  379.  
  380. 7/23/93
  381.  
  382.   Added a packing routine to the sorting. If it finds a record with userid
  383.   of ZERO and a blank handle it will move that record to the bottom of
  384.   the userbase and when its done sorting will delete all blank records.
  385.  
  386.   Added a position variable to the user editing screen. I now allow you
  387.   to edit the userid.
  388.  
  389. 8/1/93
  390.  
  391.    Added renumber the user file by record number.
  392.  
  393.    Added a a writeln to display the number of users found matching search
  394.    criteria.
  395.  
  396.    Changed filename from user.exe to edituser.exe
  397.  
  398. 8/10/93
  399.  
  400.    Changed the way I process the command line to handle all the possible
  401.    combinations that people have presented me with in the last 2 weeks.
  402.    You guys don't read docs do ya?
  403.  
  404.    Phase 1 of the screen modifications. Screen #4, F4, has been updated
  405.    to include Sysop Flags ?? - 32.
  406.  
  407.    I just noticed that the user record has changed. Not sure how long its
  408.    been that way. I don't think it will cause any problems, unless you
  409.    were using some of the now "dummy" variables for something.
  410.  
  411.    Spent a few hours or so redrawing screens, you won't notice any difference.
  412.  
  413. 9/12/93
  414.  
  415.    Worked (a long time) on making this thing more portable.
  416.  
  417. 9/13/93
  418.  
  419.     Spent more time tonight making my life a little easier and who ever
  420.     inherit's this code life miserable. Integrating the usereditor totally
  421.     into the filebase editor. And thus making changes to either side
  422.     virutally interchangable.
  423.  
  424. 9/19/93
  425.  
  426.     From the F4 edit user screen, it would not save the sysop flags. Fixed
  427.  
  428. 10/3/93
  429.  
  430.     Worked on making the userunit more compact and readable. Its now ready
  431.     to be used in the overlay of filebase
  432.  
  433. 10/6/93
  434.  
  435.     I was flipping the bits for the sysop flags on the F4 Screen.
  436.  
  437. 10/17/93
  438.  
  439.     Ooooo, many updates and fixes. I can't remember them all.
  440.  
  441. 11/11/93
  442.  
  443.     Damn, were the access, transfer, and sysop flag handling messed-up.
  444.     No one even told me about this.
  445.  
  446. 11/18/93
  447.  
  448.     Byter said I was setting the sysop flags wrong, they only place I saw
  449.     that this was happening was in the F10 listbox of sysop flags.
  450.     Everything else looks good. I've been give 3 different descriptions for
  451.     the sysop flags in the last 2 days. I'm just going to leave it the
  452.     way it is.
  453.  
  454. 11/20/93
  455.  
  456.     Continuing to gear-up towards the first REAL release in about a year.
  457.     (Was waiting for Celerity 2.0 to comeout, hahahhahah )
  458.  
  459. 12/5/93
  460.  
  461.     Hopefully fixed the handling of sysop flags (as long as Byter doesn't
  462.     change them again.)
  463.  
  464. 12/26/93
  465.  
  466.     OOoopPPPpsss. I noticed that I was using a wrong user record structure
  467.     when I noticed my users getting random(kinda) sysop flags. I was mis-
  468.     reading a field that was then getting set and mis-interpretted by
  469.     Celerity as a sysop flag. (This only popped-up cause I was using
  470.     Celerity's User Custodian and I noticed users had some sysop flags that
  471.     useredit and CMT didn't tell me about)
  472.  
  473.     Surprised no-one said anything. Too scared? hahaaha. oK Whelps heres
  474.     the fix.
  475.  
  476.     Started to code a routine(s) that will allow you to have a user-overlay
  477.     that will be assigned to each user matching a search critiera. Kinda like
  478.     what RESET.EXE should really do. You enter the search criteria, (just like
  479.     celerity's access string) and all users that match will have whatever
  480.     user-file parameters changed.
  481.  
  482. 1/8/93
  483.  
  484.     The ever polite Silver Surfer pointed out that if you were editing the
  485.     last user in the userbase that you couldn't do too much. Whelps, fixed.
  486.  
  487.     Readded the Transfer Level field.
  488.  
  489.  
  490. 2.20+
  491.  
  492. 1/23/94
  493.  
  494.     Increased the field lengths for Bytes up/down, totl files up/down, post
  495.     and the lower right hand side of the first edit screen.
  496.  
  497.     It was not looking for the KEY in the correct directory. Fixed.
  498.  
  499. 1/29/94??
  500.  
  501.     Huh? What happened? Does anyone read this? If so, post a message on
  502.     Terripan that you read this and actually have a pulse.
  503.  
  504. 1/6/94
  505.  
  506.     Releaseed 2.40 (oops) also fucked up a bunch of the protection. Looks like
  507.     a 2.5 is due out soon.
  508.  
  509. 2/20/94
  510.  
  511.     Looks like TP 7.0 doesn't like dates before 1979. It adds 128 to the year
  512.     and saves it, if the year is 1979 or earlier. I did a quick fix, just
  513.     subtract 128 if the year is greater than 2000. Now then, this will fuck
  514.     things up at the year 2000.
  515.  
  516. 3/5/94
  517.  
  518.     Added Viewing of user infoforms quickly. The error messages are crude,
  519.     but it gets the job done. Press Alt-F1 For help on how to do it.
  520.  
  521. 3/14/94
  522.  
  523.     Added the scan conference toggle to screen #4
  524.  
  525.  
  526. 3/22/94
  527.  
  528.     Added the ansi/celerity color code view unit to viewing infoforms. Its
  529.     alot faster now
  530.  
  531. 4/2/94
  532.  
  533.     The area access flags were useless in screen #3. They should have been
  534.     replaced by User Access flags about a year ago. I didn't even notice
  535.     they were still area acess flags till I went to set-up special security
  536.     on some bases. good testing guys.
  537.  
  538.     Viewing a user's note file was putting double lines out.
  539.  
  540.  
  541. 2.6
  542.  
  543.   4/4/94
  544.  
  545.     Been working on the ansi/cel stuff
  546.  
  547.   4/17/94
  548.  
  549.     Been doing a bunch of minor shit to this to reduce it in size and increase
  550.     the speed, both stand alone and in CMT.
  551.