setPartitionID

setPartitionID(partID: Integer);

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

The value of the partID parameter must be a value in the range 1 through the Max_Integer minus 15, the target partition must be present, not frozen, and it must be version‑compatible with the source object.

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

If you are using window‑relative index values, use the Object class setPartitionIndex method to specify the create partition in which to locate the receiver.

The setPartitionID method overwrites an existing partition index value.

Exception 3146 is raised if the specified partition id or partition index is out of range. Exception 3187 is raised if the object buffer is not being created; that is, it is already in a committed state.