"Expired Query-Ex Data" in the Lotus Notes Driver
Novell Cool Solutions: Tip
By Perry Nuffer
Digg This -
Posted: 26 Sep 2007
Question: In the Notes driver trace file, I see messages similar to the following:
TRACE: NotesDriver: Check subscriber channel query processor for expired query-ex data. TRACE: NotesDriver: Performing clean-up check for expired query-ex data. TRACE: NotesDriver: cleanQueryExTable: no expired query-ex data found. TRACE: NotesDriver: Check publisher channel query processor for expired query-ex data. TRACE: NotesDriver: Performing clean-up check for expired query-ex data. TRACE: NotesDriver: cleanQueryExTable: no expired query-ex data found.
What is "expired query-ex data"? And what do these trace messages signify?
Answer: These messages are displayed by the janitorial services of the NotesDriverShim. To support the feature of query-ex, the NotesDriverShim runs a process every 30 minutes (by default) to remove any orphaned query-ex data that is currently being maintained (but not utilized) by the NotesDriverShim.
Query-ex is an Identity Manager feature implemented by the IDM engine - and many IDM drivers - that allows query data to be returned to the requestor in blocks or chunks. Thus, query-ex can be used to request all the Person documents within Notes, but only return them in blocks of 50 person documents at a time, so that JVM memory limitations are not exceeded. When using this type of paged result query protocol, it is possible for the requestor to abandon the query sequence before getting all the blocks of data possible. Thus, every 30 minutes this janitorial process will run and search for orphaned query-ex data that has not been accessed by the paged result protocol in the last specified interval (30-minute default). If detected, this orphaned query-ex data is removed from memory.
To alter the default interval at which the Notes driver's janitorial service runs, you can use (or insert) a parameter definition similar to the one below. The NotesDriverShim startup parameter shown below should be inserted within the 'driver-options' section of the driver configuration.
<definition display-name="Janitor Cleanup Interval (in minutes)" name="janitor-cleanup-interval" type="integer"> <description>Janitor cleanup checks for and releases resources that might have been orphaned by unfinished query-ex sequences. This interval determines how often to perform this janitorial service.</description> <value<30</value> </definition>
Novell Cool Solutions (corporate web communities) are produced by WebWise Solutions. www.webwiseone.com