

                       -------------------------
                             skLogon  (tm)
                             Version 1.00b
                A configurable logon processor in wcCode
                          for Wildcat! 5 BBS
                       -------------------------


                     (c) Copyright 1996-1997 skWare
                          All Rights Reserved

                              skWare (tm)

                   Steve Davies (steve@welcom.gen.nz)                      
                   Kevin Murphy (kevin@welcom.gen.nz)

*****  For technical support please email to skware@welcom.gen.nz *****

With Registration:-

- The registered version allows the sysop to add external .wcx routines
  such as (skFileDownload) to add extra features to the logon process.

It will work on a Wildcat 5 BBS Release version.

Do not try installing this software on a Wildcat 4 BBS.

                 Documentation version 1.00b 03/02/1997

* By using this software you agree to the terms of the Software License
Agreement and Disclaimer of Warranty. *

Contents
--------
1.  Overview
2.  Future Plans for skLogon
3.  Registration
4.  Files
5.  Detailed Installation Instructions
6.  Error Codes
7.  Bug reports and Enhancement Requests
8.  Software License Agreement
9.  Disclaimer of Software Warranty

10. Upgrading from 1.00a to 1.00b

1.  Overview
------------
skLogon is a program that allows the sysop to customise the logon process
without having to have or use wcCode.

2.  Future Plans for skLogon
--------------------------

    - Add a configurable file download function

3.  Registration
----------------
After you register skLogon you will find that:-

- The sysop is able to add external .wcx routines such as (skFileDownload)
  to add extra features to the logon process.

All that is required to register skLogon is that you print the file
register.txt, fill in the missing parts and send it and US$10 to:-

    skWare
    PO Box 9559
    Wellington
    New Zealand

Once we have received your registration request we will email you the
registration key. Please ensure that you have included your EMAIL
ADDRESS as required in our form. If you do not we will not be able
to send your registration key to you.

4.  Files
---------
The following files are included in the archive that you downloaded.

skware.txt             <--- important information about skWare
sysop.txt              <--- you are reading it now
history.txt            <--- the file that has notes about changes etc.
register.txt           <--- the file that has notes about registration
skLogon.wcx            <--- THE executable program
skLogon.reg            <--- Registration Code file
skLogon.cfg            <--- Configuration file
file_id.diz            <--- Long program description
desc.sdi               <--- Short program description
logon.wcx              <--- A Replacement for Mustang's logon routine
sk*.prm                <--- Prompt files
skware_std_prompts.txt <--- Description of standard prompts

5.  Detailed Installation Instructions
--------------------------------------

 NOTE: Please make sure your BBS is configured and running correctly
       before installing skLogon. A full system backup would also be
       a good idea.

- See section 10 about upgrading from 1.00a to 1.00b.

- Package Installation

    1 - Create a temp directory for skLogon where you wish. We suggest
        c:\wc5\skLogon or something similar.

    2 - Extract all the files from the archive into this directory.

    3 - Move the following files into the wildcat default directory
        (eg: c:\wc5)

        skLogon.wcx
        logon.wcx

    4 - Move the following files into the wildcat data directory
        (eg: c:\wc5\data)

        skLogon.cfg
        skLogon.reg

    5 - Move the *.prm files to your default language directory
        (eg. c:\wc5\language)

    6 - Modify the supplied sklogon.cfg to suit your needs.

        skLogon will process the programs in sklogon.cfg as they are
        read. skLogon supports the following WildCat! routines:-

        CheckForGroup
            Checks to see if caller's name matches one in GROUPx.LST file,
            and displays the corresponding GROUPx.BBS file if true.

        SayGoodSomething
            Displays the "Good morning", "Good afternoon", or "Good evening"
            message to the caller depending on the time of day.

        CheckQuesDate
            Compares caller's last logon date and time with QUESDATE
            questionnaire file, and executes questionnaire if it has
            been updated.

        CheckBirthday
            Checks to see if today is the caller's birthday and displays the
            BIRTHDAY.BBS file if true.

        CheckUserFile
            Checks for the existence of "u<user record number>.BBS" in display
            file directory, displays it if found, then deletes the file.

        ShowHelloFiles
            Shows the standard "hello" files when a caller logs on.

        CheckNewsletter
            Compares caller's last logon date and time with newsletter file
            date, and prompts caller to read newsletter file if it has been
             updated.

        CheckBulletins
            Check for new bulletins

        QuoteOfTheDay
            Display a quote from the Quote-of-the-day file.

        CheckMail
            Checks for new mail for the current user.

        The order of the above routines is the order in which the normal logon
        routine processes these routines.

        skWare has also added the following routines by popular demand.

        list_new_files
            This will start the "List new files" dialog when the user logs
            onto the system.

        Once skLogon is registered, if it encounters a program other than
        one of the above it will assume that it is a .wcx and run it.

        Please note the format of sklogon.cfg as described in sklogon.cfg

6. Error Codes
--------------

The errors produced from skLogon are self explanatory you will find
a list below:-

    ERR01   - Could not open configuration file. It must be in the
              wildcat data directory (ie. c:\wc5\data)

    ERR02   - Could not open registration file. It must be in the
              wildcat data directory (ie. c:\wc5\data)

    ERR08   - Contact skWare if this error occurs.

7. Bug Reports and Enhancement Requests
---------------------------------------

- Bug Reporting

    - When reporting a bug please include the following information and
      email to us at skware@welcom.gen.nz.

        - Operating system and version
        - Version of Wildcat 5
        - Details of any LAN (eg: are files on a NetWare 3.11 server)
        - Description of problem
        - Description of the installation that you have done
        - Your email address
        - Any other relevent info

    - If you want to fax the bug report then send an email to the
      following email address skware@welcom.gen.nz requesting the
      fax number. We have had to do this as the fax number is currently
      in a state of flux and will change from what it is now.

- Enhancement Requests

    - If you have an idea or request for an enhancement please send an
      email to skware@welcom.gen.nz. While all such requests should
      be acknowledged as received within 48 hours we can not state that
      they will be accepted for a further release.
    
    - We are always ready to discuss any customisation requirements that
      you may have. For further information send an email to
      skware@welcom.gen.nz with a brief description of your
      requirements.
    
    - For faxes please see the Bug Reporting section about our fax
      number.

8.   SOFTWARE LICENSE AGREEMENT
-------------------------------
This software is LICENSED not sold.

 You may:
 --------
 (1) Make as many backups as you see fit to protect your investment.
 (2) Use this software on a single BBS for a 30 day trial period, after 
     which it must be registered.  If you run more than one BBS you must
     register additional copies of this software.
 (3) Distribute copies of the unregistered version of this software as
     long as all of the original files (listed in section 4) are included
     and are unaltered.
 (4) If you distribute this software on some sort of collection cd or
     diskette Thanks! All that we ask is that you send an email to
     skware@welcom.gen.nz so that we can ensure that you have the
     latest version and that we can update our records on how our
     software is distributed.

 Besides the above rights you have no other rights to the software,
 implied or otherwise.

 You may NOT:
 ------------
 (1) Reverse-Engineer, Decompile or Alter the software in any way.
 (2) Rent, Lease or Lend the software that you have registered.
 (3) Give out or let anybody use your software activation code.

 If you breach this License Agreement, skWare will terminate your
 license and all software must be de-installed from your system(s) and
 use of the software must be terminated.

9.  DISCLAIMER OF SOFTWARE WARRANTY
-----------------------------------

 THIS SOFTWARE PRODUCT IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND.
 THE ENTIRE RISK AS TO THE RESULTS AND PERFORMANCE OF THIS SOFTWARE IS
 ASSUMED BY YOU (NOT skWare). skWare DOES NOT WARRANT, GUARANTEE, OR
 MAKE ANY REPRESENTATIONS REGARDING THE USE OF, RESULTS OF,
 MERCHANTABILITY OR FITNESS FOR A PARTICULAR USE OF THIS SOFTWARE.
 SHOULD THE SOFTWARE PROVE DEFECTIVE, YOU (NOT skWare) ASSUME THE ENTIRE
 COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION EVEN IF skWare
 HAS BEEN NOTIFIED OF A DEFECT(S). skWare DOES NOT WARRANT, GUARANTEE,
 OR MAKE ANY REPRESENTATIONS REGARDING THE USE OF, OR RESULTS OF THE USE
 OF THE SOFTWARE IN TERMS OF CORRECTNESS, ACCURACY, RELIABILITY, OR
 OTHERWISE. YOU RELY ON THE SOFTWARE AND RESULTS SOLELY AT YOUR OWN
 RISK. skWare WILL NOT BE LIABLE FOR ANY DAMAGES, INCLUDING BUT NOT
 LIMITED TO SYSTEM DAMAGE, SERVICE, REPAIR, CORRECTION, LOSS OF PROFIT,
 LOST SAVINGS, OR ANY OTHER INCIDENTAL, CONSEQUENTIAL, OR SPECIAL
 DAMAGES OF ANY NATURE WHATSOEVER RESULTING FROM THE USE OR THE
 INABILITY TO USE THIS SOFTWARE.

 THE DISCLAIMER OF WARRANTY SHALL BE GOVERNED BY THE LAWS OF NEW
 ZEALAND.

========================================================================

          Copyright (C) skWare 1996-1997, all rights reserved

    skLogon is a trademark of skWare.
    skWare is a tradmark of skWare.

    WildCat! is a trademark of Mustang Software Inc.

    Other products and corporate names may be trademarks or registered
    trademarks of other companies, and are used for illustrative
    purposes only, and to the owners benefit, without an intent to
    infringe.

========================================================================

10. Upgrading from 1.00a to 1.00b
=================================

All that is required to upgrade from 1.00a to 1.00b is:-

1.  Replace your current sklogon.wcx with the one supplied in the new
    archive.

2.  Delete the sklogon.dat file in your wildcat data directory. (ie.
    delete c:\wc5\data\sklogon.dat.


