home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
The World of Computer Software
/
World_Of_Computer_Software-02-385-Vol-1of3.iso
/
w
/
wcht214.zip
/
WILDCHAT.DOC
< prev
next >
Wrap
Text File
|
1992-12-21
|
18KB
|
504 lines
┬┬ ┬ ┬ ┬┬ ┬┬─ ─┬┬──┐ ┌┬──┐ ┬┬ ┬ ┌┬──┐ ┌─┬┬─┐ (tm)
││ │ │ ││ ││ ││ │ ││ ││ │ ││ │ ││
││ │ │ ││ ││ ││ │ ││ │├──┤ │├──┤ ││
││ │ │ ││ ││ ││ │ ││ ││ │ ││ │ ││
└┴─┴─┘ ┴┴ ┴┴──┘ ─┴┴──┘ └┴──┘ ┴┴ ┴ ┴┴ ┴ ┴┴
Version 2.14
Tim Rider
4129 Konya Dr.
Torrance, CA 90503
(310) 371-1019
Limited voice support availible due to time constraints.
The Source BBS (310) 371-3737
WildChat(tm) is supplied as is. The author disclaims all
warranties, expressed or implied, including, without
limitation, the warranties of merchantability and of
fitness for any purpose. The author assumes no
liability for damages, direct or consequential,
which may result from the use, or inability to use,
WildChat(tm).
(C) Copyright 1992, Tim Rider
What is WildChat(tm)?
═════════════════════
WildChat is a multi-line chat door for the WildCat BBS system. It is
designed to replace the internal multi-line chat by using a DOS Hook
from the main menu.
Why use it?
═══════════
WildChat is much faster, and provides many more features than
WildCat's internal multi-line chat. WildChat is easier to use,
and basically, a lot more fun.
How does it work?
═════════════════
WildChat uses the disk to store the messages that users type. A
RAM disk is recommended, but not necessary. A disk cache is
necessary only if a RAM disk is not used, but still recommended.
WildChat writes to a fixed length file it creates when it is first
run. This file is called WILDCHAT.MSG, and it contains the messages
that users send to each other. The reason this file is fixed length
is once again speed.
WildChat writes to another fixed length file called WILDCHAT.DTA. This
file contains node info data. This file is used along with WildCat's
own NODEINFO.DAT to keep track of users on the BBS and in the
multi-line chat.
Other features
══════════════
Whispering
──────────
Whispering is one of those handy features that WildCat's multi-line
chat just doesn't have. Normally, messages you type in the multi-
line chat can be seen by everyone. WildChat will let you "whisper"
something to a user privately, so no one else can see your message.
Let me show you an example. Let's say there are two users in the
multi-line chat, T.Rider, and C.North. You are seeing what T.Rider
types.
/C.North No one else can see this message!
C.North would see something like this on his screen...
T.Rider (Whispered): No one else can see this message!
It's a handy feature, a must for any conversation!
Language Filter
───────────────
Naturally, there are always those people who take a liking to words
that you may not want on your BBS. If you BBS is a family system,
then you surely won't want profanity used in the multi-line chat.
The language filter will screen messages for those words which you
specify in the file WILDCHAT.BAT. Read on for more details.
Action Commands
───────────────
Action Commands are my favorite feature of WildChat. Action
Commands are key-words that are linked to a phrase. Let me
show you what action commands do...
Type: LAUGH T.Rider
See: C.North is laughing at T.Rider!
You can do this, and much, much more with the WildChat Action
Command parser! Read the section titled "WildChat Files" for more
details on how to create and edit action commands.
Display Screens
───────────────
WildChat uses several external display screens, they are:
CFGHELP.BBS
MAINHELP.BBS
HELLO.BBS
TUTORIAL.BBS
ALLALONE.BBS
Of course, some example screens have been included, but they aren't
very good, and I hope to improve them some time. Feel free to edit
these screens to your liking.
Files In This Archive
═════════════════════
Make sure that you have all of these files, and that they are the
proper file sizes, etc...
ALLALONE BBS 109 12-21-92 2:14p
CFGHELP BBS 3783 12-21-92 2:14p
MAINHELP BBS 3588 12-21-92 2:14p
WILDCHAT CFG 2461 12-21-92 2:14p
WILDCHAT DAT 19350 12-21-92 2:14p
WILDCHAT LST 2610 12-21-92 2:14p
WILDCHAT EXE 54459 12-21-92 2:14p
WILDCHAT BAD 299 12-21-92 2:14p
Installation
════════════
Make sure ALL nodes are taken down, and that the system is not running
under a multi-tasker before starting this set up. Also, ALWAYS BACK
YOUR SYSTEM UP!
1. Make a sub-directory off of the WildCat root directory for WildChat.
EXAMPLE: C:\WC30\WILDCHAT\
The exact name of the directory doesn't really matter.
2. Move WILDCHAT.EXE, WILDCHAT.DAT, WILDCHAT.BAD, WILDCHAT.LST into
this directory.
These four files have to be in the same directory, or WildChat
WILL NOT run.
3. Add a command into your CONFIG.SYS or your AUTOEXEC.BAT to create a
128k RAM Disk on bootup.
The larger the RAM Disk, the more reliable WildChat should be.
If you can spare more than 128k for the RAM Disk, make sure to
increase the "maximum number of messages" field in WILDCHAT.CFG.
4. Edit WILDCHAT.CFG. Instructions are in the file, and DO NOT remove
any lines from the file, or your system may suffer a severe disaster.
This is basically what the configuration file looks like. Make
sure that there are AT LEAST twenty lines in the file!
D:\
10
160
60
300
C:\WC30\WILDCHAT\
C:\WC30\DATA\
ON
50
CTS/RTS
ON
10
OFF
ON
.Don't remove any of these lines
.Don't remove any of these lines
.Don't remove any of these lines
.Don't remove any of these lines
.Don't remove any of these lines
.Don't remove any of these lines
┌─────────────────────────────────────────────────
│ WildChat! v2.xx Configuration File
└─────────────────────────────────────────────────
┌──────────┬─────────────────────────────────────┬
│ Line #1 │ RamDrive Path │
│ Line #2 │ Maximum Nodes in WILDCHAT.DTA │
│ Line #3 │ Maximum Messages in WILDCHAT.MSG │
│ Line #4 │ Basic Timeout (Seconds) │
│ Line #5 │ Complex TimeOut (Seconds) │
│ Line #6 │ Datafiles Path │
│ Line #7 │ WildCat! 3.0 Node Info Directory │
│ Line #8 │ Foul-Language Filter (ON/OFF) │
│ Line #9 │ Percentage of Online Time allowed │
│ Line #10 │ Modem Hand-Shaking (NONE, CTS/RTS, │
│ │ XON/OFF, BOTH) │
│ Line #11 │ Status Line (ON/OFF) │
│ Line #12 │ Maximum amount of time that can be │
│ │ transferred using the /GIVETIME cmd │
│ │ (Or OFF to disable /GIVETIME │
│ Line #13 │ File Locking (ON/OFF) │
│ Line #14 │ File Logging (ON/OFF) │
│ Line #15 │ Use FOSSIL (ON/OFF) │
Here are some more in-depth notes on the options...
Line #1: If you are NOT using a RAM Disk, then you can change
this line to point to a temporary directory, like
C:\WC30\WCHTFILS, or something like that. Delete the
contents of this file every time you completely re-boot
your BBS system, or if WildChat crashes.
Line #2: If you have 10 nodes set up in WildCat, specify 10 on
this line. If you have 250 nodes, set this to 250...etc...
Line #4: Basic Timeout is the amount of time you will let users sit
without pressing a key before logging them off.
Line #5: Complex Timeout is the amount of time you will let users
sit without entering a message before logging them off.
Line #6: Specify the path where you put WILDCHAT.EXE, WILDCHAT.DAT,
WILDCHAT.BAD, and WILDCHAT.LST on this line.
Line #7: Specify the path to NODEINFO.DAT on this line.
Line #8: This line toggles the language filter.
Line #11: Status line toggle.
*******> If you are using a MONOCHROME monitor, make sure to turn
the status line off in the configuration file!!
Line #13: If you have a variety of different speed computers on
your LAN, and strange things are happening like ghost
messages, etc... Try turning on full file locking.
Full file locking doesn't agree with some network
setups, though.
Line #14: If you're WildChat log files are too large, and too
un-useful for you, you can turn them off with this line.
Line #15: If you have a FOSSIL driver installed, and wish
WildChat to use it, then change this line to ON.
5. Move the edited WILDCHAT.CFG into the WildCat ROOT directory.
EXAMPLE: C:\WC30\
6. Find a free Main Menu DOS Hook.
7. Create a batch file to call WildChat.
EXAMPLE C:\WC30\MAIN1.BAT (For DOS Hook 1)
@ECHO OFF
C:\WC30\WILDCHAT\WILDCHAT.EXE
NOTE: WildChat -MUST- be run from the WildCat WORK directory.
Do -NOT- put any CD commands in the batch file, or
WildChat WILL NOT run.
8. If your system uses non-standard IRQ or addresses for COM ports,
then make sure to add the proper environment variables to the
correct CATx.BAT file. Variables needed are listed below...
COMBASE This is the base address of the COM port being used.
WCIRQID This is the IRQ of the COM port being used.
WCHOME This is the WildCat home directory.
EXAMPLE SET COMBASE=1016
SET WCIRQID=4
SET WCHOME=C:\WC30
NOTE: COMBASE *MUST* be in decimal. "03F8" won't work! You
need to use the decimal value, "1016".
NOTE: WCHOME *MUST NOT* have a trailing back slash. The
trailing back slash will crash TomCat!!
NOTE: Environment variables *MUST* be EXACLY as shown.
HOMEPATH will not substitute WCHOME!
9. Use MAKEWILD and do the following...
(a) Change the MAIN MENU "Multi-User Chat" command letter to
something like "!" or "@", so no one can accidently access
WildCat's internal chat.
(b) Change the MAIN MENU "Multi-User Chat" command access level
to 1000, so only the SysOp can access it.
(c) Change the MAIN MENU "DOS hook 1" or "DOS hook 2" command
letter to "T".
(d) Change the MAIN MENU "DOS hook 1" or "DOS hook 2" command
access level to a level so that users can access it.
(e) Change the MAIN MENU "DOS hook 1" or "DOS hook 2" command
description to "[T]..Talk with other Node(s)" or something
like that.
(f) Go to the DOOR DEFINITION area of MAKEWILD, and change the
"DOS hook 1" or "DOS hook 2" multi-user flag to YES.
10. Use the WCTEXT.DAT editor to change the following prompts...
NOTE: Prompt numbers are for WildCat 3.5 beta.
#252 from @SUB@ is PAGING.
change the above prompts to...
#252 is PAGING you from WildChat.
11. Load one node of WildCat and give WildChat a try in local mode.
If there's any problem, review the setup for any mistakes, and
if the problem cannot be resolved, contact me through The Source
BBS.
WildChat(tm) Files <-- MUST, MUST, MUST READ!
══════════════════
WildChat(tm) uses several data files, this is an explanation of what they
are and how to maintain them.
Files that WildChat(tm) reads
─────────────────────────────
WILDCHAT.CFG The main configuration file
WILDCHAT.BAD The words for the language filter
WILDCHAT.LST The action commands
WILDCHAT.DAT The prompts and text
CFGHELP.BBS User Configuration help screen
MAINHELP.BBS Main Commands help screen
ALLALONE.BBS Display File
TUTORIAL.BBS New User Tutorial
DOOR.SYS User Info created by WildCat!
o WILDCHAT.CFG is a cr/lf format text file. Use any text editor
to edit. If any lines are removed, the door will not run, and
possible will crash and do unpredictable things. Please, be
very careful with this file. Instructions on which lines are
which are in the file.
This is found in the WildCat root directory, which is pointed to
using the WCHOME environment variable.
o WILDCHAT.BAD is a cr/lf format text file. Put each word on a
separate line. If more than one word is placed on one line, then
the result may be unpredictable.
This file is found in the WILDCHAT directory.
o WILDCHAT.LST is a cr/lf format text file. Each action command
consists of three lines. The first line is the key-word for
the action, which can be up to 15 characters long. The second
line is the text that is displayed if the key-word is typed
alone, without any options. The third like is the text that is
displayed when options are typed along with the key-word.
These following codes can be used in the third line:
@SUB@ This inserts the first word of the options.
@SUB1@ This insters the second word...
@SUB2@ ...etc...
@SUB3@
@SUB4@
@SUB5@
@SUB6@
@SUB7@
@SUB8@
@SUBA@ This inserts the whole of the options typed.
@SUBB@ This inserts the options typed from the second word on.
@SUBC@ This inserts the complete command typed, including the
key-word of the action command.
See WILDCHAT.LST for more examples. Some where around 30 to 40
are included now.
This file is found in the WILDCHAT directory.
o WILDCHAT.DAT is the file containing the text that WildChat(tm)
outputs. This is the same format as WCTEXT.DAT, and can be edited
with the WCTEXT.DAT editor that is included with WildCat! Make
sure to make a backup before altering this file.
This file is found in the WILDCHAT directory.
o CFGHELP.BBS is a help screen in WildCat 3.0 format. You can use
@CLS@, @PAUSE@, and @xx@ color commands.
o MAINHELP.BBS is a help screen in WildCat 3.0 format. You can use
@CLS@, @PAUSE@, and @xx@ color commands.
o ALLALONE.BBS is displayed when a user enters the door, and there
is no one else to chat with.
o TUTORIAL.BBS is displayed to new users if they want to see it.
o DOOR.SYS... read the WildCat! manual.
Files that WildChat(tm) creates
───────────────────────────────
WILDCHAT.DTA Contains node information (Who's Online, etc)*
WILDCHAT.MSG Contains messages that users type*
WILDCHAT.USR Contains user profiles and configuration
WILDLOG!.??? Contains logging information. Where ??? is the node #.
* denotes that file is a fixed size
o WILDCHAT.DTA contains information about who is inside WildChat(tm).
This file should be deleted on every boot-up (if not on a ram disk)
or any time that WILDCHAT.CFG changes.
This file is on the RAMDISK.
----> MAKE SURE ALL NODES ARE DOWN BEFORE DELETING OR EDITING ANY
WILDCHAT(tm) FILES!
----> IF YOU ARE GETTING A "NODE HANDLE IN USE" ERRORS THEN YOU MUST
----> DELETE WILDCHAT.DTA AND WILDCHAT.MSG.
o WILDCHAT.MSG contains the messages that the users type
to each other. This should be treated EXACTLY the way
WILDCHAT.DTA is treated.
This file is on the RAMDISK.
o WILDCHAT.USR contains user information and configuration. This
file can be deleted, but then users will have to log on new again,
which is not much of a hassle. (It may only confuse some users)
This file is found in the WILDCHAT directory.
o WILDLOG!.??? contains logging information for each node.
This file should be deleted whenever it gets too large.
These files are found in the WILDCHAT directory.
Special Thanks
══════════════
I'd like to thank the following people for making WildChat possible...
Michael Conley, thanks for all the suggestions, you were a big help!
Tom Tcimpidis, thanks for picking out all the minute details!
Chip North, thanks for running The Source, and for helping me test
this thing! Also, Thanks for letting me borrow your
USR World Port 9600! I'd be lost without it!
Jeff Sumberg, who wrote QBSerial, the serial communications
interface used in WildChat(tm). Thanks Jeff! You
wrote some GREAT routines!
Lance Stewart, beta tester.
Hugh Mitchell, beta tester.
Clayton Manson, beta tester.
Dan Stasinski, honorable mention. Good guy, great programmer, but
I still can't spell his name right.