WinCIS Utilities (a.k.a. WCUTIL) version 1.0
(c) Guy Gallo
71171,3555

________________________________________________________________
INTRODUCTION

WCUTIL is an add-on for WinCIS that implements several features:

        *	Adding multiple addresses to e-Mail (either new or 
                existing) messages
        *	Uploading files to forums
        *	Special message requests

In addition to these major functions, WCUTIL also provides:

        *	A hook to a "front end" script
        *	A configurable billing script
        *	Conversion of  MOX files into files readable using the 
                built-in WinCIS message reader and 
        *	The creation of shadow forums to hold saved messages
        *	Menu items to easily edit several of WinCIS's support 
                files (button files, INI files etc.)
        
There is no printed or printable manual.  The help file is the manual.

WCUTIL uses a combination of script generation controlled by a 
stand-alone visual basic application and a modified script template 
(named, by default, WCUTIL.TPL) to perform various on-line 
processing.

________________________________________________________________
REGISTRATION

WCUTIL is not free.  It is being released as ShareWare.  If you 
continue to use WCUTIL, please register and pay the $19.95 fee.
This is a one time registration fee.  That is, future updates to the 
program (barring a revision more major than any I foresee), will be 
free.

Since this program is specifically used for logging onto CIS (with 
WinCIS), there will be no support other than via CIS;  and there will 
be no disk based version of the program.  That is to say, since I can 
assume all users can log onto CIS, all support will be provided either 
via e-Mail or (preferably) in the WinCIS section of  the WUGNET 
forum;  and all updates will be posted to Library 13 of the WUGNET 
forum.

All registration will be handled on-line, via CIS's SWREG function.
To register, Select Script.Remain On-line to stay on-line after your 
automatic session is done, or log onto CIS using the Interactive button.  

At the command prompt type 

        GO SWREG

and follow the on screen instructions.

**********THE REGISTRATION NUMBER FOR WINCIS UTILITIES IS:  1143*************

INSTALLATION
________________________________________________________________

        WCUTIL.EXE must be in the same directory as WINCIS.EXE.

        WCUTIL.INI must be present and in the same directory as 
        WCUTIL.EXE.

        WCUTIL.TPL is a script template containing the various script 
        instructions necessary to utilize the on-line features of WCUTIL.EXE.  
        You must either make this TPL your active template or copy this file 
        to WINCIS.TPL.  It makes no difference which you do.
        
        To set WCUTIL.TPL as the active template select:
        
                 Settings.Processing Options.Template to Build Scripts from
                 
        and enter WCTUIL.TPL in the edit box.
        
        WCUTIL.HLP should also be copied to your WinCIS directory.


________________________________________________________________
ASSUMPTIONS

WCUTIL makes the following assumptions.

        *	That you are using the default installation regarding 
                directory structure:  control files are in 
                C:\WINCIS\CONTROL, and all messages are stored in 
                C:\WINCIS\MESSAGES.
        *	That the file paths contained in your CFG file and in 
                WINCIS.INI are hard coded directories rather than 
                variable directories.  That is to say, you are not using the 
                variable method of pointing to a directory, such as 
                &WinCISPath\CONTROL, but are specifying directories 
                with their full path name, e.g. C:\WINCIS\CONTROL.
        *	Version 1.0 of WCUTIL assumes that you are using 
                WinCIS .94D.  WCUTIL will work with version .94C, 
                but not properly.  Specifically, the Special Request 
                Function is significantly hampered.


________________________________________________________________
HOW TO USE

Simply run WCUTIL before logging onto CIS to modify mail (add 
CCs), add new mail, specify files to upload to a forum, or add special 
message handling requests to the next run.

There are two possible cases to consider when running WCUTIL:

1) WCUTIL is run and its options selected before loading WinCIS:
In this case, selecting either of the functions which require that a 
forum be "active" in order for the custom script to be executed, will be 
marked by WCUTIL in STATUS.INF for "read waiting messages".  
The effect of this is that when you load WinCIS it will read 
STATUS.INF and the forum activities selected in WCUTIL will be 
executed when those forums are entered by logging onto CIS with the 
Actions button.  You will see Messages(Waiting) activated in the 
forum list.

2) WCUTIL is run and its options selected after loading WinCIS:
In this case, the marking of a form as active (as described above), will 
not be "registered" by WinCIS.  I hope to make the connection 
smarter, with Larry's help, in a future release.  For the time being, you 
have one of two choices:

Manually change any processing option for the forum you want to 
process with a WCUTIL script.

or

Logon to CIS using the Messages button rather than the Actions 
button.


COMMAND LINE OPTIONS
________________________________________________________________
By default, WCUTIL loads all three of the modules.  

You can load WCUTIL with a specific module by specifying any one 
of the following keywords on the command line:

        UPLOAD - Loads only the forum upload function
        MAIL   - Loads only the mail function (also loads the address 
                book)
        REQUEST- Loads only the message request function (also 
                loads the address book)

Even if you load WCUTIL with a command line option (and therefore 
initially display only one of the modules) you can always activate the 
other modules by selecting them from the Tools menu.


CAPTURING FORUM ANNOUNCEMENTS
________________________________________________________________
Code to capture forum announcements has been included in the WCUTIL.TPL
template, but it is, by default, commented out.

If you wish to capture forum announcments with every entrance to a
forum, edit WCUTIL.TPL, look for the [GO FORUM] section, and read the
comments.


REACHING THE AUTHOR
________________________________________________________________

CIS 71171,3555
Message can be left in section 13 of the WUGNET forum.

This is the initial release of WCUTIL.  I suspect that the program will
continue to evolve.  All suggestions are welcome.

Among the planned features for future versions:

        Closer ties to WinCIS
        Additional Scripts under the Scripts.Build Option
        
If you have a script or TPL modification that you think would improve
the smarts or performance of WCUTIL, please send via e-Mail to the
above CIS ID.
