Beijing Paradise BBS Backup

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

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

Wrap

Text File | 1993-03-12 | 61.5 KB | 1,355 lines

W o n d e r W h o ----------------- Version 1.00 Released March 12th, 1993 I Wonder Who Transfered That File ? Shareware program door for PCBoard v14.x Copyright (C) 1993 by José De Almeida. All Rights Reserved. P.O.Box 4185. 1504 Lisboa Codex. Portugal. --- OVERVIEW --- Thank you for giving a try to WonderWho door. I strongly hope this software pleases you to use, as it pleased me to develop. You won't regret your most valuable time giving it a try, I'm sure ! WonderWho is a PCBoard v14.x (or higher) door. There are two (that I know of) similar doors to WonderWho: ProWho and Origin. WonderWho is not an enhanced release of either those two first generation doors. It is a brand new second and latest generation concept for "I Wonder Who Transfered That File?" door. The concept stands for tranfers, not only limited to uploads or downloads. It provides 38 online rich menu commands. Users can search trough the Bulletin Board System transfer log file (usually named DOWNLOAD.TXT) using 30 different, specific and powerful commands. WonderWho provides different commands for uploaded, downloaded and both entries in a separated way (10 online commands for each case). Users can search for specific usernames, filenames, dates, protocols, average CPS, errors. For files transfered since a specific date. Raw searches (enhanced ProWho style). Verbose list of transfers, and count transfer entries. Output data is column formatted. Users can, in most search commands, specify up to 10 search patterns at the same time! It runs fast and it's extremely easy to use ! WonderWho implements enhanced statistics. After each search is performed, it displays to the user almost an entire screen of interesting statistics. Entries scanned, entries found, total uploaded and downloaded files, older and newer filedate and name, worst, best and average number of errors and CPS, etc, etc. That's what your users get. Now, about what you, SysOp, get. WonderWho its as easy to install as a door can be. It really have a "plug and play" configuration (as every door should be). The only thing you need to configure is the door batch file. One single line, two parameters. And that's all! WonderWho supports multi-node systems. Depending on the way you do things, you need just one door batch file in the server node. The same door batch file can work for all nodes. WonderWho supports multi-language for almost everything. It follows the PCBoard rules. Display files, such as Welcome, News, Main Menu, Quit, all Help files, etc. You can have one file for each language if you want. And if you don't, WonderWho will work fine with its default and original files. WonderWho supports multi-node configuration. In the configuration file you will find dozens of powerful options. You can specify filenames, individual security levels for each command, command names, etc, etc. You can specify global options or language specific options for all commands and things. But only if you want to. Furthermore, originally, all those options are disabled (I repeat: DISABLED) in the door and language configuration files! And WonderWho works 100% fine this way! But if you want, WonderWho permits you to configure almost anything you want in lots of different ways. Global configurations and language configurations mixed together. You simply ENABLE the options, and set them to what best suits you. Then you will get virtually full control of WonderWho. Nothing could be more simple than this. WonderWho also provides all the SysOp functions. You can test it locally (outside of PCBoard environment). You get built-in chat, DOS shell, and all the other conventional SysOp hot-keys. WonderWho is a fully functional Shareware program. Nothing is crippled. And more, more, more, more things, lots of things ! --- COPYRIGHT NOTICE --- WonderWho is Copyright (C) 1993 by José De Almeida. WonderWho, its accompanying documentation, and all other files that are part of the package, have been released as Shareware. It is NOT a public domain or freeware program. No part of WonderWho may be modified, altered, reverse engineered, sold, or distributed in any form which would involve some sort of trade without prior written permission from the Author. --- DISCLAIMER --- This program is provided "as is" without warranty of any kind. In addition, the Author specifically disclaims all warranties, expressed or implied, including but not limited to implied warranties of merchantability and fitness for a particular purpose and WonderWho license granted herein in particular, and without limiting operation of WonderWho gram license with respect to any particular application, use, or purpose. In no event shall the Author be liable for any loss of profit, lost savings, commercial damage, or other incidental or consequential damages arising out of the use or inability to use WonderWho even if the Author, José De Almeida, or an authorized distributor of WonderWho has been advised of the possibility of such damages, or for any claim by any other party. --- LICENSE --- SysOps are granted a limited license to use WonderWho, as a Shareware product. This gives you the chance to try WonderWho for a 30 day evaluation period. If you continue to use WonderWho beyond this period, you are required to register. Information on becoming a registered user of WonderWho can be found elsewhere in this file. All users are granted a limited license to copy WonderWho only for the purpose of allowing others to evaluate it, subject to the above restrictions as well as these: ■ WonderWho must be distributed in an unmodified form, including all the files listed in the documentation. Particularly, SysOps MUST keep inside the archive the original FILE_ID.DIZ description file, as it is distributed by the Author. This will give BBS users the correct and same good description for all BBS users over the world. ■ WonderWho may not be included with any other product for any reason whatsoever without prior written consent from José De Almeida. ■ No charge or payment may be accepted for WonderWho. Bulletin Board System Operators may post WonderWho on their BBS for downloading by their users without written permission, only if the above conditions are met, and only if no special fee is necessary to access WonderWho files (a general fee to access the BBS is acceptable). Distributors of Shareware and Public Domain software MUST obtain written permission from José De Almeida before distributing WonderWho and must follow the above conditions. Permission is almost always granted; this requirement is necessary to ensure protection for the Author and users of WonderWho from unscrupulous individuals. --- REGISTRATION / ORDERING --- Registering the WonderWho allows you to use the product after the trial period. A limited support is available to unregistered users. Most importantly, registered users know they are helping to make sure that high-quality Shareware like WonderWho continues to be offered at low cost. Here it is the registration prices and methods for WonderWho: ■ Registration, includes one 3.5" low density diskette (720 KBytes), containing a registered copy (latest release) of WonderWho, send by mail. Price: US $20 (or 3,000$00 if inside Portugal) Notes: This is the normal method. Will take a week or so. But, since SkyShip BBS, the wordwide support BBS for WonderWho, located in Lisbon, Portugal, is a member of the RIME Network, you can also receive, if you wish, your registration through the network as well. Just state what your RIME# is in the ORDER.FRM, and the SysOp of SkyShip BBS will send the registration to you as soon as the payment is received. It takes only a single day. ■ Registration, includes one 3.5" low density diskette (720 KBytes), containing a registered copy (latest release) of WonderWho, send by DHL express mail service. Price: US $80 (available for United States of America only) Notes: This is the express method. It will take 2 days or so. Payment may be only in the form of check. The register is valid for all future releases of WonderWho. Unfortunately, in Portugal we still are very limited in the use of credit cards, such as VISA. For the moment, it is not possible to accept VISA payments in any Bulletin Board Systems, like the SkyShip BBS where the program receives its worldwide support. So, in Portugal we cannot implement Credit Card doors to assist users in order to quickly pay Shareware programs. That is a pity, but this is how things are right now. Once registered, WonderWho no longer displays the '(unregistered)' message, and no longer delays for 15 seconds after a user quits the door. So, to place an order, you must print and fill an order form on the file ORDER.FRM. Please remember that, besides other things, you MUST specify the name to which door is registered. That is, the name WonderWho will display to the user when he/she quits the door or enter the [VER]sion command. This name is limited to 32 case-sensitive characters, and MUST be the EXACT name as is specifyed in PCBOARD.DAT line #94 (your board's name). Be careful about this, otherwise door will remain un-registered. --- CUSTOMER SUPPORT --- Full support to users of WonderWho is available through two major channels. If you wish contact the Author with questions, suggestions, problems, or other comments: ■ Call the WonderWho's worldwide support Bulletin Board System: SKYSHIP BBS ---------------------- SysOp : Mario Pozzetti Node #1: 351-1-3527623 * 24h USR HST Dual Standard V32Bis * 2400-16,800 Node #2: 351-1-3151435 * 24h USR HST Dual Standard V32Bis * 2400-14,400 Node #3: 351-1-3151436 * 24h USR HST V42Bis * 1200-14,400 Here I can be reached in the following conferences: (LOCAL): SUPPORT RIME : PCBSUPPORT PCBHINTS INTELEC: BBSDOORS ■ Call the Portugal co-support Bulletin Board System: THE IMAGE BANK BBS ------------------- SysOp: Jose Almeida Node #1: 351-1-7786640 * 20-24h (Tue & Thu 20-01:30h) Intel SatisFAXtion Modem /400e * 1200-14,400 P.O.Box 4185. 1504 Lisboa Codex. Portugal. Here I can be reached in the following conference: (LOCAL): WONDERWHO The Author offers limited support to unregistered users of WonderWho, in order to help them get WonderWho installed for evaluation. If you have a problem installing or using WonderWho, and you have read this entire documentation and HISTORY.DOC file (please do read it before requesting help; usually many problems can be cleared up by finding the answer in it), then feel free to request help through any of the channels mentioned above. The Author of WonderWho will make an attempt to answer all mail received, but please be aware that registered users have first priority for support. --- FILES INCLUDED --- The WonderWho is distributed in a archive ZIP file. Please do not change the archive contents or add any file. The archive name is WONDER10.ZIP, and contains the following files: ■ WONDER.EXE - Door program ■ WONDER.DOC - SysOp's manual (this file you are reading) ■ HISTORY.DOC - Version history ■ LICENSE.DOC - License agreement ■ ORDER.FRM - Order form (to register the door) ■ FILE_ID.DIZ - Description file for PCBoard systems (please do not delete or change this file; this file provides the Author's description of the archive) ■ WONDER - Sample PCBoard door script file. ■ WONDER.CFG - Door configuration file. ■ WW_LANG - Door language configuration file. ■ WW_TEST.BAT - Sample door local test batch file. ■ $DOOR.ERR - Sample door log error file. ■ WW_WELC - Default door Welcome file. ■ WW_NEWS - Default door News file. ■ WW_MENU - Default door Menu file. ■ WW_QUIT - Default door Quit file. ■ WW_H_AA - Default door help for command All: Average CPS. ■ WW_H_AC - Default door help for command All: Count. ■ WW_H_AD - Default door help for command All: Date. ■ WW_H_AE - Default door help for command All: Errors. ■ WW_H_AF - Default door help for command All: File. ■ WW_H_AP - Default door help for command All: Protocol. ■ WW_H_AR - Default door help for command All: Raw. ■ WW_H_AS - Default door help for command All: Since date. ■ WW_H_AU - Default door help for command All: Username. ■ WW_H_AV - Default door help for command All: Verbose. ■ WW_H_DA - Default door help for command Downloads: Average cps. ■ WW_H_DC - Default door help for command Downloads: Count. ■ WW_H_DD - Default door help for command Downloads: Date. ■ WW_H_DE - Default door help for command Downloads: Errors. ■ WW_H_DF - Default door help for command Downloads: File. ■ WW_H_DP - Default door help for command Downloads: Protocol. ■ WW_H_DR - Default door help for command Downloads: Raw. ■ WW_H_DS - Default door help for command Downloads: Since date. ■ WW_H_DU - Default door help for command Downloads: Username. ■ WW_H_DV - Default door help for command Downloads: Verbose. ■ WW_H_G - Default door help for command Goodbye. ■ WW_H_H - Default door help for command Help. ■ WW_H_M - Default door help for command Mode graphics. ■ WW_H_PRO - Default door help for command PROfile. ■ WW_H_Q - Default door help for command Quit. ■ WW_H_UA - Default door help for command Uploads: Average cps. ■ WW_H_UC - Default door help for command Uploads: Count. ■ WW_H_UD - Default door help for command Uploads: Date. ■ WW_H_UE - Default door help for command Uploads: Errors. ■ WW_H_UF - Default door help for command Uploads: File. ■ WW_H_UP - Default door help for command Uploads: Protocol. ■ WW_H_UR - Default door help for command Uploads: Raw. ■ WW_H_US - Default door help for command Uploads: Since date. ■ WW_H_UU - Default door help for command Uploads: Username. ■ WW_H_UV - Default door help for command Uploads: Verbose. ■ WW_H_VER - Default door help for command VERsion information. ■ WW_H_WHO - Default door help for command WHO is on?. ■ WW_H_X - Default door help for command eXpert mode. ■ TD_FILES.ZIP - Original default display files in TheDraw v4.51 format. Includes Welcome, News, Menu and Quit screen files, as well as all the Help files. --- VERSION HISTORY --- Please read the HISTORY.DOC file where all updates to the WonderWho door are described in detail. --- SYSTEM REQUIREMENTS & COMPATIBILITY --- WonderWho requires PCBoard version 14.x (as many nodes as you want) in order to work properly. Off course, I can't guarantee this current version of WonderWho runs on later versions of PCBoard other than 14.x, but it probably will. But, this is not an important matter, because if any changes of PCBoard are made in the upcoming future, WonderWho will follow those changes in future updates. Other requirements: ■ MS-DOS v3.3 or later ■ IBM AT 286 or higher WonderWho requires about 191 KBytes of RAM in order to work. --- INSTALLATION --- Installing WonderWho in you system is a very simple procedure. It probably takes less than 5 minutes, including tests. Install WonderWho as you usually install any other PCBoard door. But, let me describe all the installation procedures in short steps. Let me assume that your PCBoard home directory is C:\PCB. 1. Create a directory to put all the door files. For instance: C:\WONDER 2. Extract the WonderWho ZIP archive to a directory. All files. 3. Edit the WONDER. file. This is the PCBoard door batch file to run the door. An ASCII text file. Here you must specify the door path for the EXE program, the door path for its configuration file, and the PCboard directory. Here is an example of the batch file contents: @ECHO OFF C:\WONDER\WONDER.EXE C:\WONDER\WONDER.CFG %PCBDRIVE%%PCBDIR% ┌──────────────────┤ ┌──────────────────┤ ┌────┤ │ │ │ │ │ │ Location of Location of door Location of PCBoard door EXE program configuration file node directory (you (where all the rest may use those two of the door files PCBoard's environment should be located) sets, if you wish) NOTE: If, and only if, in PCSetup, you use the Shell to door option set to N, then you must add another line at the end of the file. You must call BOARD.BAT again in order to reload PCBoard. Like this: @ECHO OFF C:\WONDER\WONDER.EXE C:\WONDER\WONDER.CFG %PCBDRIVE%%PCBDIR% BOARD.BAT If you run a multinode system, it is possible to have just one door batch file shared by all nodes. Simply use, as you may see above, the following expression (only in PCBoard v14.5a or later): %PCBDRIVE%%PCBDIR% instead of specifying the PCBoard node directory as C:\PCB, for instance. But if you really specify C:\PCB instead od the environment sets, then you must have one door batch file for each node, which is not necessary at all. This really doesn't matter for WonderWho itself. Depends only on the way you have things done, and the way you like to do things. But I want you to do things right and easy. NOTE: WonderWho never, ever, changes the directory. So, you don't need, in the door batch file, to change the current directory from the PCboard node directory to the WonderWho directory, and then back before returning to PCBoard. 4. You do not need to edit or make any changes to the door configuration file WONDER.CFG or to the door language specific configuration file WW_LANG. Only option listed in line #1 of WONDER.CFG is working. All other options are (indeed) disabled, because they are the same as WonderWho defaults. It is plug and play, and everything should work 100% fine. So, you don't have to care about this for the moment, and leave both files unchanged. I will explain these files later in this file. 5. Run the PCboard's PCSetup program. You need to add the WonderWho door to the door list. Go to the Main Board Configuration screen, and edit the DOORS file. Here is an example: USER DOOR Filename Password Sec Login SYS SYS Shell Path to DOOR files ══════════ ══════════ ═══ ═════ ════ ════ ═════ ═══════════════════ 1) WONDER 10 N N N Y C:\WONDER WonderWho requires about 191 KBytes of RAM. So, you can run WonderWho using any of the Shell options PCBoard lets you specify. Even if you specify the Y option, which means 'Yes, shell out to the DOOR (gives faster return from door)', WonderWho will run fine, and about 140 KBytes of RAM will still be available. So, it's up to you. WonderWho works fine in either way. 6. Edit the WW_TEST.BAT batch file. This is the local test batch file. This means you can test WonderWho outside PCBoard. Here is an example of the file contents: @ECHO OFF WONDER WONDER.CFG C:\PCB LOCAL This assumes that you are running this batch file from the WonderWho directory. The LOCAL parameter (which must be in uppercase) tells WonderWho that you are testing the door locally. 7. Run the WW_TEST.BAT batch file. You are about to perform a local test to the door, outside PCBoard. Find out if everything runs fine, by entering several commands. It will be ok, unless you make any mistakes anywhere. 8. Now, run PCBoard and test WonderWho locally but inside PCBoard. If it runs fine, then you are in business (and I think you will). And that's all !!! Didn't I say that you would take less than 5 minutes ? ;) --- MULTI-LANGUAGE SUPPORT --- WonderWho fully supports multi-language following PCBoard rules for files. You may have one set of files for each language you use in your BBS. Here it is a list of the files of a language set, that WonderWho implements in multi-language support: ■ WW_LANG - Door language configuration file. ■ WW_WELC - Default door Welcome file. ■ WW_NEWS - Default door News file. ■ WW_MENU - Default door Menu file. ■ WW_QUIT - Default door Quit file. ■ WW_H_* - Default door help files for all commands. At the present, the WonderWho package only provides one default set of files for the English language. WonderWho reads information about the current language used by a user from PCBoard's PCBOARD.DAT configuration file. Your default language set of files must not have extension names (as in all PCBoard files). All other language sets of files must have an extension name, accordingly to what you have defined in the PCBML.DAT multi-language file which lists all the languages available in your system. Let me explain some situations in order to you understand how WonderWho works in this matter. Suppose your default language is English. So, files referring to the English language must not have any extension names. Suppose you also have another language available in your system: for example, French. And you defined that french files have .FRE extension names. Now, a user logs on in your BBS and selects your system's default language, which is English. WonderWho finds no problem. It will use the package bundled files, which are the english set of files, without extension names. Suppose the user is a frenchman, and selects its native language, which is french :). And you did create all the French set of files, which have the .FRE extension name. WonderWho will use all the .FRE files, instead of the default set of files without any extension name. Suppose you have not created the French set of files. Well, in this case WonderWho will always try to first locate the .FRE files. Because it doesn't find the .FRE files, it will then try to use the default set of files, the ones without extension name. So, you have no problem. Even if you have lots of languages defined in PCBoard you don't need to create any set of files for those languages. WonderWho will work fine and use the default set of files: English. Suppose you have created part of the French set of files. Let me say that you only have created the Welcome, News, Main Menu and Quit files, but you didn't create the French Help files, because it takes a lot of time to translate them. WonderWho will have no problem with this. It will use the .FRE files which are available, and will use the default English files when it doesn't find the according .FRE file. If some SysOp translates a complete set of files for a specific language, please upload these files to SkyShip BBS, or send them to me by mail in a diskette. I will appreciate very much your attention, and will include these files in the next version of WonderWho. --- CHANGING DISPLAY FILES --- The WonderWho package provides all the original files for the English language set. That is, besides including the files that are actually displayed by the door to the user, and which are @X PCBoard's color coded files (not ANSI), the package also includes the original TheDraw files used in order to create the final files which are displayed to the user. You should not use ANSI files. In WonderWho, the ProKit routines, which are responsible for displaying the files, don't support ANSI files when not in color mode. So display files must always be @X color coded files. TheDraw is the best program ever made to design text screens. It's very easy to use, yet quite powerful. I designed all the WonderWho display files with it. TheDraw uses its own file format (but it can save in several file formats, including ANSI, .COM, etc), which usually have a .TD extension name. That's what you will find in the TD_FILES.ZIP archive bundled with the WonderWho package. So, if you want to change the display files, I advise you to edit the original files in TheDraw. After make the changes you want, first you should save the TheDraw file in order to update. You can use the latest version of TheDraw (v4.60) in order to save all the files you create or change in the @X color coded format. --- MACROS --- WonderWho supports 'macros' in all the files that can be displayed to the user. Here it is a list of all the macros (in alphabetical order): MACRO NAME DESCRIPTION ---------- ------------ $@$ - File list pathname for dsz $B$ - Modem open baud rate $BLUE$ - Blue color $C$ - Connect bps $CLREOL$ - Clear to end of line $CONF$ - Conference number with mail waiting $CONFNUM$ - Current conference number $CYAN$ - Cyan color $DEFAULT$ - The default color $DISP-fname$ - Display specified text file $FIRST$ - Caller's first name $HELPFILE$ - Interpret remainder of file as multi-topic HELP file $GRAY$ - Gray color $GREEN$ - Green color $IFMEMBER-nn$ - YES or NO is the caller member of specified conf no. $LASTMSGNO$ - Higher message number $MAGENTA$ - Magenta color $MAIL$ - Mail file name $MSGCOUNT$ - Active message count $N$ - Port number 0=local, 1..4 $NAME$ - Caller's full name =- @USER@ $NO$ - Literally "NO" $NODE$ - Current node number $NOMACS$ - Disable macros for remainder of display $NONSTOP$ - Display the rest of the file non-stop $PLAY$ - Playpen directory $R$ - Result filename for batches $RED$ - Red color $SCRATCH$ - Scratch file name $SYSOP$ - Sysop name $TIME$ - Minutes left $WHITE$ - White color $YELLOW$ - Yellow color $YES$ - Literally "YES" @BEEP@ - Speaker beep, control-g @BOARDNAME@ - The name of your BBS @BPS@ - Estimated connect bps @BYTELIMIT@ - Bytes allowed from PWRD file @BYTESLEFT@ - Remaining bytes available for download for that day @CITY@ - City and state of caller (all caps) @CLS@ - Clear screen @DATAPHONE@ - Caller's business/data phone number @DAYBYTES@ - Bytes downloaded so far that day @DLBYTES@ - Total bytes downloaded - all calls @DLFILES@ - Total files downloaded - all calls @EVENT@ - Time of next scheduled event @EXPDATE@ - Subscription expiration date @FIRST@ - First name of the user (first letter capitalized) @HOMEPHONE@ - Caller voice phone number @INCONF@ - Conference the caller is currently in @LASTDATEON@ - Last date on (mm-dd-yy format) @LASTTIMEON@ - Last time on (hh:mm format) @MORE@ - Forces a "MORE" prompt @NUMCALLS@ - Total number of callers in system @NUMTIMESON@ - Number of times on system @SECURITY@ - Users current security level including conf. add. @SYSDATE@ - Host date in (mm-dd-yy format) @SYSTIME@ - Host system in (hh:mm format) @TIMELEFT@ - Time remaining that call incl. all credits, etc. @TIMELIMIT@ - Time allowed from PWRD file @TIMEUSED@ - Minutes used since logon @UPBYTES@ - Total bytes uploaded - all calls @UPFILES@ - Total files uploaded - all calls @USER@ - Complete name of the caller (first & last - all caps) @WAIT@ - Force a "press enter to continue" prompt @X - Pcboard 14.5 compatible colored codes --- CONFIGURATION FILE --- WonderWho is very easy to install and configure, as I already said, and you already noticed. Nevertheless, if after you installed the door in your system, you feel that the default configuration seems to run the door ok, and if it perfectly suits your needs, you don't have do to anything else. This is what I think it will probably happen. And if it does, well, I may say that I made things the way it should be. So, forget the configuration file, you don't need to make any changes. But, on the other hand, if it doesn't seem to be fine (which will be rather strange), or if the default configuration doesn't suit your needs, then you must make some changes. Changing the configuration file it's an easy task. You will do it in seconds. The default configuration file bundled with the WonderWho package is named WONDER.CFG. The configuration filename can have any name you want, as long as permitted by MS-DOS. For a list of valid filenames, please refer to your MS-DOS User's Guide. You can even have one configuration file for each node, but, as I said before, it is not necessary (but it can be done). And if you just want to have one configuration file (as you probably will), simply follow the rules mentioned above in the Installation chapter. But, if you wish to have a different configuration file for each node, proceed as follows, but be aware that things can be done in other ways than the one I will describe in the next two steps. 1. Re-edit the door batch file, by default named WONDER. Here it is an example of what the contents should be: @ECHO OFF C:\WONDER\WONDER.EXE C:\WONDER\WONDER.%PCBNODE% %PCBDRIVE%%PCBDIR% In this examples, all the configuration files will have the WONDER filename, but there will be different file extension names for each node. For instance: WONDER.1 WONDER.2 ... WONDER.999 But this requires only one door batch file, because this example uses the PCBoard environment set (created by PCBoard itself) named %PCBNODE%. So MS-DOS will replace that variable for the proper node number, and WonderWho will read the correct configuration file for each specific node. 2. Create all the WonderWho configuration files for all the nodes you have installed in your system. Leave all these files in the same directory where you store all other WonderWho files. Just that! WonderWho provides you dozens of door options that you can set accordingly to your specific needs. Here it is a list of all options WonderWho recognizes in the configuration file, as well as a short description of each option: ■ INTERRUPT | BIOS - Communications driver type (only in line #1) ■ DLD_DIR= - Transfer filepath, name and extension ■ LANG_FILE= - Language filename ■ WELCOME_FILE= - Welcome filename ■ NEWS_FILE= - News filename ■ NEWS_LIMIT= - News file date limit ■ MENU_FILE= - Menu filename ■ QUIT_FILE= - Quit filename ■ LOGOFF= - Logoff ■ CALLER_LOG= - Caller's log ■ OP_LEVEL_X= - Expert mode ■ OP_LEVEL_M= - Mode (color/mono) ■ OP_LEVEL_H= - Help ■ OP_LEVEL_G= - Goodbye ■ OP_LEVEL_PRO= - Profile user ■ OP_LEVEL_WHO= - Who is on? ■ OP_LEVEL_UU= - Uploads: user name ■ OP_LEVEL_UF= - Uploads: file name ■ OP_LEVEL_UD= - Uploads: date ■ OP_LEVEL_US= - Uploads: since date ■ OP_LEVEL_UP= - Uploads: protocol letters ■ OP_LEVEL_UE= - Uploads: transfer errors ■ OP_LEVEL_UA= - Uploads: average CPS ■ OP_LEVEL_UR= - Uploads: raw ■ OP_LEVEL_UV= - Uploads: verbose ■ OP_LEVEL_UC= - Uploads: count ■ OP_LEVEL_DU= - Downloads: user name ■ OP_LEVEL_DF= - Downloads: file name ■ OP_LEVEL_DD= - Downloads: date ■ OP_LEVEL_DS= - Downloads: since date ■ OP_LEVEL_DP= - Downloads: protocol letters ■ OP_LEVEL_DE= - Downloads: transfer errors ■ OP_LEVEL_DA= - Downloads: average CPS ■ OP_LEVEL_DR= - Downloads: raw ■ OP_LEVEL_DV= - Downloads: verbose ■ OP_LEVEL_DC= - Downloads: count ■ OP_LEVEL_AU= - All: user name ■ OP_LEVEL_AF= - All: file name ■ OP_LEVEL_AD= - All: date ■ OP_LEVEL_AS= - All: since date ■ OP_LEVEL_AP= - All: protocol letters ■ OP_LEVEL_AE= - All: transfer errors ■ OP_LEVEL_AA= - All: average CPS ■ OP_LEVEL_AR= - All: raw ■ OP_LEVEL_AV= - All: verbose ■ OP_LEVEL_AC= - All: count ■ OP_NAME_X= - Expert mode ■ OP_NAME_M= - Mode (color/mono) ■ OP_NAME_H= - Help ■ OP_NAME_Q= - Quit ■ OP_NAME_G= - Goodbye ■ OP_NAME_PRO= - Profile user ■ OP_NAME_WHO= - Who is on? ■ OP_NAME_UU= - Uploads: user name ■ OP_NAME_UF= - Uploads: file name ■ OP_NAME_UD= - Uploads: date ■ OP_NAME_US= - Uploads: since date ■ OP_NAME_UP= - Uploads: protocol letters ■ OP_NAME_UE= - Uploads: transfer errors ■ OP_NAME_UA= - Uploads: average CPS ■ OP_NAME_UR= - Uploads: raw ■ OP_NAME_UV= - Uploads: verbose ■ OP_NAME_UC= - Uploads: count ■ OP_NAME_DU= - Downloads: user name ■ OP_NAME_DF= - Downloads: file name ■ OP_NAME_DD= - Downloads: date ■ OP_NAME_DS= - Downloads: since date ■ OP_NAME_DP= - Downloads: protocol letters ■ OP_NAME_DE= - Downloads: transfer errors ■ OP_NAME_DA= - Downloads: average CPS ■ OP_NAME_DR= - Downloads: raw ■ OP_NAME_DV= - Downloads: verbose ■ OP_NAME_DC= - Downloads: count ■ OP_NAME_AU= - All: user name ■ OP_NAME_AF= - All: file name ■ OP_NAME_AD= - All: date ■ OP_NAME_AS= - All: since date ■ OP_NAME_AP= - All: protocol letters ■ OP_NAME_AE= - All: transfer errors ■ OP_NAME_AA= - All: average CPS ■ OP_NAME_AR= - All: raw ■ OP_NAME_AV= - All: verbose ■ OP_NAME_AC= - All: count For a more extensive description of each option listed above, please refer to the Options Description chapter, or to the WONDER.CFG and WW_LANG files, where you will find all the necessary informations you will need about each one. You don't have to specify all the options mentioned. Only the ones you want to be different than the default assumed by WonderWho. All the default specifications for each options are also listed in the WONDER.CFG and WW_LANG files. Except for the INTERRUPT | BIOS option which is required at line #1 of WONDER.CFG, all the options can be place in the file in any order you want. It can be even repeated (if they are, WonderWho will always use the last one it reads). Please note that: ■ You should edit this file using any reliable ASCII text editor, such as Norton Editor, MicroStar, QEdit, etc. ■ All options names and specifications are case-insensitive. That is, you may enter them either in uppercase or lowercase. ■ Each line must not exceed 255 characters. Everything past that column is discarded. ■ Empty lines are discarded. You may leave as many empty lines as you wish. ■ In a line, everything after (and including) a ; character is interpreted as a comment, and will be discarded. ■ You may leave as many spaces as you want before a statement. Spaces before a statement will be discarded. WonderWho reads text files very quickly. Users will not notice for delays while the door is reading the configuration file. But, if you want an even faster access to the configuration file, remove all empty and commented lines. I don't strongly des-advise you to to do this. Comments where made to tell you the meanings and rules for each option, and if you don't delete them, they will be there, waiting for you, by the time you need them. And time,... will always come... :) I think you will find this kind of configuration file very easy to understand and to change. --- LANGUAGE CONFIGURATION FILE(S) --- A language configuration file is almost the same as the door configuration file is. The routine used to read and process this file is the the very same that is used to read and to process the configuration file. Nevertheless, there are a couple of major differences: ■ The language configuration file is always read (and processed) after the door configuration file is read (and processed). So, every option specified in the language configuration file will overwrite the door internal default for that option, and also overwrite the same option if specified in the configuration file. ■ The language configuration file concerns to the PCBoard current language extension the caller is using. WonderWho treats the language configuration file as is described in the Multi-Language Support chapter. So, you can have one language configuration file for each language installed in your system ■ The INTERRUPT | BIOS option is the only option not available in the language configuration file. If that option is found, it will not be processed. WonderWho provides a default language configuration file named WW_LANG. As it happens with the default door configuration file WONDER.CFG, all options are disabled, because they are originally the internal WonderWho defaults. So, if you want, you can set a certain number of options in the door configuration file (which acts like global options for all languages), and set another number of options concerning a specific language. For instance, you may specify in the language configuration file the names for each option. This assumes that you have decided to create different Main Menu display screens for each language and changed the names of all options. Well, the way WonderWho treats the WONDER.CFG door configuration file, and WW_LANG configuration file(s) gives you complete power of most of WonderWho operations. --- OPTIONS DESCRIPTION --- Here are the detailed descriptions for all options available in the door configuration file WONDER.CFG and the language configuration file WW_LANG: ■ INTERRUPT | BIOS Communication driver type ---------------------------------------------------------------------- The first line of the door configuration file MUST be the communication driver type. This can be one of the following: ■ INTERRUPT (the best, fastest) ■ BIOS (if interrupts fail to work) Default: There is no default for this option. You must specify it. ■ DLD_DIR= Transfer filepath, name and extension. ---------------------------------------------------------------------- This is the file location and name of PCBoard's transfer summary file. If you don't specify this option, then WonderWho will use the information stored in the PCBOARD.DAT file related to the specific node. Specifying this option will make WonderWho ignore the information stored in PCBOARD.DAT, which is the default procedure. Default: What is specified in PCBOARD.DAT file. ■ LANG_FILE= Language filename ---------------------------------------------------------------------- This is the filename only (no extension) of the file that will have the name of the Main Menu commands available in WonderWho. This file must be located in the same directory where the WonderWho config file is located. You cannot specify the file extension. The maximum length for this name is 8 characters long. Default: WW_LANG Note : You may disable this option by specifying NONE. ■ WELCOME_FILE= Welcome filename ---------------------------------------------------------------------- This is the filename only (no extension) of the file that is first displayed to the user when he enters the door. This file must be located in the same directory where the WonderWho config file is located. You cannot specify the file extension. The maximum length for this name is 8 characters long. Default: WW_WELC Note : You may disable this option by specifying NONE. ■ NEWS_FILE= News filename ---------------------------------------------------------------------- This is the filename only (no extension) of the NEWS file that is displayed after the WELCOME file. This file shows to the user information about the features of the latest version of WonderWho. This file must be located in the same directory where the WonderWho config file is located. You cannot specify the file extension. The maximum length for this name is 8 characters long. Default: WW_NEWS Notes : You may disable this option by specifying NONE. If WonderWho doesn't find this file, no error will be returned. ■ NEWS_LIMIT= News file date limit ---------------------------------------------------------------------- This option controls the date until WonderWho will still display the WW_NEWS news file to the users. You have two chances: 1. Always display the file (set NEWS_LIMIT=@FOREVER@) 2. Specify a month, day and year after which the file will no longer be displayed to the user. Default: @FOREVER@ Notes : You may disable this option by specifying NONE. When specifying a date, you *MUST* insert a zero character when the month or day are less than 10. Date *MUST* be 10 characters long. No check will be performed on this. The file date format is: yyyy-mm-dd. ■ MENU_FILE= Menu filename ---------------------------------------------------------------------- This is the filename only (no extension) of the Main Menu. This file must be located in the same directory where the WonderWho config file is located. You cannot specify the file extension. The maximum length for this name is 8 characters long. Default: WW_MENU Notes : You may disable this option by specifying NONE. ■ QUIT_FILE= Quit filename ---------------------------------------------------------------------- This is the filename only (no extension) of the Main Menu. This file must be located in the same directory where the WonderWho config file is located. You cannot specify the file extension. The maximum length for this name is 8 characters long. Default: WW_QUIT Notes : You may disable this option by specifying NONE. ■ LOGOFF= Logoff ---------------------------------------------------------------------- This is how WonderWho will act after the user enters the [G]oodbye command, that is, what file will be displayed to the user at logoff time. You have two possible chances to configure this feature: 1. Show the logoff script questionnaire as specified in PCBOARD.DAT. (set LOGOFF=@PCB@) 2. Show a specific file. (set LOGOFF=complete path and filename, but no extension, these means support for multi-language systems!) Default: @PCB@ Notes : You may disable this option by specifying NONE. ■ CALLER_LOG= Caller's log ---------------------------------------------------------------------- This is where you specify if you want WonderWho to save data into the CALLER's log file. WonderWho can save all commands the user type into the file, and it follows the PCBoard style and file format. Here follows an example, which I think is self-explanatory. JAwho specific lines are the ones marked with a "->". "**************************************************************" "02-24-93 (09:03) (1) JOSE ALMEIDA (Local) (G) " " Caller Number: 880 " " Caller Security: 110 " " Opened Door (WONDER) at 09:03 " -> " (AU) # 1: JOSE ALMEIDA " -> " (UF) # 1: WONDER14.ZIP " -> " # 2: WONDER15.ZIP " -> " # 3: WONDER16.ZIP " -> " (DC) Count entries " -> " (PRO) View user profile " -> " (X) Expert mode is now on " -> " (M) Graphics mode is now off " -> " (VER) Program version info " -> " (H) Help about: (PRO) " -> " (G) Goodbye (from inside door) " " Minutes Used: 1 " "02-24-93 (09:04) (1) JOSE ALMEIDA Off Automatically " "**************************************************************" All search entries are logged, except for the [Q]uit command. Trailing characters past each log entry are filled with ASCII #255 for clear output, and in order to allow the file to be edit without any problem caused by ASCII text editors discarding trailing space characters. All call entries are saved prior to execute the command, for convenient debug operations. WonderWho will not save to the CALLER LOG file when in Local Test mode (when you pass the word "LOCAL" as the third parameter to the program). But ProKit itself does this anyway, if a "Keyboard Time Expired!" takes place. Default: YES Notes : You may disable this option by specifying NO. ■ (Varies) Option names ---------------------------------------------------------------------- Here you can specify different names for all primary commands. You cannot specify the name for the [VER]sion command. Each command name cannot exceed 3 characters length. Everything past the third character will be discarded. Default: Unless you specify differently, all option names are the ones listed after the 'OP_NAME_' word. Notes : If you wish to disable a command, set the security level to anything higher than a user can have (usually SysOp's level). Here is a list of all option names: ■ OP_NAME_X= - Expert mode ■ OP_NAME_M= - Mode color/mono ■ OP_NAME_H= - Help (secondary command: 'HELP') ■ OP_NAME_Q= - Quit (secondary command: 'QUIT') ■ OP_NAME_G= - Goodbye (secondary commands: 'G Y' and 'BYE') ■ OP_NAME_PRO= - Profile user (secondary command: 'PROFILE') ■ OP_NAME_WHO= - Who is on? ■ OP_NAME_UU= - Uploads: user name ■ OP_NAME_UF= - Uploads: file name ■ OP_NAME_UD= - Uploads: date ■ OP_NAME_US= - Uploads: since date ■ OP_NAME_UP= - Uploads: protocol letters ■ OP_NAME_UE= - Uploads: transfer errors ■ OP_NAME_UA= - Uploads: average CPS ■ OP_NAME_UR= - Uploads: raw ■ OP_NAME_UV= - Uploads: verbose ■ OP_NAME_UC= - Uploads: count ■ OP_NAME_DU= - Downloads: user name ■ OP_NAME_DF= - Downloads: file name ■ OP_NAME_DD= - Downloads: date ■ OP_NAME_DS= - Downloads: since date ■ OP_NAME_DP= - Downloads: protocol letters ■ OP_NAME_DE= - Downloads: transfer errors ■ OP_NAME_DA= - Downloads: average CPS ■ OP_NAME_DR= - Downloads: raw ■ OP_NAME_DV= - Downloads: verbose ■ OP_NAME_DC= - Downloads: count ■ OP_NAME_AU= - All: user name ■ OP_NAME_AF= - All: file name ■ OP_NAME_AD= - All: date ■ OP_NAME_AS= - All: since date ■ OP_NAME_AP= - All: protocol letters ■ OP_NAME_AE= - All: transfer errors ■ OP_NAME_AA= - All: average CPS ■ OP_NAME_AR= - All: raw ■ OP_NAME_AV= - All: verbose ■ OP_NAME_AC= - All: count ■ (Varies) Option security levels ---------------------------------------------------------------------- Here you can specify different security levels for all primary commands, except for the [VER]sion and [Q]uit commands. Default: Unless you specify differently, all security levels are set to 0 by default. Here it is a list of all level options: ■ OP_LEVEL_X= - Expert mode ■ OP_LEVEL_M= - Mode (color/mono) ■ OP_LEVEL_H= - Help ■ OP_LEVEL_G= - Goodbye ■ OP_LEVEL_PRO= - Profile user ■ OP_LEVEL_WHO= - Who is on? ■ OP_LEVEL_UU= - Uploads: user name ■ OP_LEVEL_UF= - Uploads: file name ■ OP_LEVEL_UD= - Uploads: date ■ OP_LEVEL_US= - Uploads: since date ■ OP_LEVEL_UP= - Uploads: protocol letters ■ OP_LEVEL_UE= - Uploads: transfer errors ■ OP_LEVEL_UA= - Uploads: average CPS ■ OP_LEVEL_UR= - Uploads: raw ■ OP_LEVEL_UV= - Uploads: verbose ■ OP_LEVEL_UC= - Uploads: count ■ OP_LEVEL_DU= - Downloads: user name ■ OP_LEVEL_DF= - Downloads: file name ■ OP_LEVEL_DD= - Downloads: date ■ OP_LEVEL_DS= - Downloads: since date ■ OP_LEVEL_DP= - Downloads: protocol letters ■ OP_LEVEL_DE= - Downloads: transfer errors ■ OP_LEVEL_DA= - Downloads: average CPS ■ OP_LEVEL_DR= - Downloads: raw ■ OP_LEVEL_DV= - Downloads: verbose ■ OP_LEVEL_DC= - Downloads: count ■ OP_LEVEL_AU= - All: user name ■ OP_LEVEL_AF= - All: file name ■ OP_LEVEL_AD= - All: date ■ OP_LEVEL_AS= - All: since date ■ OP_LEVEL_AP= - All: protocol letters ■ OP_LEVEL_AE= - All: transfer errors ■ OP_LEVEL_AA= - All: average CPS ■ OP_LEVEL_AR= - All: raw ■ OP_LEVEL_AV= - All: verbose ■ OP_LEVEL_AC= - All: count --- TOOLS --- This program was written using Borland's Turbo Pascal version 6.0. Besides this outstanding compiler, I also used several other programs, such as (in alphabetical order): ■ PCBoard 14.5a Copyright by Clark Development Company ■ PKLite Professional v1.12 Copyright by PKWare Inc. ■ PKZip v2.04g Copyright by PKWare Inc. ■ TheDraw v4.60 Copyright by TheSoft Programming and Ian E. Davis I also used the following libraries or source code (again, in alphabetical order): ■ ProKit v3.44 Copyright by Samuel H.Smith ■ The HeartWare Toolkit v2.00 for Turbo Pascal Copyright by José De Almeida & Luis Correia --- OTHER SOFTWARE FROM THE AUTHOR --- Besides the WonderWho door, I also released other software, either as Shareware or Freeware programs. All this software are available at SkyShip BBS (see Costumer Support chart for phone numbers). Here is a list (in alphabetical order) and brief descriptions: ■ JAJumbo v1.09 Shareware ---------------------------------------------------------------------- For Colorado Jumbo Streamers. Easy of use. Very very fast. Pulldown menus interface. True arrow mouse support in text mode. Screen fades. Internal palette and font re-definition. On-line help and built-in screen saver. Backup single, multiple or all hard-disk disk drives, restores multiple volumes in a single command. Format. Batch file support for user-specific tasks. And more! Fully functional shareware program. Filename: JAJUMBO9.* ■ JAvga v1.00 Freeware ---------------------------------------------------------------------- This is a VGA text based demo program. This is not an utility, but only a very interesting and amazing programing exercise. Includes VGA extremely fast and best implemented palette fades in and fades out. "True" arrow mouse cursor (Norton a-like). 6 Built-in text portuguese fonts, but they work code-page independently. 2 Text fonts will be displayed on screen at the same time, using VGA programing features. This means 512 different characters on screen at the same time. 16 Background colors (not only 8). Toggle character blink on/off. And remember, everything this program does, no matter what it is, is done deliberately. It have no bugs, whatsoever. Filename: JAVGA.* ■ TagMail v0.16ß Shareware ---------------------------------------------------------------------- Utility program that works with virtually any DOS off-line mail reader. Automatically inserts in a message your signature (any kind, any size) and a tagline (any size, multiple lines). Easy to configure, works in completely silent mode. More than 34,000 Taglines available in dozens of pre-compiled taglines. Filename: TAGM016B.* ■ The Image Bank BBS Clip Art Library v1.00 Freeware ---------------------------------------------------------------------- Compilation of 266 Clip art files in the following graphic file formats: ■ PCC - for DeluxePaint and PC PaintBrush ■ ST - for NeoPaint ■ GIF - for other drawing programs. Lots of nice and very small clip art images, and dozens of ready to use Microsoft Windows-alike push buttons. Includes catalogs of all images for easy view. Filename: TIBCA100.* ■ The Wallpaper Library release WL3024 Shareware ---------------------------------------------------------------------- The world's biggest wallpaper library available for Microsoft Windows v3.x, featuring 3,024 tiled .BMP wallpapers in 256-colors format, meaning about 32 MBytes of images. More than 1,300 new wallpapers than the previous release. SuperVGA required. Filenames: WL3024*.* (14 file archives) --- SPECIAL THANKS --- In a first place, I would like to express my gratitude to Mr.Mário Pozzetti, SysOp of SkyShip BBS (the world-wide support BBS for WonderWho). And this is more than a special thanks. I would like to thank him for all he have done in its wonderful BBS for the Portuguese Shareware globally speaking, for my other Shareware programs in particular, and for WonderWho door specifically nowadays. Without his initial encouragement, and continuous and closet attendance providing me almost all the informations I needed to develop WonderWho. I would like to express my gratitude to the following persons (in alphabetical order): ■ Mr.Afonso Vicente: SysOp of Intriga Internacional BBS. ■ Mr.Carlos Batista Author of a Shareware mail utility called MailDB. ■ Mr.Luis Silva and Mr.Pedro Chaves: SysOps of MsMac BBS, and distributors of Clark Development Company Inc. products, such as PCBoard, for Portugal. ■ Mr.Pedro Duarte: Author of a Shareware communication program called LusoComm. ■ Mr.Pedro Pinheiro ■ Mr.Tiago Pascoal All these folks helped me a lot in testing the WonderWho door, giving me reports of problems and bugs when found, new ideas to implement, etc, either as SysOps on their BBS, or as simple users of the door. I hope I'm not forgetting anyone. And finally, last but not least, Mr. Samuel Smith, Author of the wonderful ProKit library used in WonderWho. [end-of-file]