Detailed information for the notes.ini Keyword: 

Debug_NameLookup


Short Description: Is used to debug directory assistance

Description:
Problem
When using Directory Assistance (a.k.a. Master Address Book, MAB), how can the following NOTES.INI parameters be used to troubleshoot issues?:

Debug_Directory_Assistance=1
Debug_NameLookup=1
 
Solution
As an aid to troubleshooting, comments have been placed around the typical output that each NOTES.INI parameter will produce:

NOTE: Debug_Outfile=debug.txt will have to be set in order to capture any of the following output.

1) Debug_Directory_Assistance=1

Here is where the Directory Assistance tables (DA tables) begin to load
09/08/99 11:53:35 PM DirAssist: Initializing ...
09/08/99 11:53:35 PM DirAssist: Loading tables ...

Each document (including rules and location of replicas) in the Directory Assistance database is read into the DA tables.
02/02/2000 01:26:30 PM DirAssist: Rule added: Domain=SEINFELD;
Rule=*/*/*/*/*/*; Trusted=Yes
02/02/2000 01:26:30 PM DirAssist: Replica added: Domain=SEINFELD;
Server=CN=ARGENTINE/O=TANGO; AddressBook=conames.NSF.

02/02/2000 01:26:30 PM DirAssist: Server CN=ARGENTINE/O=TANGO added.
02/02/2000 01:26:30 PM DirAssist: Rule added: Domain=TANGO; Rule=*/*/*/*/*/*;
Trusted=Yes
02/02/2000 01:26:30 PM DirAssist: Replica added: Domain=TANGO;
Server=CN=ARGENTINE/O=TANGO; AddressBook=names.nsf.

The Public Address Book (NAMES.NSF on the server) is read last.
02/02/2000 01:26:31 PM DirAssist: Primary address book replica added:
Domain=OOGABOOGA; Server=CN=CRAZY/O=OOGABOOGA; AddressBook=names.nsf.

Here is where the DA tables are done reading from the DA database.
09/08/99 11:53:38 PM DirAssist: Done loading tables.
09/08/99 11:53:38 PM DirAssist: Done initializing.

If any of the Address Books cannot be accessed (i.e. server not responding, database does not exist, etc.) the following type of error will appear when the router or mailer process try to perform a name lookup.
> 02/02/2000 02:28:40 PM DirAssist: Getting domain replicas...
> 02/02/2000 02:28:43 PM DirAssist: Verified server CN=ARGENTINE/O=TANGO is NOT
available

or
> 02/02/2000 02:28:40 PM DirAssist: Getting domain replicas...
> 02/02/2000 02:28:43 PM DirAssist: Verified server CN=ARGENTINE/O=TANGO is available
> 02/02/2000 02:28:43 PM DirAssist: Verified replica CN=ARGENTINE/O=TANGO!!names.nsf is NOT available

When a name lookup is performed, the output will also show if the rules match the name.
02/02/2000 02:28:50 PM DirAssist: Trying to resolve domain for name alvin
02/02/2000 02:28:50 PM DirAssist: Name alvin matches Rule ///// for
Domain=SEINFELD!
02/02/2000 02:28:50 PM DirAssist: Name alvin matches Rule ///// for
Domain=TANGO!

2) Debug_NameLookup=1

Debug_NameLookup will give a lot of output and not all of it will pertain to name lookups performed by the router and mailer processes. The output which is relevant will show which views are accessed

Here is the sample output with comments:

This portion shows what happens when type-ahead is used to find a user name in the Primary Address Book.
NAMELookup: NIFLocateNameSpace: looking for namespace with DBIndex=1 view=$Users .
NAMELookup: NIFLocateNameSpace: found Notes namespace entry.
NAMELookup: lookup: Searching for name speedy (1 of 1 names).
NAMELookup: lookup: Searching in namespace with DBIndex 1.
NAMELookup: ReturnNameInfo: found 1 matches.
NAMELookup: lookup: NumMatches in return buffer = 1.
NAMELookup: lookup: No exhaustive searching, done with this name.
NAMELookup: lookup: Type-ahead found match, all done.
NAMELookup: lookup: exiting.

This excerpt shows what happens when F9 is used. Notice that first the Address Books are accessed from the DA tables and then they are searched. If an Address Book cannot be accessed, the NIFNextNameDatabase will return an error.
NAMELookup: lookup: entering.
NAMELookup: lookup: Searching view $NamesFieldLookup (1 of 1 views).
NAMELookup: NIFLocateNameSpace: looking for namespace with DBIndex=1 view=$ServersLookup .
NAMELookup: NIFLocateNameSpace: found Notes namespace entry.
NAMELookup: NIFLocateNameSpace: looking for namespace with DBIndex=1 view=$Users .
NAMELookup: NIFLocateNameSpace: found Notes namespace entry.
NAMELookup: lookup: Searching for name speedy (1 of 1 names).

NAMELookup: ProcessDeferredNAB: obtained directories from Directory Assistance
NAMELookup: ProcessDeferredNAB: adding Notes directory CN=ARGENTINE/O=TANGO!!conames.NSF.
NAMELookup: ProcessDeferredNAB: adding Notes directory CN=ARGENTINE/O=TANGO!!names.nsf.
NAMELookup: NIFNextNameDatabase: ResolveDomain found 2 directories: SEINFELD, TANGO

NAMELookup: NIFNextNameDatabase: looking for directory SEINFELD in OPEN_NAME_COLLECTION queue.
NAMELookup: NIFNextNameDatabase: Could not find directory SEINFELD in OPEN_NAME_COLLECTION queue!
NAMELookup: NIFNextNameDatabase: looking for directory TANGO in OPEN_NAME_COLLECTION queue.
NAMELookup: NIFNextNameDatabase: Found directory TANGO in OPEN_NAME_COLLECTION queue, DBIndex=2.


3) DebugRouterLookUp=3 (only applies to Domino 6 servers)

DebugRouterLookUp will display how the Router task resolves a name lookup. This will be written to the Log.NSF in the Mail Routing Events view.

This excerpt is when an inbound SMTP message is sent to a user not listed in the Primary Domino Directory.
03/03/2003 05:07:50 PM DebugRLookup: Lookup beginning for user: Matt.kersker name: matt.kersker@smtp.lotus.com
03/03/2003 05:07:50 PM DebugRLookup: Lookup beginning for user: matt.kersker name: matt.kersker
03/03/2003 05:07:50 PM DebugRLookup: Lookup error: UserName: matt.kersker Error: User %a not listed in Domino Directory NOTE: This displays that the user was not found in the Primary Domino Directory
03/03/2003 05:07:50 PM DebugRLookup: Lookup beginning for user: matt kersker name: matt kersker
03/03/2003 05:07:50 PM DebugRLookup: Lookup results: user: matt kersker name: matt kersker FullName: CN=matt kersker/O=Beta/C=US NOTE: This displays the user's Fullname found in Directory Assistance

This excerpt is when a non unique match is found for a user and results in a NDR.
03/04/2003 11:52:13 AM DebugRLookup: Lookup beginning for user: hubbard name: hubbard@smtp.lotus.com
03/04/2003 11:52:14 AM DebugRLookup: Lookup beginning for user: hubbard name: hubbard
03/04/2003 11:52:14 AM DebugRLookup: Lookup result has [2] matches. user: hubbard name: hubbard NOTE: This
displays that the router found 2 matches for the name hubbard
03/04/2003 11:52:14 AM DebugRLookup: Lookup multiple match 2 Fullname[1] = CN=Erin Hubbard/O=Alpha NOTE:
This displays the first match found in the Priamry Domino Direcotry
03/04/2003 11:52:14 AM DebugRLookup: Lookup multiple match 1 Fullname[1] = CN=Erin Hubbard/O=Beta/C=US
NOTE: This displays that the second match was found in Directory Assistance
03/04/2003 11:52:14 AM DebugRLookup: Lookup multiple match 1 Fullname[2] = Erin Hubbard
03/04/2003 11:52:14 AM DebugRLookup: Lookup Error: Non unique matches for user: hubbard name: hubbard





Default value:
None (but thus 0)

Syntax:
Debug_NameLookup=0 / 1

Example:
Debug_NameLookup=0

UI equivalent:
None


Applies to:
Server


Entry created by:
Bastian W.