MSFT_SIPQMSDBConfigSetting (New)

Article
05/23/2014

This content is no longer actively maintained. It is provided as is, for anyone who may still be using these technologies, with no warranties or claims of accuracy with regard to the most recent product version or service release.

Contains the configuration settings for the Quality of Experience (QoE) database that is installed as part of the Monitoring Server server role.

The properties in the MSFT_SIPQMSDBConfigSetting class do not map directly to the Office Communications Server 2007 R2 Administration Tool.

MSFT_SIPQMSDBConfigSetting

This class defines properties that configure Monitoring Server to calculate QoE statistics.

The following syntax is simplified from Managed Object Format (MOF) code and includes all inherited properties. Properties are listed in alphabetic order, not MOF order.

Syntax

class MSFT_SIPQMSDBConfigSetting
{
  [key] string Backend;
  string CurrentLocationMode;
  real32 DegradationAvgThreshold;
  uint32 HighDelayThreshold;
  uint32 HighVideoPacketLossThreshold;
  [key] string InstanceID;
  string LastImportTime;
  uint32 LowVideoBitRate;
  uint32 MarginTime;
  uint32 PerfCounterPublishRate;
  real32 PoorJitterFactor;
  real32 PoorPacketLossFactor;
  sint32 SingleSubnetMask;
  uint32 SlidingWindowSize;
  uint32 StatsGenerationMinSamples;
};

Methods

This class does not define any methods.

Properties

The MSFT_SIPQMSDBConfigSetting class has the following properties.

Backend
Data type: [key] string

Access type: Read-only

Required: Identifies the instance of SQL Server that manages the database for Monitoring Server.

This property specifies the database server using the following format:

computername\instancename

The value computername identifies either the FQDN or the NetBIOS name of the host computer for SQL Server and instancename identifies a named instance of SQL Server on the specified computer.

CurrentLocationMode
Data type: string

Access type: Read/Write

Required. The current location mode used for monitoring.

Value	Description
AutoEP	Endpoint (EP) subnets. Monitoring Server automatically creates subnet locations according to the subnet mask and IP address that are sent from supported call endpoints.
AutoSM	Single Subnet Mask (SM). Monitoring Server automatically creates subnet locations by applying a single administrator-configured subnet mask to the IP addresses that are sent from supported endpoints.
Import	Monitoring Server imports a comma-delimited (.csv) list of user-defined locations to be monitored.

The maximum length of the string is 6 characters.

DegradationAvgThreshold
Data type: real32

Access type: Read/Write

Required. The default threshold that categorizes poor network degradation.

Audio calls with an average Network MOS degradation value greater than this value are categorized as having “poor” Network MOS degradation.

The minimum value for this property is 0.0 and the maximum value is 4.0.

The default value for this property is 1.0.
HighDelayThreshold
Data type: uint32

Access type: Read/Write

Required. The threshold criterion that categorizes high delay for audio calls.

This is the round trip high delay threshold in milliseconds (ms) for audio packets.

Monitoring Server uses a default of 500 ms to calculate the “percentage of audio calls experiencing high delay”.

The minimum value for this property is 1 and the maximum value is 2147483647.
HighVideoPacketLossThreshold
Data type: uint32

Access type: Read/Write

Required. The threshold criterion that categorizes the poor packet loss for video calls.

Any percentage higher than this value is categorized as “poor.” Monitoring Server uses a default value of 15 (percent) for this threshold.

The minimum value for this property is 1 and the maximum value is 100.
InstanceID
Data type: [key] string

Access type: Read-only

Required. A GUID value that uniquely identifies an instance of this class.

The GUID must be encapsulated between the "{" and "}" braces; for example: "{01234567-0123-4567-89AB-CDEF01234567}".
LastImportTime
Data type: string

Access type: Read/Write

Optional. The time when the location was last imported.
LowVideoBitRate

Warning

This property is obsolete and not used in Office Communications Server 2007 R2.

Data type: uint32

Access type: Read/Write

Required. The threshold criterion that categorizes the low video average bit rate for video calls in bits per second (bps).

Monitoring Server uses a default bit rate of 100,000 bps to calculate the “percent video calls with low video bit rate”.

The minimum value for this property is 0 and the maximum value is 2147483647.
MarginTime

Important

Do not change this property.

Data type: uint32

Access type: Read/Write

Required. The offset from the current time in seconds for the sliding time interval specified by the SlidingWindowSize property.

This property is used internally to avoid possible conflicts between performance counter query and insertion and should not be changed by API calls.

Monitoring Server uses a default value of 15 seconds.

The minimum value for this property is 1 and the maximum value is 7776000 (90 days).
PerfCounterPublishRate
Data type: uint32

Access type: Read/Write

Required. The interval in seconds that performance counters query the database and publish data to be compared against performance criteria.

Monitoring Server uses a default value of 120 seconds for this property.

The minimum value for this property is 1 and the maximum value is 2147483647.
PoorJitterFactor
Data type: real32

Access type: Read/Write

Required. The jitter factor threshold that categorizes jitter as a major contributor to "poor" network MOS.

Monitoring Server uses 1.5 as the default value.

The minimum value for this property is 0.00 and the maximum value is 4.00.
PoorPacketLossFactor
Data type: real32

Access type: Read/Write

Required. The packet loss factor threshold that categorizes the packet loss as a major contributor to "poor" network MOS.

Monitoring Server uses a jitter factor of 1.5 as the default value.

The minimum value for this property is 0.00 and the maximum value is 4.00.
SingleSubnetMask
Data type: sint32

Access type: Read/Write

Optional. Specifies the subnet mask if “AutoSM” is specified for CurrentLocationMode.

The 32-bit binary subnet mask must begin with a block of consecutive ones, followed by a block of consecutive zeros.

This value for this property must be a valid IPv4 mask. The default value is NULL.
SlidingWindowSize
Data type: uint32

Access type: Read/Write

Required. The moving time interval in minutes for generating average Performance Monitor counters.

The default value is 10 minutes.

This is also the interval after which a performance counter instance for a monitored location, A/V Conferencing Server, or Mediation Server is removed if it does not participate in a call. Another performance counter instance is created after the location, A/V Conferencing Server, or Mediation Server participates in another call.
StatsGenerationMinSamples

Note

This property is obsolete and not used in Office Communications Server 2007 R2.

Data type: uint32

Access type: Read/Write

Required. The minimum sample size required to calculate a QoS statistic.

Monitoring Services uses a default value of 30.

The minimum value for this property is 1 and the maximum value is 2147483647.

Remarks

This class gets and sets information at the following level: SQL.

Only one instance of this class can be present in the forest.

Instances of this class support the following interface methods:

Provider::GetObject();
Provider::PutInstance();

Where PutInstance() supports the following flags:
- WBEM_FLAG_CREATE_ONLY
- WBEM_FLAG_UPDATE_ONLY
- WBEM_FLAG_CREATE_OR_UPDATE

Requirements

Server: Installed on computers serving the following role: Monitoring Server.

Namespace: Defined in \root\cimv2.