Loan Debugger Pro is a real‑time diagnostic viewer that displays the internal processes Encompass performs as a loan is edited. It shows field changes, rule executions, calculations, performance delays, and other behind‑the‑scenes events, enabling quick identification and resolution of issues.

Benefits

  • Provides real‑time visibility into loan events, including field updates, triggers, and calculations.
  • Shows exactly what triggered a change and presents the full cause‑and‑effect sequence.
  • Highlights errors clearly within the event log.
  • Consolidates triggers, calculations, and auto‑populated fields into a single location.
  • Allows visibility into system processing times.

 

Prerequisite

Before using the tool, ensure the following folder exists on the workstation:

C:\EncompassLog\DebugLog

 

Activation

To turn this tool on:

1. Log in to Encompass® as a Super Admin.

2. Open LTK PowerTools™ from the Encompass® menu. Confirm the license includes the Expert, Optimized or Enterprise Tier.


3. Click Settings > PowerTools™ Expert tab.

4. Turn on Loan Debugger Pro by clicking On.

Important: After activation of the Tool, be sure to wait for the prompt stating that the download is complete prior to continuing.

5. Ensure a license number populated and restart Encompass®.

 

Using the Tool

1.      Locate the Loan Debugger Pro (silver target icon) in the Windows system tray (bottomright).

 

2.      Rightclick open the options menu.

3.      Click a Debug Mode: Standard (highest overhead/detail), Faster (lower overhead/detail), or Ultra (lowest overhead/detail).


4.      Click Close.

5.      Open a loan in Encompass.  The Loan Debugger Pro icon turns blue to indicate active monitoring.


6.      Click the icon to view the debugger results.

 

Interface Highlights

Important Events Panel (TopLeft): It is recommended to select the ignore common errors check box.


The Events Panel provides real-time monitoring of all loan updates. It records opened forms, modified fields, executed business rules, and system-generated events.

A key feature of Loan Debugger Pro is its ability to track every event triggered by a loan change. When one event—such as a field value update—initiates additional events, they are displayed in a tree structure. This allows administrators to clearly follow each change and understand its cause.

Additionally, Loan Debugger Pro calculates the elapsed time for each event and event group. This helps administrators identify potential performance issues, such as slow calculations or business rules. Timing may vary based on the selected Debug Mode; for performance analysis, “Faster” or “ULTRA” modes are recommended.

 

Debug Log (TopRight): Linebyline code execution results with errors highlighted in red; synchronized with the events panel for quick crossreference. While similar to the ICE diagnostic tool, this tool updates in real time as changes occur. Selecting any event line in the Important Events section will select the line in the Debug Log section where that event occurred.  This helps the administrator to easily navigate between events before and after to further investigate the issue.

 

Any lines that contain errors or exceptions are highlighted in red.


Summary (BottomLeft): Tabs for Errors, Triggers, Calcs, and Fields provide categorized summaries of all activity since the loan was opened.


 

Performance Testing

Administrators can run performance tests individually or use “Run All Tests” to execute all simultaneously.


If the purpose of using this tool is to review processing times, it is recommended to select the options below to more closely replicate system performance when the tool is disabled.


Note that a loan must be open to run performance tests.


 

Settings & Deactivation

Rightclick the tray icon and choose Debug Options to change modes or disable the tool. The tool closes automatically when Encompass closes.

 Image Placeholder 

Installed Components

  • Custom Form: None
  • Codebase Assemblies: None
  • Custom Data Objects: LoanDebuggerProPlugin3LicenseKey.txt
  • Plugins: LoanDebuggerProPlugin3.dll (version 6.0.0.1 - updated 3/21/24)


Custom Fields Created:

Fields

Description

Format/Type

Max Length

N/A