Spamcopy instructions
=====================

Spamcopy does just what the name implies. It copies an email file from one 
location to another. In the process, the contents of the email are modified 
according to some rules. 

Two things can happen to the emails during the copy process.

First, the email destination, the "To:" field can be altered to send the mail 
to another destination. This is called trapping.

Second, the email can be converted into a problem report stating that the mail 
could not be delivered. This problem report email will be addressed back to 
the person who sent the original mail. This is called bouncing.

spamcopy is designed for use with zxmail, but can probably be used to bounce
or trap spam emails for other mailers.

BOUNCING = sending mail back where it came from.
TRAPPING = sending mail to a spam mailbox so that you can look at it 
           and check it's really spam.


CONFIGURATION
=============
1: First, edit the file spamcopy.txt.

2: Edit the following entries:-
   
   For Reporting-MTA: field
   REPRTMTA = your dns server name, something like 'computer.domain.com'

   For From: field
   RET_FROM = something like 'Automated Spamblocker <postmaster@domain.com>'

3: Compile spamcopy.txt using 'msgc.exe spamcopy.txt' on a command line.
   This will create the file 'spamcopy.msg'

INSTALLATION FAST
=================

1: Edit the configuration in the message file

2: Copy spamcopy.exe and spamcopy.msg somewhere in the path.
   'C:\os2\apps' is usually part of the path.

3: If spamcopy can't find its message file, then it's not in the path. Try
   using the config settings below.

INSTALLATION SLOW
=================

1: Follow the fast installation, above.

2: If 'spamcopy.msg' is not in the path,
   in config.sys, add the entry 'SET   SPAMCOPY=C:\os2\apps'
   if that is where you have put it.

USAGE
=====

/t<email> trap emails
/b<email> bounce emails

/d<path> where you want the email copied to, if this is missing, only a check is performed

/l<level> log level where 0 = errors only, 1 = copy only, 2 = log everything

The program returns an error level value, or the result of a check:-
0 = ok.
1 = Local file, please ignore. 

Process overview when bouncing:-
================================

a) call spamcopy.exe mail -b<domain> to see if the email is from your own domain.
There is no point bouncing emails to yourself.

b) check to see if it's spam.

c) if it's spam, call spamcopy.exe mail -b<domain> -d<dropbox>

Spamcopy will build a problem report email saying that your email could not be
delivered, and will send it back to the sender.

The spam is fed back into your mailers dropbox, and is sent on it's way.


Process overview when trapping:-
================================

a) call spamcopy.exe mail -t<spam mailbox> to see if the email is already 
   addressed to your spam mailbox.
There is no point in checking spam to see if it is spam.

b) check to see if it's spam.

c) if it's spam, call spamcopy.exe mail -t<spam mailbox> -d<dropbox>
The spam is fed back into your mailers dropbox, and is sent to the spam mailbox.

zxmail spam filter example:-
============================

Have a look at the file "pop3.flt". 

If you copy it, don't forget to edit the spamtrap/domain address!!

