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.

Read syntax diagramSkip visual syntax diagram
>>- -T -+------------------------+------------------------------>
        '-I--+-----------------+-'   
             +-Cinput_card_num-+     
             '-from-+-----+----'     
                    '-:to-'          

>--+-------------------------+--+---+--+---+--+---+------------->
   '-O--+------------------+-'  '-S-'  '-B-'  '-U-'   
        '-Coutput_card_num-'                          

>--+-----------+-----------------------------------------------><
   '-=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.