Data Transformation Engine E-Mail Adapter Reference Guide

E-mail Adapter Reference Guide

Chapter 5 - Troubleshooting

For information about error codes and messages returned by the adapters, see

Appendix A - Return Codes and Error Messages.

Various troubleshooting tools are available when you encounter problems using

e-mail adapters as data sources or targets for a map. If you attempt to run a map

that uses an e-mail adapter and receive a run-time error or do not get the

expected output, use any or all of the following troubleshooting tools:

♦ View the Trace log file (.mtr)

♦ View source and target data

Trace Log File

The adapter trace log file contains detailed information provided by the adapter,

recording the actions that are taking place such as connections that are

established and statements that are executed. The trace log file is produced

during the adapter execution and can be used as a debugging aid. To produce a

trace file for the adapter, use the

–TRACE command. The default name for the log

is m4email.mtr which is located in the same directory as the compiled map file.

You can specify an alternate filename and/or location using the

–TRACE command.

Sample MAPI E-mail Adapter Trace File

This sample trace file was produced using the MAPI e-mail adapter; the other

e-mail adapters produce the same type of information in the same format.

Mercator E-Mail Adapter, Version 6.0(560)

Built for WIN32 - INTEL on Mar 23 2000 at 11: 38: 41 by BocaBuild.

Mercator Command Server is ‘C:\Mercator6.0\mercnt.exe’.

Extended MAPI 1.0 for Windows NT is

Using C: \WINNT\System32\MAPI32.DLL (Version 5.5.2174.0) for MAPI services.

Retry Count is 0. Retry Interval is 0. Rollback is OFF.

Fetch Unit is 0. Burst Mode is OFF.

Run Started at 08: 44: 17.299 on 03/28/00.

Options used: trace,to,proto

Recipient #1 is FMUERR111.

Recipient ‘FMUERR111’ resolved to ‘FMUERR111’ at ‘MAPIPDL: ‘.

MAPIPDL: appears to be a special MAPI address type. Copying internal parameters.

Message sent successfully.

Run Completed at 08: 44: 19.542 on 03/28/00.