Versions Compared

Old Version 6

changes.mady.by.user Elena Piskunova

Saved on

compared with

New Version Current

changes.mady.by.user Vasil_Kisliak

Saved on

Key

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

...

FIXEdge provides the possibility to set up and configure adapters for FIXEdge using using the FIXEdge.properties file.

There can be one or several adapters configured for one instance of FIXEdge. There also can be several instances of one adapter configured for one instance of FIXEdge. 

Each adapter is a separate *.dll file.

Preparation

  1. Download Download the adapter (or adapters) you want to configure;
  2. Make a backup copy of your current FIXEdge configuration;
  3. Prepare configuration amendments in case you plan to change any credentials, destination folders, connection parameters, etc. Refer to configuration guides for assistance;
  4. Make sure you have sufficient administration permissions for further uninstall/install procedures.
  5. Install the chosen adapter according to the rules specified in FIXEdge Transport Adaptors article for each adapter.

Configuring

  1. The list of adapters to be used by the instance of FIXEdge should be specified in TransportLayer.TransportAdapters parameter. Values are delimited by comma.
    E.g.For example: TransportLayer.TransportAdapters = TransportLayer.MQAdaptor, TransportLayer.JMSTA
  2. For each mentioned adapter, the set of specific configuration parameters should be defined.
    Refer to FIXEdge Transport Adaptors for assistance and adapters configuration parameters details.

For example, if you want to set up one instance of of the MQ adapter, after preparation phase, you need to specify the following properties in the FIXEdge.properties file:

Code Block
titleFIXEdge.properties
TransportLayer.TransportAdapters = TransportLayer.MQAdaptor

#-------------------------------------------------------------------------
# MQ Adaptor Settings
#-------------------------------------------------------------------------

TransportLayer.MQAdaptor.Description = MQ Transport Adaptor DLL
TransportLayer.MQAdaptor.TimeIntervalBeforeReconnect = 1000

TransportLayer.MQAdaptor.DllName = bin/MQTAAddin-vc10-MD-x64.dll
TransportLayer.MQAdaptor.StorageDirectory = FixEdge1/log
TransportLayer.MQAdaptor.NumAttemptReconnect = -1
TransportLayer.MQAdaptor.WaitIntervalForGet = 10000
TransportLayer.MQAdaptor.BufferSizeForMessage = 65536

TransportLayer.MQAdaptor.MQ_HOSTNAME = localhost
TransportLayer.MQAdaptor.MQ_MANAGER_NAME = TestMQ
TransportLayer.MQAdaptor.MQ_PORT = 1414
TransportLayer.MQAdaptor.MQ_CCSID = 437
TransportLayer.MQAdaptor.MQ_CHANNEL_NAME = TestConnection

TransportLayer.MQAdaptor.SessionNumber = 1
TransportLayer.MQAdaptor.Session.1.ClientID = MQClient
TransportLayer.MQAdaptor.Session.1.FromClientQueue = MQClient_from
TransportLayer.MQAdaptor.Session.1.ToClientQueue = MQClient_to
TransportLayer.MQAdaptor.Session.1.ErrorQueue = MQClient_error
TransportLayer.MQAdaptor.Session.1.SmartXMLProcessor = false

...

Below is the sample of configuration of MQ adapter and JMS Adapter on the one instance of FIXEdge:

...

How to configure several instances of one adapter

When you want to setup set up two or more instances of one adapter (e.g. two instances of of the MQ adapter), follow the steps procedure below:

  1. Take the *.dll file of the adapter, copy it and change the name of the copied *.dll file. 
    E.g. take *.dll of MQ Adapter (bin/MQTAAddin.dll), copy it and get the renamed copy (bin/MQTAAddin_secondary.dll).
  2. Specify both instances of adapter in TransportLayer.TransportAdapters parameter in the FIXEdge.properties file. 
    E.g.TransportLayer.TransportAdapters = TransportLayer.MQAdaptorPrimary,TransportLayer.MQAdaptorSecondary.
  3. Define specific configuration parameters for each of instances of the adapter in the FIXEdge.properties file. 
    Refer to FIXEdge Transport Adaptors for assistance and adapters configuration parameters details.
  4. Check that each configured instance uses its own *.dll file in DllName property of the specific adapter configuration section.

So, if you want to set up two instances of MQ Adapter, you need to specify the following properties in the FIXEdge.properties file:

Code Block
titleFIXEdge.properties
TransportLayer.TransportAdapters = TransportLayer.MQAdaptorPrimary,TransportLayer.MQAdaptorSecondary

#-------------------------------------------------------------------------
# Primary MQ Adaptor Settings
#-------------------------------------------------------------------------

TransportLayer.MQAdaptorPrimary.Description = Primary MQ Transport Adaptor DLL
TransportLayer.MQAdaptorPrimary.TimeIntervalBeforeReconnect = 1000

TransportLayer.MQAdaptorPrimary.DllName = bin/MQTAAddin.dll
TransportLayer.MQAdaptorPrimary.StorageDirectory = FixEdge1/log
TransportLayer.MQAdaptorPrimary.NumAttemptReconnect = -1
TransportLayer.MQAdaptorPrimary.WaitIntervalForGet = 10000
TransportLayer.MQAdaptorPrimary.BufferSizeForMessage = 65536

TransportLayer.MQAdaptorPrimary.MQ_HOSTNAME = 192.168.0.2
TransportLayer.MQAdaptorPrimary.MQ_MANAGER_NAME = TestMQ
TransportLayer.MQAdaptorPrimary.MQ_PORT = 1414
TransportLayer.MQAdaptorPrimary.MQ_CCSID = 437
TransportLayer.MQAdaptorPrimary.MQ_CHANNEL_NAME = TestConnection

TransportLayer.MQAdaptorPrimary.SessionNumber = 1
TransportLayer.MQAdaptorPrimary.Session.1.ClientID = MQClient
TransportLayer.MQAdaptorPrimary.Session.1.FromClientQueue = MQClient_from
TransportLayer.MQAdaptorPrimary.Session.1.ToClientQueue = MQClient_to
TransportLayer.MQAdaptorPrimary.Session.1.ErrorQueue = MQClient_error
TransportLayer.MQAdaptorPrimary.Session.1.SmartXMLProcessor = false
 
#-------------------------------------------------------------------------
# Secondary MQ Adaptor Settings 
#-------------------------------------------------------------------------
 
TransportLayer.MQAdaptorSecondary.Description = Secondary MQ Transport Adaptor DLL
TransportLayer.MQAdaptorSecondary.TimeIntervalBeforeReconnect = 1000
 
TransportLayer.MQAdaptorSecondary.DllName = bin/MQTAAddin_secondary.dll
TransportLayer.MQAdaptorSecondary.StorageDirectory = FixEdge1/log
TransportLayer.MQAdaptorSecondary.NumAttemptReconnect = -1
TransportLayer.MQAdaptorSecondary.WaitIntervalForGet = 10000
TransportLayer.MQAdaptorSecondary.BufferSizeForMessage = 65536
 
TransportLayer.MQAdaptorSecondary.MQ_HOSTNAME = 192.168.0.3
TransportLayer.MQAdaptorSecondary.MQ_MANAGER_NAME = TestMQ
TransportLayer.MQAdaptorSecondary.MQ_PORT = 1414
TransportLayer.MQAdaptorSecondary.MQ_CCSID = 437
TransportLayer.MQAdaptorSecondary.MQ_CHANNEL_NAME = TestConnection
 
TransportLayer.MQAdaptorSecondary.SessionNumber = 1
TransportLayer.MQAdaptorSecondary.Session.1.ClientID = MQClient
TransportLayer.MQAdaptorSecondary.Session.1.FromClientQueue = MQClient_from
TransportLayer.MQAdaptorSecondary.Session.1.ToClientQueue = MQClient_to
TransportLayer.MQAdaptorSecondary.Session.1.ErrorQueue = MQClient_error
TransportLayer.MQAdaptorSecondary.Session.1.SmartXMLProcessor = false