Versions Compared

Version Old Version 72 New Version 73
Changes made by

AntonA (Unlicensed)

AntonA (Unlicensed)

Saved on

Key

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

Table of Contents

Overview

...

Info

Starting FixEdge version 6.10.0 it is recommended to use IBM MQ Client library version 8.x.

The older and newer versions may lead to MQ adapters failures

...

Property NameDefault ValueDescription

TransportLayer.MQAdaptor.Description

MQ Transport Adaptor DLLDescription of the transport adaptor

TransportLayer.MQAdaptor.DllName

bin/MQTAAddin.dllPath to the transport adaptor module

TransportLayer.MQAdaptor.TimeIntervalBeforeReconnect

1000Time interval in milliseconds between reconnect attempts

TransportLayer.MQAdaptor.StorageDirectory

FixEdge1/logLogging directory for storage of outgoing messages. Required.

TransportLayer.MQAdaptor.BufferSizeForMessage

65536Message buffer size. Max value is 4194304. 0 means a default value 64 * 1024

TransportLayer.MQAdaptor.MQ_HOSTNAME

localhostMS Series Server host name

TransportLayer.MQAdaptor.MQ_PORT

1414MS Series Server port

TransportLayer.MQAdaptor.MQ_MANAGER_NAME

TestMQMS Series manager name

TransportLayer.MQAdaptor.MQ_CHANNEL_NAME

TestConnectionMS Series Channel name

TransportLayer.MQAdaptor.MQ_CCSID

437MS Series Server CCSID. The coded character set identifier to use with the WebSphere MQ queue

TransportLayer.MQAdaptor.SslKeyRepository

/var/mqm/ssl/keyPath to SSL certificate storage file without extension (SCKR,MQSSLKEYR) e.g. /var/mqm/ssl/key or C:\\Program Files\\IBM\\WebSphere MQ\\ssl\\key

TransportLayer.MQAdaptor.SslCipherSpecification

TRIPLE_DES_SHA_USSSL CipherSpec name (SSLCIPH), required to use SSL, e.g. TRIPLE_DES_SHA_US

TransportLayer.MQAdaptor.SslClientAuthentication

falseRemote peer authentication (SSLCAUTH)

TransportLayer.MQAdaptor.SslPeerName

CN=QMGR.*, OU=IBM, OU=WEBSPHERERemote peer DN filter(SSLPEER)

TransportLayer.MQAdaptor.WaitIntervalForGet

1000Time interval in milliseconds to wait between polling message on MQ Series Server

TransportLayer.MQAdaptor.NumAttemptReconnect

10Number of reconnect attempts to MQ Series Server

TransportLayer.MQAdaptor.SessionNumber

1Number of sessions with MQ Series. Each session is a set of MQ Series queues.

TransportLayer.MQAdaptor.Session.1.ClientID

MQClientMQ session ID.

TransportLayer.MQAdaptor.Session.1.SmartXMLProcessor

trueEnables mode of processing XML/FIXML messages:
  • For outgoing FIX XML message (MsgType = n) adaptor extracts XML data then sends data to MQ client.
  • For incoming XML/FIXML raw data adaptor wraps data into FIX XML message (MsgType = n) then routes message to FIX Edge.

TransportLayer.MQAdaptor.Session.1.ToClientQueue

MQClient_toThe name for Queue, dedicated for message coming from client to MQ via FIX Edge

TransportLayer.MQAdaptor.Session.1.FromClientQueue

MQClient_fromThe name for Queue, dedicated for message coming from MQ to client via FIX Edge

TransportLayer.MQAdaptor.Session.1.ErrorQueue

MQClient_errorThe name for Queue dedicated for message, which cannot be handled because of error.

TransportLayer.MQAdaptor.Session.1.SenderID

-Not required. SenderCompID (Tag = 49) in the received message is set to the property value.

TransportLayer.MQAdaptor.Session.1.TargetID

-Not required. TargetCompID (Tag = 56) in the received message is set to the property value.

TransportLayer.MQAdaptor.Session.1.FromClientDropMessageFilter

-Not required. Defines a regular expression (perl syntax) to drop matched messages coming from MQ.

TransportLayer.MQAdaptor.Session.1.SmartXMLProcessorFromClientMessageFilter

-Not required. Defines a regular expression (perl syntax) to apply SmartXMLProcessor to matched messages coming from MQ. Overrides default filter: case insensitive "<\?xml version.*|<FIXML.*"

...

  1. Configure sessions in FIXEdge.properties

    Code Block
    titleFIXEdge.properties
    #------------------------------------------------------------
# FIX Layer Section
#------------------------------------------------------------
 
FixLayer.FixEngine.Sessions = SENDER, RECEIVER
 
FixLayer.FixEngine.Session.SENDER.Version = FIX44
FixLayer.FixEngine.Session.SENDER.StorageType = persistentMM
FixLayer.FixEngine.Session.SENDER.Role = Acceptor
FixLayer.FixEngine.Session.SENDER.SenderCompID = FIXEDGE
FixLayer.FixEngine.Session.SENDER.TargetCompID = SENDER
FixLayer.FixEngine.Session.SENDER.EncryptMethod = 0
FixLayer.FixEngine.Session.SENDER.InSeqNum = 0
FixLayer.FixEngine.Session.SENDER.OutSeqNum = 0
FixLayer.FixEngine.Session.SENDER.Description = FIX session for test mq sender
FixLayer.FixEngine.Session.SENDER.StartTime = 08:00
FixLayer.FixEngine.Session.SENDER.TerminateTime = 23:59
FixLayer.FixEngine.Session.SENDER.RecreateOnLogout = true
FixLayer.FixEngine.Session.SENDER.IntradayLogoutTolerance = true
FixLayer.FixEngine.Session.SENDER.ForceSeqNumReset = false
FixLayer.FixEngine.Session.SENDER.SocketPriority = EVEN
FixLayer.FixEngine.Session.SENDER.HandleSeqNumAtLogon = false
 
FixLayer.FixEngine.Session.RECEIVER.Version = FIX44
FixLayer.FixEngine.Session.RECEIVER.StorageType = persistentMM
FixLayer.FixEngine.Session.RECEIVER.Role = Acceptor
FixLayer.FixEngine.Session.RECEIVER.SenderCompID = FIXEDGE
FixLayer.FixEngine.Session.RECEIVER.TargetCompID = RECEIVER
FixLayer.FixEngine.Session.RECEIVER.EncryptMethod = 0
FixLayer.FixEngine.Session.RECEIVER.InSeqNum = 0
FixLayer.FixEngine.Session.RECEIVER.OutSeqNum = 0
FixLayer.FixEngine.Session.RECEIVER.Description = FIX session for test mq receiver
FixLayer.FixEngine.Session.RECEIVER.StartTime = 08:00
FixLayer.FixEngine.Session.RECEIVER.TerminateTime = 23:59
FixLayer.FixEngine.Session.RECEIVER.RecreateOnLogout = true
FixLayer.FixEngine.Session.RECEIVER.IntradayLogoutTolerance = true
FixLayer.FixEngine.Session.RECEIVER.ForceSeqNumReset = false
FixLayer.FixEngine.Session.RECEIVER.SocketPriority = EVEN
FixLayer.FixEngine.Session.RECEIVER.HandleSeqNumAtLogon = false

  2. Configure MQ Adaptor

    Code Block
    titleFIXEdge.properties
    #------------------------------------------------------------
# Transport Layer Section
#------------------------------------------------------------
 
#Comma separated list of identifiers of Transport Adapters should be loaded.
TransportLayer.TransportAdapters = TransportLayer.MQAdaptor
 
#-------------------------------------------------------------------------
# MQ Adaptor configuration
#-------------------------------------------------------------------------
 
TransportLayer.MQAdaptor.Description = MQ Transport Adaptor DLL
TransportLayer.MQAdaptor.Type = DLL
 
TransportLayer.MQAdaptor.DllName = bin/MQTAAddin-MD-x64.dll
TransportLayer.MQAdaptor.TimeIntervalBeforeReconnect = 1000
TransportLayer.MQAdaptor.BufferSizeForMessage = 65536
TransportLayer.MQAdaptor.MQ_HOSTNAME = ecsa00400539.epam.com
TransportLayer.MQAdaptor.MQ_MANAGER_NAME = FIXEdge
TransportLayer.MQAdaptor.MQ_PORT = 1414
TransportLayer.MQAdaptor.MQ_CCSID = 437
TransportLayer.MQAdaptor.MQ_CHANNEL_NAME = TestConnection
TransportLayer.MQAdaptor.WaitIntervalForGet = 1000
TransportLayer.MQAdaptor.NumAttemptReconnect = 10  
TransportLayer.MQAdaptor.StorageDirectory = FIXEdge1/log
TransportLayer.MQAdaptor.UseTransactions = true
 
TransportLayer.MQAdaptor.SessionNumber = 2
 
# MQ QA session
TransportLayer.MQAdaptor.SessionNumber = 1
TransportLayer.MQAdaptor.Session.1.ClientID = MQHub1
TransportLayer.MQAdaptor.Session.1.ToClientQueue = MQClient_test
TransportLayer.MQAdaptor.Session.1.FromClientQueue =
TransportLayer.MQAdaptor.Session.1.ErrorQueue = MQClient_error
TransportLayer.MQAdaptor.Session.1.SmartXMLProcessor = true
TransportLayer.MQAdaptor.Session.1.SendTransactionSize = 300
TransportLayer.MQAdaptor.Session.1.ReceiveTransactionSize = 1
 
TransportLayer.MQAdaptor.SessionNumber = 2
TransportLayer.MQAdaptor.Session.2.ClientID = MQHub2
TransportLayer.MQAdaptor.Session.2.ToClientQueue =
TransportLayer.MQAdaptor.Session.2.FromClientQueue = MQClient_test
TransportLayer.MQAdaptor.Session.2.ErrorQueue = MQClient_error
TransportLayer.MQAdaptor.Session.2.SmartXMLProcessor = true
TransportLayer.MQAdaptor.Session.2.SendTransactionSize = 300
TransportLayer.MQAdaptor.Session.2.ReceiveTransactionSize = 1

  3. Configure BL 

    Code Block
    languagexml
    <?xml version="1.0" encoding="UTF-8"?>
<FIXEdge>
    <BusinessLayer>
        <Rule Description="Convert ExecutionReport from FIX.4.4 to FIXML.4.4">
            <Source Name="SENDER" />
            <Action>
                <Convert SourceProtocol="FIX.4.4" TargetProtocol="FIXML.4.4"/>
                <Send Name="MQHub1"/>
            </Action>
        </Rule>
		<Rule Description="Route MQ messages back to receiver and convert from FIXML.4.4 to FIX.4.4">
            <Source Name="MQHub2" />
            <Action>
				<Convert SourceProtocol="FIXML.4.4" TargetProtocol="FIX.4.4"/>
                <Send Name="RECEIVER"/>
            </Action>
        </Rule>
        <DefaultRule>
            <Action>
                <DoNothing/>
            </Action>
        </DefaultRule>
    </BusinessLayer>
</FIXEdge>
    Note
    Note: full

    Full list of possible versions to convert can be found in Convert

  4. Configure Queues Managers on IBM Websphere server


...

  1. Make sure that IBM MQ Client is installed on the host with FIXEdge
  2. Make sure that the environment variable PATH contains the path to the IBM MQ Client bin folder.
  3. Make sure MQTAAddin-xx.dll MQTAAddin-xx.so library exists in FIXEdge/bin folder.


The message is not processed due to incorrect rule found

Message was received from the client, but is not processed and forwarded by FIXEdge. The following error appears in FixEdge.log:

Code Block
languageperl
ERROR   [BL_RoutingTable]  17680  Incorrect rule found: FIX version 'FIX44' of source protocol doesn't correspond to target protocol FIXML.4.4.

Root cause

Incorrect protocol version(s) was specified for conversion in BL_Config.xml:

Code Block
languagexml
<Rule Description="Convert ExecutionReport from FIX44 to FIXML.4.4">
	<Source Name="SENDER" />
    	<Action>
        	<Convert SourceProtocol="FIX44" TargetProtocol="FIXML.4.4"/>
            <Send Name="MQHub1"/>
        </Action>
</Rule>

Solution:

Check for possible protocol versions for conversion in Convert. Make changes in BL_Config.xml to set up correct ones:

Code Block
languagexml
<Convert SourceProtocol="FIX.4.4" TargetProtocol="FIXML.4.4"/>


WebSphere MQ Setup Guide

Getting MQ Soft

...

MQ TA has not supported the authentication in IBM MQ Server. 

It can lead to failure in MQ TA initialization with the error records in the log:

...

  1. Login to the remote server where MQ Instance is running

  2. Open cmd

  3. Run 'runmqsc'. Check if connected to correct QM:

  4. Execute 'ALTER QMGR CHLAUTH(DISABLED)':

  5. Try to reestablish connection by clicking 'No' in the dialog:

  6. And Finish in the dialog:

  7. If the error is still here, look at Channel authentication records and make sure that your account is not in the Block User List:



  8. Try again steps 5-6.

Also you can find how to disable IBM MQ authentication on the official site.