IBM Support

The basics of Notes view index refreshing

Product documentation


Abstract

When designing a View, the Design View Attributes dialog box contains an "Index Options" button. Clicking this button opens the following dialog box, which contains different techniques for refreshing views:

Content

Unschedule View Index Updating

In Lotus Notes or Lotus Domino Designer, when designing a View, the Design View Attributes dialog box contains an "Index Options" button. Clicking this button opens the following dialog box, which contains different techniques for refreshing views:





Refresh Frequency Options
The following four refresh frequency options are available when opening a view:

1. "Auto, after first use" views will be forced to be up-to-date when opened. When a user opens a database, and documents have been modified since the view was last updated, the view will be updated (refreshed), and the client will have to wait until the view is updated before the database will open.

Note: When update or updall is run on this type of view, the view will always be brought up-to-date.

2. Automatic views will be forced to be up-to-date when opened. When a user opens a database, and documents have been modified since the view was last updated, the view will be updated (refreshed), and the client must wait until the view is updated before the database will open.

Note: When update or updall is run on this type of view, the view will always be brought up-to-date. With this type of view, if it is not built, the view index will be built when update or updall runs against it.

3. Manual/Background views will never be refreshed by the user opening the view. The view will always open immediately. The only way a user can cause the view to be refreshed is to press the F9 key (refresh) while in the view.

Note: When update or updall is run on this type of view, the view will always be brought up-to-date.


4. Automatic - at most once every XX hours views, when opened by a user, will be brought up-to-date only if they have not been refreshed in the specified interval. If the view has been refreshed in the last XX hours, then the view will open immediately. This refresh frequency is accomplished via the Chronos task and is particularly good for large databases that are often modified. When a user opens a view, they won't have to wait for the view to be refreshed, it will open immediately, but will have the yellow refresh icon at the top left of the view.

Note: When update or updall is run on this type of view, the view will always be brought up-to-date.


The update Task (Indexing When Closing a View)

The update task refreshes the views in a single database, and is a task that runs continuously on the server. It maintains a work queue, and regularly polls this queue to see if there are update requests to perform. A request is put into the update queue for the following reasons:

- When a user closes a database after they have modified a document in that database.
- When a database is replicated.
- When the router adds a note to a database.

When the update task processes the request to refresh the views in this database, it will update all views that have been previously opened in the database, regardless of the selected View Refresh option (or in the case of automatic, will build the view if not already built). This is so that the user who next opens the database will not see stale information. The update task performs incremental updates, and these updates are generally very speedy. Setting LOG_UPDATE = 2 in the notes.ini file will allow you to observe each view being updated in the database.



Scheduled View Index Updating
Updall is a task which (by default) is scheduled to run at 2:00 AM each morning against all databases on a Notes server. It makes a list of all the databases on the server, and then updates the views in each of them. When these databases have all been updated, updall terminates.

The updall task will update all views that have been previously opened in a database, regardless of the selected View Refresh option (or in the case of automatic, will build the view if not already built). Set the notes.ini variable to LOG_UPDATE=2 to observe each view being updated in the database.

IMPORTANT NOTE: Since updall can also be initiated via the Server Console, a Remote Server Console, and operating system commands, it is also an unscheduled way to update indexes when desired.

Related information

Notes Indexing Basics: NIF, Update, Updall (and Updall
What Causes Notes/Domino Indexes to Rebuild?

Cross reference information
Segment Product Component Platform Version Edition
Messaging Applications Lotus End of Support Products Lotus Domino Designer 7.0, 6.5, 6.0

Document information

More support for: Lotus End of Support Products
Lotus Notes

Software version: 5.0, 6.0, 6.5, 7.0

Operating system(s): Windows, iOS

Reference #: 7002624

Modified date: 25 April 2006


Translate this page: