### CpuLoggingMask

This metabase property specifies which process accounting and throttling fields should be written to the IIS log file. All enabled fields will be written on every process accounting log. All values logged are for the reset interval in which the logging occurs.

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.

This property contains the following flags:

CpuEnableLogging | CpuEnableProcType
CpuEnableActiveProcs | CpuEnableTerminatedProcs
CpuEnableEvent | CpuEnableTotalProcs
CpuEnableKernelTime | CpuEnableUserTime
CpuEnablePageFaults |

You can also change the logging mask flags by directly manipulating the flags contained in CpuLoggingMask by using the hexadecimal values described in the following tables.

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.

Data type | Long
Default value | All Member Flags = TRUE
Inheritance | Inheritable

###### Access Locations

This property is accessible at the following locations:

Metabase Path | Key Type
/LM/W3SVC | IIsWebService
/LM/W3SVC/N | IIsWebServer

###### IIS Admin Base Object Information

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

Metabase identifier | MD_CPU_LOGGING_MASK
User type | IIS_MD_UT_SERVER
Default bitmask setting Note Multiple bits are set by default. | MD_CPU_ENABLE_LOGGING MD_CPU_ENABLE_EVENT MD_CPU_ENABLE_PROC_TYPE MD_CPU_ENABLE_USER_TIME MD_CPU_ENABLE_KERNEL_TIME MD_CPU_ENABLE_PAGE_FAULTS MD_CPU_ENABLE_TOTAL_PROCS MD_CPU_ENABLE_ACTIVE_PROCS MD_CPU_ENABLE_TERMINATED_PROCS
Default bitmask value | 0x800000FF

###### Bitmask Values

Constant | Value | Description
MD_CPU_ENABLE_LOGGING | 0x80000000 | Specifies whether process accounting is enabled.
MD_CPU_ENABLE_EVENT | 0x00000001 | Log site events, such as start, stop, and site process throttling.
MD_CPU_ENABLE_PROC_TYPE | 0x00000002 | Log the process type.
MD_CPU_ENABLE_USER_TIME | 0x00000004 | Log the total user CPU time, as a percentage of total CPU time, in 1/1000ths of a percent.
MD_CPU_ENABLE_KERNEL_TIME | 0x00000008 | Log the total kernel CPU time, as a percentage of total CPU time, in 1/1000ths of a percent.
MD_CPU_ENABLE_PAGE_FAULTS | 0x00000010 | Log the total number of page faults.
MD_CPU_ENABLE_TOTAL_PROCS | 0x00000020 | Log the total number of processes.
MD_CPU_ENABLE_ACTIVE_PROCS | 0x00000040 | Log the total number of active processes.
MD_CPU_ENABLE_TERMINATED_PROCS | 0x00000080 | Log the total number of terminated processes.

© 1997-2001 Microsoft Corporation. All rights reserved.