wcDoit! v1.0  A Message Posting Utility
For WildCat v4.01
Written in wcCODE v4.01 
By: Leon Krzyzanowski


FREEWARE
You may freely distribute, upload or make available for download this archive 
in its original archive form. 

Also, you are free to use and modify the source code for prelog.wcc in any way 
that you so desire.  If you do alter the programs, the source code or the 
documentation in any way you cannot distribute, upload or make available for 
download the altered programs, source code or the documentation using my Name 
or the name wcDoit!.  

DISCLAIMER:
These programs are provided "AS IS" without warranty of any kind. The entire 
risk as to the results and performance of these programs is assumed by you.   
I the author and anyone who distributes these programs do not warrant, 
guarantee, or make any representations regarding the use of the programs or
the results from the use of the programs.   If you use these programs you do
so at your own risk.  I the author and anyone who distributes these programs
cannot accept and will not accept responsibility for system damage, loss of 
profit, or any other special, incidental, or consequential damages resulting 
from the use or inability to use these programs.  

YOU ARE FORBIDDEN TO INSTALL THESE PROGRAMS ON ANY COMPUTER AND YOU ARE 
FORBIDDEN TO USE THESE PROGRAMS IF YOU CAN NOT ACCEPT THE TERMS OF THIS 
DISCLAIMER NOTICE.

WHAT IS wcDOIT! v1.0:
wcDoit! is a wcCODE message posting utility for WildCat v4.01 that will send
a text message to every user in one security level that you specify.  It was
written for the purpose of sending a text file to a newuser before that user
logs on to a BBS for the second time.  It has an option to attach a file to
every message that it sends to the specified security level.  wcDoit! will 
change the security level of the newuser to any security level you choose
and it will set their expiration date (if you wish to do so).  It will send 
either a public or private message to the conference of your choice.  I wrote 
this wcCODE program to be run from prelog.wcx.  It's ideal for sending a 
Welcome Back message to a newuser before their second call to your BBS with a 
file attached (if you wish to do so) for downloading.  wcDoit also maintains 
a log of the messages sent and an error log.

FILES INCLUDED:
Desc.sdi      - Short description of wcDoit!
File_id.diz   - Long description of wcDoit!
Hiagain.txt   - Sample text file message
Prelog.wcc    - wcCODE v4.01 source code file for the program prelog.wcx
Prelog.wcx    - Prelog.wcx program file compiled with wcCODE v4.01 
wcDoit!.cfg   - wcDoit! configuration file
wcDoit!.txt   - This file that you are reading
wcDoit!.wcx   - wcDoit! program file compiled with wcCODE v4.01
wcDoit!.his   - wcDoit! History file

FILES CREATED BY wcDoit!:
wcdoit!.log - This is a log of the messages sent.
              You can periodically delete the text in this file to reduce the
              size of the file.  You can also delete this file.  It will be
              created again the next time a message is sent.
wcdoit!.err - This is the wcDoit! error log.
              You can periodically delete the text in this file to reduce the
              size of the file.  Hopefully there will be none to delete. <g>
              Or you can delete the file.
OHOH!.txt   - This is a temporary text file that is created and sent to the
              Sysop if the file wcDoit!.cfg does not exist in WildCat's home
              directory.  The file is deleted when the wcDoit! program ends.


DECISION MAKING TIME & INSTALLATION:
You must decide which way you want to install wcDoit!.   

IF YOU DO NOT HAVE prelog.wcx installed for WildCat v4.01 you can do the
following:  
    
    INSTALLATION:
1.  Unzip the archive into WildCat's home directory.
2.  Edit the wcDoit!.cfg file.(See wcDoit!.cfg section below.)    
3.  Installation is complete.

IF YOU DO HAVE a prelog.wcx file installed for WildCat you can do the 
following: 

    INSTALLATION:
1.  Unzip the archive into a temporary directory.
2.  Edit YOUR EXISTING prelog.wcc file with wcCode v4.01 by copying the
    contents of the prelog.wcc file included with this archive, recompile it,
    and copy the newly compiled prelog.wcx into WildCat's home directory.
3.  Edit the wcDoit!.cfg file and copy it into the WildCat home directory.
    (See wcDoit!.cfg section below.)
4.  Copy the wcdoit!.wcx file to WildCat's home directory.
4.  Installation is complete.


wcDoit!.cfg:
This file MUST EXIST in WildCat's home directory or a message will be sent to
the SysOp EVERY TIME someone logs on the BBS until the problem is corrected.

These are the options that you can change in the configuration file.  Do not
change anything to the left of the equal(=) sign.  Only change the options on
the right side.  Letters do not need to be caps.  All data MUST be entered in
the first position after the equal sign. 


CONFERENCE=1
PUBLICPRIVATE=YES
OLDSECLEVEL=NEWUSER
NEWSECLEVEL=VISITOR
MSGFROMWHO=SYSOP
MSGSUBJ=Welcome Back Again!
MSGTOSEND=c:\wildcat\text\hiagain.txt
MSGATTACHMENT=c:\wildcat\xfers\free\mybbs.zip
NUMOFDAYS=14

HOW TO CONFIGURE wcDOIT!.CFG:

CONFERENCE
Enter the conference number where you want the message to be posted.  If you 
leave this option blank the message will be sent to WildCat's default 
conference which is conference 0.  The message will be sent as private or 
public mail depending on how you have configured the PUBLICPRIVATE option in 
the wcDoit! configuration file.

PUBLICPRIVATE
Enter YES for private message or enter NO for public message.  Please note
that this option will override whatever you have configured the conference 
for in the MakeWild program.  It will send private mail to a conference that 
does not allow private mail in MakeWild.  If you leave this option blank it
will be sent as public mail.

OLDSECLEVEL
THIS OPTION MUST BE ENTERED.  Enter the security level of the user that you 
specified in the MakeWild program for a newuser.  If you leave this blank an  
error message will be logged in the wcdoit!.err file and the wcDoit! program
will terminate.

NEWSECLEVEL
THIS OPTION MUST BE ENTERED.  Enter the new security level you wish the user 
to be changed to.  The security level you enter MUST EXIST in MakeWild or the 
security level of the user will be changed to a level that DOES NOT EXIST.  
If it does not exist in MakeWild the user will not be able to log on.  If you 
leave this blank an error message will be logged in the wcdoit!.err file and 
the wcDoit! program will terminate.

MSGFROMWHO
Enter the name of the person sending the message.  You can enter a person's 
name here or you can enter the word SysOp.  You may enter a person's name here
even if the person does not exist in the user record.  If you enter the word 
SysOp here, the name of the SysOp configured in MakeWild will be used. If you 
leave this option blank the message will be from the WildCat Mail Room.

MSGSUBJ
Enter the subject of the message that is being sent.  If this option is left 
blank the subject will be "Welcome Back Again!"   

MSGTOSEND
THIS OPTION MUST BE ENTERED. Enter the path and name of the text file to be 
sent to the user.   If the text file does not exist or you leave this blank 
an error message will be logged in the wcdoit!.err file and the wcDoit! 
program will terminate.

MSGATTACHMENT
Enter the path and name of file to be attached to the message.  You may 
leave this blank if you do not wish to attach a file to the message.  If the
file attachment does not exist an error message will be logged in the 
wcdoit!.err file and the wcDoit! program will terminate.

NUMOFDAYS
Enter the number of days that the user will have until the new security 
level expires.  The new expire date will be the number of days you specify
added on to the current date of the day the message is sent to the user.
If you leave this option blank, or use a 0, there will be no change to the 
user's expiration date.

ERROR CHECKING:
I spent a LOT OF TIME checking to ensure that this program runs as it was
intended to run.  However, if any errors are detected or you need any help 
setting wcDoit! up please feel free to contact me.  I will try my best to 
help you out.  

I can be contacted via:

Name: Leon Krzyzanowski
CompuServe: ID# 74357,1436

I also frequent MSI's BBS usually every weekend to check out what's new. I am
currently setting up my WC and I am a very patient fellow.  I refuse to open
her up until I have completely satisfied myself that everything is set up the
way I want it to be.  That is why I can only be contacted at CompuServe & MSI 
at this time.     

IN CLOSING:
If enough interest is shown in this program and if I receive some ideas
from you SysOp's on how to further enhance this program you will most likely 
be hearing from me again.  This is a simple program and some of it's features 
can be accomplished by other means.  I wrote this program to help myself
learn the wcCODE language and to provide an alternate way of doing things.
I also feel that this program may be of some use to some of you out there
who do not have wcCODE.
 

Thank You,
Leon Krzyzanowski
