PPJ Manual
HomeCurrent IssuesDownloads
  • Welcome
  • Releases
    • PPJ 2023
  • PPJ 2023
  • PPJ Web API
  • PPJ Desktop API
  • Wisej.NET Documentation
  • General
    • Framework
      • Features
        • SAL and SQL Functions
        • Constants and Variables
        • SalContext
        • Visual Toolchest
        • XSal2
        • Reporting Support
        • LINQ Support
        • SalCompileAndEvaluate
        • Unicode Support
        • Startup Arguments
        • App.config
      • Data Types
        • Automatic Casts
        • Dynamic Arrays
      • Controls
        • ToolBar
        • TabControl
        • TableWindow
        • QuickObject
        • Ribbon Bar
        • NavigationBar
      • SQL Support
        • Configuration
        • ADO.NET Drivers
        • Bind and Into Variables
        • DBP Parameters
        • SqlContext
      • Extensions
        • Table Window
        • Unicode Support
        • Bug Fixes
        • Object Oriented Types
        • Custom Parsers
        • Named Properties
        • Microsoft Charts
        • Tabbed MDI
        • Watermark
        • HTML Rendering
      • Skins and Themes
        • Skin Files
        • Theme Files
        • Configuration
        • Skin Editor
        • Theme Builder
      • Tracing
        • Trace Viewer
        • Default Listeners
        • Tracing the Application
      • Spell Checker
        • Dictionaries
    • Ported Application
      • Project Structure
        • Late Bind Calls
        • Visual Styles
        • Unqualified References
        • Message Actions
        • When SQLError
        • Classes
      • Global Items
      • Forms
      • COM/ActiveX
      • Multiple Inheritance
      • Configuration Tool
      • Issues & Workarounds
    • Ported Reports
      • General
      • Crystal Reports
        • Structure
        • Unsupported Features
      • List & Label
        • Report Conversion
        • Structure
        • Document
        • Input Items
        • Passing Data
        • Unsupported Features
      • Reporting Services
        • Features
      • Stimulsoft
        • Break Groups
        • Fields
        • Formulas
        • Cache Mode
Powered by GitBook
On this page
  • Enable tracing in {app}.exe.config
  • Enable Tracing at Runtime
  • Trace Sources

Was this helpful?

  1. General
  2. Framework

Tracing

The PPJ Framework starting from version 2010 has been instrumented with a granular system of trace calls (we will fine tune it and improve the location and details of the trace calls in future builds and major version releases.)

There are seven trace sources defined in the PPJ Framework:

  1. SQL

  2. Windows

  3. TableWindows

  4. Files

  5. Reports

  6. System

  7. Application

Each source can be set to one of 4 different levels:

  • Off (Default) = 0

  • Error = 1

  • Warning = 2

  • Info = 3

  • Verbose = 4

Enable tracing in {app}.exe.config

Enable Tracing at Runtime

Tracing can be enabled programmatically at any time by simply changing the TraceLevel assigned to the trace source.

For example, to enable SQL tracing at runtime use the following code:

Sys.TraceSQL.Level  = TraceLevel.Info;

Trace Sources

In the following table you can find a description of the kind of activity that is traced for each switch.

Source
Description

SQL

SQL operations, including parsing, execution, fetching data, exceptions.

Windows

SAL and Windows events.

TableWindows

Table Windows operations, including populating, creating rows, columns, etc.

Files

All files operation and exceptions.

Reports

Reporting operations including loading a report, input variables parsing and binding, printing viewing, and errors.

System

System events, including startup, shutdown, SalCompileAndEvaluare and bind variables resolution and read/write operations, unhandled exceptions, etc.

Application

Application's generated traces.

PreviousTheme BuilderNextTrace Viewer

Last updated 2 years ago

Was this helpful?

To enable tracing in the application's configuration file you can edit it with a text editor or by using our . In this case the application needs to be restarted.

configuration tool