Home
Execution commands
This documentation includes information about the various ways to use execution commands and their options when executing maps. Execution commands are used to specify how to execute a map.
Examples
This documentation presents a variety of examples involving the execution of maps using various execution commands in a RUN() function and from the command line in UNIX™ and Windows™ environments.
Using a run function and echoed outputs in memory
When using the Output Target Override - Echo execution command (-OE) with the X option, the output is stored in memory and is not echoed back to the calling map or application.

Execution commands
This documentation includes information about the various ways to use execution commands and their options when executing maps. Execution commands are used to specify how to execute a map.
- Command Server overview
  Use execution commands to override the map settings or card settings in a compiled map when a map is run using one of the following methods:
- Using Command Server commands
  When you run a map, you can:
- List of execution commands
  This documentation contains information about the execution commands and associated options, including the syntax of each command and its particular usage.
- Examples
  This documentation presents a variety of examples involving the execution of maps using various execution commands in a RUN() function and from the command line in UNIX™ and Windows™ environments.
  - Running a map located in a different directory
    From a UNIX™ command line, enter:
  - Creating work files in an alternate directory
    From a Windows™ command line, enter:
  - Executing multiple maps from a single command
    From a Windows™ command line, enter:
  - Overriding a database target
    Suppose you want to run the map multitran.hp, overriding some of the settings for the fourth output card, which is a database target.
  - Overriding the schema location at run time
    When you have a map that is designed to parse input XML data, but want to use a different schema location than what was set up in the Metadata location setting for the root type on the input card in the Map Designer GUI, run the map from the command line and override the map settings.
  - Executing a command file
    As an alternative to typing execution commands on the command line, you can run maps using maps and execution commands in a command file.
  - Using a run function and echoed outputs in memory
    When using the Output Target Override - Echo execution command (-OE) with the X option, the output is stored in memory and is not echoed back to the calling map or application.
  - Audit Log in memory
    Similar to how the data built for an output card can be echoed back to a calling map or application, the audit log, including Data and Execution information, can be placed in memory using the MapAudit execution command (-A) with the M option and echoed back to its calling map or application with the E option
- INI commands for debugging maps
  This documentation presents the dtx.ini (INI) file commands you can use for the debugging of adapter connections for maps run using non event-driven execution methods.

Using a run function and echoed outputs in memory

When using the Output Target Override - Echo execution command (-OE) with the X option, the output is stored in memory and is not echoed back to the calling map or application.

A typical scenario in which this is useful and can serve to optimize performance is when a map has an output that is only used as a scratch card. Tthat is, it is built to be used only by a subsequent output.

For example, if used in a RUN() function:


RUN ("some_map.mmc","-WM -OE1 -OE3X -OE4")

In this example, a memory-based WorkSpace is used and the data for output cards 1 and 4 are echoed back to the rule in which the RUN function is located. All other map settings and input and output card settings for executing this map, such as MapAudit, Century, and so on, would use the settings compiled into some_map.mmc.

This results in the execution of some_map.mmc. The data produced for output card 1 and 4 is concatenated and echoed back to the rule containing the RUN function. The data for output card 3 is not echoed back to the rule because of the use of the X option. Given that output card 1 builds 103910^ABC, output card 3 builds justsomedata, and output card 4 builds 01/23/98, the RUN function returns 103910^ABC01/23/98.

The most common use for this feature of echoed outputs is when the data for an output card is needed only during the execution of the map, perhaps for use on a later output card, and can be discarded after the map has completed execution.

For another example of using an echoed data destination, see the Platform API documentation.