Data Transformation Engine Services Guide

Chapter 9 – BEA TUXEDO Messaging Adapters

Using the Adapter Commands

The BEA Tuxedo messaging adapters support Tuxedo services or Tuxedo /Q for data sources and data

targets, or both. The adapter commands enable you to specify the caller mode, the Tuxedo username and

password, the name of the Tuxedo client, the data format, and more. You can specify the use of the

BEA Tuxedo messaging adapters in map rules and map cards using the Map Designer, in map execution

settings using the Integration Flow Designer, in execution commands on the command line, in a

command file, or with the Platform API.

The adapter supports commands that specify the data format of the data being passed to the output card,

or specifies the desired format of the data being returned from an input card.

Tuxedo or Tuxedo (MT) Adapter

The messaging adapter for Tuxedo that is installed on your machine must correspond with the BEA

Tuxedo or BEA Tuxedo with Client Threads Supplement messaging system software that is installed.

Because you are running either the Tuxedo or the Tuxedo (MT) messaging adapter, you must specify

which adapter is to be used for a source or target in map cards, execution settings, and on the command

line.

If you do not know which Tuxedo software you are running, contact your System Administrator.

When to Select Tuxedo

When the messaging adapter for Tuxedo has been installed in an environment running the BEA Tuxedo

messaging system software, you select to use the Tuxedo adapter as follows:

♦ In the Map Designer. For the AdapterSource setting in an Input Card dialog or the

AdapterTarget setting in an Output Card dialog, select the value Tuxedo.

♦ In Map Rules and Component Rules. Use the adapter commands in functions in component rules

in the Type Designer and map rules in the Map Designer. You can use adapter commands with GET

and PUT functions.

♦ In the Integration Flow Designer. Select Tuxedo for the AdapterSource or AdapterTarget

value in a map’s execution settings for either the Command settings.

♦ In Execution Commands. The messaging adapter commands are used with the Input Source

Override - Message (-IM) or Output Source Override - Message (-OM) execution commands.

Specify on the command line either the (-IM) or (-OM) execution command with the server adapter

alias (TUX) followed by the adapter commands that you want passed to the Command Server at

execution time for a source or target. You use these execution commands to override particular

settings, such as a user id and password.

♦ Using the Platform API from an Application. Execute maps that use the messaging adapter.