Start/notes.ini Parameters/DEBUG_CAPTURE_TIMEOUT

DEBUG_CAPTURE_TIMEOUT

🛠️
Parameter: DEBUG_CAPTURE_TIMEOUT
Short description: Automatically triggers an NSD-like data capture when a semaphore/thread is blocked for longer than the specified period.

Profile

Parameter
DEBUG_CAPTURE_TIMEOUT
Category
Logging / Debug
Component
Server
Available since
8.0
Supported versions
9.0.1, 10.0, 11.0, 12.0, 14.0, 14.5
GUI equivalent
notes.ini only (no GUI)
Possible values
Integer in seconds, 0 = disabled (default)

Description

Setting DEBUG_CAPTURE_TIMEOUT=<sec> activates a watchdog function: if a semaphore or thread wait time exceeds the specified value, Domino automatically writes a diagnostic snapshot similar to a partial NSD run into the server directory. This allows later verification of which thread is hanging and which semaphore is affected.
Indispensable for diagnosing hangs that occur only sporadically and are over again by the time an admin could react.

Example configuration

DEBUG_CAPTURE_TIMEOUT=120
DEBUG_THREADID=1

Notes & pitfalls

  • Value in seconds.
  • Too low = many false-positive captures; too high = real hangs are missed. 60–300 seconds is a good starting value.
  • Captures typically land in the data directory and consume disk space.
  • Complements Debug_Outfile, NSD scripts, and health monitoring.
  • The change takes effect only after a server restart.