Data Transformation Engine Execution Commands Reference Guide

Chapter 2 - Execution Commands List of Execution Commands
Execution Commands Reference Guide
39
Output Target Override – Echo (-OE)
Use the Output Target Override – Echo execution command (-OE) to override
specifications in the compiled map file for a specific output card for a single
execution of a map.
Use this command when you want the data resulting from one or more output
cards passed back to a calling application or a map, rather than being directed to
a file, database, application, or message. If this command is used to override
more than one output, the results of the outputs are concatenated without
separators.
For example, use this command in conjunction with the RUN() function to pass
data from one map to another:
-OE
card_num [S|X]
Option Description
card_num
This is the card number of the output to override.
S
Return the size (in bytes) of the output data. This option causes
the resulting output data to be returned as an ASCII number
representing the size of the data, followed by a space, followed
by the data itself.
For example, if used in a RUN() function:
RUN (“mymap.mmc”,”-AE -OE2S -OE4S”)
If the data resulting from output card #2 is “This and That”
and the output from output card #4 is “19439.27”, the string
returned by this example RUN() function is “13 This and That
8 19439.27”.
If the size option is not used, the data returned by this example
RUN() function is “This and That 19439.27”.
X
Exclude this card from echo. The output is stored in memory and
not echoed back to the specified map or application.
You might use this option to optimize performance when a map
has an output used strictly as a scratch card, that is, it is built
only to be used by a later output.