| Table of Contents |
|---|
Overview
IBM MQ Transport Adaptor (hereafter MQ TA) is an add-in for FIXServer that allows clients to communicate with FIXServer over IBM MQSeries middleware. The document contains full instructions how to install MQ TA for testing.
Description
MQ TA is responsible for:
- Establishing and maintaining sessions with MQ Series Server to communicate with Clients
- Transmitting messages to its clients
- Delivering messages from clients
- Facilitating monitoring and administration
Monitoring and Administration
MQ TA provides the following monitoring information:
- Number of messages sent
- Number of messages received
- Time the last message was sent/received for each client
- List of clients
Integration Guide
Installation MQ Adaptor to FixEdge
Normally MQ adaptor is distributed as a zip-archive with the name MQAdaptor-xx.zip, where xx stands for MQ adaptor version. The distribution package consists of:
| File | Description |
BIN\MQTAAddin-xx.dll or BIN\MQTAAddin.so | MQ Transport Adaptor dynamic library for Windowsor MQ Transport Adaptor shared library for Linux |
| DOC\MQTA_InstallationGuide.pdf | MQ Transport Adaptor - Installation Guide. This document |
| DOC\VersionHistory.txt | MQ Transport Adaptor Version History |
| DOC\FIXEdge.properties | Sample FIX Edge configuration file. |
To install MQ adaptor:
- IBM MQ Client libraries must be installed on the FIX Edge machine where MQ Adaptor is ran. Third-party libraries are not incuded into TA package. They can be downloaded from here.
- Unpack the package and copy MQTAAddin-xx.dll/ MQTAAddin-xx.so into the FIX Edge /bin folder. Configure adaptor according to the instructions below.
Restart FIX Edge.
Configuration
IBM MQ Transport Adaptor can be configured using FIXICC or directly by editing the FIXEdge.properties file of the correspondent FIX Edge instance. All properties to be set up are described in the table below. You can also use FIXEdge.properties file from the package as an example.
Make sure that configuration of the adaptor correlates with the MQ Series Server parameters.
...
Table of Contents
Overview
IBM MQ Transport Adaptor (hereafter MQ TA) is an add-in for FIXServer that allows clients to communicate with FIXServer over IBM MQSeries middleware. The document contains full instructions how to install MQ TA for testing.
Description
MQ TA is responsible for:
- Establishing and maintaining sessions with MQ Series Server to communicate with Clients
- Transmitting messages to its clients
- Delivering messages from clients
- Facilitating monitoring and administration
Monitoring and Administration
MQ TA provides the following monitoring information:
- Number of messages sent
- Number of messages received
- Time the last message was sent/received for each client
- List of clients
Integration Guide
Installation MQ Adaptor to FixEdge
Normally MQ adaptor is distributed as a zip-archive with the name MQAdaptor-xx.zip, where xx stands for MQ adaptor version. The distribution package consists of:
| File | Description |
BIN\MQTAAddin-xx.dll or BIN\MQTAAddin.so | MQ Transport Adaptor dynamic library for Windowsor MQ Transport Adaptor shared library for Linux |
| DOC\MQTA_InstallationGuide.pdf | MQ Transport Adaptor - Installation Guide. This document |
| DOC\VersionHistory.txt | MQ Transport Adaptor Version History |
| DOC\FIXEdge.properties | Sample FIX Edge configuration file. |
To install MQ adaptor:
- IBM MQ Client libraries must be installed on the FIX Edge machine where MQ Adaptor is ran. Third-party libraries are not incuded into TA package. They can be downloaded from here.
- Unpack the package and copy MQTAAddin-xx.dll/ MQTAAddin-xx.so into the FIX Edge /bin folder. Configure adaptor according to the instructions below.
Restart FIX Edge.
Configuration
IBM MQ Transport Adaptor can be configured using FIXICC or directly by editing the FIXEdge.properties file of the correspondent FIX Edge instance. All properties to be set up are described in the table below. You can also use FIXEdge.properties file from the package as an example.
Make sure that configuration of the adaptor correlates with the MQ Series Server parameters.
| Property Name | Default Value | Description |
| TransportLayer.MQAdaptor.Description | MQ Transport Adaptor DLL | Description of the transport adaptor |
| TransportLayer.MQAdaptor.DllName | bin/MQTAAddin.dll | Path to the transport adaptor module |
| TransportLayer.MQAdaptor.TimeIntervalBeforeReconnect | 1000 | Time interval in milliseconds between reconnect attempts |
| TransportLayer.MQAdaptor.StorageDirectory | FixEdge1/log | Logging directory for storage of outgoing messages. Required. |
| TransportLayer.MQAdaptor.BufferSizeForMessage | 65536 | Message buffer size. Max value is 4194304. 0 means a default value 64 * 1024 |
| TransportLayer.MQAdaptor.MQ_HOSTNAME | localhost | MS Series Server host name |
| TransportLayer.MQAdaptor.MQ_PORT | 1414 | MS Series Server port |
| TransportLayer.MQAdaptor.MQ_MANAGER_NAME | TestMQ | MS Series manager name |
| TransportLayer.MQAdaptor.MQ_CHANNEL_NAME | TestConnection | MS Series Channel name |
| TransportLayer.MQAdaptor.MQ_CCSID | 437 | MS Series Server CCSID. The coded character set identifier to use with the WebSphere MQ queue |
| TransportLayer.MQAdaptor.SslKeyRepository | /var/mqm/ssl/key | Path 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_US | SSL CipherSpec name (SSLCIPH), required to use SSL, e.g. TRIPLE_DES_SHA_US |
| TransportLayer.MQAdaptor.SslClientAuthentication | false | Remote peer authentication (SSLCAUTH) |
| TransportLayer.MQAdaptor.SslPeerName | CN=QMGR.*, OU=IBM, OU=WEBSPHERE | Remote peer DN filter(SSLPEER) |
| TransportLayer.MQAdaptor.WaitIntervalForGet | 1000 | Time interval in milliseconds to wait between polling message on MQ Series Server |
| TransportLayer.MQAdaptor.NumAttemptReconnect | 10 | Number of reconnect attempts to MQ Series Server |
| TransportLayer.MQAdaptor.SessionNumber | 1 | Number of sessions with MQ Series. Each session is a set of MQ Series queues. |
| TransportLayer.MQAdaptor.Session.1.ClientID | MQClient | MQ session ID. |
| TransportLayer.MQAdaptor.Session.1.SmartXMLProcessor | true | Enables mode of processing XML/FIXML messages:
|
| TransportLayer.MQAdaptor.Session.1.ToClientQueue | MQClient_to | The name for Queue, dedicated for message coming from client to MQ via FIX Edge |
| TransportLayer.MQAdaptor.Session.1.FromClientQueue | MQClient_from | The name for Queue, dedicated for message coming from MQ to client via FIX Edge |
| TransportLayer.MQAdaptor.Session.1.ErrorQueue | MQClient_error | The 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. |
...