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.
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.
Examples using Fail on Warnings (-F)
The following examples shows use of Fail on Warnings (-F).

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.
    - Examples using Fail on Warnings (-F)
      The following examples shows use of Fail on Warnings (-F).
  - 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.
  - 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.

Examples using Fail on Warnings (-F)

The following examples shows use of Fail on Warnings (-F).

-F: A map-failed message is returned when any of the warning codes is encountered.
-F!: A map-failed message is returned when any of the warning codes is encountered.
-F18: A map-failed message is returned when a Page Usage Count Error (18) is encountered.
-F!18: Excluding the Page Usage Count Error (18), a map-failed message is returned for all of the other warning codes.
-F18:27:28: A map-failed message is returned when any of the specified warning codes is encountered (18, 27, or 28 in this case).
-F34: A map-failed message is returned when a Too Few Pages Requested, More Allocated Error (34) is encountered.

If the -F command is used and the map fails due to the cause associated with the specified warning, the execution audit includes an Error map status with the appropriate warning code preceded by a minus sign and the map-failed message.

For example:


<Summary MapStatus="Error" Return="-28">
   <ElapsedTimeInSec>0.0898</ElapsedTimeInSec>
   <Message>Input type contains errors.</Message>
   <CommandLine>'install_dir\example\ansiack\receiveEDI.mmc'
   </CommandLine>
   <ObjectsFound>0</ObjectsFound>
   <ObjectsBuilt>0</ObjectsBuilt>
</Summary>

When using this command, you cannot specify the same warning code using the -Z command. If you do, the setting of the latter command in the command line is used. For example, if your command line included -F18:26 -Z18:27:28, a return code of 18 (Page Use Count error) would be ignored because the Ignore Warnings command (-Z) follows the Fail on Warnings command (-F).

A map-failed message is returned when any of the warning codes is encountered for both the -F and -F! commands.