Calman Error Logging

When Calman generates an error, it is often due to a failure of Calman to communicate properly with an external hardware or software device. If you do encounter a Calman error, it is often helpful to enable Calman’s full logging options while you recreate the problem.

Calman is capable of logging the operations that occurred prior to, and during error conditions. Calman has extensive error logging options that are not normally enabled, to minimize disk utilization during normal operation.

After you have enabled full Calman logging and have recreated the original problem, the Calman log file can be sent to Calman Support. This will usually assist the Calman support and development team in troubleshooting the issue to provide the necessary solution and/or temporary workaround.

Calman Full Log

To collect a Calman log file with full logging enabled:

1. On the Calman main menu, select Logging
2. On the Logging dialog, enable all the Logging Options.
3. Close the Logging dialog.
4. Run through the same Calman processes that previously resulted in a Calman error. Repeat the processes, if necessary, until the error occurs.
5. If the error results in Calman closing, re-open Calman.
6. On the Calman main menu, select Logging
7. On the Logging dialog, double-click the log file at the top of the Log Files list. This will result in the log file being opened in Notepad.
8. Save a copy of the log file to a convenient location (e.g. the Desktop).
9. Disable all Logging Options except “Errors.”
10. Generate an email to calman-support@portrait.com. Describe the Calman measurement or calibration conditions that resulted in the error and attach a copy of the Calman log file.

Calman Debug Log

In a few specific cases, Calman support personnel may request an extended log file known as a “Calman debug log.” If you are requested to gather this type of log file, do the following:

1. Close Calman.
2. Navigate to the following directory on the Calman computer:
   C:\\ProgramData\Portrait Displays\Calman (Your Version Name)\Logs
3. Sort the log files by Date modified to identify and open the current date log file. (If there is not a current date log file, open and close Calman first, to create a current date log file.)
4. Edit line two of the current date log file to read “Level = 255” (the default is Level = 1).
5. Save and close the log file.
6. Open Calman (click OK on each of the small message boxes that appear).
7. Run through the same Calman processes that previously resulted in the error/issue of interest. Repeat the processes, if necessary, until the issue occurs.
8. If the issue results in Calman closing, re-open Calman.
9. On the Calman main menu, select Logging
10. On the Logging dialog, double-click the log file at the top of the Log Files list. This will result in the current date log file being opened in Notepad.
11. Save a copy of the log file to a convenient location (e.g. the Desktop).
12. Generate an email to calman-support@portrait.com. Describe the Calman measurement or calibration conditions that resulted in the error and attach a copy of the Calman log file.