cpu Element for add for applicationPools [IIS Settings Schema]

Note

For more information about the cpu element, see the following topic on the Microsoft IIS.net Web site: CPU Settings for an Application Pool <cpu>.

Configures values for CPU usage parameters and CPU actions that will be used an application pools.

Syntax

Attributes and Elements

The following sections describe attributes, child elements, and parent elements for this section.

Attributes

Attribute	Description
action	Optional enum attribute. Configures the action(s) that IIS takes when an worker process exceeds its configured CPU limit. The action attribute is configured on a per-application pool basis. The action attribute can be one of the following possible values. The default value is NoAction. Value Description KillW3wp Application pool worker processes that exceed their CPU limit will be forced to shut down. The numeric value is 1. NoAction No action is taken when the CPU limit is exceeded. A warning is written to the event log. The numeric value is 0.
limit	Optional uint attribute. Configures the maximum percentage of CPU time (in 1/1000ths of one percent) that the worker processes in an application pool are allowed to consume over a period of time as indicated by the resetInterval attribute. If the limit set by the limit attribute is exceeded, an event is written to the event log and an optional set of events can be triggered. These optional events are determined by the action attribute. The default value is 0, which disables CPU limiting.
resetInterval	Optional timeSpan attribute. Specifies the reset period (in minutes) for CPU monitoring and throttling limits on an application pool. When the number of minutes elapsed since the last process accounting reset equals the number specified by this property, IIS resets the CPU timers for both the logging and limit intervals. Important   The value in resetInterval must be greater than the time between logging operations, otherwise IIS will reset counters before logging has occurred, and process accounting will not occur. Note Because process accounting in IIS uses Windows job objects to monitor CPU times for the whole process, process accounting will only log and throttle applications that are isolated in a separate process from IIS. The default value is 0, which disables CPU monitoring.
smpAffinitized	Optional Boolean attribute. Specifies whether a particular worker process assigned to an application pool should also be assigned to a given CPU. This property is used together with the smpProcessorAffinityMask attribute. The default value is false.
smpProcessorAffinityMask	Optional uint attribute. Configures the hexadecimal processor mask for multi-processor computers, which indicates to which CPU the worker processes in an application pool should be bound. Before this property takes effect, the smpAffinitized attribute must be set to true for the application pool. Note Do not set this property to 0. Doing so disables symmetric multiprocessing (SMP) affinity and creates an error condition. This means that processes running on one CPU will not remain affiliated with that CPU throughout their lifetime. The default value is 4294967295. If you set the value to 1 (which corresponds to 00000000000000001 in binary), the worker processes in an application pool run on only the first processor. If you set the value to 2 (which corresponds to 0000000000000010 in binary), the worker processes run on only the second processor. If you set the value to 3 (which corresponds to 0000000000000011 in binary) the worker processes run on both the first and second processors.
smpProcessorAffinityMask2	Optional uint attribute. Specifies the high-order DWORD hexadecimal processor mask for 64-bit multi-processor computers, which indicates to which CPU the worker processes in an application pool should be bound. Before this property takes effect, the smpAffinitized attribute must be set to true for the application pool. Note: On 64-bit computers, the smpProcessorAffinityMask attribute contains the low-order DWORD for the processor mask, and the smpProcessorAffinityMask2 attribute contains the high-order DWORD for the processor mask. On 32-bit computers, the smpProcessorAffinityMask2 attribute has no effect. The default value is 4294967295.

Child Elements

None.

Parent Elements

Element	Description
configuration	Specifies the root element in every configuration file that is used by IIS 7.
system.applicationHost	Specifies the root element for configuring Web process settings.
applicationPools	Contains default configuration settings for all application pools on the server and defines configuration settings for specific application pools.
add	Configures an application pool in the server configuration.

Remarks

For more information about the cpu element, see the following topic on the Microsoft IIS.net Web site: CPU Settings for an Application Pool <cpu>.

Element Information

Configuration locations	ApplicationHost.config
Requirements	Microsoft Internet Information Services (IIS) version 7.0