Beijing Paradise BBS Backup

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

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

Wrap

Text File | 1993-10-22 | 61KB | 1,195 lines

┌─────╖ ┌──────╖ ┌───╖ ┌─╖ ┌──────╖ ┌──────╖(R) │ ╓─┐ ║ │ ╓──┐ ║ │ ╙╖ │ ║ └┐ ╓─┐ ║ │ ╓──┐ ║ │ ╙─┘ ║ │ ╙──┘ ║ │ ╟┐ ╙╖│ ║ │ ║ │ ║ │ ╙──┘ ║ │ ╓───╜ │ ╓──┐ ║ │ ║└┐ ╙┤ ║ │ ║ │ ║ │ ╓──┐ ║ │ ║ │ ║ │ ║ │ ║ └┐ ║ ┌┘ ╙─┘ ║ │ ║ │ ║ └─╜ └─╜ └─╜ └─╜ └───╜ └──────╜ └─╜ └─╜ ┌──────╖ ┌──────╖ ┌─────╖ └┐ ╓─┐ ║ └┐ ╓─┐ ║ │ ╓───╜ │ ╙─┘ ║ │ ╙─┘ ║ │ ╙───╖ │ ╓─┐ ║ │ ╓─┐ ║ └───┐ ║ ┌┘ ╙─┘ ║ ┌┘ ╙─┘ ║ ┌───┘ ║ └──────╜ └──────╜ └─────╜ ┌─╖ ┌───╖ ┌─────╖ ┌─────╖ ┌─────╖ ┌──────╖ │ ║ └┐ ╓╜ │ ╓───╜ └─┐ ╓─╜ │ ╓───╜ │ ╓──┐ ║ │ ║ │ ║ │ ╙───╖ │ ║ │ ╙─╖ │ ╙──┘ ║ │ ║ │ ║ └───┐ ║ │ ║ │ ╓─╜ │ ╓─┐ ╓╜ │ ╙──╖ ┌┘ ╙╖ ┌───┘ ║ │ ║ │ ╙───╖ │ ║ │ ╙╖ └────╜ └───╜ └─────╜ └─╜ └─────╜ └─╜ └──╜ PBBSList ─ Online BBS Listing Door CopyRight (C) 1993 Bing Wu All Rights Reserve PBBSList.exe Compiled with BC++ V3.1 and OD 4.20ß5 Other utilities compiled with TC V2.02 October 22, 1993 ┌──────────────────────────────────────────────────────────────────┐ │▓▓ Table Of Contents ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓ Page II ▓▓│ └──────────────────────────────────────────────────────────────────┘ Chapter 1 - Introduction............................................ Features......................................................01 OverView & System Requirements................................01 Credits.......................................................02 Files In Distribution Pack....................................02 Licensing Information.........................................03 How to register...............................................04 Product Support...............................................04 Installation..................................................05 Chapter 2 - Configuration...─[ PBLSETUP.EXE ]─...................... THE FILE MENU................................................... Info......................................................06 Credits...................................................06 Exit......................................................06 THE SYSTEM MENU............................................... Paths.....................................................06 Site Info.................................................07 THE OPTIONS MENU................................................ System....................................................07 Colours...................................................09 Paging....................................................09 Visiting Sysop............................................09 THE MANAGER MENU................................................ Protocol..................................................10 Compression...............................................10 System Limits.............................................10 Verify Setup..............................................11 External Support Files.......................................... Language Files............................................13 Text Files................................................13 Control Files (CTL).......................................14 External Protocol Batch File..............................14 Examples........................................................ Single Line...............................................15 Multi Line................................................15 Command Line Parameters...................................16 ErrorLevels...............................................16 Chapter 3 - Exnternal Record Editor...─[ PBLEDIT.EXE ]─...........17 Chapter 4 - External Maintanence Utility...─[ PBBSLREN.EXE ]─.....19 Chapter 5 - Inter BBS PBBSList.BBS Sharing...─[ PBBSLNET.EXE ]─...19 Chapter 6 - Language File Compiler...─[ PBBSLVER.EXE ]─...........20 Chapter 7 - Record Verifier...─[ PBBSLVER.EXE ]─..................20 Chapter 8 - Additional Information.................................. Contact Author............................................21 Other Programs............................................21 Beta Testers Needed.......................................21 ┌──────────────────────────────────────────────────────────────────┐ │▓▓ Features ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓ Page 1 ▓▓ │ └──────────────────────────────────────────────────────────────────┘ ─ Search through BBS list database via key─string ─ Briefly List the entries (summarized) ─ View the detail information of the BBS - Delete/Undelete an entry (#) ─ Download a list of BBSs ─ System Operator Paging ─ Configuration file supported BUT not required ─ Most BBS system compatiable ─ Data carrier monitor ─ Local status bar (can be disabled) ─ External Maintenance programs ─ Record Modification (#) ─ Custom Logon Screen ─ U.S. and free phone formats ─ Multi─Language Support ─ Go back and forth between pages while view the records ─ Three different ways to specify where the data files are located ─ Inter─BBS Sharing PBBSList.BBS option ─ Create difference file (*.MOD) if change has been made = User Define Protocol drivers and compression utilities = Auto Record Verifier Utility with configuration = External Control files and Text files = Full Screen Local Record Editor = Full Screen Menu Driven Setup = User BBS Screen Upload = Cosysop Access level = Auto Give Visiting Sysop Access to the sysop of verified record = DataBase string in two different mthods = Export database entries to text files (#) Sysop and the person who entered that record only = New options added in this version ┌──────────────────────────────────────────────────────────────────┐ │▓▓ OverView & System Requirements ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓│ └──────────────────────────────────────────────────────────────────┘ From the Features Listed above you can see that this program has all the features of a regular Online BBS Lister door but with much much more. Features marked with (+) or + is registered only feature. To run this program online on your BBS, you need to run either one of the following BBS systems or one of the compatiable systems. ■ RemoteAccess 1.xx & 2.xx ■ WildCat ■ QuickBBS ■ ProBoard ■ SpitFire ■ RBBS─PC ■ Telegard ■ WWIV ■ Any Software supports either one of above system's exit file This Program fully supports and has been tested under DV, Windows, DOS. ┌──────────────────────────────────────────────────────────────────┐ │▓▓ Credits ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓ Page 2 ▓▓│ └──────────────────────────────────────────────────────────────────┘ * Thanks Mike McGrane and all other beta testers for testing this program and give valuable feedbacks. * Thanks to my parents for keeping up with me. :─) * Thanks to Jeff Mesch for helping me with SISNet and Scouting Online Info Base so I can find time to write those programs * Thanks to all SISNet system operators for keeping up with SISNet and never quit to make it better. * Thanks for those who registered PBBSList. * NO THANKS for those who have used the unregistered version for more than 21 (Twenty─One) days. * All Mentioned products in this manual are copyrighted/registered by its respective owner(s). * Special thanks to Eric Spaeth for his suggestion towards improving PBBSList. ┌──────────────────────────────────────────────────────────────────┐ │▓▓ Files In The Package ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓│ └──────────────────────────────────────────────────────────────────┘ ─────[ PBBSList and associated files ]───── PBBSList.EXE The main program PBBSList.A?? Screen to be displayed to your user when then enter the door ─────[ PBBSList text files ]───── PBBSList.DOC This file PBBSList.HIS Developement Notes/History Registra.REG Program registration form for all Panda programs Betatest.APP Application for Beta testing for PBBSLIST ─────[ Others ]───── PBBSLNet.EXE Inter─BBS PBBSLIST.BBS file sharing utility PBBSLVer.EXE Auto BBS Verifier PBBSLCMP.EXE PBBSList language file compiler PBBSLRen.EXE PBBSList maintenance program ENGLISH .LNG English version of the PBBSLIST language file SAMPLE .ZIP Sample System text and control files ─────[ Included in Samples.??? ]───── PBBSList.TOP ASCII file to be add to the top of the BBS listing file PBBSList.BOT ASCII file to be append to the bottom of the BBS listing file PBBSList.DAT ASCII file to be added to the download file PBLPHONE.LOC A List of phone number that is local to you ─────[ Auto Created ]───── PBBSList.BBS DataBase file PBBSList.CFG Configuration file for PBBSList (TEXT) PBLSETUP.CFG Configuration file for PBBSList (BINARY) PBLMODEM.CFG Configuration file for PBBSLVer ┌──────────────────────────────────────────────────────────────────┐ │▓▓▓ Licensing Information ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓ Page 3 ▓▓│ └──────────────────────────────────────────────────────────────────┘ PBBSList refers to all executables and text files contained in the PBBSList archives released by Bing Wu (author) of Panda BBS! 1. PBBSList is the copyrighted material of Bing Wu. It may only be used in accordance with the Licensing Conditions. 2. You may use PBBSList for period of three weeks on a trial basis in order to determine its suitability for your system. After this period, you MUST register each PBBSList you run concurrently on different computers under different BBS Names. Multi─Line BBS sharing same system files ONLY needed to register one copy. 3. Commerial Sites (School, business, organization, or any site that conduct commerical activities) must register this program first before it can be used. 4. Registration entitles you to use PBBSList and any future version of it without any future registration. 5. The Products are provided AS IS. Neither the author nor any BBS operator distributing this software is responsible for any damage incurred during the operation of the program. 6. The Author (Bing Wu) can discountinue support and development of PBBSList without notice and at anytime. 7. You may not modify or otherwise reverse─engineer PBBSList. 8. You may not use PBBSList in any unlawful and/or illegal manner. 9. You are welcome to distribut PBBSList as long as you don't charge more than $5 for it, modify the program in anyway, or delete and/or files from the original distribution archives. 10. A Registered Version of PBBSList MAY/MUST not be distributed with or without Author's Permission. ┌──────────────────────────────────────────────────────────────────┐ │▓▓ Registration & Support ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓ Page 4 ▓▓│ └──────────────────────────────────────────────────────────────────┘ -=[ Registration ]=- This program is distributed as shareware. You are grant 21 days (three weeks) trail period, after that you must either send in $15.00 registration fee or discontinue use it. Also Commercial sites MUST register this program first before it can be used. Otherwise legal action may be brought against you since this program is CopyRighted. However, SISNet (Staying In Scouting Network) System operators can freely use this program without registration while with SISNet (a registration key will be sent to all SISNet operators freely upon request). The $15 registration fee grant you to use to all future versions of this program without additional registration fee. Your registration will be either send to you via crash netmail or conventional mail at no extra charge within CANADA and USA. $5 charge applies for order outside USA and CANADA. See REGISTRA.REG for more registration information. -=[ Support ]=- Echo Areas: FidoNet: RA_UTIL, SYSOP SISNet: SIS_COMPUTER, SIS_SYSOP Support/Distribution Site: Bing Wu (World Wide) Data: 1-612-378-7783 (19,200ZYX) Voice/FAX: 1-612-378-0885 SISNet: 74:74/0 FidoNet: 1:282/1016 InterNet: bing@tdkt.kksys.com Distribution/Beta sites: ■ Freq or DL the latest version of PBBSList with magic name PBL from any of the following sites: Chris Desio Curtiss Denson 1-612-872-4736 (14,400) 1-915-821-0661 (14,400) FidoNet: 1:282/4032 FidoNet: 1:381/84 Mike McGrane Todd A. Lyon 1-612-537-0449 (14,400) 1-318-582-3150 (14,400) FidoNet: 1:282/1024 FidoNet: 1:3807/4 SISNet: 74:7612/0 RANet: 72:318/0 ■ Following Sites support Download ONLY Robert Quackenbush Harold Lindrud 1-612-529-7716 (14,400) 1-612-771-5121 (14,400) ┌──────────────────────────────────────────────────────────────────┐ │▓▓ Upgrade from V1.42.x ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓ Page 5 ▓▓│ └──────────────────────────────────────────────────────────────────┘ If you are upgrading PBBSList from a previous version of PBBSList, you need to run "PBBSLREN upgrade" (w/o ") before you are able to run the main program or any other utility programs. This will convert the old data file format to the new format used by PBBSList. Also since the content of the language file has been modified, you need to modify the language file as well. Compare the old and new ENGLISH.LNG in both package for difference. ┌──────────────────────────────────────────────────────────────────┐ │▓▓ Installation ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓│ └──────────────────────────────────────────────────────────────────┘ The setup is easy and simple, it takes about 5 minutes in average time to do it. The program can be run under ANY BBS software, such as RemoteAccess, WildCat, QuickBBS, etc., This program DOES support the new version of RA (V2.01). This version of PBBSList takes advantage of the environment variable, it will function much smoother with the SET environment but it's not required. It is simply used to make PBBSList and its utilitis to be able to locate the correct data files. In case neither the SET environment is set nor a directory is specified with command line parameter, current directory where the program is loaded will be used. To use the PBBSList evironment variable, simply add following line to your autoexec.bat or the batch file you call the RA or the PBBSList SET PBBSL=[Directory] Also begin this version, a full screen menu driven setup program is included. ┌──────────────────────────────────────────────────────────────────┐ │▓▓ ■■ CONFIGURATION - PBLSETUP.EXE ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓ Page 6 ▓▓│ └──────────────────────────────────────────────────────────────────┘ PBLSETUP is the full screen setup utility for both PBBSList and PBBSLVer. Since you have already setup a BBS, I assume you have basic knowledge on how the full screen, selectable menu works. Therefore no explanation how to use it will be given in this manual. ONLY description of each choice is listed below. -= The File Menu =- There is nothing needs to be modified in this menu. Here is some information regarding about PBBSList. Info ──────────────────────────────────────────────────────────────── Here is little information about PBBSList Credits ──────────────────────────────────────────────────────────────── The Credits given by the author Exit ──────────────────────────────────────────────────────────────── Choose this option when you wish to exit the setup program. press [ESC] will also allow you to exit the program. -=THE SYSTEM MENU =- ┌──────────────────────────────────────────────────────────────────┐ │▓▓ Paths Define ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓│ └──────────────────────────────────────────────────────────────────┘ The paths shown on your screen are those which you have specified during the system configuration. Those paths specify where all PBBSList and its related files are located. PBLSetup will not check for existence of a path, so make sure you have entered a valid path. BBS Ads Scr ─────────────────────────────────────────────────────────────────── This path specify where PBBSList should locate the screens to be displayed to the user if the user chose to view a record that has a screen specified in that record. Also, this path specify where uploaded screens should be stored.If this path is left blank, PBBSList path will be used. PBBSList ─────────────────────────────────────────────────────────────────── This is the directory where PBBSList will find all its files. It is suggested to have a separate directory for the PBBSList but it's not required. (Command Line parameter and/or PBBSL environment paramter will overwrite the path specified here) Swapping ─────────────────────────────────────────────────────────────────── The Path where PBBSList should swap to in case there is not enough XMS/EMS memory available. Blank entry will disable the swapping feature of PBBSList. Log File ─────────────────────────────────────────────────────────────────── This field specifies the full path and name of the PBBSList log file. The full path is optional. If no path was specified, PBBSList directory will be used. ┌──────────────────────────────────────────────────────────────────┐ │▓▓ Site Information ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓ Page 7 ▓▓│ └──────────────────────────────────────────────────────────────────┘ This is where you define various information about your system such as system name, sysop's name, and system's phone number. System Name ─────────────────────────────────────────────────────────────────── What is the name of your system (BBS) System Operator's Name ─────────────────────────────────────────────────────────────────── What is the name of the Sysop. The Name must match the one specified in the system exit file to ensure that the key will function correctly. System Phone Number ─────────────────────────────────────────────────────────────────── Input your System Primary phone number here. You may use any format you want. -= THE OPTION MENU =- ┌──────────────────────────────────────────────────────────────────┐ │▓▓ System Setup ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓│ └──────────────────────────────────────────────────────────────────┘ The System Options contain basic information used by PBBSList to determine availability of some the features. Most of the option below can be overwrite with the command line options. Read <<Command Line Options>> for details. Allow Add ([Y]es/[N]o) ─────────────────────────────────────────────────────────────────── Specify whether or not the user is allowed to ADD new entries to the database. If you are involved in a PBBSList.BBS sharing network and you are not one of the modify sites, then disable this function to ensure the database in the network is the same among the member sites. Allow Del ([Y]es/[N]o) ─────────────────────────────────────────────────────────────────── Specify whether or not the user is allowed to DELETE entries from the Dbase. If you are involved in a PBBSList.BBS sharing network and you are not one of the modify sites, then disable this function to ensure the database in the network is the same among the member sites. Allow Edit ([Y]es/[N]o) ─────────────────────────────────────────────────────────────────── Specify whether or not the user is allowed to EDIT entries from the database. If you are involved in a PBBSList.BBS sharing network and you are not one of the modify sites, then disable this function to ensure the database in the network is the same among the member sites. Allow Format ([F]ree/[U]sa/[A]sk) ─────────────────────────────────────────────────────────────────── Here you specify which phone format to use. Free No restrict on which phone format to use USA Use US phone format xxx─xxx─xxxx ASK Ask the user to choose which phone format ┌──────────────────────────────────────────────────────────────────┐ │▓▓ System Setup Continues ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓ Page 8 ▓▓│ └──────────────────────────────────────────────────────────────────┘ Allow DL ([Y]es/[N]o) ─────────────────────────────────────────────────────────────────── This Option tells PBBSList whether or not to allow the user to download the BBS list in text format. Allow Compress ([Y]es/[N]o) ─────────────────────────────────────────────────────────────────── This Option tells PBBSList whether or not to allow the user to Compress the BBS list before download it. This will surely cut the downloading time if a long BBS list is going to be downloaded. Create Mod File ([Y]es/[N]o) ─────────────────────────────────────────────────────────────────── Specify whether or not PBBSList should produce a MOD file if a record was added or modified. Specify YES to this option if and only if you are invloved in a PBBSList.BBS sharing network, and is one of the modify sites. Check Who ([Y]es/[N]o) ─────────────────────────────────────────────────────────────────── PBBSList will check for valid information before allow a user to delete or modify an entry if this option is set to YES, otherwise all users will have access to modify/delete any record of their choice. If set to YES, only the person who entered the record, the person whose name match the sysop's name of the record, or the sysop of this BBS will be allowed to make changes. Visiting Sysop ([Y]es/[N]o) ─────────────────────────────────────────────────────────────────── Turn this option ON (YES) if your BBS offers special access to sysop from another BBS. If this option is set to YES, the menu command "Visiting Access" is turned on. Allow Screen ([Y]es/[N]o) ─────────────────────────────────────────────────────────────────── Specify is your user allowed to upload the ANS/ASC screen(s) of his/her BBS to be displayed when a user choose to view the information of his/her BBS. (The Screen takes up alot of space, use this option with CAUTION) Allow Logoff ([Y]es/[N]o) ─────────────────────────────────────────────────────────────────── Should your user allowed to logoff directly from PBBSList without have to return to the BBS? Sysop Access ─────────────────────────────────────────────────────────────────── Users with which access level (or above) should have SYSOP access to PBBSList. ┌──────────────────────────────────────────────────────────────────┐ │▓▓ Colours ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓ Page 9 ▓▓│ └──────────────────────────────────────────────────────────────────┘ Here you specify which color to use for the user and the sysop while they are chatting within the PBBSList Door. Chatting User ─────────────────────────────────────────────────────────────────── This tells PBBSList what color to be used for the user while in chatting session within the PBBSList. Valid colors are displayed in the window on the right hand side. Chatting Sysop ──────────────────────────────────────────────────────────────────── This tells PBBSList what color to use for the SYSOP while in chatting session within the PBBSList. Valid colors are displayed in the window on the right hand side. ┌──────────────────────────────────────────────────────────────────┐ │▓▓ Paging ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓ Page 5 ▓▓│ └──────────────────────────────────────────────────────────────────┘ In this setup, you will set the options of online paging while in PBBSList. The information used here is used by PBBSList to control the paging function of PBBSList, as well as setup a paging schedule. Paging Duration ─────────────────────────────────────────────────────────────────── This sets the duration ( in seconds ) that pagng tune should sound at the local console. Begin Time & Ening Time ─────────────────────────────────────────────────────────────────── Between what period of time a user is allowed to page you for a chat. If you don't have paging hour for a particular day, enter same time in both "Begin Time" and "Ending Time" to disable paging for that day. (You must enter ":" yourself) ┌──────────────────────────────────────────────────────────────────┐ │▓▓ Visiting Sysop ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓│ └──────────────────────────────────────────────────────────────────┘ This setup is available if and only if you have specified in the system setup that your BBS gives special access to sysops from another BBS. Security Level ─────────────────────────────────────────────────────────────────── What security level should a visiting sysop have if the entry he/she entered is verified as valid. Security Flag (NOT USED IN V1.50) ─────────────────────────────────────────────────────────────────── This option will available only to those system with support to flags. -= This Option is not available in this release =- -= THE MANAGER MENU =- ┌──────────────────────────────────────────────────────────────────┐ │▓▓ Protocols ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓ Page 10 ▓▓│ └──────────────────────────────────────────────────────────────────┘ Begin this version of PBBSList, the user is allowed to define the protocol and protocol driver of his/her own by specifying and creating a batch file to be called by PBBSList. You may specify up to 7 protocols available for your user to use if he/she decided to download a list of BBSes. The PBBSList comes with defaults of Z─MODEM, X─MODEM, and Y─MODEM. Name ─────────────────────────────────────────────────────────────────── The Name of the protocol. This will be displayed to the user for her/him to choose if the protocol is marked as AVAILABLE. Batch File Name ─────────────────────────────────────────────────────────────────── Here is the file name which PBBSList should execute if the use chose to use that particular protocol. See the Z─MODEM.BAT/X─MODEM.BAT/ Y─MODEM.BAT inside the sample.??? for batch file example. Availability ([Y]es/[N]o) ─────────────────────────────────────────────────────────────────── Here you specify whether or not the defined protocl is available for user to use. ┌──────────────────────────────────────────────────────────────────┐ │▓▓ Compression ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓│ └──────────────────────────────────────────────────────────────────┘ Here you define the command line should be used if the user choose a compression utility to compress the BBS list before actually download it. A total of 7 compression utility's commandline can be defined. ONLY those with a commandline parameters will be displayed to user to choose. Name ─────────────────────────────────────────────────────────────────── This Column listed ths compression utility can be used, it will be displayed to the user. Command Line ─────────────────────────────────────────────────────────────────── What the command line PBBSList should use if the user chose that particular compression utility. ┌──────────────────────────────────────────────────────────────────┐ │▓▓ Restrictions ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓│ └──────────────────────────────────────────────────────────────────┘ Here you set two restrictions on the usage of PBBSList Time Allowed in Door ─────────────────────────────────────────────────────────────────── What is the MAXIMUM time a user is allowed in PBBSList in minutes Inactivity Timeout ─────────────────────────────────────────────────────────────────── The Timeout field determine how long to wait during persiod of inactivity before log the user off bu hanging the modem. User will be give a WARNING before he/she is logged off. ┌──────────────────────────────────────────────────────────────────┐ │▓▓ Verifier ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓ Page 11 ▓▓│ └──────────────────────────────────────────────────────────────────┘ Here you define the setup for PBBSLVer.EXE. A utility used to verify the records in the database according to the configuration here. file PBLMODEM.CFG is produced. In Un-Registered Version ONLY the options NOT marked with (+) will be saved. Port ─────────────────────────────────────────────────────────────────── The COM port where your modem is connected to. PBBSLVer supports COM 1 to COM 4. Speed ─────────────────────────────────────────────────────────────────── The Maximum speed your modem supports. (Speeds supported: 300, 1200, 2400, 9600, 19200, 38400, 57600) (+) Verify every ? days ─────────────────────────────────────────────────────────────────── If this option is set to 0, then PBBSLVer will only verify those new and unverified records when it is executed. A value greater than 0 tells the PBBSLVer to verify those records every how may days (The Number of days you specified). (+) Verify all ([Yes]/[N]o) ─────────────────────────────────────────────────────────────────── Should PBBSLVer verify all record in the database. If this option is set to YES, both long distance and local BBSes will be called. (USE with CAUTION) (+) Busy as verify ([Yes]/[N]o) ─────────────────────────────────────────────────────────────────── This tells PBBSLVer how it should treat BUSY signal received from the modem. If this option is set to YES, then whenever BUSY signal is received from the modem, that record is updated as a verified record. (USE this option with CAUTION) (+) Mark LD as verified ─────────────────────────────────────────────────────────────────── If the option "Verify all" is set to NO, should PBBSLVer update the records with long distance phone number as a verified record. (+) Mark "Down" after ? days ─────────────────────────────────────────────────────────────────── A non 0 value here tells PBBSLVer after how many days of unseccessful try should have a record marked as DOWN. (+) Mark "DEL" after ? days ─────────────────────────────────────────────────────────────────── A non zero value here tells PBBSLVer to mark a BBS as DELETE after how many days of unseccessful verify attempts. ┌──────────────────────────────────────────────────────────────────┐ │▓▓ Verifier Continues ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓ Page 12 ▓▓│ └──────────────────────────────────────────────────────────────────┘ (+) Tries/Day ─────────────────────────────────────────────────────────────────── How many time should PBBSList try to verify the record on one execution. Initial String ─────────────────────────────────────────────────────────────────── Entry the Initial String PBBSLVer should use to initilize your MODEM. There is no need to add either "|M" or "^M" at end of the string, PBBSLVer will automatically add one. example: ATZX7&V1&X4 (Don't use this, it is just an example) Dailing Prefix1 ─────────────────────────────────────────────────────────────────── What is command PBBSLVer should use to dail a phone number. examples: ATDT, ATPT, ATDT*70, ATDT*70,9 (+) Dailing Prefix2 ─────────────────────────────────────────────────────────────────── What should be added to a long distance number if option "Verify All" is set to YES Dailing Suffix ──────────────────────────────────────────────────────────────────── What string should be send to the modem after a number has been dailed. No need to add "|" at end of string. -= External Support Files =- ┌──────────────────────────────────────────────────────────────────┐ │▓▓ Language Files ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓ Page 13 ▓▓│ └──────────────────────────────────────────────────────────────────┘ The Language file used by PBBSList is PBBSLL???.LNG. Where the ??? represents the language number that will be passed by the BBS system when it executes the door. See <<Run PBBSLCMP.EXE>> for more information. Those text files are used by PBBSList. Some are displayed to the user, others are attached to a certain file. ADDONLY.A?? ────────────────────────────────────────────────────────────────── This file will be displayed to the user if PBBSList is running in ADD ONLY mode. NOPAGE.A?? ────────────────────────────────────────────────────────────────── This file will be displayed to the user if he/she tries to page the sysop for a chat while in PBBSList door if his/her name was found in the control file NOPAGE.CTL. NOTALLOW.A?? ────────────────────────────────────────────────────────────────── This file will be displayed to the user if he/she tries to enter the PBBSList door and his/her name was found in the control file NOTALLOW.CTL. He/she will be returned to the board after this file is displayed. PBBSLIST.A?? ────────────────────────────────────────────────────────────────── This file will be displayed to the user when he/she enters the Door. Default screen is a Panda Software introdution screen, you may make changes to the file to suit your need. PBBSLIST.DAT ────────────────────────────────────────────────────────────────── This file will attached to the text file containing the BBS list which will be download by the user. You can have whatever you want in here. ┌──────────────────────────────────────────────────────────────────┐ │▓▓ Control Files ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓ Page 14 ▓▓│ └──────────────────────────────────────────────────────────────────┘ Those Control files are used by PBBSList to determine some functions. NON of the following is required to execute PBBSList. Use them as you need them. You ONLY list one item per line in the control files. BADNAME.CTL ────────────────────────────────────────────────────────────────── This file should contain the BBS names you don't want to have in your database. PBBSList will check the names in this file to determine whether or not to allow the user to complete the new record. BADPHONE.CTL ────────────────────────────────────────────────────────────────── Has same function as BADNAME.CTL except this file contains bad phone numbers. Examples: 911 411 NOTALLOW.CTL ────────────────────────────────────────────────────────────────── When a user enters the door, PBBSList will scan the user's name with the enteies here, if found, a message or the file NOTALLOW.A?? will be displayed to the user and the user will be returned to the board. NOADD.CTL ────────────────────────────────────────────────────────────────── This file will be scanned when a user wish to add a new entry to the Dbase. If his/her name is found in this file, a message telling him/her the base if full. NOPAGE.CTL ────────────────────────────────────────────────────────────────── This file will be scanned when a user pages the sysop for a chat inside the paging period. If his/her name is found, a fake paging will be made and a message stating ths sysop is not available or the file NOPAGE.A?? will be displayed to the user. ┌──────────────────────────────────────────────────────────────────┐ │▓▓ External Protocl Batch File ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓│ └──────────────────────────────────────────────────────────────────┘ Batch file is very important in BBS List downloading function. When a user chose to download a list, PBBSList will call up the predefined batch which will then call up the external protocol. PBBSList will pass three parameters when calling tha batch file: %1 The Port Number %2 The File Name %3 Sending/Receiving Indicator 1 Receive from the user 2 Send to the user ┌──────────────────────────────────────────────────────────────────┐ │▓▓ Setup Examples ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓ Page 15 ▓▓│ └──────────────────────────────────────────────────────────────────┘ -= Set Envrionment Variable =- in your autoexec.bat file add following parameter SET PBBSL=D:\BBS\DOOR\BBSLIST ────────────────── │__ Directory where the PBBSLIST files are located -= Setup without Environment Varaibale =- <── W/O Batch File ── D:\BBS\DOORS\TROOP\PBBSLIST.EXE *M *N >────── Batch File ───── d: cd \ra\doors\list pbbslist cd \ra\line1 exit -= Setup with Environment Varaibale =- In this case no batch file is need, but you can always use a batch file. <── Without a bacth file, call directly from the Type 7 menu option C:\BBS\DOOR\PBBSLIST\PBBSLIST.EXE /Sc:\BBS\LINE*N <── With a bacth file C:\BBS\DOOR\PBBSLIST\PBBSLIST.EXE /SC:\BBS\LINE1 -=[ Setup with Multi─Node systems ]=- <── With a batch file ── On the Type 7 option line ── C:\BBS\DOOR\PBBSLIST\PBBSLIST.EXE *N ─── │__ The node # ── In the Batch file ── C:\BBS\DOOR\PBBSLIST\PBBSLIST.EXE /SC:\BBS\LINE%1 <── Without a batch file ── On the Type 7 option line ── C:\BBS\DOOR\PBBSLIST\PBBSLIST.EXE /SC:\RA\LINE*N ──────────── ── Directory Name ___│ │__ Parameter passed Node 1 would be C:\RA\LINE1 to which node is on ┌──────────────────────────────────────────────────────────────────┐ │▓▓ Command Line Parameters ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓ Page 16 ▓▓│ └──────────────────────────────────────────────────────────────────┘ [ Options ] [ Description of the Option ] /S[path] Path to the BBS System files (EXITINFO.BBS, DORINFO?.DEF etc.) /D[path] Path to the directory where PBBSList and its files are located ─NOADD Disable the "add record" option in the program ─NODEL Disable the "Delete Option" & "Undelete Option" in the program ─NOEDIT Disallow the user to modify an record in the DBase ─NOMOD Tell the program not to produce a *.MOD file, it's used if you are not involved in a PBBSLIST.BBS Sharing group ─NODN Disable the download feature of PBBSList ─NOCOMP Disable the compression feature in the D/L rocedure ─NOCHECK Disable the Security check when a user wish to modify or delete a record ─USA Force US style phone format xxx─xxx─xxxx ─FREE Force Free style phone format ─NOSCR Disable the ANS/ASC screen feature ─ADDONLY Only execute the record adding feature ┌──────────────────────────────────────────────────────────────────┐ │▓▓ ErrorLevels ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓│ └──────────────────────────────────────────────────────────────────┘ PBBSList will exit with one of the following errorlevels: 0 ─ Critical Door error (no fossil, etc.) 1 ─ Carrier lost, user off─line 2 ─ Sysop terminated call, user off─line 3 ─ User time used up, user STILL ON─LINE 4 ─ Keyboard inactivity timeout, user off─line 5 ─ Sysop dropped user back to BBS, user ON─LINE 10 ─ User chose to return to BBS 11 ─ User chose to logoff, user off─line 12 ─ Critical PBBSList error ┌──────────────────────────────────────────────────────────────────┐ │▓▓ PBLEedit <─────> Full Screen Record Editor ▓▓▓▓▓▓▓▓▓ Page 17 ▓▓│ └──────────────────────────────────────────────────────────────────┘ This is a full screen selectable record editor. When the program was executed, it will read in records from the database file PBBSList.BBS and display the Record (BBS) name as the selectable menu items. To edit a record, simply move the cursor to highlight the record, and press return. The last choice is used to creat a new record. However, the newly created record will not show up on the menu after you have saved the record and back to the selection menu. (It will show up on the select menu after you re─load the program). While in ther editor, you may use the UP and DOWN arrow keys to select the field you wish to edit. The field the cursor is on will be highlighted. Press [ESC] key once while in the editor will exit you back to the selection menu. Un-Registered Version will save NEITHER the modified NOR the newly created record(s). BBS Name ────────────────────────────────────────────────────────────────── Here enter the name of the BBS. (Will not check for duplication) Private BBS ([Y]es/[N]o) ────────────────────────────────────────────────────────────────── Specify if this a private BBS. (Private BBS allowes no NEW users, all users must be pre─approved). Set to NO will allow PBBSList to display this BBS as a Public BBS. Pay BBS ([Y]es/[N]o) ────────────────────────────────────────────────────────────────── Is the user need to pay some kind of fee to use this BBS? (fee means charge or $1 or more, DONATION not included) Multi─Line BBS ([Y]es/[N]o) ────────────────────────────────────────────────────────────────── Is this BBS operating on More than one lines? (Local Node doesn't count, REMOTE access nodes only) BBS Phone ────────────────────────────────────────────────────────────────── Phone number of the current BBS. (all formats supported, MUST include area code) BBS Speed ────────────────────────────────────────────────────────────────── The Maximum speed supported by this BBS. (Integers and Characters Allowed) BBS Hours ────────────────────────────────────────────────────────────────── What hours of the week is this BBS in service. example: 24 hours ─ ZMH (This specifies the BBS is running 24 hours a day, however the user can only access this BBS when it is not in Zone Mail Hour(s)) ┌──────────────────────────────────────────────────────────────────┐ │▓▓ PBLEdit Continues ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓ Page 18 ▓▓│ └──────────────────────────────────────────────────────────────────┘ BBS Location ─ City ────────────────────────────────────────────────────────────────── In which city or town is this BBS located at. BBS Location ─ State/Province ────────────────────────────────────────────────────────────────── In which state or province is this BBS located at. BBS Location ─ Zip Code ────────────────────────────────────────────────────────────────── What is the zip code of where the BBS is located. (This is used to help user find the BBS near him/her quickly) Network Name & Address ────────────────────────────────────────────────────────────────── If this BBS belongs to a network, here is where he/she specify which network they belong to and the address associated to that network. (QWK Mail nodes should use QWK as the node address) BBS Status ────────────────────────────────────────────────────────────────── What is the status of this BBS? [N]ew If a new record is added, this should be the status of the record. Run PBBSLVER.EXE to verify this record automatically. [V]erified Specify whether or not this BBS is up and running correctly [D]eleted If a record has been deleted or not in service anymore, this is marked do[W]n If a record has been down (Not accept phone calls), this should be marked Entered By ────────────────────────────────────────────────────────────────── Name appending this is the name of the person who enter ths record to the database. This name CANNOT be changed. BBS Screen ([Y]es/[N]o) ────────────────────────────────────────────────────────────────── Specify if there ANS/ASC screen(s) associated with this record. If this is set to YES and the system allows BBS Screens, the file named in the BBS Scr name is displayed to the user when he/she selects to view the record. BBS Scr Name (8 characters, no extension) ────────────────────────────────────────────────────────────────── Here you enter the upto eight characters of the file name which contains the screen for this BBS. PBBSList will automatically append the correct extension to the filename according to the user's setup. ┌──────────────────────────────────────────────────────────────────┐ │▓▓ Run PBBSLRen <──> PBBSList Maintanence Program ▓▓▓▓▓ Page 19 ▓▓│ └──────────────────────────────────────────────────────────────────┘ This program is the maintanence program for PBBSList. It is used to pack, sort, export and renumber the database file. ■ Usage: PBBSLREN [command] <options> [commands] PACK ── Delete invalid record and renumbering RENUMBER ── Renumber records in the entry SORT <Option> ── Sort The DataBase (+) EXPORT <Option> [@FILENAME] ── Output PBBSLIST in several format upgrade ── Convert Data file format <option> ■ ─NAME ── Sort By BBS Name (DEFAULT) ■ ─TELE ── Sort By BBS Phone Number <Options> ■ ─ALP ── Alphabetically Sorted List (ASCII) ■ ─SFT ── BBS Software Sorted List (ASCII) ■ ─TEL ── BBS Phone Number Sorted List (ASCII) This program will use the path specified in the PBBSL environment or use the current directory. Other than this has to be cleared, everything else is pretty straight forward. You may creat custom designed TOP (PBBSLIST.TOP) and BOTTOM (PBBSLIST.BOT) file to be inserted into the BBS Listing file to be created by PBBSLRen. This file should be in ASCII. If any of those two files is not found, the built─in default of the file is used by PBBSList. You may have anything you want in either of those two files. [EXAMPLES enclosed] ┌──────────────────────────────────────────────────────────────────┐ │▓▓ Run PBBSLNet <────> PBBSList database sharing utility ▓▓▓▓▓▓▓▓▓│ └──────────────────────────────────────────────────────────────────┘ This utility program is new for Version 1.50. This program was and is designed to make the sysop's life easier when invloved in a PBBSLIST database sharing group. This program has the option to convert multiple *.MOD files to a single one and import multiple *.MOD to your database. (it will not import a file w/o valid file specification in the file) ■ Usage: PBBSLNET [Command] [options] [commands] ■ IMPORT [options] ── Import *.MOD file(s) to DBase ■ CONVERT [Options] ── Convert multiple *.MOD files to one [options] ■ ─S[directory] ─CONVERT ── Path to the to be converted *.MOD files ─IMPORT ── Path to the to be imported *.MOD files ■ ─NOUPD ── No Update records ■ ─NODEL ── No record deletion All directories are defaulted to current directory where the PBBSLNET is loaded if there is no PBBSL Environment found nor there is Path specified. ┌──────────────────────────────────────────────────────────────────┐ │▓▓ Run PBBSLCMP <────────> Language Compiler ▓▓▓▓▓▓▓▓▓▓ Page 20 ▓▓│ └──────────────────────────────────────────────────────────────────┘ This program will compile the plain text language file to a file that can be read by PBBSLIST. Instruction on how to modify the language file: [1] Copy the default ENGLISH.LNG file to any file name you want [2] Modify the file you just copied to suit your needs [3] Compile the text file with PBBSLCMP. Example: If you have a language "French" specified as 1 in the BBS, then you would run PBBSLCMP French.lng 1 ────────── ─ │ │__ What is the language │ code used in BBS └── Import filename This will produce a language file called PBBSLL1.LNG. ┌──────────────────────────────────────────────────────────────────┐ │▓▓ Run PBBSLVer <────────> Auto BBS Verifier ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓│ └──────────────────────────────────────────────────────────────────┘ This program will help reduce your job loads by auto calling the BBSes listed in your database and verify them according to the setup. This setup of this program can be configured to use the PBLSETUP.EXE which comes with this pack. Read "Configuration" for more information. In order to run this file correctly, you must have a file called PBLPHONE.LOC in the directory where PBBSLver can locate it. This file contains the local calling area's phone numbers and how PBBSLVer should handle that call. Example: 612-378- 378- 612-379- 379- ┌──────────────────────────────────────────────────────────────────┐ │▓▓ Contact Author ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓ Page 21 ▓▓│ └──────────────────────────────────────────────────────────────────┘ Bing Wu (author) can be reached via: Snail Mail: Bing Wu 604 Ontario Street SE Minneapolis, MN 55414─3118 Telephone: (612)378─0885 BBS: Panda BBS! @ (612)378─7783 @ 19,200 ZYXEL+ NetMail: bing@tdkt.kksys.com of InterNet bing wu@1:282/1016 of FidoNet bing wu@74:74/0 of SISNet bing wu@16:612/28 of SIMNet ┌──────────────────────────────────────────────────────────────────┐ │▓▓ Other Programs ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓│ └──────────────────────────────────────────────────────────────────┘ Online Programs ──────────────── BBSTROOP ──Ver 1.30── Online Scouting Troop Listing ($15 reg.) BBSMBCON ──Ver 1.20── Online Scouting MB Counselor list ($15 reg.) PBBSVOTE ──Ver 1.10── Online BBS Voting Door ($10 reg.) PBBSLIST ──Ver 1.52── Online BBS Listing Door ($15 reg.) Utilities ───────── CONVERT ────N/A──── Converts MCV.LOC ver 1.10 to MCV.LOC ver1.11 CFDATE ──Ver 1.00── Comp two files' date, find which one is newer ┌──────────────────────────────────────────────────────────────────┐ │▓▓ Beta Tester Needed ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓│ └──────────────────────────────────────────────────────────────────┘ The author is currently seeking beta testers to test his programs, including all Door programs listed above and all upcoming programs. If you are intereted in becoming a beta tester, fill out the application BETATEST.APP and specify the name of the program you wish to test or indicate you wish to test all programs. (Pre-registration of the program MAY be required)