Versions Compared

Version Old Version 75 New Version 76
Changes made by

Artem Kleshchev (Unlicensed)

AntonA (Unlicensed)

Saved on

Key

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

Table of Contents

...

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

...

Monitoring and Administration

Info

Information about the configured TA's session parameters list and dynamic state is sent to the subscribed monitoring application when FIXEdge starts.

When the TA session dynamic state is changed FIXEdge sends the update to the subscribed monitoring application.

MQ TA provides the following monitoring information:

  • Status
  • Number of messages sent
  • Number of messages received
  • Time of the last successful message sending
  • Time of the last message was sent/received for each clientsuccessful message receiving
  • List of clients

Integration Guide

...

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.MQAdapter.Session.1.FIXVersion

FIX44

In every session, FIX messages use a particular version of the FIX protocol. Use this parameter to set the version of the FIX protocol for a given session.

Acceptable values:
FIX40, FIX41, FIX42, FIX43, FIX44, FIX50, FIX50SP1, FIX50SP2.

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

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

  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

...

Please check configuration values for properties:

MQ Adapter can't find all its dependencies

...

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.