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


FREEWARE
You may freely distribute, upload or make available for download this archive 
in its original archive form.(Vendors/Distributors See the file Vendor.txt) 

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.

NEW IN wcDoit! v1.10:
wcDoit! now sends a PRIVATE message to the Sysop that a newuser called 
the BBS for the first time.  The message will be posted in the conference of
your choice which is configured in the wcDoit!.cfg file.  The message will 
include the newuser's name, date & time of the call, security level, company,
address & phone #'s. (See SYSOPCONFERENCE below for configuration details)

WHAT IS wcDoit! v1.10:
wcDoit! is a wcCODE message posting utility for WildCat v4.10 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 sends a
message to the Sysop and maintains a log of the messages sent and an error 
log.


FILES INCLUDED IN THE wcDoit! v1.10 ARCHIVE (File Name:DOIT!110.ZIP)
Desc.sdi      - Short description of wcDoit! v1.10
File_id.diz   - Long description of wcDoit! v1.10
Hiagain.txt   - Sample text file message
Packing.lst   - Text file with list of files in the wcDoit! v1.10 ARCHIVE 
Prelog.wcc    - wcCODE v4.10 source code file for the program prelog.wcx
Prelog.wcx    - Prelog.wcx program file compiled with wcCODE v4.10 
Vendor.txt    - Text file about distribution of wcDoit! v1.10 
wcDoit!.cfg   - wcDoit! v1.10 configuration file
wcDoit!.txt   - This program documentation file that you are reading
wcDoit!.wcx   - wcDoit! v1.10 program file compiled with wcCODE v4.10
wcDoit!.his   - wcDoit! History file

FILES CREATED BY wcDoit! v1.10:
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.
SYSDOIT!.txt- This text message is created in WildCat's home directory and 
              sent to the Sysop after the new user has called.  It is over-  
              written each time a message is sent to the Sysop.

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


UPGRADING FROM VERSION 1.0 TO VERSION 1.10:
If you are upgrading form wcDoit! v1.0 you should:
1.  Replace wcDoit!.wcx from version 1.0 with wcDoit!.wcx from version 1.10. 
2.  Print out your existing wcDoit!.cfg file.  Replace wcDoit!.cfg from
    version 1.0 with wcDoit!.cfg from version 1.10.  Then edit wcDoit!.cfg by 
    entering the options you printed out. Then see SYSOPCONFERENCE below for  
    configuration of this new option.
3.  Installation is complete. 


NEW USERS:
IF YOU DO NOT HAVE prelog.wcx installed for WildCat v4.10 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.10 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.
5.  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
SYSOPCONFERENCE=0

HOW TO CONFIGURE wcDoit!.CFG:

CONFERENCE
Enter the conference number where you want the message to the new caller to 
be posted.  If you leave this option blank or enter a conference number that 
does not exist 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.

SYSOPCONFERENCE
Enter the conference number where you want the message to be posted to the
Sysop configured in MakeWild.  If you leave this option blank or if the 
conference number does not exist the message will be sent to WildCat's default 
conference which is conference 0.  The message will ALWAYS be sent as PRIVATE 
mail no matter what the conference is configured for in MakeWild.

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, or if you have some comments, 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
Internet: 74357.1436@compuserve.com

I also frequent MSI's BBS usually every weekend to check out what's new. My
BBS is not on-line yet.
    



Thank You,
Leon Krzyzanowski
