Beijing Paradise BBS Backup

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

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

Wrap

Text File | 1993-08-18 | 24.9 KB | 544 lines

┌═══════════════════════════════════════════════════════╤══════════════════┐ │ Modern Technology - BBSList (v1.1 /Standard) │ ■ 08-18-93 │ └═══════════════════════════════════════════════════════╧══════════════════┘ BBSList for PCBoard 15.0 with Search & Find Text Options, Sort Listings using your favorite Sorting utils, and more! MT-BBSList /Standard Copyright (c) 1993. Modern Technology MT-BBSList /Deluxe Copyright (c) 1993. Modern Technology PCBoard 15.0 Copyright 1993 Clark Development Co. All Rights Reserved Worldwide. Modern Technology - PO BOX 6531, Providence RI 02940 Data Lines: (401)-333-3451 [HAYS96] (401)-333-1638 [HST168] - MT-BBSList is Shareware but NO FEE IS REQUIRED TO REGISTER!!! There are no fees associated with using this product! HOWEVER you must still REGISTER / indicate that you are using this product. REGISTERING will get you many benefits, including; you will be placed on our mailing list / BBSList Listing of Registered users and more. <see registration form for more info> ┌══════════════════════════════════════════════════════════════════════════┐ │ MT-BBSList /Deluxe Features at a glance │ └══════════════════════════════════════════════════════════════════════════┘ - BBSList /Standard version is 100 percent functional with no hidden commands / features. There are no expiration dates, nor is this product crippled in any way! - Add new entries to Current Listing. - VIEW existing entries (BBSListing) - SEARCH existing listing entries for specific matches (Similar to the PCBoard Zippy commands> - BBSListing is automatically SORTED after each entry and can be done using your favorite Dos Sort util with whatever options you specifiy! <Like Qsort could be used to sort this listing> - Automatic BLOCK-OUT of duplicate entries which have the same phone number. In other words BBSList allows only one Entry per each phone number in the list and no more! * - Display OTHER BBSLists to View/Search <if provided by the sysop> Such as adding the USBBS Listing etc, so callers may do View or Search right from within BBSList. - Command interpretation <Just like PCBoard> BBSList allows all commands to be abbreviated, therefore <S> <SE> <SEA> <SEARCH> etc... are all valid commands to invoke each feature command! - Full Menu, Help, Info, and News display-files which can be modified at will for fit your needs. - Program is adaptable such as the Name of BBSList, Colors displayed to callers and enable/disable of some features is supported in this version. For complete listing of detailed config options See the BBSList.CNF file for more details. - Logs all activity to the CALLERS log * /Deluxe version only ┌══════════════════════════════════════════════════════════════════════════┐ │ What is BBSList /Deluxe │ └══════════════════════════════════════════════════════════════════════════┘ What is the Deluxe Version? The /Deluxe version of MT-BBSList is the very same product and behaves very much like the /Standard version. However there are many additional features, which are not available in the standard version of this software. The /Deluxe version besides being more elegant and complexed it also adds capability to allow callers to choose amoung multiple BBS Listings to View or Search for entries/text. A good example would be to use the BBSList not only to compile a listing of entries which New sysops and other users will enter in the database but also let callers View/Search for say the USBBS List,the Official PCBoard BBS Listing or the RIME Node list etc... The maximum capacity of lists which can be added to VIEW/SEARCH in the /Deluxe version may not Exceed 99 different listings, but the sysop merely needs to use whatever the amount needed. Other BBS Lists are simple to add! Simply enter in the Config file the Path and Name of file and BBSList [OTHER] Lists feature will automatically adapt to display them to the caller <if enabled by the sysop> If you would like a version of the /Deluxe version one can be obtained from us <See below for more info> ┌══════════════════════════════════════════════════════════════════════════┐ │ Obtaining BBSList /Deluxe │ └══════════════════════════════════════════════════════════════════════════┘ * To obtain a copy of MT-BBSList Deluxe you must Register! * * MT-BBSList Registration Form * Fill the form below <or include similar info on a 3x5, a letter or postcard> You may use the Comment Lines to let us know what you would like to be added to the BBSList in the future, or whatever comments or questions you may have <>++++++++++++++ Cut below this line, Fill Out and Mail ++++++++++++++++<> Fill out and US Mail to: Modern Technology PO Box 6531 Providence RI 02940-6531 Access Lines: (401)-333-3451 [HAYES 96] * (401)-333-1638 [HST 168] Your Name: ________________________ Voice Phone: ________________________ Your Address: ______________________________________________________________ BBS Name: ________________________ BBS Number: ________________________ BBS Address: ______________________________________________________________ CPU Type: ________________________ Modem Type: ________________________ Occupation: ________________________ Interests: ________________________ How Long have you been a sysop: ________________________ Do you program: ___ If so in what languages: ______________________________ Features you would like to see added to BBSList: ___________________________ Comments 1: ______________________________________________________________ Comments 2: ______________________________________________________________ Comments 3: ______________________________________________________________ Comments 4: ______________________________________________________________ Would you like a DELUXE version of MT-BBSList: ___ (Yes/No) <see below> Would you like us to upload to you the latest /Deluxe version __ (Yes/No) <>++++++++++++++ Cut above this line, Fill Out and Mail ++++++++++++++++<> <Yes/No Detailed Explanation> (No) - No problem... You are now a registered user! Remember = THERE are NO FEES required of continued use of this product. There are no hidden or expiration features in this version of MT-BBSList /Standard. This version is fully functional and is NO way crippled. (Yes) - If yes, then a copy of the latest DELUXE version of MT-BBSList can be either downloaded from our system or one may be uploaded to your system! Please include along a donation for $5.00 US Dollars to cover our processing fees. Please make Checks or Money orders Payable to: Modern Technology and mail along with your registration to the same address. ALSO NOTE that future development of this product will be only the the /Deluxe version. ┌══════════════════════════════════════════════════════════════════════════┐ │ BBSList Installation │ └══════════════════════════════════════════════════════════════════════════┘ ALL THE STEPS LISTED IN THIS DOCUMENT REGARDING INSTALLATION ASSUME YOU HAVE A COPY OF PCBOARD V15.0 (OR ABOVE) ALREADY CONFIGURED AND RUNNING! Unzip the contents of MT-BBS10.ZIP into it's own directory. Suggested path is -> DRIVE:\PCB\PPE\BBSLIST but you can place it anywhere you you would like, just as long as the correct path and PPE names are assigned within PCBoard <Next Step> Adding this program to PCBoard is simple. Load PCBsetup and choose option [B] File Locations Once in this PCBsetup Submenu choose (once again) option [B] Configuration files. Scroll down until you see -> Name/Loc of Default CMD.LST File : D:\PCB\MAIN\CMD.LST Now use the F2 key to edit the CMD.LST file "NOTE that the location shown above is the default as supplied by PCBoard" Your location might be different you might also have individual CMD.LST files for different conferences, the above is assuming you have a standard PCBoard v15.0 setup. <next step> <more> Next will see a screen resembling the one below, just choose a name/command that you would like your callers to access the BBSList from within PCBoard. (Recommended choices are BBSLIST) but you may name it whatever you want, just be sure that the path pointing to the BBSLIST.PPE file is correct <after all PCBoard must find the PPE file in order to execute it!> File Locations Command Security PPE/MNU File -or- Keystroke Replacement ══════════════ ════════ ═══════════════════════════════════════ 1) BBSLIST 0 D:\PCB\PPE\BBSLIST\BBSLIST.PPE That's about it, if you added the above then Matrix should now be ready to run as a PCBoard command by your callers of course you should add it to your main menu so callers will see it as an option. <see note below> <note> You may also wish to create a MORE features Sub-menu <use the Submenu features of PCBoard v15.0 In this MORE Sub-Menu you could make available all the PPE programs you have installed <After ALL placing ALL PPE cmds and files in your main menu can get confusing!>. You then just instruct your callers where to look to find / run all the PPE files you may have recently installed on your system. Oh some other recommendations to place in your MORE features menu would be BBSLIST [PPE], ONELINERS [PPE] a QUOTE [PPE], a LOTTERY [PPE], etc.. ┌══════════════════════════════════════════════════════════════════════════┐ │ Configuration Files Notes │ └══════════════════════════════════════════════════════════════════════════┘ !!! IMPORTANT !!! BBSLIST.CNF contain all configuration options and They must exist in the current path for this program to run properly. * Features included with this package are sysop configurable! * REFER to the Files BBSLIST.CNF for more information. A copy of this file is included here for reference as well. ┌══════════════════════════════════════════════════════════════════════════┐ │ BBSLIST.CNF (Configuration File) │ └══════════════════════════════════════════════════════════════════════════┘ Modern Technology BBSlist BBSLIST.DAT D:\PCB\PPL\BBSLIST\QSORT.EXE /L @X0A @X08(@X0F@TIMELEFT@ @X07min left@X08) @X01-> @X09BBSList @X0FCommand@X07? @X09Enter Text to @X09[@X0FSearch@X09] @X09for? (H), (Enter)=none? @X07Press [@X0EEnter@X07] to continue 1 ------------------------------------------------------------------------------- Line 1: Name of BBS List (BBSName + BBSList) Line 2: FileName which holds the BBS List Entries (Whatever you wish) Line 3: Path & Name of Util to Sort List with Line 4: Color of Feature Titles (Any Valid PCBoard Color Code) Line 5: BBSList Main Prompt (Whatever you wish Line 6: BBSList SEARCH list for matches (text search) prompt Line 7: BBSList "Press [Enter] to continue" prompt Line 8: Show (Loading BBSList) when door is loaded 0=No, 1=Yes ------------------------------------------------------------------------------- * BBSLIST.CNF --- NOTE! THIS FILE MUST EXIST * * ALL configuration lines must be properly filled in for the door to work! * DETAILED DESCRIPTION OF BBSLIST.CNF CONFIGURATION ITEMS (LINES) Line 1: Whatever you wish to call your BBS List! Recommended names are; your BBS Name followed by the words BBSList. This will allow you to personalize this door for your system. Line 2: FileName you wish to use to store the BBS entries. This is the file which callers will be allowed to add their NEW entries into. Please note that you may edit the file with any Text Editor. The listing {for convinience purposes} is kept in a standard ASCII / TEXT file! Line 3: Path and Filename of util & Paramaters which BBSList will use to sort the listing. (Qsort recommended for this feature). If you do not make Qsort available then the listing will not be Sorted after each new entry! Line 4: Each feature inside the BBSList has a Title. IE --> if a caller uses the ADD command to ADD a NEW entry, BBSList correctly displays to the caller what part of the door they are currently in, you may wish to personalize these titles even more by changing the color code here. Any valid PCBoard color code is fine. NOTE! (FYI) you may have each feature CLEAR the screen as well, if you wish to do this in this field simply enter a; @cls@ followed by a valid PCBoard color code! For example; @CLS@@X0E would clear the screen and properly display the current feature title to the caller in the color which is selected right after the CLS code. Line 5: BBSList Main Prompt (Whatever you wish). Recommended is something simple but meaninfull, the default provided with this door is; (TimeLeft min Left) -> BBSList Command? ******NOTE****** That you have to add a question mark (?) at the end of this prompt in the CNF file!!!! This is of course if you wish to use a question mark. It is recommended that you do provide it at the end of the prompt however some sysops prefer to use some other character to signal end of the prompt and therefore this option of not / or using a question mark at the end of the prompt is included here for that reason alone. Line 6: BBSList SEARCH list for matches (text search) prompt Line 7: BBSList "Press [Enter] to continue" prompt message. Note that a '?' is automatically appended to the end of this prompt by PCBoard. Line 8: Show (Loading BBSList) when door is loaded 0=No, 1=Yes When a caller selects to run the BBSlist from within PCBoard you can instruct the caller by having BBSlist display a message similar to this; "Loading BBSList . . ." However you may also disable this by entering a Zero in this Configuration option line. ┌══════════════════════════════════════════════════════════════════════════┐ │ File included with this archive! │ └══════════════════════════════════════════════════════════════════════════┘ ADD 211 08-18-93 - Displayed to callers when using the ADD cmd HELP 1692 08-18-93 - Displayed to callers when using HELP cmds HLPFIND 1446 08-18-93 - Displayed to callers (Help during SEARCH cmd) MENU 762 08-18-93 - BBSList main Menu NEWS 614 08-18-93 - BBSList News file SEARCH 253 08-18-93 - Displayed to callers when using the SEARCH cmd VIEW 253 08-18-93 - Displayed to callers when using the VIEW cmd WELCOME 1258 08-18-93 - Displayed to callers upon loading of door BBSLIST.CNF 3673 08-18-93 - Configuration file BBSLIST.DAT 891 08-18-93 - BBSList Data file (where entries are stored) BBSLIST.DOC 24563 08-18-93 - BBSList Docs -> [This File] BBSLIST.PPE 10866 08-18-93 - BBSList Executable PPE main file. HISTORY.DOC 87 08-18-93 - BBSList History file FILE_ID.DIZ 230 08-18-93 - BBS Description file ------------------------------------------------------------------- QSORT.DOC 88075 08-18-93 - Qsort v4.11 Docs QSORT.EXE 17941 08-18-93 - Qsort v4.11 Exe (used to sort BBSList) Total: 16 file(s) Qsort is what BBSList relies on to sort bbs listing entries. Any valid Qsort paramaters may be passed along as well. See BBSList Configuration file (BBSLIST.CNF) for more details. For more info on Qsort then consult the Qsort Docs. These two files must be included as it is specifically requested ty the author in his docs files <that if Qsort is distributed with any other non-comercial utils> then both QSORT.EXE and QSORT.DOC must be included. See the Qsort.DOC file for more info on Qsort. *NOTE* that you can use any sorting program you wish! For more info see BBSList.CNF file for proper configuration entry if you wish to use some other program to sort the bbs listings. --------------------> !!!!!!!!!!! NOTE !!!!!!!!!!! <--------------------- THERE IS ONE MORE FILE WHICH CAN BE USED BY THIS VERSION OF BBSLIST (BUT IS NOT INCLUDED / OR LISTED ABOVE) The file is: HEADER (for MONO) or HEADERG (for ANSI) / HEADERR (for RIP), if this file exists in the BBSList path then the internal Header displayed to callers at the top of every BBS listing display will be replaced by whatever you put in this file. This is included here in case you choose to make your own HEADER screen. If BBSList finds your HEADER file it will use it instead. --------------------------------------------------------------------------- The 16 files listed above should be the only ones in this archive. Any other files you find within the archive MT-BBS10.ZIP have been placed there by various bbs Sysops that still don't realize that inside-Zip-comments will do more damage then good to their boards! --------------------------------------------------------------------------- ┌══════════════════════════════════════════════════════════════════════════┐ │ Sample HELP file: HELP (for MONO) / HELPG (for ANSI) / HELPR (for RIP) │ └══════════════════════════════════════════════════════════════════════════┘ * BBS List Help with Commands * * NOTE! ALL Features may be activated by using the * * first letter(s) of each command! * MT-BBSList will allow you to ADD new entries to the appropriate Listing! BBS Lists are chosen by the sysop. If more then one listing is available then you will be prompted when using the View command on which list you would like to view. You may also wish to use the Search features to scan for text within the available listings. Subcommands: (ADD) (VIEW) (SEARCH) (OTHER) (HELP) (NEWS) (MENU) (RE)LIST (INITIAL) (QUIT) (GOODBYE) (A)dd Entry to existing BBS Listing (V)iew Current BBS entries (S)earch List for Text * (O)ther View/Search Other Lists (if enabled by the sysop) (H)elp With BBSList cmds -> [This File] (N)ews BBSList-NEWS (M)enu (Relist) BBSList-MENU (R)elist BBSList-MENU {same as M)enu} (I)nitial BBSList Welcome Scrn. (Q)uit to PCBoard (G)oodbye [Logoff system] (BYE) [Quick Logoff System] Also NOTE! That when adding a new entry to the BBSList you should be as accurate as possible. The list will allow you to enter some basic information about your system <or some other bbs you might wish to post>. Thanks... Remember! (Just like PCBoard) BBSList allows commands to be abbreviated! Example; <V> <VI> <VIE> or <VIEW> are ALL valid BBSList commands. * Available in /Deluxe version only. ┌══════════════════════════════════════════════════════════════════════════┐ │ Sample ADD file: ADD (for MONO) / ADDG (for ANSI) / ADDR (for RIP) │ └══════════════════════════════════════════════════════════════════════════┘ Please NOTE: BBSList entries should entered as accurate as possible! BBS Entries may be listed once only... Or one Phone Number per entry! * Information provided in each field IS CaSe SenSiTivE! * ┌══════════════════════════════════════════════════════════════════════════┐ │ Sample SEARCH HELP File for the Search features (HLPFIND) filename │ └══════════════════════════════════════════════════════════════════════════┘ BBSList SEARCH for Text Feature - Help -------------------------------------- Subcommands: (ENTER) (Q) (H) (ENTER) <carriage return> Hitting Enter Alone quits Search (Q) Same as above <Quits to BBSList Main Menu. (H) Help with BBSList Commands -> [This File] Description: This command is a generic BBS List Text Search! You may use it to cross-reference any information. You may also use it to extract specific info from the listing. An example is if you wish to see only Systems within a certain area code, then you would specify the appropriate info to the BBSList Search prompt. When doing searches you should keep in mind that the listing is kept free-form as much as possible for convinience purposes... Therefore if you were looking for a "MODEM TYPE" and used "HST" as the keyword, then ALL entries which have HST as modem type would be displayed. HOWEVER if the entry was posted differently then your keyword might not work <or skip over a system> a good example is for say a BBS system which has post their modem type as USR! If USR had been used instead of HST then <of course> searches for HST would not work. ┌══════════════════════════════════════════════════════════════════════════┐ │ Sample NEWS file │ └══════════════════════════════════════════════════════════════════════════┘ Thanks for checking this News/Info file @FIRST@! Please report any bugs or problems to the Sysop of this system. If you need to contact the authors directly you may call our Data Lines at: 401-333-1638 [HST168] / 401-333-3451 [HAYS96] You may write to us as well: Modern Technology PO Box 6531 Providence RI 02940 Also Please NOTE! When adding a new entry to the BBSList you should be as accurate as possible... The list will allow you to enter some basic information about your system <or some other bbs you might wish to post> ┌══════════════════════════════════════════════════════════════════════════┐ │ Sample VIEW file │ └══════════════════════════════════════════════════════════════════════════┘ NOTE: This is the listing to which NEW entries are recorded to! Any other BBS Listings <If available> are provided for viewing/searching purposes only! You may also use the (S)earch commmands to extract specific matches from any of the Listings! ┌══════════════════════════════════════════════════════════════════════════┐ │ DISCLAIMER │ └══════════════════════════════════════════════════════════════════════════┘ In no event will I "or anyone else" be liable to you for any damages, including any lost profits, lost savings or other incidental or consequential damages arising out of your use or inability to use this program, or for any claim by any other party. ┌══════════════════════════════════════════════════════════════════════════┐ │ Thank You Notes! │ └══════════════════════════════════════════════════════════════════════════┘ A big THANK YOU goes out to: - CDC for creating the BEST BBS software around today! As without it this BBSList PPE would not exist. - To ALL the Sysops which have spend endless hours and big money on making their systems available for our enjoyment! Same goes for shareware programers. History ------- 08-02-93 (v1.0) /Standard - Initial coding and release. 08-18-93 (v1.1) /Standard - Fixed the Text Search routine features, it works much faster now! - Various cosmetic fixes, including and typos in the msgs displayed to callers. - Compiled with the latest version of the PCBoard PPL compiler - The BYE BBSList feature/command was simply hanging up on the caller changed so now it works just like the PCBoard BYE command. - Several other minor improvements and fixes. <eof>