Data Transformation Engine Services Guide

Chapter 9 – BEA TUXEDO Messaging Adapters
41
BEA Tuxedo Messaging Adapter Examples
The example files provided in the /usr/tandem/nsdte/examples/Tuxedo/SlashQ folder demonstrate the
use of the BEA Tuxedo messaging adapter. The readme.txt file in this folder provides instructions on
how to use these example files.
Using the Adapter for Tuxedo Service
The Tuxedo service is a two-way messaging system running on a Tuxedo server.
Tuxedo Service for Data Sources
When mapping source data that is defined as a Tuxedo service, the data returned from the service is the
source data.
The complication with data sources is that typically data must be provided to the service, so that data
may be returned. The mechanism to do this is through the Buffer adapter command (-B) if this is called
from an input card, or as the third parameter in a GET function call. There is a limit of 260 bytes on the
length of the adapter command, which limits the amount of data passed to a service for a data source
when not using the GET function. The GET function should therefore be used if the data is large, or used
as an alternative retrieval method if the data is binary.
If the data to be passed to the service is always fixed, then enter it directly in the Tuxedo adapter
command in the data source settings. Typically, this data is not fixed and must be mapped from some
other input source. To achieve this the GET function should be used. The sample.mms map provided in
the Examples\Open Design Pack\Tuxedo folder and described in this chapter demonstrates how this is
done.
Tuxedo Service for Data Targets
When mapping data to a data target which is defined as a Tuxedo service, the data is passed to the
specified service. The buffer returned by the service is discarded, but the success code is used to
determine the success status of the card, and hence the map.
Additional System and Configuration Requirements
In addition to the requirements detailed in the Getting Started book, the following is an additional
requirement to install and run the BEA Tuxedo messaging adapters:
♦ The BEA Tuxedo software version 6.4 must be installed and configured on the same machine as a
Command Server.