LimitRevisions (Database - Java™)

Read-write. The maximum number of entries allowed in the $Revisions field.

Note: This property is new with Release 6.5.

Defined in

Database

Data type

double

Syntax

public double getLimitRevisions()
    throws NotesException
public void setLimitRevisions(double revisions)
    throws NotesException

Usage

This property corresponds to "Limit entries in $Revisions fields" in the database advanced properties of the UI.

This property must be an integer in the range 0 - 2147483647. When setting it:

  • Any fraction is truncated.
  • A value less than 0 raises NotesError.NOTES_ERR_NEGATIVE_VALUE (4631) "Value can not be negative."
  • A value greater than 2147483647 throws NotesError.NOTES_ERR_LONG_OVERFLOW (4673) "Value must be positive and less than 2147483648."

A value of 0 means no limit.

When $Revisions reaches the limit, a new entry results in deletion of the oldest entry.

The database must be open to use this property.

Example