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
19
In Map Rules and Component Rules
Specify messaging adapter commands using GET and PUT functions when defining
map rules in the Map Designer or in component rules in the Type Designer.
The default adapter scope when using both
GET and PUT functions is burst. GET
and
PUT functions have the following default behaviors:
Result GET Function PUT Function
Successful
Completion
All source messages on the
source queue are deleted.
The message is
sent.
Failure to
Complete
Source messages retrieved
through the messaging
adapter are not deleted.
The message is
not sent.
Using the GET Function
The GET function returns messages from the MQSeries server messaging adapter
as a single text item. The following example shows a map rule using a
GET
function with messaging adapter commands to specify particular adapter settings:
GET (“MQS”,“-QMN globalque -QN top1”)
This GET example retrieves messages from the IBM MQSeries server messaging
adapter as a single text item. The Queue Manager Name adapter command
(
-QMN globalque) specifies a queue manager named globalque. The Queue
Name adapter command (
-QN top1) specifies the top1 queue.
Using the PUT Function
The PUT function sends messages to the messaging adapter as output and returns
a single text item that is always NONE. The following example shows a map rule
using a
PUT function with messaging adapter commands to specify particular
adapter settings:
PUT (“MQS”,“-QMN myque -QN best”,TEXT( messageobject ))
This PUT example places TEXT(messageobject) on the MQSeries server
messaging adapter and returns a single text item of NONE. The Queue Manager
Name adapter command (
-QMN myque) specifies the myque queue manager. The
Queue Name adapter command (
-QN best) specifies the best queue.