Versions Compared

Key

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

...

The SMTP adaptor is configured by means of the following properties:

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.TypeType of the adaptor library, contains 'DLL' value.
The property is 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 client.

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 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 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 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 properties file are applied only after FixEdge restart.

...

By default the SMTP adaptor puts log messages into the FIXEdge log. Ececute Execute the following steps to configure the SMTP adaptor logging into a separate file:

  1. Open FixEdge properties file
  2. Add 'Log.SMTPAdaptorSmtpAdaptorTransportLayer.SmtpTA.File.Name' property with value - path and name of the SMTP adaptor log file.

    Code Block
    Log.SMTPAdaptorSmtpAdaptorTransportLayer.SmtpTA.File.Name = SMTP.log
  3. Restart FixEdge

...

Code Block
languagexml
smtp-source -v -f <from> -t <to> -S "Test Email" <email_server>


Troubleshooting

Problem
Solution

FixEdge start fails and the FixEdge log file contains the following record:

[FATAL] 20070215-11:42:25.250 - Transport Layer has failed to initialize: Error loading DLL './/../SMTPAdaptorAddin.dll '. : The specified module could not be found. (126)

FixEdge is unable to find the SMTP adaptor library file. Make sure that 'TransportLayer.SmtpTA.DllName' contains valid path and name.

FixEdge start fails and the FixEdge log file contains the following record:

[FATAL] 20070215-11:45:12.312 - Transport Layer has failed to initialize: Cannot find the 'TransportLayer.SmtpTA.XXX' property.

The SMTP adaptor was not configured properly. The required 'TransportLayer.SmtpTA.XXX' property does not exist in the FixEdge property file.
FixEdge is started but the FixEdge log file does not contain 'SMTP Adaptor v.xxx started' record.

Make sure that the SMTP adaptor was configured properly in the FixEdge property file:

  1. 'TransportLayer.SmtpTA' added into the 'TransportLayer.TransportAdapters' property
  2. 'Log.
SMTPAdaptor
  1. SmtpAdaptorTransportLayer.SmtpTA.File.Name' property that redirects the SMTP adaptor log into another file that does not exist.

Make sure that the FixEdge log file does not contain any related error messages.

 

...