Output Target Override - Echo (-OE)

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:

-OEcard_num[M['filename']]   [S|X][EN][EA][EF][ES][EW][AF][AI][U][!U]

Option

Description

card_num

This is the card number of the output to override.

M'filename'

This is the metadata (XML schema or DTD) file location of the output card to override.

Specify filename as an absolute path along with the file name and enclosed in single quotes, for the metadata when parsing output XML. An example is:

M'k:\my_project_folder\myschema.xml'

Use this command option to override the Metadata location setting for the root type specified on an output card in the Map Designer GUI.

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.

EN

Use this command option to never call the external parser for document verification.

EA

Use this command option to always call the external parser for document verification.

EF

Use this command option to call the external parser for document verification only if validation fails.

ES

Use this command option to call the external parser for document verification only if validation is successful.

EW

Use this command option to call the external parser for document verification only for the well-formed document.

AF

Use this command option to fail on adapter warnings.

AI

Use this command option to ignore adapter warnings.

U

Use this command option to apply the burst setting.

!U

Use this command option to not burst (integral mode).