home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
OS/2 Shareware BBS: 3 Comm
/
03-Comm.zip
/
maredos2.zip
/
MAILRED.TXT
< prev
next >
Wrap
Text File
|
1996-11-06
|
33KB
|
853 lines
DataEnter, Michael Kocum
Taborstrasse 27/23
A-1020 Vienna
AUSTRIA
CIS: 70143,1667
MHS: MICHAEL @ DEMK (via CSERVE)
Internet: michael@demk.co.at
Fax: +43/1/2143829
Introduction to MailRed for MSMail
----------------------------------
MailRed redirects messages from a mailbox to another address
and/or sends absent notifications (out-of-office messages).
MailRed preserves the sender's address and is fully message driven.
Once installed users can start and stop redirection by simply sending
messages with commands to MailRed.
Also included is a Windows Client (MRClient.EXE) which is a simple point
and click interface to MailRed.
MailRed is avilable in English, German and French for
DOS, OS/2, Windows 95 and Windows NT.
Some suggestions as to what you can do:
- Send an absent notification so that everyone knows you are out of
office
- Redirect mail from the Admin mailbox to a real user
- Redirect mail for an out-of-office user to another person
- Redirect mail from a virtual mailbox like "Sales" or "Support" to
a real person
- Redirect mail for a user to his/her Compuserve account
(Gateway required)
- Redirect mail for a user to the Internet
(Gateway required)
- Redirect mail for a user to a fax machine
(FAX Gateway required)
System Requirements
-------------------
DOS version : DOS 3.3
Win32 version : Windows NT 3.1 or Windows 95
OS/2 version : OS/2 2.x
Microsoft Mail, version 3.2 or
Windows for Workgroups
Installation
------------
1) MailRed does two things:
Firstly it redirects mail from one mailbox to another address, where
the address can be another mailbox or any other valid MS Mail address.
To do this, MailRed logs into MSMail as the mailbox and resends
the mail to the redirection address.
Secondly, it processes script files that users sent to MailRed and
builds a routing table, so that MailRed knows which mailbox to
check and to whom it should redirect the messages.
MailRed also needs a person who is responsible for its correct
operation. Any time MailRed processes a script or when it detects
an error, it sends a message to this person's mailbox.
The address of this person is located in the INI file under
"Admin". This is not the same as "Admin" in your MS Mail
environment and it should be a real person who accesses their mail
regularly.
2) MailRed requires a single user mailbox on your Microsoft Mail
system in order to work with Microsoft Mail.
You have to create this mailbox before installing MailRed. On a
Microsoft Mail Postoffice this is done via ADMIN.EXE.
MailRed needs this mailbox for communcation with the users on your
postoffice.
We suggest that you use "MailRed" as the mailbox name and
"MailRed" as the alias.
Note: No other person should use this mailbox!!!
Do not use the real Admin's mailbox for this purpose,
because MailRed seems to work but in fact doesn't.
3) Create a directory on your server and copy MailRed.EXE and
MailRed.INI into it.
We suggest that you create a directory called MailRed below your
MAILEXE, so it is clear that MailRed belongs to MS Mail.
Note: If you want to run MailRed as a Service on Microsoft NT, you
need to install it on a local drive. For more information
about MailRed as a Service read the section
"Installing MailRed as a Microsoft NT Service" below.
4) Edit MailRed.INI and change the configuration so that it will fit
your needs.
MailFax.INI is plain ASCII file where each option is on a different
line. It is similar to your WIN.INI.
The options are:
----------------
MailDrive=<drive> <drive> is the drive or path where your
mail database is located. If you have
more than one postoffice, add a line
for every postoffice.
The first line has to be the drive
where MailRed's mailbox is located.
(The one you created in step 2)
<drive> can also be the full path or
UNC name like M:\MAILDATA or
\\SERVER\SHARENAME
Note: If you want to run MailRed as a Windows
NT Service and your postoffice is not
local, you need to use UNC.
If your postoffice is local, you need
to use C:\MAILDATA or C:\AGPO or
C:\WGPO or whatever directory your
postoffice is located.
MailBox=<mailbox> <mailbox> is the mailbox which MailRed
should use. Its the mailbox you created
in step 2.
Password=<password> <password> is the password for the
mailbox you created in step 2.
Admin=<MSAddress> <MSAddress> is the full MS address of
MailRed's Admin. MailRed will send
error reports (mostly attempts with a
wrong passwords) to this address. A
sample address is:
YOURNETWORK/YOURPOSTOFFICE/YOURNAME
HelpFile=<file> <file> is the file which MailRed sends
to the user if it receives a message
with HELP in the subject or body of the
message.
WriteLogFile=<logical> If <logical> is True, MailRed will
write a log file called MRYYMMDD.LOG,
where YY is the year, MM is the month
and DD is the day.
LogPath=<path> <path> is path where MailRed will
write the log file. If <path> is empty,
MailRed writes the log into the
directory where MailRed.EXE resides.
Verbose=<logical> If <logical> is True, MailRed displays
and log everything, whereas if
<logical> is False, it will display and
log only if there is a real action.
WriteStatisticFile=<logical> If <logical> is True, MailRed will
write a statistic file called
MRYYMMDD.CSV, where YY is the year, MM
is the month and DD is the day.
You can use Excel or any other program
which imports delimited text files, to
run your statistics.
StatisticPath=<path> <path> is path where MailRed will write
the statistic file. If <path> is empty,
MailRed writes the statistic into the
directory where MailRed.EXE resides.
Language=<language> If <language> is ENG, MailRed uses
English for all its messages and log
files.
Supported values for <language> are
ENG English
DEU German
FRA French
DetectInfiniteLoop=<logical> If <logical> is True, MailRed will
check each redirection for an infinite
loop and will send a message to Admin
if it detects one.
A infinite loop is when "A" redirects
to "B", "B" redirects to "C" and "C"
redirects back to "A".
Without detecting the infinite loop,
MailRed would redirect every message
from "A" to "B", then to "C" and then
back to "A", which results in a lot of
network traffic and fills the mailbox
if the keep option is activated.
Note: MailRed checks only for a postoffice
address, not for gateway address. So it
would not detect infinite loops when a
gateway is involved.
InfoMsgAsCCToAdmin=<logical> If <logical> is True, MailRed will send
a CC to admin for every system message
sent to a user (status sheet and so on).
RedirToSender=<logical> If <logical> is False, MailRed will
check if the sender address is the same
as the redirection address.
If so, MailRed will not redirect the
messages and keeps a copy of the
message in the mailbox, even when
message keep is not enabled.
DestroyMailHeader=<logical> If <logical> is True, MailRed will not
redirect the header of a message.
The header is the first part of the
message text which describes the
routing information about the message
(From,To,CC).
Usualy you see this header only in the
DOS Client of MSMail. The Windows
Client of MSMail destroys the header.
AddRedirHeader=<logical> If <logical> is True, MailRed will add
a short header to every redirected
message, so that the recipient knows
from which address this message was
redirected. It will show the From, To
and CC's of the original message.
AddRedirHeaderCC=<logical> If <logical> is False, MailRed will
supress the CC's in the header of the
message.
FastRedir=<logical> If <logical> is True, MailRed will try
to do a fast redirection.
In a fast redirection, MailRed does not
touch the message at all, it simply
moves a pointer inside MSMail's
database to point to another user.
A fast redirection uses less network
resources, because no files are
written.
MailRed checks every message if it can
do a fast redirection and if there is
something in the messages which makes a
fast redirection impossible, it will
continue with normal redirection.
To qualify a message for fast
redirection, the sender, all to's and
CC's and the new recipient need to be
on the same postoffice.
Note: DestroyMailHeader and AddRedirHeader
are not applicable in fast mode,
because MailRed does not touch the
message.
StatusAllAsFile=<logical> If <logical> is True, MailRed will
convert STATUS ALL messages to a file
and send it as an attachment.
If <logical> is False, MailRed will
send it as a note text.
ExcludeGateway=<gateway> If <gateway> is given, MailRed will not
redirect any messages to this gateway.
For every gateway you want to exclude
add one line. Assume you want to
exclude your Fax, your MHS and your
SMTP gateway, add three lines, each
with the gateway you want to exclude,
like:
ExcludeGateway=FAX
ExcludeGateway=MHS
ExcludeGateway=SMTP
AbsentExcludeGateway=<gateway> If <gateway> is given, MailRed will not
send absent messages to this gateway.
For every gateway you want to exclude
add one line. Assume you want to
exclude your Fax, your MHS and your
SMTP gateway, add three lines, each
with the gateway you want to exclude,
like:
AbsentExcludeGateway=FAX
AbsentExcludeGateway=MHS
AbsentExcludeGateway=SMTP
AbsentExcludeAddress=<address> If <address> is given, MailRed will not
send absent messages to this address.
For every address you want to exclude
add one line. Assume you want to
exclude a Internet mailing list add
line with the address you want, like
AbsentExcludeAddress=SMTP:MSMAIL-L@YaleVM.CIS.Yale.Edu
AbsentExcludeSubject=<text> If <address> is given, MailRed will not
send absent messages when the subject
contains <text>
SendAbsentEvery=<minutes> <minutes> is the count of minutes that
MailRed waits before sending a second
absent notification to the same
address.
<minutes> default to 0, which means
that every time a absent message is
sent.
Assume you want an absent notification
only once a day to an address, add the line
SendAbsentEvery=1440
ExcludeSubject=<text> If <text> is at any place in the
subject, MailRed will not redirect the
messages.
For every text you want to exclude add
one line. Assume you want to exclude
all messages with a subject of
confidential or secret, add the lines
ExcludeSubject=confidential
ExcludeSubject=secret
SingleCycle=<logical> If <logical> is True, MailRed will run
only a single cycle and exits
thereafter. This is usefull if you want
to run MailRed and External on one DOS
maschine.
Interval=<seconds> <seconds> is the count of seconds that
MailRed waits between processing
messages.
BreakTime=<time> <time> is time when MailRed stops
working and exits.
The format of time is HH:MM
Assume you want to stop MailRed at
2:00pm, use
BreakTime=14:00
BreakRelative=<string> <string> is time and day relative to
the start of MailRed, when MailRed stops
working and exits.
The format of time is DD:HH:MM , where
DD: is optional.
Assume you want to stop MailRed after
two hours use
BreakRelative=02:00
Assume you want to stop MailRed after
seven days and one hours use
BreakRelative=07:01:00
ScreenMono=<logical> If <logical> is True, use black and
white for screen output.
A sample MailRed.INI is included with MailRed.
5) Edit MailRed.HPL so that it will fit your needs. It lists all
valid keywords that MailRed accepts. You can translate it to your own
language as long as the keywords are in English.
6) Start MailRed and check if there is any error message.
7) Start MRClient and log in using your mailbox and send a message to
MailRed (to the mailbox you created in step 2).
Check the checkbox "Require status sheet about the state of all
redirections" and send the message.
Start MailRed, it should send you back a status sheet which will be
empty because you have not started any redirections yet.
If you get the status sheet, everything is OK and MailRed shoud work as
expected.
Using Redirection:
------------------
Note: Below you will find the documentation about the commands you can
send to MailRed.
In general it is better to use MRClient, which gives you an easy
point and click interface and writes the message for you.
Please refer to MRClient.txt for a documentation about MRClient.
Let's assume the name of your network is NETWORK, the name of postoffice
is POSTOFFICE and your name is RICK. Your address is therefore
NETWORK/POSTOFFICE/RICK. Note the forward slash between network and
postoffice and name. Do not use a back slash or you will get no result.
Let's further assume you want to redirect your mail to ANN.
To start redirection send a message to MailRed with the following
lines in the body of the message:
REDIR NETWORK/POSTOFFICE/ANN
START
KEEP
The line with REDIR is the redirection address and START means "start
redirecting now" and KEEP means that MailRed shoud keep the messages
(without deleting them) after forwarding. After MailRed gets your message, it
processes the keywords and save the data into its database. MailRed then
sends you a confirmation so that it is clear to you what MailRed has done.
To stop redirection send a message to MailRed with the line
STOP in the body of the message.
MailRed will stop redirection, but will save the redirection address for
the next start command.
You can also redirect another mailbox to an address. This is usefull for
virtual mailboxes like "Sales".
To redirect SALES to ANN send the following messages:
ADDRESS NETWORK/POSTOFFICE/SALES
PASSWORD PASSWORD
REDIR NETWORK/POSTOFFICE/ANN
START 1995-06-13 13:00
The line ADDRESS is the address of the sales mailbox, the one with
PASSWORD is the password of the sales mailbox (not your password), the
line with REDIR is the redirection address and START means "start
redirecting on 06/13/95 at 1:00pm" and as KEEP command is missing,
MailRed will delete the message after redirection.
Using Status:
-------------
When you want to know what redirections are active, simply send a message
with the following line:
STATUS
or if you want to know all redirections MailRed knows about, send
STATUS ALL
MailRed will mail you back a list of redirection(s).
Using Delete:
-------------
DELETE is used to delete a user from MailRed database, mostly because
you deleted the mailbox with ADMIN.EXE and your want to remove the
mailbox from MailRed also.
Running MailRed on the same machine as External
-----------------------------------------------
In order to work, MailRed has to poll MS Mail for messages from time to
time. In NT or OS/2 you can start a task with MailRed and so there is
not problem.
In DOS however, only one program can work at a time. The way it works
under DOS, is to run External and MailRed in a loop. The following batch
file shows how do do it.
Note: You need SingleCycle=True in MailRed.Ini to let it work.
@echo off
:Start
rem Change to MailRed directory
cd MailRed
rem Execute MailRed
MailRed
rem Change back to directory where External is located
cd ..
rem Call External for 15 minutes
external -BR0:0:15
rem Check Externals errorlevel to find out if the
rem operator pressed ESC
if errorlevel 66 goto End
if errorlevel 63 goto Start
if errorlevel 62 goto End
:End
Installing MailRed as a Microsoft NT Service ( Win32 version only )
-------------------------------------------------------------------
Keep in mind that MailRed needs to reside on a local disk or the Service
Controller can't start. For the samples below, we assume MailRed is
in C:\MAILRED.
Be sure that MailRed is running well in Console Mode and there is no
error, because once you run it as a Service, you cant see a screen and
a problem will only be visible in the log file.
There are two different install methods depending of the location of
your postoffice.
a) Your postoffice is is on a local disk
Start MailRed one time with an argument of "install",
i.e. type
mailred install
and MailRed will create the service. By default it's an AUTOSTART
Service and any time your computer is started, MailRed will start.
You can start and stop MailRed at any time via the "Control Panel".
Note: In MailRed.Ini, MailDrive= had to point to a local
directory, NOT to a sharename,
i.e use MailDrive=C:\MAILDATA
and not MailDrive=M
b) Your postoffice is on a network disk
Start MailRed one time with an argument of "install",
i.e. type
mailred install
and MailRed will create the service. By default it's an AUTOSTART
Service and any time your computer is started, MailRed will start.
Note: Before you do the next part its a good idea to create
a user "MailRed" on your NT machine
Open "Control Panel", select "Services",
locate MailRed and press the button labeled "Startup...".
In section "Log On As" select "This account" and select a
account (user) which MailRed should use for performing a log on into
the network.
The account need to have the right to "Log on as a Service".
You can set this right when checking "Show Advanced Rights"
in "User Manager". On NT 3.51 this is done automatic when you select
the account.
It's a good idea to create a user "MailRed" on your NT machine and
select this user instead of a human person, because if your ever
change the password or delete the account, MailRed can't no longer
log on into the network.
You can start and stop MailRed at any time via the "Control Panel".
Note: In MailRed.Ini, MailDrive= had to be an UNC name and not a drive.
i.e use MailDrive=\\SERVER\SHARENAME
and not MailDrive=M
because there is no drive mapping for a Service.
Note: After you started MailRed as a Service, verify that MailRed has no
errors ( i.e. it have access to all your postoffices ).
You need to take a look into the log file to do this.
Removing MailRed as a Microsoft NT Service ( Win32 version only )
-----------------------------------------------------------------
Start MailRed one time with an argument of "remove",
i.e. type
mailred remove
and MailRed will delete the service.
More information
----------------
Enclosed you will find FAQ.TXT which answers frequently asked questions
Latest Version:
---------------
You will find the lastest version of MailRed on
ftp://ftp.ahub.co.at/demk or
http://www.ahub.co.at/demk or
CompuServe, GO PCAPP, LIB 9
Filenames are:
MaRedDOS.ZIP DOS Version
MaRedW32.ZIP Win32 Version
MaRedOS2.ZIP OS/2 Version
Licensing Agreement
-------------------
MailRed (c) is copyrighted 1993-1996 by DataEnter, Michael Kocum,
portions (c) Microsoft Corp.
This product and its documentation may not, in whole or in part, be
copied, reproduced, transmitted, transcribed, stored in a retrieval
system, or translated into any other natural or computer language, in
any form or by any means whatsoever, be it electronic, mechanical,
magnetic, optical, manual or otherwise, without the prior written
consent of DataEnter.
DataEnter makes no warranty or representation, either expressed or
implied, with respect to the product MailRed and its
documentation, their quality, perfomance, merchantability, or fitness
for a particular purpose. DataEnter reserves the right to revise the
user's guide and make changes in the content without obligation to
notify any person or organization of such a change.
In no event will DataEnter be liable for any direct, indirect,
special, incidental or consequential damages, real or imagined,
resulting from the use or purchase of this software.
Under no circumstances shall DataEnter's liability for damages
exceed the price paid for the software license.
Should any remedy hereunder be determined to have failed, all
limitations of liability and exclusion of damages set forth above
shall remain in full force and effect.
The extent of the DataEnter's warranty for the software and its
documentation is limited to physical defects of the distribution media
containing the software. Contact DataEnter to obtain return
authorization for the replacement diskette within 30 days of the
original date of purchase. Any further statement made by agents,
employees, distributors or dealers of DataEnter do not constitute
warranties and are not binding. No employee of DataEnter has the
authority to modify any portion of this warranty.
All brand and product names we refer to in the documentation are used
solely for identification purposes and may be trademarks of other
companies.
DataEnter, (the licensor) grants the buyer (the licensee)
the right to use this copy of MailRed (the program)
on a single postoffice at a single location as long as the
licensee complies with the terms of this license.
The licensor reserves the right to terminate this license if the
licensee violates any part of the agreement.
The licensee agrees to make copies of the program only for backup
purposes. The licensee agrees not to copy the documentation and to
take all necessary precautions to ensure that the backup copies of the
software are not distributed to or acquired by other parties.
Microsoft Mail is a trademark of Microsoft Corp.
Windows for Workgroups is a trademark of Microsoft Corp.
Windows NT is a trademark of Microsoft Corp.
Windows Windows 95 is a trademark of Microsoft Corp.
OS/2 is a trademark of IBM Corp.
Server History:
---------------
v3.00 96-05-11 Released
v3.01 96-05-13 Fixed a bug when StatusAllAsFile was enabled
v3.02 96-05-14 Access.glb and Access2.glb had to have one user or
postoffice is not valid
Added check to make sure we have a valid disk access
before deleting a redirection
Added old Redirection Address to Admin message when
a rediretion is deleted
If "TEMP" enviroment variable points to an invalid
directory MailRed uses now the directory where the EXE
resides. If this also fails, MailRed uses the current
directory.
v3.03 96-05-20 Fixed a bug where MailRed does not set user count.
v3.04 96-06-06 Fixed a confusing English message
Fixed MAILRED.INI example file
Removed check for disk access to speed up NT
Added cache for database
v3.05 96-06-19 Infinite loop message to admin is sent only once
Added full name and address in infinite loop message
instead of address only
v3.06 96-06-28 Fixed a memory problem
v3.07 96-06-28 Fixed missing absent files when MailRed was started
with an absolute path
v3.08 96-07-10 Fixed a bug where a MailRed started redirection before
the StartTime when no StopTime was given
Added Start and Stop time in infinite message
Administrator rights are no longer needed to run MailRed
as a NT Service
v3.09 96-07-11 Fixed a bug when redirection to a group
v3.10 96-07-18 Added AbsentExcludeSubject in INI for excluding
subject from getting an absent message
MailRed checks if a message is a absent message
( based on the subject ) and does not send a
absent message back to prevent an infinite loop
AbsentExcludeAddress supports now partial addresses
to exclude a whole Network without the need to list
every address
When redirecting to a group, MailRed excluded the
current address from the group to prevent an infinite
loop
v3.11 96-07-29 Added a monitor for INI file. If size, date or time
changes, MailRed does a internal restart
Added a workaround for the problem that Remote Mail
does not download Messages when an absent message is
defined and the Remote Mail connects via a NT External
The password is now removed from a confirmation message
v3.12 96-08-31 Help File loaded with an absolute path
Fixed a problem with MCI addresses in absent notification
v3.13 96-09-16 Added workaround for MCI messages
Added MessageID in Logfile
Fixed a memory free bug in Win32
v3.14 96-09-25 New release with MRAdmin included
v3.15 96-11-05 Added database for saving LastRun, SentCount and RecvCount
Admin History:
---------------
v3.13 96-09-23 Released
v3.14 96-09-25 Fixed a bug in Date conversation
v3.14a 96-09-28 Fixed a display problem with "Network" field in Win16
and NT 3.5
Added a record number column in main grid
v3.15 96-11-05 Added right mouse menu to main grid
Added Server Statistic Dialog
Changed Dialogs to Tabbed Dialogs
