                                   UMFU
                     UniNova's Mail Forwarding Utility
              Copyright 1997 by UniNova Services Corporation

This manual is intended to be read on-screen.  It does not have page
formatting, so if you decide to print it (although this should not be
necessary), you may wish to load it into a text editor or word
processor that will properly split it into pages.

*** NOTICE ***
  Your use of this software on your system legally implies that you have
  read and agreed to the section entitled LICENSE AND DISCLAIMER.  If you
  do not agree with the terms of that section, remove the software from
  your system immediately.

INTRO
-----
Thank you for taking a look at UMFU.  It's a very simple program to use,
and provides you with an easy method to forward mail addressed to certain
local users to alternate addresses.  UMFU makes an excellent addition to
your regular maintenance runs.  Written in wcCODE, it is only for use with
Wildcat! 5.  Even sysops who have wcCODE may want to register UMFU,
because the price is so low that their time to create their own version
would probably be worth more than the money spent registering it.

This program only processes mail in Conference 0.

INSTALLATION
------------
Copy the UMFU.WCX file into your Wildcat! directory.  Then, add a call to
wcRUN from your nightly maintenance (or other processing situation), using
this syntax:

wcrun -r umfu

Then, in your Wildcat! directory, create the file MSG_FWD.DAT which is
described in detail below.

EXAMPLE BATCH FILE SEGMENT
--------------------------
rem Process any mail that needs to be forwarded
echo Forwarding mail...
wcrun -r umfu

SPECIFYING FORWARDING ADDRESSES
-------------------------------
The file MSG_FWD.DAT in your Wildcat! directory (where you also placed
your copy of the UMFU.WCX file) specifies which users on your system have
their mail forwarded, and the address to which the mail should go.  The
format is simply one user per line, in the format:

local name > remote@address.net

There must be an account on your BBS with the name specified on the
left side of the > mark.  Also, the destination address can be another
BBS account, but the validity of local accounts is not verified.  Thus,
if you forward mail to a local BBS account that does not exist, you will
have a "dead letter."

Here is a sample MSG_FWD.DAT file, for a system that has the accounts
JANE DOE, MARK SMITH, and KAREN NERAK, all of whom need their mail
forwarded to another address:

Jane Doe > janeyd@somesite.net
mark smith > smithm@anothersite.net
KAREN NERAK > Karen Jones

As this sample suggests, addresses may be upper or lower case.

OPTIONAL PARAMETERS
-------------------
You may use the following command line parameters for the effects
described below.  The order of the command line parameters is not
relevant, as long as they all appear after the name of the .WCX
file being executed by wcRun.

/a - This turns on "accounting" mode.  In this mode, which is for
     REGISTERED USERS ONLY, the program will write out the original
     TO: address for each message forwarded.  This is written to
     a separate "accounting log" file, MSG_ACCT.LOG, which can then
     be sorted to help determine how many times each user has had
     a message forwarded.  If you are charging for forwarding, this
     will come in handy.  If enough people express interest in this
     feature, we will make it easier to use in the future.

/h - This suppresses the line that is appended to each forwarded
     message, which indicates the message was forwarded by UMFU.
     The ability to use this to turn off that line is for REGISTERED
     USERS ONLY.

/k - Kill attachments instead of forwarding them.  If used in
     conjunction with the /r parameter (see below), the original
     attachment is left alone, but the forwarded message will not
     have the attachment.  Without this option, attachments will
     be forwarded.  This is available to UNREGISTERED AND
     REGISTERED USERS.

/l - This option, which is available for UNREGISTERED AND REGISTERED
     USERS, will make the program write its activity log information
     to the WIN Server activity log for the node that UMFU logs in to.
     Without this parameter, UMFU continues to maintain its own log,
     as described in the next section.

/o - Original address display.  By adding this to the command line,
     each forwarded message will show (at the beginning, but not in
     the headers) what the original address was, prior to forwarding.
     This is available to UNREGISTERED AND REGISTERED USERS.

/r - Read, don't delete.  Use this option if you might want to go back
     later to read processed messages.  Normally, if this option is
     not used, UMFU will delete the original message after forwarding.
     However, there are times when this behavior is not correct, in
     which case this option can be used to mark the message as received,
     without deleting it.  This is available to UNREGISTERED AND
     REGISTERED USERS.

/v - If you wish for UMFU to make a log entry every time it runs, as
     it did in the original version, add this command line parameter.
     Otherwise, it will only write a log entry if it forwards at least
     one message.  This applies to UNREGISTERED AND REGISTERED versions.

ADDITIONAL FILES
----------------
The files MSG_FWD.AUX and MSG_FWD.LOG are maintained by UMFU.  They are
simply text files, and you may examine their contents at will.  

The file MSG_ACCT.LOG is only created by the registered version of the
program, and only if it is requested by using the /a command line parameter
to enable accounting mode.  This file will list each original address, each
time it is used for forwarding.  By using standard sorting tools, such as
the SORT utility in DOS, you can quickly determine how many times messages
were forwarded for each entry in your MSG_FWD.DAT file.

REGISTRATION
------------
Please use the file REGISTER.TXT to submit your registration.  The price
is $10 for orders outside Washington State.  For orders inside Washington
State, a 72-cent discount applies, so your price is just $9.28.  Of course,
there is a 7.7% sales tax to apply to Washington State orders, so your total
comes to $10.  Fancy that!

Your benefits of registration include:
     * You will receive a copy of UMFU that does not include the text in
       the forwarded message indicating it came from an unregistered copy.
       (Registered copies are delivered by Internet e-mail; or, you can
       call UniNova's BBS and arrange to pick up your copy there.)
     * You will be able to entirely remove the line at the bottom of each
       forwarded message that indicates it was forwarded by UMFU.
     * You will have the option to enable accounting mode, in case you
       want to charge for forwarding mail.
     * The program will no longer send you mail on every 100th use to
       remind you that the program is not registered.  It also will no
       longer attempt to send mail to UniNova on every 500th use to 
       provide usage counts.  (If you run UMFU once a night, these events
       will only happen approximately every three months and less than
       once a year, respectively.)
     * You can ask for, and actually get, technical support.  Technical
       support is provided by Internet e-mail or on UniNova's BBS.
     * You will have free upgrades to UMFU for the life of the product.

LICENSE AND DISCLAIMER
----------------------
THIS SOFTWARE, INCLUDING THE COMPILED CODE AND ALL SUPPORTING AND GENERATED
FILES, IS PROVIDED AS-IS, WITH NO WARRANTIES, IMPLIED OR OTHERWISE.  UNINOVA
SERVICES CORPORATION SPECIFICALLY DISCLAIMS RESPONSIBILITY FOR THE RESULTS OF
YOUR USE, MISUSE, OR INABILITY TO USE THIS SOFTWARE.  BY USING THIS SOFTWARE
ON YOUR SYSTEM, YOU AGREE TO ASSUME FULL RESPONSIBILITY, AND TO WAIVE ALL 
CLAIM AGAINST UNINOVA SERVICES CORPORATION, FOR ANY AND ALL DAMAGES THAT
MAY OCCUR, INCLUDING WITHOUT LIMITATION LOSS OF DATA, LOSS OF TIME, LOSS OF
BUSINESS, AND ALL OTHER DAMAGES.  LOCAL LAW MAY AFFECT YOUR LIABILITY.

This software is licensed, not sold.  At no time will you own the software;
your license is one of the following:

If you have paid the registration fee to UniNova Services Corporation, you
have a limited license to use the registered version of the software,
governed by the following terms:
     1.  You may make and use unlimited copies of the software on unlimited
         numbers of computer systems under your direct control within the
         confines of one location, defined for this purpose as a single
         building or cluster of buildings designed for a common purpose
         (e.g., a school campus).
     2.  You may not transfer copies of the registered version of the
         software to any third party, by any means, to include without
         limitation actions such as sale, trade, gift, or not making
         reasonable attempts to prevent theft or unauthorized copying.
     3.  You may request updates to the registered version of the software
         any time there exists a version newer than what you already have
         installed.
     4.  You may alter the software (there is nothing in copyright law
         to prevent you from doing so), but you may not distribute copies
         of the altered version (see #2 above).
     
If you have not paid the registration fee, your limited license is governed
by these terms:
     1.  You may make, and use, unlimited copies of the unregistered version
         of the software, for an unlimited time (subject to revocation; see
         below).
     2.  You may distribute unlimited copies of the unregistered version of
         the software, subject to these terms:
              a) no part of the distributed copies, including the
                 documentation, supporting files, or generated files,
                 may be altered in any way; and,
              b) you may not charge a fee solely for the software, but
                 there can be a materials, handling, or access fee for
                 the recipient, provided such fee does not exceed $10 if
                 the distributed copy of the unregistered version is the
                 only benefit for said fee.

These licenses may be negotiated, but UniNova has little incentive to waste
much time for said negotiation.  All licenses are limited to the extent that
they may be revoked at any time in the event that the terms of the license
are violated.  Violation of your license may be a violation of US copyright
law and international copyright treaties and agreements, and may subject you
to criminal prosecution.

CONTACTING UNINOVA
------------------
UniNova may be contacted by any of the following means:

Postal Mail:     UniNova Services Corp.
                 PO Box 900
                 Ellensburg WA 98926-0900

E-Mail:          Sales@UniNova.COM

WWW:             http://www.uninova.com

BBS:             (509) 962-3407
FAX:             (509) 925-3893
Sales:           1-888-UniNova
Other:           (509) 925-3894
                 (Regular business hours only.)

REVERSE HISTORY
---------------
1.50 -  1 OCT 1997: Changed the way the message conference is handled, to
                    ensure messages do not get missed as a result of
                    message packing.  Attachments are now forwarded, but
                    can be "killed" instead.  Added option to just mark
                    original messages as read, rather than deleting them.
                    Added option to show in the forwarded message the
                    original address.
1.10a (not a public release)
1.10 - 21 SEP 1997: New features added, including accounting mode, logging
                    to WIN Server log instead of separate log, and ability
                    to remove the "forwarded by" (credit) line.  Eliminated
                    logging of runs where no mail was forwarded, but also
                    gave option to have this again using verbose logging.
1.00 - 11 MAR 1997: Initial release.

THE END
-------
