home *** CD-ROM | disk | FTP | other *** search
/ Chip 2002 November / Chip_2002-11_cd1.bin / zkuste / delphi / nastroje / SENDMAIL.ZIP / readme.txt next >
Text File  |  2002-08-03  |  7KB  |  138 lines
  1. SendMail 1.0 Readme
  2. ===================
  3.  
  4. Copyright (c) 2002 DATO Software
  5.  
  6. Author:
  7. =======
  8.   Jerinic Stasa stasa.jerinic@dato.at
  9.  
  10. Idea:
  11. =====
  12.   Bernd Maierhofer bernd.maierhofer@dato.at
  13.  
  14. Description:
  15. ============
  16.  
  17. 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.
  18.  
  19. For example: 
  20. sendmail /FROM=stasa.jerinic@dato.at /TO=c:\to.txt /CC=c:\cc.txt /REF=Meeting /MESSAGE=c:\message.txt ATTACHMENTS=c:\attach.txt
  21.  
  22.   PARAMETERS:
  23.   ===========
  24.  
  25.   Parameters that must be declared:
  26.     /TO         : This switch sets the TO addresses (file path and file name is indicated).
  27.     /MESSAGE    : This switch sets the message (file path and file name is indicated).
  28.     /FROM       : This switch identifies the transmitter.
  29.     /REF        : This switch sets the subject.
  30.   Other possible parameters:
  31.     /CC         : This switch sets the CC addresses (file path and file name is indicated).
  32.     /BCC        : This switch sets the BCC addresses (file path and file name is indicated).
  33.     /ATTACHMENTS: This switch sets the attachment (file path and file name is indicated).
  34.     /HOST       : This switch sets the SMTP server. Default value is 'smtp.chello.at'.
  35.     /PORT       : This switch sets the port address. Default value is '25'.
  36.     /?          : This switch shows the overview of all registered switches.
  37.                   Immediately afterwards the application terminates.
  38.     /RegOff     : This switch switches the readout from the registry in or out. Default value is '-'.
  39.     /IniOff     : This switch switches the readout from the Ini file in or out. Default value is '-'.
  40.     /CmdOff     : This switch switches the readout from the command line in or out. Default value is '-'.
  41.     /RegPath    : This switch sets the path of the registry. 
  42.                   Default is  Default value is '\Software\DATO\"Applicationname"\'.
  43.     /IniPath    : This switch sets the path of the Ini file. Default value is "Application path".
  44.     /IniFile    : This switch sets the names of the Ini file. Default value is '"Application name".ini'.
  45.     /WriteIni   : This switch activates the writing of the registered switches into the Ini file.
  46.                   Immediately afterwards the application terminates.
  47.     /WriteReg   : This switch activates the writing of the registered switches into the registry.
  48.                   Immediately afterwards the application terminates.
  49.     /SHOWHIDDEN : This switch shows or hides the switches, which are registered with the special register method.
  50.                   Default value is 'off'.
  51.  
  52.   Example for ini file (Sendmail.ini is in the same path like the application):
  53.   =============================================================================
  54.  
  55.     [PARAMETERS]
  56.     MESSAGE=c:\sendmail\message.txt
  57.     FROM=stasa.jerinic@dato.at
  58.     REF=Meeting
  59.     TO=c:\sendmail\to.txt
  60.     CC=c:\sendmail\cc.txt
  61.     BCC=c:\sendmail\bcc.txt
  62.     ATTACHMENTS=c:\sendmail\attach.txt
  63.     HOST=smtp.chello.at
  64.     PORT=25
  65.  
  66.     For example the file "c:\sendmail\to.txt" looks like this:
  67.       Jerinic Stasa <stasa.jerinic@dato.at>
  68.       $I c:\sendmail\further_mails.txt
  69.       GMX-Stasa <stale78@gmx.net>
  70.       no_name@gmx.net
  71.  
  72.       The file "C:\sendmail\further_mail.txt" will be also read and the e-mail addresses will be added to the "TO" addresses.
  73.  
  74.    For example the file "c:\sendmail\attach.txt" looks like this:
  75.       c:\Test.doc
  76.       c:\download\indy\Indy_8_22_Src_D6.zip
  77.       
  78.   LOG File:
  79.   =========
  80.  
  81.     SendMail loggs when a e-mail was sent and if the sending process was sucessful or not.
  82.  
  83.     Example for a succesfully sent e-mail:
  84.       2002-07-11 16:36:54: started
  85.       2002-07-11 16:36:54:   FROM: stasa.jerinic@dato.at
  86.       2002-07-11 16:36:54:   TO: c:\sendmail\to.txt
  87.       2002-07-11 16:36:54:   CC: c:\sendmail\cc.txt
  88.       2002-07-11 16:36:54:   BCC: c:\sendmail\bcc.txt
  89.       2002-07-11 16:36:54:   REF: Meeting
  90.       2002-07-11 16:36:54:   MESSAGE: c:\sendmail\message.txt
  91.       2002-07-11 16:36:54:   ATTACHMENTS: c:\sendmail\attach.txt
  92.       2002-07-11 16:37:12:   The message is successfully sent!
  93.       2002-07-11 16:37:12: terminated
  94.  
  95.     Examples for failed e-mails:
  96.       2002-07-11 16:47:59: started
  97.       2002-07-11 16:47:59:   FROM: stasa.jerinic@dato.at
  98.       2002-07-11 16:47:59:   TO: Failure: Multiple occurrence of e-mail address Jerinic Stasa <stasa.jerinic@dato.at> 
  99.                                  in file  c:\sendmail\to.txt.
  100.       2002-07-11 16:47:59:   CC: c:\sendmail\cc.txt
  101.       2002-07-11 16:47:59:   BCC: 
  102.       2002-07-11 16:47:59:   REF: Hallo
  103.       2002-07-11 16:47:59:   MESSAGE: c:\sendmail\message.txt
  104.       2002-07-11 16:47:59:   ATTACHMENTS: c:\sendmail\attach.txt
  105.       2002-07-11 16:47:59:   The message is not sent!
  106.       2002-07-11 16:47:59: terminated
  107.  
  108.       2002-07-11 16:43:01: started
  109.       2002-07-11 16:43:02:   FROM: Failure: The FROM e-mail address Jerinic Stasa <stasa..jerinic@dato.at> is incorrect.
  110.       2002-07-11 16:43:02:   TO: c:\sendmail\to.txt
  111.       2002-07-11 16:43:02:   CC: c:\sendmail\cc.txt
  112.       2002-07-11 16:43:02:   BCC: c:\sendmail\bcc.txt
  113.       2002-07-11 16:43:02:   REF: Hallo
  114.       2002-07-11 16:43:02:   MESSAGE: c:\sendmail\message.txt
  115.       2002-07-11 16:43:02:   ATTACHMENTS: c:\sendmail\attach.txt
  116.       2002-07-11 16:43:02:   The message is not sent!
  117.       2002-07-11 16:43:02: terminated
  118.  
  119.       2002-07-12 10:00:38: started
  120.       2002-07-12 10:00:38:   FROM: stale78@gmx.net
  121.       2002-07-12 10:00:38:   TO: Failure: The e-mail address Jerinic Stasa <stasa..jerinic@dato.at> 
  122.                                  from file c:\sendmail\to.txt is incorrect.
  123.       2002-07-12 10:00:38:   CC: c:\sendmail\cc.txt
  124.       2002-07-12 10:00:38:   BCC: c:\sendmail\bcc.txt
  125.       2002-07-12 10:00:38:   REF: Hallo
  126.       2002-07-12 10:00:38:   MESSAGE: c:\sendmail\message.txt
  127.       2002-07-12 10:00:39:   ATTACHMENTS: c:\sendmail\attach.txt
  128.       2002-07-12 10:00:39:   The message is not sent!
  129.       2002-07-12 10:00:39: terminated
  130.  
  131. Contact:
  132. ========
  133.  
  134.   For further ideas or if you have any problems with SendMail please write to the email: stasa.jerinic@dato.at.
  135.   Please visit our homepage: www.dato.at
  136.  
  137.  
  138.