SendMail 1.0 Readme
===================

Copyright (c) 2002 DATO Software

Author:
=======
 Jerinic Stasa [email protected]

Idea:
=====
 Bernd Maierhofer [email protected]

Description:
============

SendMail is an application for broadcasting mass e-mails. It is a command line tool, which can be controlled by batch files or makefiles. All parameters (e.g. From, To) needed to send an e-mail can be defined eigther as command line parameters, an Ini file or in the registry. Values for the parameter fields can be read in from defined text files. Each text file can include further text files by containing a "$I file" line. SendMail uses a SMPT server to deliver the e-mails and not Exchange/Outlook.

For example:
sendmail /[email protected] /TO=c:\to.txt /CC=c:\cc.txt /REF=Meeting /MESSAGE=c:\message.txt ATTACHMENTS=c:\attach.txt

 PARAMETERS:
 ===========

 Parameters that must be declared:
   /TO         : This switch sets the TO addresses (file path and file name is indicated).
   /MESSAGE    : This switch sets the message (file path and file name is indicated).
   /FROM       : This switch identifies the transmitter.
   /REF        : This switch sets the subject.
 Other possible parameters:
   /CC         : This switch sets the CC addresses (file path and file name is indicated).
   /BCC        : This switch sets the BCC addresses (file path and file name is indicated).
   /ATTACHMENTS: This switch sets the attachment (file path and file name is indicated).
   /HOST       : This switch sets the SMTP server. Default value is 'smtp.chello.at'.
   /PORT       : This switch sets the port address. Default value is '25'.
   /?          : This switch shows the overview of all registered switches.
                 Immediately afterwards the application terminates.
   /RegOff     : This switch switches the readout from the registry in or out. Default value is '-'.
   /IniOff     : This switch switches the readout from the Ini file in or out. Default value is '-'.
   /CmdOff     : This switch switches the readout from the command line in or out. Default value is '-'.
   /RegPath    : This switch sets the path of the registry.
                 Default is  Default value is '\Software\DATO\"Applicationname"\'.
   /IniPath    : This switch sets the path of the Ini file. Default value is "Application path".
   /IniFile    : This switch sets the names of the Ini file. Default value is '"Application name".ini'.
   /WriteIni   : This switch activates the writing of the registered switches into the Ini file.
                 Immediately afterwards the application terminates.
   /WriteReg   : This switch activates the writing of the registered switches into the registry.
                 Immediately afterwards the application terminates.
   /SHOWHIDDEN : This switch shows or hides the switches, which are registered with the special register method.
                 Default value is 'off'.

 Example for ini file (Sendmail.ini is in the same path like the application):
 =============================================================================

   [PARAMETERS]
   MESSAGE=c:\sendmail\message.txt
   [email protected]
   REF=Meeting
   TO=c:\sendmail\to.txt
   CC=c:\sendmail\cc.txt
   BCC=c:\sendmail\bcc.txt
   ATTACHMENTS=c:\sendmail\attach.txt
   HOST=smtp.chello.at
   PORT=25

   For example the file "c:\sendmail\to.txt" looks like this:
     Jerinic Stasa <[email protected]>
     $I c:\sendmail\further_mails.txt
     GMX-Stasa <[email protected]>
     [email protected]

     The file "C:\sendmail\further_mail.txt" will be also read and the e-mail addresses will be added to the "TO" addresses.

  For example the file "c:\sendmail\attach.txt" looks like this:
     c:\Test.doc
     c:\download\indy\Indy_8_22_Src_D6.zip

 LOG File:
 =========

   SendMail loggs when a e-mail was sent and if the sending process was sucessful or not.

   Example for a succesfully sent e-mail:
     2002-07-11 16:36:54: started
     2002-07-11 16:36:54:   FROM: [email protected]
     2002-07-11 16:36:54:   TO: c:\sendmail\to.txt
     2002-07-11 16:36:54:   CC: c:\sendmail\cc.txt
     2002-07-11 16:36:54:   BCC: c:\sendmail\bcc.txt
     2002-07-11 16:36:54:   REF: Meeting
     2002-07-11 16:36:54:   MESSAGE: c:\sendmail\message.txt
     2002-07-11 16:36:54:   ATTACHMENTS: c:\sendmail\attach.txt
     2002-07-11 16:37:12:   The message is successfully sent!
     2002-07-11 16:37:12: terminated

   Examples for failed e-mails:
     2002-07-11 16:47:59: started
     2002-07-11 16:47:59:   FROM: [email protected]
     2002-07-11 16:47:59:   TO: Failure: Multiple occurrence of e-mail address Jerinic Stasa <[email protected]>
                                in file  c:\sendmail\to.txt.
     2002-07-11 16:47:59:   CC: c:\sendmail\cc.txt
     2002-07-11 16:47:59:   BCC:
     2002-07-11 16:47:59:   REF: Hallo
     2002-07-11 16:47:59:   MESSAGE: c:\sendmail\message.txt
     2002-07-11 16:47:59:   ATTACHMENTS: c:\sendmail\attach.txt
     2002-07-11 16:47:59:   The message is not sent!
     2002-07-11 16:47:59: terminated

     2002-07-11 16:43:01: started
     2002-07-11 16:43:02:   FROM: Failure: The FROM e-mail address Jerinic Stasa <[email protected]> is incorrect.
     2002-07-11 16:43:02:   TO: c:\sendmail\to.txt
     2002-07-11 16:43:02:   CC: c:\sendmail\cc.txt
     2002-07-11 16:43:02:   BCC: c:\sendmail\bcc.txt
     2002-07-11 16:43:02:   REF: Hallo
     2002-07-11 16:43:02:   MESSAGE: c:\sendmail\message.txt
     2002-07-11 16:43:02:   ATTACHMENTS: c:\sendmail\attach.txt
     2002-07-11 16:43:02:   The message is not sent!
     2002-07-11 16:43:02: terminated

     2002-07-12 10:00:38: started
     2002-07-12 10:00:38:   FROM: [email protected]
     2002-07-12 10:00:38:   TO: Failure: The e-mail address Jerinic Stasa <[email protected]>
                                from file c:\sendmail\to.txt is incorrect.
     2002-07-12 10:00:38:   CC: c:\sendmail\cc.txt
     2002-07-12 10:00:38:   BCC: c:\sendmail\bcc.txt
     2002-07-12 10:00:38:   REF: Hallo
     2002-07-12 10:00:38:   MESSAGE: c:\sendmail\message.txt
     2002-07-12 10:00:39:   ATTACHMENTS: c:\sendmail\attach.txt
     2002-07-12 10:00:39:   The message is not sent!
     2002-07-12 10:00:39: terminated

Contact:
========

 For further ideas or if you have any problems with SendMail please write to the email: [email protected].
 Please visit our homepage: www.dato.at