Page Comparison

MQ Transport Adaptor — Setup Guide

Overview

The document contains full instructions how to install MQ TA for testing.

Getting MQ Soft

If you need to setup your own MQ server, you can download software from IBM Site.

Websphere MQ Configuration# MS Series manager name

Steps to configure access to Websphere MQ (running on Windows) from the remote host are described below. These configuration is performed on the MQ Server host.

1. Create User
   1. Create non-domain user e.g. mquser in 'mqm' group.
   2. Change its domain to local host name e.g. EVUAKYISD0223
   3. Grant this user permissions to login remotely
   4. Grant this user Administraive permissions
2. Start MQ
   1. Start all MQ services ('IBM MQSeries' and 'IBM Websphere MQ(<InstallationName>)') under user created on previous step
      In order to change user for service go to Services. Select service and open its properties, go to 'Log On' tab, select 'This user' and specify user credentials
3. Configure Manager and Queues
   1. Start MQExplorer.
   2. Add new Queue Manager (e.g. TestMQ):
      
   3. Add Server-connection channel to created Queue Manager (e.g. TestConnection)
      
   4. Set channel MCA with user from step 1.1 (mquser):
       
   5. Add Client-connection to Queue Manager:
      1. Select 'New Client-connection Channel' menu item:
         
      2. Client-connection Channel should have the same name as the Server-connection channel (TestConnection):
         
      3. Client channel connection name should be the same as host public IP (10.17.13.88):
         
4. Add queues.

Check connection to Queue Manager from remote host

Check connection using MQ

...

Explorer

In order to use described approach you need to install IBM WebSphere MQ Explorer to the client box.

...

QM should be accessible via remote MQ Explorer.

Check connection using FE

In order to check connection to Queue Manager from the remote (client) host using FE:

...

1. Login to 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:
   

...

MQ Transport Adaptor — Integration Guide

Overview

MQ Adaptor is an add-in Transport Adaptor for FIXServer that allows clients to communicate with FIXServer over IBM MQSeries middleware.

Description

MQ Adapter 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

Installation

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:

...

• make sure IBM MQ Client is installed on the FIX Edge machine. For furtehr details see here;
• unpack the .zip file and copy MQTAAddin-xx.dll into the FIX Edge \bin folder. Configure adaptor according to the instructions below;
• restart FIX Edge.

Configuration

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 useFIXEdge.properties file from the package as an example.

...

Troubleshooting

MQ TA fails to initialize with record in log "Failed to set character set. Code: some code": make sure QueueManager on server side is running and you are trying to set right code character set.