Data Transformation Engine IBM WebSphere MQ Adapter Reference Guide

Chapter 3 - IBM WebSphere MQ Commands Using the Adapter Commands

IBM WebSphere MQ Adapter Reference Guide

For information about the using the

GET and PUT functions, refer to the Functions

& Expressions Reference Guide.

From the Integration Flow Designer

Use the execution settings for a map in either the Integration Flow Designer, or

Command Server to specify the adapter settings for the MQSeries adapter as a

source or target.

On the Command Line

Specify the MQSeries adapter commands using an execution command string on

the command line or create a command file that contains adapter commands

dictating the desired execution settings. For information about all of the options

you can use with the execution commands for messaging adapters or how to

create a command file, refer to the Execution Commands Reference Guide.

Use the Input Source Override - Message execution command (

-IM ) and the

Output Source Override - Message execution command (

-OM) with the appropriate

MQSeries adapter-specific alias as follows:

Adapter Alias As Input As Output

MQSeries

(server)

MQS -IMMQS

card_num

-OMMQS

card_num

When using an adapter alias with the execution command, the MQSeries adapter

commands can be issued on the command line or in a command file. Use the

adapter commands to specify adapter functions such as:

specifying a particular message identifier

allowing output data to be broken up into multiple messages

retrieving a logical message from a source queue with a correlation identifier

For example, to override the adapter commands defined in output card 1, the

command string for the adapter in an MQSeries server environment might be:

-IMMQS1 ‘–QMN queuemgr -QN topqueue -T’

This sample execution command string specifies the queue manager named

queuemgr and the queue named topqueue as the source for this card’s data.

The

–T command dictates that a trace file be created to report adapter activity

information, recording the events that occur while the adapter is retrieving this

data.