Data Transformation Engine Services Guide

Chapter 9 – BEA TUXEDO Messaging Adapters

In Map Rules and Component Rules

You can specify messaging adapter commands when using the GET and PUT functions when defining

map rules in the Map Designer or in functions 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.

♦ GET returns the message(s) from the BEA Tuxedo 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 (“TUX”,“-M C -B V,MyView -N PROCVIEW”,TEXT(

dataitem

))

This GET example gets messages from the BEA Tuxedo as a single text item. The Mode adapter

command (-M C) specifies the client mode. The Buffer adapter command (-B V,MyView)

defines the buffer type as view, with the view name of MyView. The Service Name adapter

command (-N PROCVIEW) specifies a service named PROCVIEW.

♦ PUT sends message(s) to the messaging adapter as output and returns a single text item which is

always NONE.

PUT (“TUX”,“-M C –N INQUIRY –AP JONES -T”,TEXT(

messageobject

))

This PUT example puts TEXT(messageobject) on the Tuxedo messaging adapter and returns a

single text item of NONE. The Mode adapter command (-M C) specifies the client mode. The

Service Name adapter command (-N INQUIRY) specifies the Tuxedo service name INQUIRY.

The Application-Wide Password adapter command (-AP JONES) sets the application password to

JONES. The Trace adapter command (–T) dictates that a trace file be created to report adapter

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

See the Functions and Expressions Reference Guide for information about the using the GET and PUT

functions.