Runtime Service

The Runtime Service has a few log files that can be of value when investigating problems. The logs are in the “Program files/Unisys/Data Exchange<version_number>/Runtime Service/Log” directory. The current file is called DataExchangeRuntimeServiceLog.txt, and the older files are called DataExchangeRuntimeServiceLog.txt.x (where x = 1, 2, 3, 4 or 5, and 5 is the oldest). By default, only the user who installed the Runtime Service and the System account have the privilege to access and read the log files.

Configuration

For configurations related to log files, change the following text in C:\Program Files\Unisys\Data Exchange<version number>\Runtime Service\ServiceLoggingConfig.config:

  1. To get more information while Runtime Service is handling the messages and data transformations, turn on Debug for FileLogger. The default level is INFO.

    <logger name="FileLogger">
    <level value="DEBUG" />
    <appender-ref ref="LogFileAppender" />
    </logger>
  2. To get more log file backups or more contents in a single log file, change the maximum log file roll back number and file size. The default values are 5 and 10 MB.

    <file value="Log\DataExchangeRuntimeServiceLog.txt"/>
    <encoding value="utf-8" />
    <appendToFile value="true"/>
    <rollingStyle value="Size"/>
    <maxSizeRollBackups value="5"/>
    <maximumFileSize value="10MB"/>
  3. To get more tracing information about the transactions (from the time Data Exchange reads the records from the source data store and commits to the target), change the log level of TransactionTraceLogger from Info to Debug.

    <logger name="TransactionTraceLogger">
    <level value="INFO"/>
    <appender-ref ref="TransactionTraceFileAppender"/>
  4. To get transaction log, set the value of TransactionLogger to INFO. The default level is OFF.

    <logger name="TransactionLogger">
    <level value="INFO"/>
    <appender-ref ref="TransactionLogAppender"/>

For configurations related to Runtime Service processing change the following text in C:\Program Files\Unisys\Data Exchange<version_number>\Data Exchange Runtime Service<version_number>.exe.config:

Turn on Transaction Log, so that Runtime Service will write the transformed commands to transaction log before committing them to the target. The default is False.

<setting name="TransactionLoggingOn" serializeAs="String">
<value>True</value>
</setting>