Administration Version 2.6.1
 —  Using the Data Mapping Tool  —

Managing Logging and Log Files

When the Data Mapping Tool is installed, all Data Mapping Tool messages are automatically written to the Data Mapping Tool log file. You can control the level of log messages written to the Windows and UNIX event logs; read Setting Log Levels for more information.

This document covers the following topics:


Log File Location

All Data Mapping Tool log files are stored in the MappingTool\logs subdirectory of your Data Mapping Tool installation. The Data Mapping Tool log file name is MT-log.txt.nn, where nn is a sequential number of the log file (newest log files have the lowest or no number). The log files contain all current log messages, including statistics about the Data Mapping Tool session processing. If you have a problem, please keep this log file.

Top of page

Reviewing the Log Files

The log files can be reviewed using a text editor.

Top of page

Setting Log Levels

You can set the log level of messages written to the log files. Seven log levels are available (listed in order of settings that result in the most logging to those resulting in the least logging):

Log Level Description
TRACE All messages are logged or displayed.

Note:
Setting this log level can impact performance.

DEBUG Only debugging, informational, warning, error, and fatal messages are logged or displayed.

Note:
Setting this log level can impact performance.

INFO Only informational, warning, error, and fatal messages are logged or displayed.
WARN Only warning, error, and fatal messages are logged or displayed.
ERROR Only error and fatal messages are logged or displayed.
FATAL Only fatal messages are logged or displayed.
OFF No logging occurs or displayed.

Start of instruction setTo change the log level of messages written to the log files:

  1. Once the Data Mapping Tool is started, select the Logging Level... option on the Options menu.

    Or:
    Click on the graphics/btnopen.png button.

    The Set Logging Level dialog appears.

    graphics/loglvl.png

  2. Select the log level as needed. Valid log level values are TRACE, DEBUG, INFO, WARN, ERROR, FATAL, and OFF, as described earlier in this section.

    Note:
    Setting the log level to TRACE or DEBUG can impact performance.

  3. When the trace level has been selected, click OK.

Top of page