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

Copyright (c) 2002 DATO Software

Author:
=======
  Jerinic Stasa stasa.jerinic@dato.at

Idea:
=====
  Bernd Maierhofer bernd.maierhofer@dato.at

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 /FROM=stasa.jerinic@dato.at /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
    FROM=stasa.jerinic@dato.at
    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 <stasa.jerinic@dato.at>
      $I c:\sendmail\further_mails.txt
      GMX-Stasa <stale78@gmx.net>
      no_name@gmx.net

      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: stasa.jerinic@dato.at
      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: stasa.jerinic@dato.at
      2002-07-11 16:47:59:   TO: Failure: Multiple occurrence of e-mail address Jerinic Stasa <stasa.jerinic@dato.at> 
                                 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 <stasa..jerinic@dato.at> 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: stale78@gmx.net
      2002-07-12 10:00:38:   TO: Failure: The e-mail address Jerinic Stasa <stasa..jerinic@dato.at> 
                                 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: stasa.jerinic@dato.at.
  Please visit our homepage: www.dato.at