Versions Compared

Version Old Version 69 New Version 70
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.*"

BL Configuration Example

The following configuration describes the basic FIX to MQ conversion message flow.

FIX message from SENDER session is converted to FIXML and pushed to the middleware via MQ.

...

case insensitive "<\?xml version.*|<FIXML.*"

Configuration Sample to FIX MQ conversion flow

The following configuration describes the basic FIX to MQ conversion message flow.

FIX message from SENDER session is converted to FIXML and pushed to the middleware via MQ.

All messages from MQ are be converted from FIXML to FIX and send it to RECEIVER FIX session.

  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-vc10-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 FIX44 to FIXML.4.4">
            <Source Name="SENDER" />
            <Action>
                <Convert SourceProtocol="FIX44" TargetProtocol="FIXML.4.4"/>
                <Send Name="MQHub1"/>
            </Action>
        </Rule>
		<Rule Description="Route MQ messages back to receiver and convert from FIXML.4.4 to FIX44">
            <Source Name="MQHub2" />
            <Action>
				<Convert SourceProtocol="FIXML.4.4" TargetProtocol="FIX44"/>
                <Send Name="RECEIVER"/>
            </Action>
        </Rule>
        <DefaultRule>
            <Action>
                <DoNothing/>
            </Action>
        </DefaultRule>
    </BusinessLayer>
</FIXEdge>
  4. Configure Queues Managers on IBM Websphere server



Error queue

An error queue is a local queue to which error messages can be sent by the WebSphere MQ connector when a message operation fails. For target queues, the error queue acts as a backup option for the target queue when messages cannot be written to the target queue

...

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.