Start/notes.ini Parameters/DEBUG_AMGR

DEBUG_AMGR

🛠️
Parameter: DEBUG_AMGR
Short description: Enables debug output for the Agent Manager (scheduler, executive, queues) for analyzing scheduled and triggered agents.

Profile

Parameter
DEBUG_AMGR
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), =1 (basic), *=2 (verbose); sub-components combinable, e.g. sched=2, executive=1

Description

Indispensable for any Agent Manager diagnosis: Why isn't a scheduled agent running? Why is a document update trigger hanging? DEBUG_AMGR writes entries about scheduling, queue depths, agent start, end, and errors to the Debug_Outfile.
It can be controlled granularly per sub-component (sched, executive, loader, ...) – making it possible to analyze only the relevant subsystem.

Example configuration

DEBUG_AMGR=sched=2, executive=1
Debug_Outfile=/local/notesdata/IBM_TECHNICAL_SUPPORT/amgr_debug.log

Notes & pitfalls

  • High levels generate very large logs – enable only temporarily.
  • Complements Debug_Outfile, AMgr_DocUpdateEagerness, AMgr_DisableMailLookup.
  • Use tell amgr show schedule and show stat agent.* as additional diagnostic tools.
  • For reproducible problems, hand the output over to HCL Support.
  • Takes effect immediately after set config DEBUG_AMGR=...; no restart required.