
                          File Wishing Well II
                   Copyright 1992-94, PAROLE Software
                          All Rights Reserved

                          The Parole Board BBS
               (919) 965-4696 <-US Robotics Dual Standard
               (919) 965-9885 <-US Robotics Dual Standard

                        Fido: 1:151/185 @fidonet


     File Wishing Well II (FW) is a complete rewrite of the original
program distributed by PAROLE Software.  This version is a bit more user
friendly and the output files are somewhat more elegant. <G>  FW is a
BBS door program which will allow you and your users to list files and
utilities that are being sought for various reasons.

DISTRIBUTION:

     This program is distributed in ZIP format and carries the PAROLE
Software "AV".  The "AV" is your assurance that this file is an original
archive and has not been tampered with.  Please make sure it is still
intact.  If it is missing, notify the SysOp of the BBS you acquired it
from.  You may download a clean version from The Parole Board BBS at the
number listed above.  If you just want to download the pSoft files, you
may logon using the following name.

     FIRST NAME: Parole
     LAST NAME : Software
     PASSWORD  : Now!

     You may enter all of this at the first Name prompt.

DISCLAIMER:

INSTALLATION:

     Create a directory to hold the FW files.  Run the INSTALL.BAT and
it will create the necessary sub directories.  Edit the CFG file to suit
your individual BBS.  You will also need to modify the DOOR.BAT for your
system.  The examples I have included are set up for a Wildcat!3.x
system and will not operate on your system as written.

     If you are using Wildcat!4, create a "0" byte file named
"WILDCAT.4" and place it in the door directory.  This will force the
door to write to the correct ACTIVITY.LOG.

     Select the user drop file that suits the BBS software your are
running.  If you are operation a WC!3.x BBS, You must point to your
NODEx directory and NOT your WC30 directory.

C:\PCB\PCBOARD.SYS         Ŀ  <- For PCBoard systems using PCBOARD.SYS only
C|\PCB\USERS.SYS               <- For PCBoard systems using USERS.SYS
C:\BBS\CALLINFO.BBS            <- For Wildcat! systems (prior to v3.0)
C:\BBS\DOOR.SYS                <- For Wildcat! v4 systems
C:\BBS\USERINFO.DAT            <- For Wildcat! v3.x systems
C:\BBS\CHAIN.TXT               <- For WWIV systems
C:\BBS\GTUSER.BBS              <- For GT Power systems
C:\BBS\USERINFO.DAT            <- For Wildcat! 3.x+ systems.
C:\BBS\DOOR.SYS                <- For systems that support DOOR.SYS
C:\BBS\DORINFOx.DEF            <- For QBBS/RBBS/RA. Replace x with Node #.
C:\BBS\SFDOORS.DAT             <- For Spitfire systems.
C:\BBS\TRIBBS.SYS            <- For TriBBS systems.
The Parole Board BBS            <- BBS name
Dennis                          <- Sysop's first name
Maidon                          <- Sysop's last name
12345                           <- Registration Number
25                              <- # of days for listing to remain current.
                                   Defaults to 14 days if not
                                   registered.
C:\WC30\BULL\BULL99.BBS         <- Path and name of Color Bull
{BLANK} if WC or PCB next line  <- Path and name of ASCii Bull
WC                              <- Type Bulletin WC = WC!3
                                   PCB = PCBoard N = ANSI/ASCii
10                              <- Min. Sec Level to access door.
ZIP                             <- Preferred Archive type.(ZIP, ARJ, etc....)
Y                               <- Create TEXT file (Y/N)
E:\TEXT\WISHWELL.TXT            <- Path and Name of Text File
C:\WC30                         <- Path to BBS's ACTIVITY.LOG
RIP                             <- "RIP" = create RIP bulls
                                   "N" = do not create

   The CFG file must contain 15 lines.  Please check your CFG file
carefully as an incorrect CFG file will cause FW to fail to operate.

NOTE: See Miscellaneous Notes for info on using Environment Variables.

NOTE: There are 2 additional lines necessary when using GTUSER.BBS. Since
      this file does not provide the ComPort% and NodeNum% variables, advise
      your Door users to add them to this .CFG file on lines 5 and 6
      respectively. Both variables will default to 1.


Fossil Driver Support
---------------------
DoorFrame supports the use of Fossil drivers.  To tell your Door to use the
Fossil driver instead of the standard COM ports, just put /FD on the command
line when running the door. For example:
     MYDOOR MYDOOR.CFG /FD
indicates that a Fossil driver is present and should be used. If no Fossil
driver is detected, DoorFrame will print a message to that effect and exit
the door gracefully.

Environment Variables
---------------------
DoorFrame supports COM 1-4 on the standard IRQ's - COM1/COM3 = IRQ4 and
COM2/COM4 = IRQ3. If you wish to use a non-standard IRQ, add the IRQ
number after the configuration filename. Let's assume your Door is
called FOOBAR and you want to use COM1 and IRQ5. The command line
passed to your Door would be:
    FOOBAR FOOBAR.CFG /5  or
    FOOBAR FOOBAR.CFG /%IRQ%  for the environment variable.
The /5 tells DoorFrame to use IRQ5 rather than the standard IRQ4 that
is normally used with COM1. No /x parameter is needed for the standard IRQ's.

When specifying the location of the system file on line 1 of the doors .CFG
file, you may use the environment variables %pcbdrive%, %pcbdir%, %pcbnode%,
and %wcnodeid%. Some examples:
 PCBoard: 
   USERS.SYS in C:\PCB           - %pcbdrive%%pcbdir%\USERS.SYS
   USERS.SYS in C:\PCB\NODE1     - %pcbdrive%%pcbdir%\NODE%pcbnode%\USERS.SYS

 Wildcat!:
   USERINFO.DAT in C:\WC\NODE1   - C:\WC\NODE%wcnodeid%

Non-PCBoard systems may use the PCB environment variables by setting them
in either AUTOEXEC.BAT or in the batch that runs the door. For example:
 SET PCBDRIVE=C:
 SET PCBDIR=\BBSDIR
 SET PCBNODE=1

     If you have registered FW, you may use the enclosed WISHWELL.CAT
file and change the default file categories.  The file must be a
straight ASCii file containing 22 lines with only 1 category per line.
The file that is included in this archive contains the defaults that are
written into the software.


DOOR.BAT

@echo off
cd \door\wishwell
WWELL WWELL.CFG

     If you are running a multi-node setup, you will need to create a
CFG file for each node.  Be sure to give each one is own specific name.

     WWELL1.CFG     WWELL2.CFG     WWELL3.CFG

     You may also use the environment variables explained above and run
only 1 CFG file that will work on all nodes.

REGISTRATION:

     Registration entitles you to free upgrades and any utilities that
are written for this door.   Updates may be downloaded from The Parole
Board BBS.  Voice support is also available by calling (919) 965-3600
before 9:30pm EST.  I am not available after this hour.  Please do not
call.

CREDITS:

     A very special thanks to my wife Brenda.  Without her patience, I
     would never accomplish what I have achieved.

     A fantastic BETA crew.  They picked out a lot of bugs.

     File Wishing Well II is written using MicroSoft Visual Basic for
     MS/DOS v1.0 (Pro Version)

     This program is dedicated to the memory of Robert A. Park.  A close
     friend and fellow SysOp.  The original File Wishing Well was his
     idea.  May Gob Bless and keep him.

