setPartitionModulus

setPartitionModulus(modulus: Integer);

The setPartitionModulus method of the DbFile class specifies the number of partitions in which new instances are stored through the value the modulus parameter, which is in the range 1 through 1,024. This sliding window is referred to as the creation window, as it defines the subset or window of partitions in which new objects are created. Expanding the creation window to include frozen, or offline, partitions is not allowed.

An exception is raised if the database file is locked for reorganization, the file is not partitioned, the specified partition modulus is a value outside the range of 1 through 1024, or the new modulus value would include frozen or offline partitions in the creation window.

For more details, see "Partition Index, Modulus, and Creation Window", in Chapter 20 of the Developer's Reference.