setPartitionIndex

setPartitionIndex(partIndex: Integer);

The setPartitionIndex method of the Object class specifies the partition in which to locate the receiver. It must be called within the creating transaction.

The value of the partIndex parameter must be a value in the range 1 through the value of the DbFile class setPartitionModulus method minus 1 and the target partition must be present, not frozen, and version-compatible with the source object.

The value set is observed only when the transaction commits; that is, only the last value set is used.

A 3146 exception is raised if the specified partition identifier is out of range.