Data Transformation Engine Resource Adapter Reference Guide

Chapter 2 - Resource Adapters Use Functions
Resource Adapters Reference Guide
29
Functions
For detailed information about using the GET, PUT and all other functions, refer
to the Functions and Expressions Reference Guide.
Using the GET Function
The GET function returns messages from the 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 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.
For more adapter-specific usage information, refer to each adapter-specific
chapter in the various adapter reference guides.
Using the PUT Function
The PUT function sends messages to the 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 ("MQSC","-QMN myque -QN best",TEXT( messageobject ))
This PUT example places TEXT( messageobject ) on the MQSeries client 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.
For more adapter-specific usage information, refer to each adapter-specific
chapter in the various adapter reference guides.
Note For all adapters, the scope of the PUT function is burst. The executable map
controls the transaction behavior (commit or roll back), regardless of nested RUN
functions.