home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
The World of Computer Software
/
World_Of_Computer_Software-02-387-Vol-3of3.iso
/
w
/
wonder10.zip
/
WONDER.DOC
< prev
next >
Wrap
Text File
|
1993-03-13
|
63KB
|
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]