
                           WCALLFIX VERSION 1.00

                          THE WILDCAT FILE FINDER

                           WRITTEN BY P. DINGLEY

 COPYRIGHT (C) ALL RIGHTS RESERVED P. DINGLEY AND RIVENDELL BBS (UK) 1995-1997

 The latest version of this program can be downloaded from Rivendell BBS.
-----------------------------------------------------------------------------
License and Disclaimer
----------------------

     "WcAllFix" refers to all executables and documentation as distributed
     in the compressed file in which the program was released.

     * All mentioned program names or trademarks are the properties of the
       respective owner(s).

     * WcAllFix is copyrighted by Paul Dingley.
       It may only be used in agreement with the conditions pointed out in 
       this license agreement.

     * WcAllFix is released as shareware.
       You may use WcAllFix for an evaluation period of thirty (30) days.
       After this period you must either register WcAllFix or stop using it.

     * Registration is required for any use in a commercial environment.

     * WcAllFix may be distributed freely in the original package provided
       no money or any other compensation is asked or accepted without prior
       written permission from Paul Dingley.

     * WcAllFix is provided as is, without warranty or guarantee of any kind,
       the only warranty I can give is that WcAllFix will use disk space.

     * In no event shall I Paul Dingley be liable to you or anyone
       else for any damages, cost or lost income which may be the result from 
       the use or inability to use WcAllFix.

     * In no way is Paul Dingley obligated to you or anyone else to provide
       future versions of or support for WcAllFix

     * Registered users are registered for this release and all future
       releases of WcAllFix

-----------------------------------------------------------------------------
INTRODUCTION

    WcAllFix was written to fill a gaping hole in the Wildcat 5.0 based
    systems that connect to either Fidonet, or any other FTSC compatible
    echomail based network.

    WCALLFIX is a Wildcat file finder which processes echomail file search
    requests, searches through the Wildcat! file database for matching files
    and then posts an echomail message back to the originator detailing the
    results of the filefind operation.

    For Example
    If WcAllFix reads Echomail conference number 10 in Wildcat and
    finds the following message:

         FROM: John Smith
         TO:   ALLFIX
         SUBJ: /TELIX

    It will generate a reply message to the original poster with a list
    of files found in the file database which matches the string found
    in the message subject line such as:

        Greetings,

        Here are the results of your recent search for files posted
        by WcAllFix.

        BBS Name        : Rivendell BBS (UK)
        Fidonet         : 2:2503/221.0
        Phone Number    : +44-1623-558988
        Location        : Nottingham, UK
        Times           : 06:00 - 24:00
        Freq            : All files freqable
        Access          : Full access to files on first call.
        Total Files     : 41625
        SysOp           : Paul Dingley
        ---------------------------------------------------------------------
        ZOCBK104.ZIP   20k Zoc Phone Book Converter From Telix
        ZAPFON05.ZIP   11k Telix Phone Directory Management
        ZAPFON05.ZIP   11k Telix Phone Directory Management
        XHOST20S.ZIP  172k Run A Full Featured BBS With This
        UKBBTELB.ZIP   25k TELIX format Directory of 700 UK BBs - ver 11
        UKBBTELB.ZIP   25k TELIX format Directory of 700 UK BBs - ver 11
        TX321FIX.ZIP   57k Patch File For Registered Versions of Telix
        HOST32.ZIP     22k Telix 3.11 host mode with ANSI graphics!
        ---------------------------------------------------------------------
        Rivendell BBS (UK)
        41625 files available in 5GB.
        +44-1623-558988 (06:00 - 24:00)               2:2503/221
        00:00 - 06:00 Mail Only.
        File Requests Acceptible
        --------------------------------------------------------
            WcAllFix for Wildcat by P. Dingley, Rivendell BBS (UK)
            Rivendell can be contacted on +44-1623-558988 2:2503/221
            This Version limited to 15 matches
        --- Report Created by WcAllFix 0.17 (UNREGISTERED)

    Within this message, the header and trailer are fully user
    configurable.  Registered users may also alter the number of files
    that WcAllFix will search for.

    WcAllFix is *NOT* a file echo processor, and is not related or associated
    with the excellent 'ALLFIX' program by Harald Harms.



-----------------------------------------------------------------------------
INSTALLATION

 1. Place the following files into either the main Wildcat 5/WINS directory
    or into a directory called 'WCALLFIX' below the main Wildcat directory.

    WCALLFIX.WCX

 2. Assuming that you have Wildcat installed in the default C:\WC5 directory,
    place the following files into the C:\WC5\WCALLFIX directory.

    WCALLFIX.HDR
    WCALLFIX.TLR
    WCALLFIX.CFG

    If you have Wildcat installed in a different directory, or on a different
    drive, replace C:\WC5 with the structure that points to your Wildcat home
    directory.
   
    If this directory is network-sharable all nodes that will be used to 
    execute the program must have Read/Write/Create/Delete/Execute access 
    to this directory.

 3. Edit the WCALLFIX.CFG file to reflect your own BBS configuration.
    Each configuration item is preceeded by a keyword.  Semicolon characters
    are comments.  The keywords are:

    REGISTERED_TO    - The name that WcAllFix will report itself registered
                       to when it finds a valid registration key.
    REGISTRATION_KEY - The WcAllFix registration key.  This key is generated
                       by myself if/when you register WcAllFix.
    WCALLFIX_NAME    - The name WcAllfix will look for in filefind messages.
    WCALLFIX_CONF    - The echomail conference WcAllFix will process.
    WCALLFIX_NODE    - Your FTSC network node number.

 4. Edit the WCALLFIX.HDR amd WCALLFIX.TLR files.  These are the Header and
    Trailer files that will be used to create the body of any messages that
    are generated by WcAllFix.

    Three Wildcat! @ macros can be used within either of these files.

    @BBS@   - The name of your BBS as it appears in MakeWild.
    @SYSOP@ - The BBS SysOp's name as it appears in MakeWild.
    @TFILE@ - The total number of files on the BBS.

-----------------------------------------------------------------------------
OPERATION

    Operation couldn't be simpler, since the program can be run via one
    of two methods.

    Initially I'd recommend that it's run manually by creating a menu
    option available only to the SysOp, which is used to run WcAllFix.

    Key   F
    Desc  F...........WcAllFix
    Type  Run WcCode Program
    Name  E:\WC5\WCALLFIX.WCX     <- Change this to point to your path.

    The second option, once you are happy with it's operation is to run it
    as a scheduled event, either within Wildcat, or from the front-end mailer.

    If using the Front-End mailer option, setup a daily event which exits with
    an errorlevel, then in the controlling batch file trap the errorlevel,
    and execute the following command to run WCALLFIX.

    E:\WC5\WcRun -r E:\WC5\WCALLFIX

    WcAllFix will search for echomail messages in the speficied conference
    which are addressed to the name you have specified in the configuration
    file.

    Each message it finds that is not addressed to the specified name will
    be marked as 'Read', and ignored.

    When it finds a message to the specified name, it will search the
    Wildcat files database for any matches against the contents of the
    message's subject line.

    If any matches are found, an Echomail message will be generated in the
    same conference.  It will be addressed back to the original message sender,
    and will list each file-match.

-----------------------------------------------------------------------------
LIMITATIONS

    This EVALUATION version is limited to finding the first 15 matches.
    The registered version is fully configurable and not limited in this way.

    Only short descriptions are displayed in the find results.

    Search requests containing "AND", "OR", "NOT" or the characters "&" and 
    "|" are ignored, due to the Wildcat searching algorithm, thus /HAND is a
    valid search, whereas /"HAND AND WRIST" isnt.
-----------------------------------------------------------------------------
REGISTRATION
------------

    If you find WcAllFix useful, and/or wish to continue using it after the
    initial 30-day evaluation period, I ask you to please show some
    consideration for the time and effort I've put into the program by
    registering it.

    To Register WcAllFix, complete the registration form below, and send it
    along with a cheque, bankers draft, money order, or Postal Order for the
    sum of 10.00 Sterling, or $15.00 USD made payable to 'Paul Dingley' to
    the address below:

    Mr Paul Dingley.
    WcAllFix Registration
    20 Homewood Drive,
    Kirkby-In-Ashfield
    Nottingham
    NG17 8QB
    England.

-----------------------------------------------------------------------------
REGISTRATION FORM
-----------------

    Your Personal Details

    First Name        : _____________________________________________

    Last Name         : _____________________________________________

    Sex               : [Male / Female]

    Business Name     : _____________________________________________

    Email Address     : _____________________________________________

    Fidonet Netmail   : _____________________________________________

    Please include the full name below as you want it to appear on any
    registration information messages:

    Registered To     : _____________________________________________

    Your Postal Address Details

    Street Line 1     : _____________________________________________

    Street Line 2     : _____________________________________________

    Town              : _____________________________________________

    City              : _____________________________________________

    County / State    : _____________________________________________

    Postal / ZIP Code : _____________________________________________

    Country           : _____________________________________________

    Voice Phone Number: _____________________________________________

    Data Phone Number : _____________________________________________

    Registration Costs:  Personal or Non Commercial Use
                         1 License : 10.00 GBP or $15.00 USD

                         Business or Commercial Use
                         1 License : 10.00 GBP or $15.00 USD

    Your personalised registration key will be generated when this completed
    form is received along with payment.  The Key will be a case-sensitive
    string of alphanumeric characters, which will be shipped as a file along
    with your registered name.
    
    How do you wish to receive your key ?

    [ ] Sent to the above Fidonet address via Netmail.
    [ ] Sent to the above Internet Email address.
    [ ] Sent on disk via SnailMail to the above address.

    Please complete this form, and send it with the appropriate payment to:

    Mr Paul Dingley.
    WcAllFix Registration
    20 Homewood Drive,
    Kirkby-In-Ashfield
    Nottingham
    NG17 8QB
    England.


-----------------------------------------------------------------------------
HISTORY
-------
    0.01 - WcAllFix first written to operate at Rivendell as a test only.
           All configuration options hard coded.
           First 25 matches reported.

    0.02 - Configuration file added.
           Match limit raised to 50.

    0.05 - Added option to move all files out of Wildcat home directory.
           Match limit raised to 100.
           Changed search algorithms to look for more than the first keyword.

    0.06 - Configuration file structure changed to allow keywords.

    0.07 - Squished a bug that prevented WcAllFix from deleting old
           response messages.
           Added limited @macro support

    0.08 - 0.16 Unreleased Trial Versions.

    0.17 - First Test Release version for Wildcat 5.0.

    0.18 - Feature set approaching finalisation prior to release.
           Registration key used to unlock 15-limit file searches.
           WcAllFix directory re-located.  It should now reside below the main
           Wildcat 5.0 / WINS directory.

    1.00 - Implemented MAXFILESFOUND keyword.
           Tidied up registration key routines.

-----------------------------------------------------------------------------
THE FUTURE
----------

    A number of enhancements are planned to WcAllFix for the future, including
    amongst other things more customisable options, and version 2.0 is already
    under development.  I reserve the right to alter the licensing price of
    any future versions of WcAllFix, however future versions will be free to
    all registered users.


