Data Transformation Engine Services Guide

Chapter 8 – Using Messaging Adapters
37
♦ Map – the transaction is committed or rolled back when the map completes. The success of the map
determines whether the transaction is committed or rolled back. This is the default behavior.
♦ Burst – the transaction is committed or rolled back when each burst completes. The success of the
burst determines whether the transaction is committed or rolled back. If the map only has one burst,
this is equivalent to map scope.
♦ Card – the transaction is committed when the card completes. The success of the messaging adapter
operations in the card determines whether the transaction is committed or rolled back.
Connection Management
Connection management results in fewer connections being made to the messaging system, which may
improve performance. Existing connections are reused whenever possible. Connection sharing occurs
between cards and maps within a map.
In the situation where connection sharing occurs between cards and maps within a map, the connection
is described as active, as long as there is one or more card or rule that accesses a database and has yet to
be committed or rolled back (that is, there is an active transaction). After there are no such cards or
rules, the connection is inactive, but still alive.
Example
In addition to the burst mode on a per card basis, the map itself may be set to operate in an iterative
manner, thereby invoking multiple source card bursts in a single map invocation. For example, if the
Quantity adapter command (-QTY 50) is specified on the input card SourceAdapterCommand, and
the FetchUnit value is 5, the map processes the input and output cards until 50 data source objects
(messages) are retrieved. The map executes 10 times (50/5) times, with each input card returning 5
messages concatenated together.
Messages as a Data Target
When any messaging adapter is specified as the data target, the messaging adapter formulates and sends
a single message.
Messaging Adapter Execution Command Aliases
You can specify the adapter commands using an execution command string on the command line. Or
you can create a command file that contains adapter commands that dictate the desired execution
settings. For information about all the options that you can use with the execution commands for
messaging adapters or creating a command file, see the Execution Commands Reference Guide.
Use the execution commands -IM and -OM with the appropriate adapter alias that is specific for the
messaging adapter as follows:
Adapter Alias As Input As Output