Start/notes.ini Parameters/DEBUG_NAMELOOKUP

DEBUG_NAMELOOKUP

🛠️
Parameter: DEBUG_NAMELOOKUP
Short description: Enables debug output for the NAMELookup API (directory resolution, group expansion, Directory Assistance) – the most important tool for authentication and ACL problems.

Profile

Parameter
DEBUG_NAMELOOKUP
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, 3 = trace (incl. cache hits)

Description

When a user suddenly has no access, a group entry doesn't take effect, or Directory Assistance doesn't return expected results, DEBUG_NAMELOOKUP is the first thing to reach for. It logs every NAMELookup call with its search path, hits, and cache behavior.
Level 3 additionally shows cache hits/misses – helpful when directory changes don't propagate due to Server_Name_Lookup_NoUpdate.

Example configuration

DEBUG_NAMELOOKUP=2
Debug_Outfile=/local/notesdata/IBM_TECHNICAL_SUPPORT/namelookup_debug.log

Notes & pitfalls

  • Produces very large logs on busy servers – enable only briefly.
  • For authentication problems, combine with DEBUG_LDAP=1 and DEBUG_NRPC=1.
  • Complements Debug_Outfile and the Directory Assistance configuration.
  • Control cache behavior via the Server_Name_Lookup_* family.
  • Takes effect immediately after set config DEBUG_NAMELOOKUP=...; no restart required.