Data Transformation Engine Services Guide

Chapter 9 – BEA TUXEDO Messaging Adapters

Option Description

binary_data

Up to 260 alphanumeric characters. No delimiters are required, the

size value defines the character count of the binary data. Spaces are

allowed. Within a map, the command line of an adapter is limited to

260 characters and this limitation applies to the number of bytes

passed to the adapter.

field_name

If the buffer type of FML value is specified, the name of the field to

be extracted from the FML stream must be the next argument.

view_name

If the buffer type of view is specified, the name of the view must be

the next argument.

The format of the binary data is identical to the data format presented to an output card. If calling the

Tuxedo adapter from a GET function, the data to be sent to the called service may be passed as the third

parameter. In this case, the size and binary data should not be provided with the Buffer adapter

command (-B). However, the buffer type must still be specified to instruct the adapter how to interpret

the datastream.

By calling a map from within a RUN function, data is mapped from an input card directly into the RUN

arguments, and then passed to the Tuxedo adapter on input.

Note The Buffer adapter command (-B) is only valid when calling a Tuxedo service as a data source.

Correlation ID (-CID)

Use the Correlation ID adapter command (-CID) to specify a particular correlation ID for a data source

or a data target. A correlation identifier can be up to 32 bytes long.

-CID

correlation_ID

Option Description

correlation_ID

-or-

“

correlation_ID

”

The correlation ID value can be 1 to 32 alphanumeric characters

specified as a single string that contains no spaces or as multiple

strings enclosed in double open (“) and double closed (”) quotes

with spaces.

Use the Correlation ID adapter command (-CID) for a data source to retrieve messages from a queue

with a specific correlation ID. When a correlation identifier is specified for a data source, the adapter

retrieves the first message on the queue with that correlation ID.

Use the Correlation ID adapter command (-CID) for a data target to assign a correlation ID to a

message when placing it on a queue.

If -CID is used in conjunction with the -MID command, the message retrieved begins with the first

message on the queue that has the specified message ID and correlation ID.