[This is preliminary documentation and subject to change]

### CPULimitPause

This metabase property specifies the percentage of CPU time, in 1/1000ths of a percent, that all isolated processes on the Web server can occupy during a given process accounting interval (specified by CPUResetInterval). If the processes attempt to occupy more CPU time than specified in CpuLimitPause, IIS will pause the entire site, and any new client requests will receive a custom error indicating that the server is out of resources. The site will remain in a paused state until the current reset interval has ended. Any limit overrun will be recorded in the Windows Event Log, and, if process accounting is enabled, in the IIS log as well.

If CpuLimitPause is set to 0, or a value greater than 100,000 (100 percent), IIS will not pause the site. However, one of the other process throttling properties, such as CPULimitLogEvent, CPULimitPriority, or CPULimitProcStop, could generate a response from IIS if a CPU limit is exceeded.

Note Because process accounting in IIS uses Windows Job Objects to monitor CPU times for an entire process, process accounting will log and throttle only applications that are isolated in a separate process from IIS.

Process throttling and process accounting are independently controlled by several other metabase properties. In order to enable process accounting you must set CpuEnableLogging (which is a member of CPULoggingMask) to TRUE, and set at least one other CPULoggingMask property to TRUE. It is also necessary to set at least one member flag of the CPULoggingOptions, set CPULoggingInterval to a nonzero value, and set either CPUAppEnabled or CPUCGIEnabled, as appropriate, to TRUE.

To properly activate process throttling, CPULimitsEnabled must be set to TRUE, and at least one of the following properties should be set to TRUE: CPULimitLogEvent, CPULimitPriority, CPULimitProcStop, or CpuLimitPause.

Important Applications that do not have process throttling enabled do not contribute to the total CPU time for the purposes of calculating CPU limit overruns.

Attribute Name | Attribute Value
Data Type | DWORD
Attributes | INHERIT
Default Value | 0
MetaFlagsEx | CACHE_PROPERTY_MODIFIED
User Type | IIS_MD_UT_SERVER
StartingNumber |
EndingNumber | 0
ID | 2152

### Access Locations

This property is accessible at the following locations:

Metabase Path | IIS Admin Object Type
/LM/W3SVC/Info/Templates/Public Web Site | IIsWebServer
/LM/W3SVC/Info/Templates/Secure Web Site | IIsWebServer
/LM/W3SVC | IIsWebService

### IIS Admin Base Object Information

The following table lists additional information required only for code that uses the IIS Admin Base Object.

Metabase identifier | MD_CPU_ENABLE_LOGGING
Data type | DWORD
User type | IIS_MD_UT_SERVER

© 1997-2001 Microsoft Corporation. All rights reserved.