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.
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.
MapTrace (-T)
The MapTrace execution command (-T) creates a trace file that you can use to diagnose invalid data or incorrect type definitions.

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.
  - Command availability
    Some commands are limited because they can only be used with a Command Server and cannot be used from within a RUN() function or using the Platform API. Also, there are some commands that are not available on all platforms. The Map Designer, and the Command Server have a user interface for these commands where they apply.
  - MapAudit (-A)
    Use the MapAudit execution command (-A) to control the creation of audit log information.
  - Close Window (-B)
    When executing a map using a Command Server for Windows™ or AS/400® OS/400®, use the Close Window execution command (-B) to exit the Command Server application after the map has completed.
  - Century (-D)
    Use the Century execution command (-D) to specify the start of a 100-year range used to supply a missing century portion for a Date & Time.
  - Fail on Warnings (-F)
    Use the Fail on Warnings (-F) execution command to specify that the map should fail when any of the selected warning codes are returned.
  - Ignore Validation Options (-G)
    Use the Ignore Validation Options execution command (-G) to specify the item properties, if any that should be ignored during validation.
  - Input Source Override - Application (-IA)
    Use the Input Source Override - Application execution command (-IA) to override specifications in the compiled map file for a specific input card for a single execution of a map.
  - Input Source Override - Database (-ID)
    Use the Input Source Override - Database execution command (-ID) to override specifications in the compiled map file for a specific input card for a single execution of a map.
  - Input Source Override - Echo (-IE)
    Use the Input Source Override - Echo execution command (-IE) to override specifications in the compiled map file for a specific input card for a single execution of a map.
  - Input Source Override - File (-IF)
    Use the Input Source Override - File execution command (-IF) to override specifications in the compiled map file for a specific input card for a single execution of a map.
  - Input Source Override - Message (-IM)
    Use the Input Source Override - Message execution command (-IM) to override specifications in the compiled map file for a specific input card for a single execution of a map.
  - Input Source Override - Pointer (-IP)
    The Input Source Override - Pointer execution command (-IP) is for platform API users only, and allows data to be passed in via a pointer rather than a buffer.
  - List (-L)
    When using a Command Server on a platform other than Windows™, use the List execution command (-L) to display a list of the data sources and targets that are compiled into a map file.
  - Initialization File Override (-N)
    To override the default initialization (dtx.ini) file for the Command Server, use the -N command option as the first command to the Command Server, as indicated in the following syntax:
  - Output Target Override - Application (-OA)
    Use the Output Target Override - Application execution command (-OA) to override specifications in the compiled map file for a specific output card for a single execution of a map.
  - Output Target Override - Database (-OD)
    Use the Output Target Override - Database execution command (-OD) to override specifications in the compiled map file for a specific output card for a single execution of a map.
  - 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.
  - Output Target Override - File (-OF)
    Use the Output Target Override - File execution command (-OF) to override data destination specifications for a specific output card in a compiled map file for a single execution of a map.
  - Output Target Override - Message (-OM)
    Use the Output Target Override - Message execution command (-OM) to override data destination specifications for a specific output card in a compiled map file for a single execution of a map.
  - Output Target Override - Pointer (-OP)
    The Output Target Override - Pointer execution command (-OP) is for platform API users only, and allows data to be returned via a pointer rather than a buffer.
  - WorkSpace PageSize (-P)
    When a file-based WorkSpace is used, the amount of memory accessed at a given time depends on the number of pages and the size of pages you configure for a map to run. Use the WorkSpace PageSize execution command (-P) to specify the size of and number of pages to be used.
  - Refresh Status (-R)
    The Refresh Status execution command (-R) is used to specify the frequency of map status update when displayed in the Command Server window when using the Windows™ operating system or in the console when using all other operating systems.
  - MapTrace (-T)
    The MapTrace execution command (-T) creates a trace file that you can use to diagnose invalid data or incorrect type definitions.
    - Examples using MapTrace (-T)
      The following are the examples of the MapTrace (-T) command.
  - Stop Validation (-V)
    The Stop Validation execution command (-V) specifies to stop validation at the card where the first error is detected.
  - Time Zone (-TZ)
    The following 39 time zones are identified here, for use with the -TZ command.
  - WorkSpace (-W)
    When you run a map, the Command Server uses its own paging scheme to access information about the data as efficiently as possible. Portions of both workspace data and actual data are paged as needed. The workspace can be either a combination of files and memory or memory-based. When file-based workspace is used, the amount of memory accessed at a given time depends on the number of pages and the count of pages configured for map execution.
  - Retry (-Y)
    The Retry execution command (-Y) is used to specify the retry rate for non-data files accessed during map execution.
  - Ignore Warnings (-Z)
    The execution Ignore Warnings execution command (-Z) specifies for a map that selected warning codes should be ignored and a 0 return code should be issued.
- 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.
- 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.

MapTrace (-T)

The MapTrace execution command (-T) creates a trace file that you can use to diagnose invalid data or incorrect type definitions.

For more information about the trace file, see the Map Designer documentation.

Use this command to trace a particular input or output card, a range of input data objects, or to produce a trace summary. When the -T command is used without other options, no trace log is produced.

The MapTrace (-T) execution command overrides all trace settings in the compiled map. You cannot override individual map settings. When you run the -T command, only the trace options that you specify on the command are in effect.

-T [ I [ { [ C input_card_num ] | from [:to] } ] ] [ O [ C output_card_num ] ] [ S ] [ B ] [ U ] [ =filepath ]

Option: Description
I: Produces detailed trace information for all input cards.
Cinput_card_num: Produces detailed trace information for a single input card. For example, the command -TIC3 produces detailed trace information for input card 3.
from[:to]: Produces detailed trace information for a range of input objects. For example, to produce trace information for objects 1000 to 1320, specify -TI1000:1320. The upper limit of the object range is optional. To trace from input object 1000 to the end of the file, you can specify -TI1000.
O: Produces detailed trace information for all output cards.
Coutput_card_num: Produces detailed trace information for a single output card. For example, the command -TOC3 produces detailed trace information for output card 3.
S: Produces summary level trace information for all input and output cards providing a message for each card. For example, the message for a particular card might be Input 1 was valid, but 34 bytes of unknown data found or Output 2 built successfully.
B: Creates the trace file in binary format.
U: Creates the trace file with a unique name, in the format Mer_mapname_processKey_mapCounter_hostname.mtr.
=filepath: Specifies a file name, file path, or file name and path for the trace file. By default, the trace file is created as mapname.mtr in the directory of the compiled map (.mmc) file.
If you specify =filepath, it must be the last option on the -T command.