Versions Compared

Version Old Version 12 New Version 13
Changes made by

Artem Kleshchev (Unlicensed)

Vasil_Kisliak (Unlicensed)

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

The SMTP Transport Adaptor (hereinafter the SMTP adaptor) is intended to send FIX messages from FIXEdge from the FIXEdge server to clients using the SMTP protocol.

Configuration

...

Property name
Description
TransportLayer.SmtpTA.DllNameContains path and name of the SMTP adaptor DLL. 
The property is required.
TransportLayer.SmtpTA.DescriptionAdaptor name. 
The property is required
TransportLayer.SmtpTA.TypeThe type Type of the adaptor library. Should be 'DLL'. The property is not required.
TransportLayer.SmtpTA.SMTPSessions

This parameter determines the names of SMTP clients. 
It is necessary to define the parameters described below for each client.
The format is 'SMTPSession.X.ParameterName' where 'X' is the name of the client.

The SMTP Client name is uses used as a reference of the Client in BL and JavaScripting for the <Send /> action and and the  send(<session source identifier>) js fuction JavaScript function.

TransportLayer.SmtpTA.SMTPSessions.DefaultServerNameDefault SMTP server name or IP address. 
The property is not required
TransportLayer.SmtpTA.SMTPSessions.DefaultServerPortDefault SMTP server port. 
The property is not required.
TransportLayer.SmtpTA.SMTPSessions.DefaultFromDefault value of the 'From' field. 
The property is not required.
TransportLayer.SmtpTA.SMTPSessions.DefaultCCDefault value of the 'CC' field. 
The property is not required.
TransportLayer.SmtpTA.SMTPSessions.DefaultBCCDefault value of the 'BCC' field. 
The property is not required
TransportLayer.SmtpTA.SMTPSessions.DefaultSmartEmailProcessingWhen true, the corresponding tags will be used for e-mail Subject and Body at FIX EMail message conversation. 
The property is not required.
TransportLayer.SmtpTA.SMTPSessions.DefaultSendingTimeoutSending message timeout, common for all SMTP sessions. 
The property is not required.
TransportLayer.SmtpTA.SMTPSessions.DefaultConnectionTimeoutSMTP server connection timeout, common for all SMTP sessions. 
The property is not required.
TransportLayer.SmtpTA.SMTPSession.XXX.ServerNameSMTP server name or IP address. 
The property is required when DefaultServerName is not defined.
TransportLayer.SmtpTA.SMTPSession.XXX.ServerPortSMTP server port. The property is required whenDefaultServerPort ia when DefaultServerPort is not defined.
TransportLayer.SmtpTA.SMTPSession.XXX.SecureConnectionType of secure connection: TLS, SSL. 
The property is required if secure connection is needed, otherwise - not required.
TransportLayer.SmtpTA.SMTPSession.XXX.LoginUser login. 
The property is required if authorization is needed, otherwise - not required.
TransportLayer.SmtpTA.SMTPSession.XXX.PasswordUser password. 
The property is required if authorization is needed, otherwise - not required.
TransportLayer.SmtpTA.SMTPSession.XXX.FromValue of the 'From' field. 
The property is not required if DefaultFrom definedif DefaultFrom is defined, otherwise - required.
TransportLayer.SmtpTA.SMTPSession.XXX.ToValue of the 'To' field. 
The property is required.
TransportLayer.SmtpTA.SMTPSession.XXX.CCValue of the 'CC' field. 
The property is not required.
TransportLayer.SmtpTA.SMTPSession.XXX.BCCValue of the 'BCC' field. 
The property is not required.
TransportLayer.SmtpTA.SMTPSessions.XXX.SmartEmailProcessingWhen If true, the corresponding tags will be used for e-mail Subject and Body at FIX EMail message conversation. 
The property is not required.
TransportLayer.SmtpTA.SMTPSessions.XXX.SendingTimeoutMessage sending timeout, defined for a specified session. 
The property is not required.
TransportLayer.SmtpTA.SMTPSessions.XXX.ConnectionTimeoutSMTP server connection timeout, defined for a specified session.
The property is not required.

Note that all changes in the FIXEdge properties file are applied only after FIXEdge restart.

...

  1. Open the FIXEdge properties file (FIXEdge.properties by default).
  2. Find the 'TransportLayer.TransportAdapters' property
    1. Add the 'TransportLayer.TransportAdapters' property in case it does not exist

  3. Set 'TransportLayer.SmtpTA' to the value of the 'TransportLayer.TransportAdapters' property:

    Code Block
    languagexml
    TransportLayer.TransportAdapters = TransportLayer.SmtpTA

    1. If the 'TransportLayer.TransportAdapters' property already has a value - already, append ',TransportLayer.SmtpTA' to the value:

      Code Block
      languagexml
      TransportLayer.TransportAdapters = ...,TransportLayer.SFSAdaptorDLL,TransportLayer.SmtpTA

  4. Add the 'TransportLayer.SmtpTA.Description' property with the value - SMTP adaptor name:

    Code Block
    languagexml
    TransportLayer.SmtpTA.Description = SMTP Transport Adaptor DLL

  5. Add the 'TransportLayer.SmtpTA.DllName' property with the value - path to the SMTP adaptor dll:

    Code Block
    languagexml
    TransportLayer.SmtpTA.DllName = bin/SMTPAdaptorDll.dll

  6. Add the 'TransportLayer.SmtpTA.Type' property with the 'DLL' value:

    Code Block
    TransportLayer.SmtpTA.Type = DLL

  7. Add the set of default properties:

    Code Block
    TransportLayer.SmtpTA.SMTPSessions.DefaultServerName = mail.test_test.com
TransportLayer.SmtpTA.SMTPSessions.DefaultServerPort = 25
TransportLayer.SmtpTA.SMTPSessions.DefaultSendingTimeout = 10
TransportLayer.SmtpTA.SMTPSessions.DefaultConnectionTimeout = 10
TransportLayer.SmtpTA.SMTPSessions.DefaultSmartEmailProcessing = false

  8. Add the 'TransportLayer.SmtpTA.SMTPSessions property with value - the set of SMTP client's names:

    Code Block
    TransportLayer.SmtpTA.SMTPSessions = TestSmtp

  9. Add properties for each client, like this:

    Code Block
    TransportLayer.SmtpTA.SMTPSession.TestSmtp.ServerName = mail.test_test.com
TransportLayer.SmtpTA.SMTPSession.TestSmtp.ServerPort = 25
TransportLayer.SmtpTA.SMTPSession.TestSmtp.To = jsg@test_test_btobits.com
TransportLayer.SmtpTA.SMTPSession.TestSmtp.From = jsg@test_test_btobits.com
TransportLayer.SmtpTA.SMTPSession.TestSmtp.CC = 
TransportLayer.SmtpTA.SMTPSession.TestSmtp.BCC = 
  10. Restart the FIXEdge server to apply changes.

...

When the SMTP adaptor starts, the following record will be written into the log file (xxx is the SMTP adaptor version):

...