Beijing Paradise BBS Backup

home *** CD-ROM | disk | FTP | other *** search

/ Beijing Paradise BBS Backup / PARADISE.ISO / software / BBSDOORW / UEDIT55.ZIP / UEDIT.DOC < prev next >

Wrap

Text File | 1993-03-20 | 20.1 KB | 516 lines

=============================================================================== Virtual BBS External User Editor Version 5.5 By Scott 51@4121 VirtualNET =============================================================================== This is the seventh official release version of the VBBS EXTERNAL USER EDITOR. The main file UEDIT.EXE must be run within the VBBS main Directory or whichever directory contains the configuration files. The files needed by this program are SYSPATHS.CFG and USERFILE.DAT. Your suggestions are welcomed and encouraged. Please contact me at 51@4121 VirtulNET with any suggestions or bug reports. This program uses pulldown menus and supports a Microsoft Mouse. It is recomended to use the mouse for the best navigation of the editor. Liability: =============================================================================== Well here goes.... If this program should cause you to have a bad day it is not my responsibility. This program is distributed "as is". It has been tested on several systems without incident. =============================================================================== Beta Testers. version 1.10: I would like to take a moment to thank the following people for their help in getting the bugs ironed out of the early versions.... Silver Surfer 2@4123, Renegade 1@4121, and Beep 1@4120...... Thanks for the help guys!!! version 3.11: Once again, Thanks to Renegade 1@4121 for the help and suggestions on version 3.11! version 4.0: Need I say it again? Ok..... Thanks Renegade. version 5.0: Renegade Once again!! version 5.5: No one.... =============================================================================== The Menus...... To manuver the menus is simple. Just put the mouse pointer on your selection and click the left button to select it. If you are not using the mouse just hit the "Alt" key and then the highlited letter may be pressed to select an option or you may move the "highlight bar" with the arrow keys and then press enter on your selection. You may also use the "Short-cut" keys F1 for View/Edit User F2 for List Users Etc.... This program is fairly self explanitory so you shouldn't have many problems getting around. Menu Choices.... +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ ___________ | | | User Edit | |___________| View/Edit User: This is just what is sounds like. Once this option is selected you will be prompted for a user number or name. The number will take you directly to that account and the name will search each record for a match in either the "Handle Field" or the "Real Name Field". The Search string may be partial or complete, you will be prompted for each matching name found by the program. Once you have a user record on the screen your cursor will be positioned on the cancel button. The best way to move around the screen is with the TAB key. Shift+TAB moves backwards. Most of what is seen on this screen is self explanitory. Just move to the item you want to change and then type in the new value which you want to give it. Some items will pop up a window and you will edit the item in the window. For example the Forward Mailbox Window will pop up whenever you TAB past the item on the main screen. On the Forward mail screen you can fill in each of the fields if you want the users mail to be forwarded. NOTE: You must have the Mailbox Forwarded marker X'd at the bottom of this window in order for the box to actually be forwarded. There are some additional windows that are activated by pressing one of the buttons at the bottom of the screen. In these windows you will find such items as the Extra Fields and the Activities (Posts, Emails, U/L's, and D/L's). You can also call a user at his/her voice phone number by pushing the CALL button on the bottom right side of the main edit window. I would like to thank Silly Boy #1 @5035 VirtualNET for this idea! The first time the dialer is run you will need to tell it which Com Port your modem is on and whether to dial Tone or Pulse. NOTE: If you have shelled to UEDIT while the user is ONLINE.... **DO NOT** use this because obviously the user will be hung up on, unless you have more than one modem. To change the com port you can now go into the 'Options' Menu and select 'Com Select' and then choose the comport that your system uses. NOTE: Some of the fields are not accessable with the mouse such as the flags. You must go to the Password field and then hit TAB or Enter to get there. There are a few other key combinations that may be used in the main editor as well. Search Up and Search Down: A newly added feature in UEDIT version 3.11 is the search feature. This feature is very usefull for finding users' who have certian things in common with their accounts. First you must go to the 'Options' menu and select 'Set Defaults' or modify them by hitting Alt-S. Once you set the defaults then the 'Page Up' and 'Page Down' keys will search through the user file until it finds a matching account to the default options. Then the account will be displayed. 'Page Up' searches forward through the accounts and 'Page Down' searches Backwards through the accounts. When using this option you must be on one of the buttons at the bottom of the main edit window. Left And Right Arrow Keys: The left and right arrow keys will go backward and forward one user number at a time. Atl-S: This from the editor will take you directly to the search defaults settings. Alt-D: This will delete the current user. Also deletes mail and oneliners. Alt-M: This will move a user. CAUTION when using this!! This can seriously *@#& up your user file!!! This option will take the current user and ask you for a new number to give this user. Once you answer, UEDIT will then move the current user to that location and the old account from that location will be moved to the current location. Also all email and oneliners will be changed to their new addresses. **NOTE: make sure that both users know about this change because they WILL NOT be able to log on by their old user number. This is because some users log on by number rather than by name. F1 Key: Brings up the Help menu. List Users: List users is just for seeing the users' handles that are in your user file. If you select one of those users and push the "Ok" button you will automaticaly be taken to the "View/Edit User" screen for that user. Specific Users: This is a new section for UEDIT 5.0. This will give you four choices to choose a search item from. Once you choose one, enter a search string (partial or complete) and then UEDIT will search for any users accounts that match that string. Once the matching accounts are found you will see them on a list. If you select one of these accounts you will be brought directly to the View/Edit screen for that account. Apon Exiting the View/Edit screen you will be brought back to the list. **NOTE: if you made any changes to the information shown in the list you will not see it change on the list. This is because the information is still loaded in memory from before the changes were made. If you want to update the list you must exit the list completely and then re-enter the search parameters. Multiple Changes: This option will change a given field on EVERY user in your userfile. If you only want to change a few then you must use the above option. Once you select this option you will first be warned by a warning screen that you have selected the mass changer then you will be asked weather or not you would like to make a backup copy of your userfile. If you answer yes to make a backup, UEDIT will make a backup in your data directory called USERFILE.BAK. This is a good Idea because if you really louse something up then you can easily rename the USERFILE.BAK to USERFILE.DAT and start over. At this point you will be presented with a list of options to change. If you decide not to use this just push the "Cancel" button or your escape key. If you want to edit an item just highlight that item then push the "Ok" button. Once you have done this then just enter the new value, and that value will be set in EVERY user account in your userfile. Global Color Change: This will reset all of the colors in every user account to those that are set in account #1. Simply adjust the colors in your account the way that you want all the others to be then run this option. Conditional Changer: This option will change only the accounts that match the criteria set in the 'Defaults' section. You may change any of the default settings before running this option without making the changes perminant. Once you have set up the Search Options then you must Either select 'Find and Verify' or 'Change All'. 'Find and Verify' will querry you before changing each user that matches the settings. 'Change All' will just make the changes. For more details on the 'Defaults' see the section on 'Set Defaults'. Quick Validate User: This option makes it realy nice to validate users. Here Only the security related items are shown for editing. Also the Case of the Handle, Name, And Address fields are automaticaly fixed. **NOTE: Any information left blank on this screen will go into the user record that way. So fill out all of the valid fields. The one exception is the 'Flags' field, this will add to what is already there. Exit: This option ends the editing session and returns you to DOS. +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ ___________ | | | Options | |___________| Color 1: This sets the screen color to Color 1 Color 2: This sets the screen color to Color 2 (May be suitable for some monochrome.) Monochrome: Monochrome screen mode Com Select: Sets up UEDIT to use your modem for the 'Call User' option. Search Defaults: This is where you will set the defaults for the Conditional Printer, the Conditional Changer, and the search up and down. The first field is for the default SL. once you enter a security level here now you need to tell UEDIT wether to look for SL's of an equal value, less than, or greater than the SL that you entered. The next set of fields are 'access flags' and 'flags' fields. The last field is changable from Time Bank, Credits, or Max time. Just put the 'X' in the apropriate box and then enter the value. There is also a field on this one for 'Equal to', 'less than', or 'greater than'. You may omit any of these fields you like. If a field is left blank it is ignored. You may also use as many simultaniously <SP?> as you like . But remember..... in order for the user to be found their account must match every field that you have an entry in. If the Ratio Exempt Only box is X'd then only those users who are ratio exempt will be counted. Otherwise all users are counted. +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ ____________ | | | User Print | |____________| Print All Users (Long): This option will print a detailed list of each users account. This list will contain much of the information shown in the view user screen or you can print a short version which will only print 4 lines for each user. Print All Users (Short): Similar to the Long list only prints a few fields. Print Mailing Labels: This option will print out mailing labels of every user in your userfile. To abort the printing once it has started just hit the escape key. Print Select Users: This is a new option for UEDIT 2.x. You will first need to create a text file called SELECT.LST, and in this file you will place the user number of each user that you want printed in the order you like. When entering user numbers be sure to only place one user number per line. UEDIT will print the users from the top of the list to the bottom in the order in which they appear in SELECT.LST. SELECT.LST must be placed in the same directory as UEDIT.EXE. This will print using the macro files. **NOTE** This feature is only available on Registered Copies! Conditional Print: This section is just like the conditional changer in that it uses the Default setting to determine which users to print. When you first make this selection you will be prompted as to which type of printout you want to make, Macro Print or a Detailed Listing. Once the printing begins you will be able to abort it by hitting the escape key. It may take a moment for the buffer on your printer to empty. **NOTE** This feature is only available on Registered Copies! Macro Print: Prints All users using one of the macro Files. ** See Macro Section. =============================================================================== U E D I T M a c r o P r i n t i n g ! =============================================================================== This is a brand new feature that I just added to UEDIT! And I think you will like this one! New in UEDIT 5.0 is a Macro set that can be incorperated into a formatted text file created by you to print virtualy any type of report. Each macro file is layed out in a special format. This first line is the Title to be printed on each new page. On line 2 there is simply just a number. This number is the total number of user accounts to be printed on one page before sending a form feed. After that lines 3 through 12 are used to lay out the printed form. On lines 3 through 12 are either Literals or Variables. A literal is just text as you would want it to appear on the paper. The variables range from user account items to Tabbing and Spacing commands. Below is the list of the variables used by UEDIT in the macro file. Each macro file MUST end in the ".MAC" extention in order for it to be used by UEDIT!! Commands \Sxxx Where xxx is the number of Spaces to add \Txxx Position the print head at column xxx. ** This will not go backwards, the number xxx must be greater than the current print head position. %HANDLE% Prints the Users Handle %NAME% Prints the Users Real Name %STREET% Prints the Users Street address %CITY% Prints the Users City %STATE% Prints the Users State %ZIP% Prints the Users Zipcode %PH1% Prints the Users Phone #1 (Voice) %PH2% Prints the Users Phone #2 (Data) %PASSWORD% Prints the Users Password %BIRTHDAY% Prints the Users Birthday (MM/DD/YYYY) %AGE% Prints the Users Age (xx Years Old.) %FLAGS% Prints the Users Flags %ACFLAGS% Prints the Users Access Flags %SL% Prints the Users Security Level %LASTON% Prints the Date the user was last on. (YYMMDD) %MAXTIME% Prints the Users Time alowed per day. %TOT% Prints the Users Total time on to date (mins.) %VIDEO% Prints the Users Videomode (ex. ASCII, ANSI etc..) %RATIO% Prints 'Yes' or 'No' depending on the users ratio exempt status. %VERIFY% Prints 'Yes' or 'No' for the Verify Birthday setting. %EX1% Prints the Extra variables in the users account. . . %EX8% %UPK% Prints the Users total U/L'd K. %UPF% Prints the Users number of Files U/L'd. %DNK% Prints the Users total D/L'd K. %DNF% Prints the Users number of Files D/L'd. %POSTS% Prints the number of posts written by user. %EMAILS% Prints the number of Emails written by user. %TIMEBANK% Prints the total time in the Users time bank. %CREDITS% Prints the users total credits. %COMMENT% Prints the User Comment. %CR% Carridge Return & LF %TAB% Tabs the print head to the next tab stop. That is the complete list of Macro commands for UEDIT 5.0. It does not matter to UEDIT if the commands are Upper or Lower case. There must be at least one space in between each command. Rules: If you use a litteral each space, tab, or group of spaces will be interpereted as 1 space! If you want additional spaces, use the \S command. Here is an example file for the Macro Printer. -------------------------------------------------------------------------- This is UEDIT 5.0's new Macro Print Feature! 7 %cr% %cr% \S25 This will print with every user. %cr% %cr% User Name: %name% %tab% Handle: %handle% %cr% Age: %AGE% %tab% Video Mode: %video% %tab% Ratio Exempt: %ratio% %CR% Security Level: %SL% %tab% Sex: %ex1% %tab% %tab% Ph: %ph1% %cr% -------------------------------------------------------------------------- Notice on line one: "This is UEDIT 5.0's new Macro Print Feature!" This line will be centered at the top of each new page. On line two you see the number 7. What this means is that 7 user accounts will be printed per page. The rest of the file is the macros and literals. For example on line 5: Age: %AGE% %tab% Video Mode: %video% %tab% Ratio Exempt: %ratio% %CR% | | | | | |__ Will move the print head to the next tab stop. | | | |__ Will be replaced with the users actual age. | |_____ Literal, will be printed exactly as it is. Also Note: Age: %AGE% %tab% Video Mode: %video% %tab% Ratio Exempt: %ratio% %CR% would be printed exactly the same as: Age: %AGE% %tab% Video Mode: %video% %tab% Ratio Exempt: %ratio% %CR% UEDIT will not do a Caridge Return until it encounters a %CR%. Also the extra spaces are ignored. 1 space is the same as 40 spaces.... The use of one space is however recomended. Experiment with these commands and see what you can come up with... There is a sample macro included with this archive. Use it and then compare the printout with the file and this will help you get a better understanding of the UEDIT macros. ================================================================================ Comments & Suggestions: Please Drop me an E-Mail at 51@4121 and let me know what you think..... Or call Final Approach at (412)-843-7147 14.4K Baud Modem.