Drop CPU and user-defined virtual processors

While the database server is in online mode, you can use the -p option of the onmode utility to drop, or terminate, virtual processors of the CPU and user-defined classes.

Drop CPU virtual processors

Following the onmode command, specify a negative number that is the number of virtual processors that you want to drop, and then specify the CPU class in lowercase letters. For example, the following command drops two CPU virtual processors:

% onmode -p -2 cpu

If you attempt to drop a CPU virtual processor that is running a poll thread, you receive the following message:

onmode: failed when trying to change the number of cpu virtual processor by -number.

For more information, see Run poll threads on CPU or network virtual processors.

Drop user-defined virtual processors

Following the onmode command, specify a negative number that is the number of virtual processors that you want to drop, and then specify the user-defined class in lowercase letters. For example, the following command drops two virtual processors of the class usr:

onmode -p -2 usr

Windows only: In Windows™, you can have only one user-defined virtual processor class at a time. Omit the number parameter in the onmode -p vpclass command.

For information about how to create a user-defined class of virtual processors and assign user-defined routines to it, see User-defined classes of virtual processors.