Win32_PerfFormattedData_PerfNet_ServerWorkQueues class

The Win32_PerfFormattedData_PerfNet_ServerWorkQueues formatted data class provides precalculated data from performance counters that monitor the length of the queues and objects in the queues.

This class represents the Server Work Queues object in System Monitor and returns the same data you see in System Monitor. The original data source is the PerfNet performance library. The corresponding raw data class is Win32_PerfRawData_PerfNet_ServerWorkQueues. Data is dynamically provided for this class from the performance library object by the WmiPerfInst provider.

Windows Server 2003 and Windows XP: WMI data for this class is supplied by the Formatted Performance Data Provider.

The following syntax is simplified from MOF code and shows all of the inherited properties, including the Frequency and Timestamp properties required for class display in System Monitor. For more information about required property qualifiers, see Property Qualifiers for Performance Counter Classes. For more information about CounterType values, see WMI Performance Counter Types.

Syntax

class Win32_PerfFormattedData_PerfNet_ServerWorkQueues : Win32_PerfFormattedData
{
  uint32 ActiveThreads;
  uint32 AvailableThreads;
  uint32 AvailableWorkItems;
  uint32 BorrowedWorkItems;
  uint64 BytesReceivedPerSec;
  uint64 BytesSentPerSec;
  uint64 BytesTransferredPerSec;
  string Caption;
  uint32 ContextBlocksQueuedPerSec;
  uint32 CurrentClients;
  string Description;
  uint64 Frequency_Object;
  uint64 Frequency_PerfTime;
  uint64 Frequency_Sys100NS;
  string Name;
  uint32 QueueLength;
  uint64 ReadBytesPerSec;
  uint64 ReadOperationsPerSec;
  uint64 Timestamp_Object;
  uint64 Timestamp_PerfTime;
  uint64 Timestamp_Sys100NS;
  uint64 TotalBytesPerSec;
  uint64 TotalOperationsPerSec;
  uint32 WorkItemShortages;
  uint64 WriteBytesPerSec;
  uint64 WriteOperationsPerSec;
};

Members

The Win32_PerfFormattedData_PerfNet_ServerWorkQueues class has these types of members:

  • Properties

Properties

The Win32_PerfFormattedData_PerfNet_ServerWorkQueues class has these properties.

ActiveThreads

Data type: uint32

Access type: Read-only

Qualifiers: CookingType ("PERF_COUNTER_RAWCOUNT") , Counter ("ActiveThreads") , PerfTimeStamp ("Timestamp_PerfTime") , PerfTimeFreq ("Frequency_PerfTime")

Number of threads currently working on a requests from the server client for this CPU. The system keeps this number low to minimize unnecessary context switching. This is an instantaneous count for the CPU, not an average over time.

AvailableThreads

Data type: uint32

Access type: Read-only

Qualifiers: CookingType ("PERF_COUNTER_RAWCOUNT") , Counter ("AvailableThreads") , PerfTimeStamp ("Timestamp_PerfTime") , PerfTimeFreq ("Frequency_PerfTime")

Number of server threads on this CPU not currently working on requests from a client. The server dynamically adjusts the number of threads to maximize server performance.

AvailableWorkItems

Data type: uint32

Access type: Read-only

Qualifiers: CookingType ("PERF_COUNTER_RAWCOUNT") , Counter ("AvailableWorkItems") , PerfTimeStamp ("Timestamp_PerfTime") , PerfTimeFreq ("Frequency_PerfTime")

Instantaneous number of available work items for this CPU. Every request from a client is represented in the server as a work item. The server maintains a pool of available work items per CPU to speed processing. A sustained near-zero value indicates the need to increase the MinFreeWorkItems registry value for the Server service. This value is always 0 (zero) in the blocking queue instance.

BorrowedWorkItems

Data type: uint32

Access type: Read-only

Qualifiers: CookingType ("PERF_COUNTER_RAWCOUNT") , Counter ("BorrowedWorkItems") , PerfTimeStamp ("Timestamp_PerfTime") , PerfTimeFreq ("Frequency_PerfTime")

Instantaneous number of work items borrowed from another CPU. Every request from a client is represented as a work item. The server maintains a pool of available work items per CPU to speed processing. When a CPU runs out of work items, it borrows a free work item from another CPU. An increasing value of this running counter might indicate the need to increase the MaxWorkItems or MinFreeWorkItems registry values for the Server service. This value is always 0 (zero) in the blocking queue instance.

BytesReceivedPerSec

Data type: uint64

Access type: Read-only

Qualifiers: CookingType ("PERF_COUNTER_RAWCOUNT") , Counter ("BytesReceivedPerSec") , PerfTimeStamp ("Timestamp_PerfTime") , PerfTimeFreq ("Frequency_PerfTime")

Rate at which the server is receiving bytes from the network clients on this CPU. This value is a measure of how busy the server is.

For more information about using uint64 values in scripts, see Scripting in WMI.

BytesSentPerSec

Data type: uint64

Access type: Read-only

Qualifiers: CookingType ("PERF_COUNTER_BULK_COUNT") , Counter ("BytesSentPerSec") , PerfTimeStamp ("Timestamp_PerfTime") , PerfTimeFreq ("Frequency_PerfTime")

Rate at which the server is sending bytes to the network clients on this CPU. This value is a measure of busy the server is.

For more information about using uint64 values in scripts, see Scripting in WMI.

BytesTransferredPerSec

Data type: uint64

Access type: Read-only

Qualifiers: CookingType ("PERF_COUNTER_BULK_COUNT") , Counter ("BytesTransferredPerSec") , PerfTimeStamp ("Timestamp_PerfTime") , PerfTimeFreq ("Frequency_PerfTime")

Rate at which the server is sending and receiving bytes with the network clients on this CPU. This value is a measure of how busy the server is.

For more information about using uint64 values in scripts, see Scripting in WMI.

Caption

Data type: string

Access type: Read-only

Short textual description for the statistic or metric. This property is inherited from CIM_StatisticalInformation.

ContextBlocksQueuedPerSec

Data type: uint32

Access type: Read-only

Qualifiers: CookingType ("PERF_COUNTER_COUNTER") , Counter ("ContextBlocksQueuedPerSec") , PerfTimeStamp ("Timestamp_PerfTime") , PerfTimeFreq ("Frequency_PerfTime")

Rate at which work context blocks had to be placed on the server's FTP queue to await server action.

CurrentClients

Data type: uint32

Access type: Read-only

Qualifiers: CookingType ("PERF_COUNTER_RAWCOUNT") , Counter ("CurrentClients") , PerfTimeStamp ("Timestamp_PerfTime") , PerfTimeFreq ("Frequency_PerfTime")

Instantaneous count of the clients being serviced by this CPU. The server actively balances the client load across all of the CPUs in the system. This value is always 0 (zero) in the blocking queue instance.

Description

Data type: string

Access type: Read-only

Textual description of the statistic or metric. This property is inherited from CIM_StatisticalInformation.

Frequency_Object

Data type: uint64

Access type: Read-only

Frequency, in ticks per second, of Timestamp_Object. This property is defined by the provider. This property is inherited from Win32_Perf.

For more information about using uint64 values in scripts, see Scripting in WMI.

Frequency_PerfTime

Data type: uint64

Access type: Read-only

Frequency, in ticks per second, of Timestamp_Perftime. A value can be obtained by calling the Windows function QueryPerformanceCounter. This property is inherited from Win32_Perf.

For more information about using uint64 values in scripts, see Scripting in WMI.

Frequency_Sys100NS

Data type: uint64

Access type: Read-only

Frequency, in ticks per second, of Timestamp_Sys100NS (10000000). This property is inherited from Win32_Perf.

For more information about using uint64 values in scripts, see Scripting in WMI.

Name

Data type: string

Access type: Read-only

Qualifiers: Key, MaxLen (256)

Label by which the statistic or metric is known. When subclassed, the property can be overridden to be a key property. This property is inherited from CIM_StatisticalInformation.

QueueLength

Data type: uint32

Access type: Read-only

Qualifiers: CookingType ("PERF_COUNTER_RAWCOUNT") , Counter ("QueueLength") , PerfTimeStamp ("Timestamp_PerfTime") , PerfTimeFreq ("Frequency_PerfTime")

Current length of the server work queue for this CPU. A sustained queue length greater than four might indicate processor congestion. This is an instantaneous count, not an average over time.

ReadBytesPerSec

Data type: uint64

Access type: Read-only

Qualifiers: CookingType ("PERF_COUNTER_BULK_COUNT") , Counter ("ReadBytesPerSec") , PerfTimeStamp ("Timestamp_PerfTime") , PerfTimeFreq ("Frequency_PerfTime")

Rate at which the server is reading data from files for the clients on this CPU. This value is a measure of how busy the server is.

For more information about using uint64 values in scripts, see Scripting in WMI.

ReadOperationsPerSec

Data type: uint64

Access type: Read-only

Qualifiers: CookingType ("PERF_COUNTER_BULK_COUNT") , Counter ("ReadOperationsPerSec") , PerfTimeStamp ("Timestamp_PerfTime") , PerfTimeFreq ("Frequency_PerfTime")

Rate at which the server is performing file read operations for the clients on this CPU. This value is a measure of how busy the server is. The value is always 0 (zero) in the blocking queue instance.

For more information about using uint64 values in scripts, see Scripting in WMI.

Timestamp_Object

Data type: uint64

Access type: Read-only

Object-defined timestamp, defined by the provider. This property is inherited from Win32_Perf.

For more information about using uint64 values in scripts, see Scripting in WMI.

Timestamp_PerfTime

Data type: uint64

Access type: Read-only

High Performance counter timestamp. A value could be obtained by calling the Windows function QueryPerformanceCounter. This property is inherited from Win32_Perf.

For more information about using uint64 values in scripts, see Scripting in WMI.

Timestamp_Sys100NS

Data type: uint64

Access type: Read-only

Timestamp value in 100 nanosecond units. This property is inherited from Win32_Perf.

For more information about using uint64 values in scripts, see Scripting in WMI.

TotalBytesPerSec

Data type: uint64

Access type: Read-only

Qualifiers: CookingType ("PERF_COUNTER_BULK_COUNT") , Counter ("TotalBytesPerSec") , PerfTimeStamp ("Timestamp_PerfTime") , PerfTimeFreq ("Frequency_PerfTime")

Rate at which the server is reading and writing data to and from the files for the clients on this CPU. This value is a measure of how busy the server is.

For more information about using uint64 values in scripts, see Scripting in WMI.

TotalOperationsPerSec

Data type: uint64

Access type: Read-only

Qualifiers: CookingType ("PERF_COUNTER_BULK_COUNT") , Counter ("TotalOperationsPerSec") , PerfTimeStamp ("Timestamp_PerfTime") , PerfTimeFreq ("Frequency_PerfTime")

Rate at which the server is performing file read and file write operations for the clients on this CPU. This value is a measure of how busy the server is. This value is always 0 (zero) in the blocking queue instance.

For more information about using uint64 values in scripts, see Scripting in WMI.

WorkItemShortages

Data type: uint32

Access type: Read-only

Qualifiers: CookingType ("PERF_COUNTER_RAWCOUNT") , Counter ("WorkItemShortages") , PerfTimeStamp ("Timestamp_PerfTime") , PerfTimeFreq ("Frequency_PerfTime")

Every request from a client is represented in the server as a work item. The server maintains a pool of available work items per CPU to speed processing. a sustained value in this property greater than 0 (zero) indicates the need to increase the MaxWorkItems registry value for the server service. This value is always 0 (zero) in the blocking queue instance.

WriteBytesPerSec

Data type: uint64

Access type: Read-only

Qualifiers: CookingType ("PERF_COUNTER_BULK_COUNT") , Counter ("WriteBytesPerSec") , PerfTimeStamp ("Timestamp_PerfTime") , PerfTimeFreq ("Frequency_PerfTime")

Rate at which the server is writing data to files for the clients on this CPU. This value is a measure of how busy the server is.

For more information about using uint64 values in scripts, see Scripting in WMI.

WriteOperationsPerSec

Data type: uint64

Access type: Read-only

Qualifiers: CookingType ("PERF_COUNTER_BULK_COUNT") , Counter ("WriteOperationsPerSec") , PerfTimeStamp ("Timestamp_PerfTime") , PerfTimeFreq ("Frequency_PerfTime")

Rate at which the server is performing file write operations for the clients on this CPU. This value is a measure of how busy the server is. This value is always 0 (zero) in the blocking queue instance.

For more information about using uint64 values in scripts, see Scripting in WMI.

Remarks

All classes derived from Win32_Perf are designed to be used with a refresher object. For more information about how to create and use a refresher object in C++, see Accessing Performance Data in C++. For more information about how to create and use a refresher object using scripts, see Refreshing WMI Data in Scripts.

The performance class and property qualifiers determine how to interpret the class data. For more information, see Class Qualifiers for Performance Counter Classes and Property Qualifiers for Performance Counter Classes.

Examples

For script code examples, see WMI Tasks for Scripts and Applications and the TechNet ScriptCenter Script Repository.

For C++ code examples, see WMI C++ Application Examples.

Requirements

Minimum supported client

Windows XP

Minimum supported server

Windows Server 2003

Namespace

\root\CIMV2

DLL

WmiPerfInst.dll; WmiCookr.dll on Windows Server 2003 and Windows XP

See also

Performance Counter Classes

Accessing WMI Preinstalled Performance Classes

WMI Tasks: Performance Monitoring

Accessing Performance Data in Script