Application.QuantumDuration Property

Article
12/03/2008

Gets or sets a value that indicates the length of time for a generator quantum, which determines how frequently the generator attempts to process work.

Namespace: Microsoft.SqlServer.Management.Nmo
Assembly: Microsoft.SqlServer.Smo (in microsoft.sqlserver.smo.dll)

Syntax

'Declaration
Public Property QuantumDuration As TimeSpan

public TimeSpan QuantumDuration { get; set; }

public:
property TimeSpan QuantumDuration {
    TimeSpan get ();
    void set (TimeSpan value);
}

/** @property */
public TimeSpan get_QuantumDuration ()

/** @property */
public void set_QuantumDuration (TimeSpan value)

public function get QuantumDuration () : TimeSpan

public function set QuantumDuration (value : TimeSpan)

Property Value

A TimeSpan object that specifies the generator quantum duration.

Remarks

Updated text:5 December 2005

If you use the Application(Instance,String) constructor, the default value is 60 seconds. If you use the default constructor, you must set this property.

The application quantum duration controls how often the generator fires rules to generate notifications. Shorter quantum durations generate notifications more often, but require more resources. You need to balance the need for timely notifications with the processing load placed on the server by running the rules more frequently. For more information, see Specifying the Generator Quantum Duration.

Example

The following examples show how to set all application execution settings, including the quantum duration:

// Define application execution settings
myApplication.QuantumDuration = new TimeSpan(0, 0, 15);
myApplication.PerformanceQueryInterval = new TimeSpan(0, 0, 5);
myApplication.SubscriptionQuantumLimit = 1;
myApplication.ChronicleQuantumLimit = 1;
myApplication.VacuumRetentionAge = new TimeSpan(0, 0, 1);
myApplication.LogBeforeDeliveryAttempts = false;
myApplication.LogNotificationText = false;
myApplication.LogStatusInfo = false;
myApplication.EventThrottle = 500;
myApplication.NotificationThrottle = 500;
myApplication.SubscriptionThrottle = 500;
myApplication.ProcessEventsInOrder = false;

' Define application execution settings
myApplication.QuantumDuration = New TimeSpan(0, 0, 15)
myApplication.PerformanceQueryInterval = New TimeSpan(0, 0, 5)
myApplication.SubscriptionQuantumLimit = 1
myApplication.ChronicleQuantumLimit = 1
myApplication.VacuumRetentionAge = New TimeSpan(0, 0, 1)
myApplication.LogBeforeDeliveryAttempts = False
myApplication.LogNotificationText = False
myApplication.LogStatusInfo = False
myApplication.EventThrottle = 500
myApplication.NotificationThrottle = 500
myApplication.SubscriptionThrottle = 500
myApplication.ProcessEventsInOrder = False

Thread Safety

Any public static (Shared in Microsoft Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Platforms

Development Platforms

For a list of the supported platforms, see Hardware and Software Requirements for Installing SQL Server 2005.

Target Platforms