How to Fix Profile Document Enumeration Pool Full Error in HCL Domino

Are You Facing the “Profile Document Enumeration Pool is Full” Error in HCL Domino?

Here’s the Fix.

If you’re working with HCL Domino and managing a large number of profile documents - typically more than 6000 - you may encounter a critical error:

Error: Profile document enumeration pool is full.

This error often arises when trying to access or iterate over profile documents using traditional profile-related functions. Fortunately, there’s a solution that avoids overloading the profile document enumeration pool using a more direct approach.

What Causes the “Profile Document Enumeration Pool is Full” Error?

HCL Domino uses a limited internal pool to handle profile document enumeration. This pool quickly becomes saturated when you exceed a threshold of profile documents - often around 6000 - which results in this error. Once the pool is full, additional operations on profile documents will fail until the memory is released or a more efficient method is used.

The Solution: Use NoteCollection to Access Profile Documents Safely

Instead of accessing profile documents using standard methods that rely on the enumeration pool, you can use the NoteCollection class in LotusScript or Java. This bypasses the limitations of the profile document pool entirely.

Here’s a Java code snippet that safely processes all profile documents without triggering the enumeration pool error:

// Create a NoteCollection that only selects profile documents
NoteCollection nc = sourceDb.createNoteCollection(false);
nc.setSelectProfiles(true);
nc.buildCollection();

// Process profile documents one by one
String noteID = nc.getFirstNoteID();
while (noteID != null && !noteID.isEmpty()) {
    Document profileDoc = sourceDb.getDocumentByID(noteID);

    // Process the profile document...

    noteID = nc.getNextNoteID(noteID);
}

Why This Works

The NoteCollection approach allows you to directly access document IDs (NoteIDs) without invoking the enumeration pool. This provides a scalable and memory-efficient way to loop through thousands of profile documents - ideal for maintenance, updates, or migration tasks.

Best Practices for Managing Large Numbers of Profile Documents

1. Avoid Unnecessary Profile Creation – Use profile documents only when needed.

2. Regularly Audit and Clean – Periodically check and remove obsolete profile docs.

3. Use NoteCollection for Bulk Operations – Always use NoteCollection when dealing with high volumes.

4. Monitor Server Logs – Catch pool warnings early before they escalate into errors.