Start/notes.ini Parameters/DEBUG_EVENTS

DEBUG_EVENTS

🛠️
Parameter: DEBUG_EVENTS
Short description: Debug output for the Event task – logs triggered event generators, the associated handlers, and sent notifications (SMTP, Mail, Relay).

Profile

Parameter
DEBUG_EVENTS
Category
Logging / Debug
Component
Server
Available since
10.0
Supported versions
10.0, 11.0, 12.0, 14.0, 14.5, 14.5.1
GUI equivalent
notes.ini only (no GUI)
Possible values
0 = off (default), 1 = basic, 2 = verbose

Description

The Event task (event) evaluates server events based on the event generators and event handlers defined in events4.nsf. DEBUG_EVENTS records in detail which generators fired, which filters (severity, server, database) were applied, and which handlers were executed – including mail notifications, relay to other servers, logging, and SNMP traps.
In case of an issue (e.g. event not detected, mail not delivered, handler doesn't fire), the log provides decisive clues about incorrect filters, missing permissions, or routing problems.

Example configuration

DEBUG_EVENTS=2
Debug_Outfile=/local/notesdata/IBM_TECHNICAL_SUPPORT/events_debug.log

Notes & pitfalls

  • Level 2 is very verbose – enable only temporarily.
  • Entries appear in console.log and in Debug_Outfile.
  • Takes effect immediately via set config DEBUG_EVENTS=2; a restart is not strictly required.
  • Complementary to events4.nsf configurations, Debug_Outfile, DDM_DISABLED.
  • Additionally verify mail notifications using mail trace tools.