                    Ŀ 
                              F R E E - O J          
                              ~~~~~~~~~~~~~          
                               Version 1.2           
                                                     
                       Copyright 1996 by Mike Fox    
                                                     
                                 ******              
                                                     
                       ChAoS Online (310) 318-5089   
                                
                    
DISCLAIMER:
===========
THIS SOFTWARE PRODUCT IS DISTRIBUTED "AS IS" WITHOUT WARRANTY OF ANY 
KIND, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF MERCHANTABILITY 
AND FITNESS FOR A PARTICULAR PURPOSE. IN NO EVENT SHALL CHAOS ONLINE 
OR THE AUTHOR OF THIS SOFTWARE BE LIABLE FOR ANY KIND OF DAMAGES 
ARISING FROM THE USE OF THIS PRODUCT, INCLUDING BUT NOT LIMITED TO 
DIRECT, INDIRECT, SPECIAL, OR CONSEQUENTIAL DAMAGES.

DISTRIBUTION:
=============
Free-OJ is Freeware! You may post this file for downloading or you 
may upload it to any other BBS, provided that you do not make any 
changes to the contents of the archive (ZIP file). The archive and 
its individual contents are still copyrighted material and may not
be sold under any conditions.

PROGRAM DESCRIPTION:
====================
In this door, your callers will live the life of OJ Simpson! Starting
with OJ's football days, callers can experience the murder, the trial,
and verdict. The program depicts events in OJ's life with original ANSI
artwork, and players are scored by how many mistakes they make along the
way. A bulletin of the Top Ten players is displayed at the end.

Free-OJ is full of sarcasm, satire and humor. But it is also safe for 
minors, as no profanity is used. The game is intended to be a parody of 
the real life media event, and is not to be taken seriously. All events 
and depictions are the opinion of the author, and may not represent 
actual events.

STANDARD FEATURES:
==================
* Desqview aware, multi-node.
* Supports most BBS drop files.
* Use COM 1-15 and non-standard IRQ's.
* Fossil driver support.
* Will return to BBS on dropped carrier.
* Returns to BBS after 4 minutes of no activity.
* Support BBS available.
* Sysop configurable.

PLAYING LOCALLY:
================                                 
To try out Free-OJ, just type OJ LOCAL and press return. Make sure
the OJ.CFG file is in the same directory as the OJ program. Free-OJ
is Freeware! There are no delay screens or other crippling.

TOP TEN BULLETIN:
=================
The OJ program creates a file named OJ_BULL.DAT that stores the data
for the top ten players. This file is SELF-MAINTAINING. When all ten
players on the list achieve a perfect score, the file is reset and 
the Top Ten Bulletin starts over. This keeps the bulletin "fresh" by
allowing new players to get on the list.  

SOURCE CODE INCLUDED!
=====================
Version 1.2 of Free-OJ includes the source code! OJ.BAS is a great
example for those wanna-be door programmers. If you are curious about
writing doors, read the SOURCE.TXT file for information on what files
you need, how to link/compile programs, etc. I wish this information
was available when I wrote "Chat With Lisa".

INSTALLATION:
=============
Installation consists of modifying two files: A batch file that your 
BBS calls to run OJ, and a configuration file that controls the various
options. The program also uses the ANSI.SYS driver that comes with DOS,
so make sure that is installed. Instructions follow:

SAMPLE BATCH FILE:
==================
A sample batch file (OJ.BAT) is included and consists of the following:

   ECHO OFF
   CD C:\DOORS\OJ    <--- Change to the door's directory.
   OJ OJ.CFG         <--- Run the door program using config filename.
   CD C:\WILDCAT     <--- Go back to BBS directory when user exits door.
   BBS.BAT           <--- Restart node or BBS. Use ONLY if you terminate
                          instead of shelling before using the door.

SEE YOUR INDIVIDUAL BBS DOCUMENTATION FOR INSTRUCTIONS ON RUNNING DOORS!

If you need to use a non-standard IRQ, add the IRQ number after OJ.CFG 
in the batch file. For example, to use IRQ 5:

   ECHO OFF
   CD C:\DOORS\OJ  
   OJ OJ.CFG /5    <--- Non-standard IRQ callout. Include the "slash" 
   CD C:\WILDCAT 
   
The /5 tells the program to use IRQ 5 instead of the standard IRQ. Or you 
can set the IRQ environment variable (SET IRQ=5) and use it as follows:   

   OJ OJ.CFG /%IRQ%    <--- Non-standard IRQ callout. Include the "slash"    
   
Don't forget to place the batch file in the proper directory so that
your BBS can execute it. Usually, the batch file is placed in the BBS
directory or subdirectory, not the OJ directory.

CONFIGURATION:
==============
You must edit the OJ.CFG file to configure Free-OJ for your BBS. The OJ 
program will read only the first 5 lines, and they must be in the order 
specified without any blank lines. The following example of OJ.CFG is 
for all BBS's:  (you should edit the OJ.CFG file already supplied)

C:\PCB\PCBOARD.SYS   <---,    The first line should be the full path to
C:\PCB\USERS.SYS         |    your BBS drop file. The OJ program can
C:\BBS\DOOR.SYS          |    use any drop file shown here. Select the
C:\BBS\USERINFO.DAT      |--- correct one and edit the line to provide
C:\BBS\CALLINFO.BBS      |    the full path. Use only one line here. The
C:\BBS\DORINFOx.DEF      |    second line must be the name of your BBS,
C:\BBS\SFDOORS.DAT       |    as described below.
C:\BBS\TRIBBS.SYS    <---'
ChAoS Online      <--- The name of your BBS.
Mike             <--- First name of the Sysop (not displayed to callers).
Fox             <--- Last name of the Sysop (not displayed to callers).
999999         <--- Registration code. Use any number if not registered.
                   Once registered, you cannot change lines 2, 3, or 4.
                  (no longer applies, use any number, Oj is freeware!)
                   ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Remember to press <enter> at the end of each line, including the last
one (don't leave trailing spaces on any line). Also check for spelling
errors and make sure that OJ.CFG is located in the OJ directory.

MULTIPLE NODES:
===============
When specifying the location of the drop file on line 1 of OJ.CFG,
you may use the environment variables %wcnodeid%, %pcbdrive%, %pcbdir% 
and %pcbnode%. YOU MUST USE JUST ONE CONFIGURATION FILE TO RUN MULTIPLE 
NODES! The configuration filename must be OJ.CFG for proper operation. 
Here are some examples:

For Wildcat 4.X software, the first line in OJ.CFG could be:

   C:\WILDCAT\WCWORK\NODE%WCNODEID%\DOOR.SYS

The WCNODEID environment variable should be SET in the batch file 
that starts each node.

For PCBoard software, the first line in OJ.CFG could be:

   %PCBDRIVE%%PCBDIR%\NODE%PCBNODE%\USERS.SYS
    or just C:\BBSDIR\NODE%PCBNODE%\USERS.SYS
   
The PCB environment variables must also be SET in the batch file 
that starts the BBS or the batch file for each node. See below:

   SET PCBDRIVE=C:      <--- Drive letter of your BBS files.
   SET PCBDIR=\BBSDIR   <--- Path to your BBS files.
   SET PCBNODE=1        <--- Number of the node running OJ. Since 
                             this could change, you should add it to 
                             the batch file that starts each node.

Other BBS systems can use the same variables as Wildcat and PCBoard.
The correct path to the drop file for different nodes could then be
specified in the OJ.CFG file by following the examples shown above.

Note: If you specify a filename other than OJ.CFG, Free-OJ will read
the first line of the specified file to get the path for the drop file,
and then open OJ.CFG to get all the other settings.

DON'T FORGET TO INSTALL SHARE.EXE IN YOUR AUTOEXEC.BAT FILE IF YOU ARE 
RUNNING MULTIPLE NODES!

FOSSIL DRIVER SUPPORT:
======================
DoorFrame supports the use of Fossil drivers. To use the Fossil driver 
instead of the standard COM ports, just add /FD after OJ.CFG in the 
batch file. For example:

   ECHO OFF
   CD C:\DOORS\OJ  
   OJ OJ.CFG /FD    <--- Use the Fossil driver! 
   CD C:\WILDCAT 
   
If no Fossil driver is detected, DoorFrame will print a message to that 
effect and then exit the door gracefully.

TECHNICAL SUPPORT:
==================
Almost every problem that you might encounter while installing OJ has
been described and solved in the HELP.TXT file. If any internal errors do
occur, check for a file called DFRAME.ERR and tell me what the error code
says. But try reading the HELP.TXT file before asking for help.

Like all mortals, my time is limited. So please don't call and leave
messages like "It doesn't work" or "I get an error". If you want my help,
give me the details, ie: What did the screen display? When did it occur?
What error code? Which BBS software? Which Operating System?

And if you don't know how to use DOS, or haven't read the instructions,
or can't edit batch files, or don't know how to run your BBS, I will be 
happy to teach you... for $50.00 per hour :)

WHERE TO REACH ME:
==================
BBS:  ChAoS Online, (310) 318-5089 (I am the Sysop)
      If you want help, log on with your name and [Y]ell at the Sysop 
      from the Main Menu. Call back in 48 hrs to read your mail.
      (don't ask me to call your BBS, I will ignore you!)

America Online:  Send e-mail to mikefox1@aol.com
                 I check my mail at AOL at least once a week.
   
Snail Mail:  ChAoS Online
             P.O.Box 1211
             Torrance, CA 90505

DISPLAY PROBLEMS:
=================
If you observe strange characters while using this door locally,
you need to add the following line to your CONFIG.SYS file:
   DEVICE=C:\DOS\ANSI.SYS
Read your DOS manual for more information. If you are multi-tasking
with DesqView, add DVANSI.COM to the batch file for each node.

PROBLEMS WITH 486DX COMPUTERS:
==============================
From the DoorFrame documentation: "The math co-processor in 486DX 
computers cannot handle the floating point math that all Microsoft 
Basics use". If you keep getting "keyboard timeout" errors, or get
ERROR 5 or 6, place the following line in your AUTOEXEC.BAT file:
   SET NO87=ON
This will turn off your math co-processor and allow the door to 
function properly.

END OF FILE!
============
