The Simple XML Socket Transport Adaptor (hereinafter SXS) is intended for communication with FIXEdge from third-part applications. The main goal of this adaptor is a quick and easy building of the network applications that communicate using XML messages.
SXS adaptor is distributed as a zip-archive with the name SXSAdaptor_xx.zip, where xx stands for SXS adaptor version. To install SXS adaptor unpack the .zip file and copy SXSAdaptorAddin.dll into the FIXEdge's \bin folder. See the sections Configuration in order to learn how to configure SXS adaptor. After the SXS adaptor is configured the FIXEdge needs to be started.
SXS adaptor is configured using the following properties:
Contains path and name of the SXS adaptor dll. Property is required
Adaptor's name. Property is required
Type of the adaptor library, contains value 'DLL'. Property is required
Listen port that SXS adaptor uses to accept client's connections. Integer value, should be > 0. Property is required
This parameter controls how often SXS adaptor sends HeartBeat messages. HeartBeat messages are used to verify that the another peer is alive. Time is seconds.
This parameter controls how long SXS adaptor waits for the HeartBeat message responce. When HeartBeat message response isn't receivedheartbeatInterval*(1 + reasonableTransmissionTime/100) time interval, SXS adaptor makes decision that client isn't alive and closes session. Value in percents, > 0 and <100.
To integrate SXS adaptor into the FIXEdge, the following steps have to be executed:
- Open FIXEdge properties file (FIXEdge.properties by default).
- Find 'TransportLayer.TransportAdapters' property
- Add 'TransportLayer.TransportAdapters' property in case it doesn't exist
Set 'TransportLayer.SXSAdaptorDLL' to the value of the 'TransportLayer.TransportAdapters' property:
- If 'TransportLayer.TransportAdapters' property already has value - append ',TransportLayer.SXSAdaptorDLL' to the value:
Add property 'TransportLayer.SXSAdaptorDLL.Description' with value - SXS adaptor name:
Add property 'TransportLayer.SXSAdaptorDLL.DllName' with value - path to the SXS adaptor dll:
Add property 'TransportLayer.SXSAdaptorDLL.Type' with value 'DLL':
Add property 'TransportLayer.SXSAdaptorDLL.listenPort' with value - port where SXS adaptor will accept incoming connections:
Add property 'TransportLayer.SXSAdaptorDLL.heartbeatInterval' with value - delay between 2 HeartBeat message sending:
Add property 'TransportLayer.SXSAdaptorDLL.reasonableTransmissionTime, like this:
- Restart FIXEdge to apply changes
After changes the FIXEdge properties file may look like this: