[This is preliminary documentation and subject to change]

CPULoggingOptions

This metabase property contains flags that specify how IIS should log CPU times for services, servers, or applications. You can use this property to configure IIS to sum the CPU times of CGI applications only, of ISAPI extensions and ASP applications only, or of all applications.

note 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, CPULimitPriority, or CPULimitPause.

Attribute NameAttribute Value
Data TypeDWORD
AttributesINHERIT
Default ValueCPUEnableAllProcLogging
MetaFlagsExCACHE_PROPERTY_MODIFIED
User TypeIIS_MD_UT_SERVER
StartingNumber
EndingNumber0
ID2146

Access Locations

This property is accessible at the following locations:

Metabase PathIIS Admin Object Type
/LM/W3SVC/2IIsWebServer
/LM/W3SVC/Info/Templates/Public Web SiteIIsWebServer
/LM/W3SVC/Info/Templates/Secure Web SiteIIsWebServer
/LM/W3SVCIIsWebService

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_LOGGING_OPTIONS
Data typeDWORD
User typeIIS_MD_UT_SERVER

Flags

NameValueMetabase Bitmask IdentifierDescription
CPUEnableAllProcLogging
1 | 0x1
MD_CPU_ENABLE_ALL_PROC_LOGGING
Log the sum of CPU time used by applications and CGI. This flag indicates whether IIS should log total CPU times for all out-of-process ISAPI extensions and ASP and CGI applications.
CPUEnableCGILogging
2 | 0x2
MD_CPU_ENABLE_CGI_LOGGING
Log the CPU time used by CGI applications. This flag indicates whether IIS should log total CPU times for CGI applications.
CPUEnableAppLogging
4 | 0x4
MD_CPU_ENABLE_APP_LOGGING
Log the CPU time used by ISAPI and ASP applications. This flag indicates whether the total number of active processes is recorded when process accounting is performed.

© 1997-2001 Microsoft Corporation. All rights reserved.