The IMatch Log file

What it Does

IMatch uses a normal text file to record statistical information and data about warnings and errors encountered while IMatch was running. This log file can be very helpful when diagnosing problems. The file can be viewed with any text editor, e.g., Windows Notepad.

The IMatch log file is stored in the file IMATCHN_LOG.txt in the TEMP folder on your computer. N stands for the internal IMatch version number you are using, e.g., IMATCH6_LOG.txt for IMatch 2019 and later.

Viewing the Log File

To view, copy or control the log file, use the commands provided under Help > Support. In this menu you have options to set the log mode, to display the current log file (via Windows Notepad) and to save the log file to a file on your disk. This allows you to take snapshots of the active log file while IMatch is running, e.g., right after you've run into a problem.

The Log Mode

By default, IMatch writes only a minimum of data to the log file. This keeps the file small but still records errors and most warnings.

Debug Logging

If you experience problems with IMatch, enable the special high-detail debug logging and try to reproduce the problem. This debug mode produces as much information as possible for the log file, which may be very helpful in finding the reasons for problems.

To enable debug logging, go to Help menu > Support > Debug Logging.

When Debug Logging is enabled, IMatch reminds you at every start to reset the mode back to default logging (when you no longer need it).



What To Do When IMatch Runs Into a Problem

IMatch is a very robust and solid application. Nevertheless, it may run into a problem occasionally. These may be caused by bugs in the software, unexpected user behavior, external influences like faulty drivers, failing 3rd party components, damaged files and dozens of other reasons.

1. Problem or Unexpected Behavior

If IMatch runs into a problem or you get an unexpected error message, go the Help > Support and make a copy of the log file. This ensures that the current state of IMatch is available in the log file, and that the relevant data is at the end of the log file copy. This makes it easier to extract the portions related to the problem.

2. IMatch Is Unresponsive

Wait a few seconds. Windows displays the 'non-responding' message very quicky. IMatch may just be temporarily too busy to respond. Give it a few seconds to finish whatever it is doing.

When IMatch no longer reacts to user input, you cannot use the Help menu to create a copy of the log file.
In this case you need to copy the log file manually via Windows Explorer. IMatch stores log files and other intermediate files in the special folder designated for such files (the TEMP folder). If you don't know where this folder is, just type

%temp%

into a Windows Explorer address bar or the START menu search box to open it.

The IMatch log file is named IMATCH*_LOG.TXT. IMatch keeps the log file of the previous session in the file named IMATCH*_LOG_BACKUP.TXT. If you have restarted IMatch after the problem happened (which also creates a new log file), the BACKUP log file contains the information about the session where the problem happened.

3. IMatch Crashes

When IMatch crashes an internal crash handler is triggered. This handler uses Windows functions to produce a so-called DUMP file which helps us to determine the potential reason for the crash.

Please see the The Debug Dump File for detailed information.

Have a Look!

The log file contains technical information intended for photools.com support. But you can easily do a preliminary check to see if warnings or errors were logged.

If you experience issues while using IMatch and the log file contains errors or warnings, make sure to include the log file when you contact photools.com support.

Sending a Problem Report

When you contact photools.com support by email or you want to post a bug report in the photools.community, please include both log files (the current and the BACKUP).

Always ZIP (compress) the log files. This typically reduces the size by 80%.

Privacy

A log file may contain data you consider private. This includes:

IMatch log files are plain text files and not encrypted. If you don't want to make this information public, you can open the log file in a text editor and replace this information before sending or uploading the log file. If you send log files to photools.com, they will only be used to help analyzing the problem. We will delete them afterwards.