QuantumDuration Element for Distributor (ADF)

Defines the length of time for a distributor quantum, which determines how frequently Notification Services invokes the distributor.

Syntax

<Distributors>
    <Distributor>
        ...
        <QuantumDuration>

Element Characteristics

Characteristic Description

Data type

duration.

Default value

60 seconds.

Occurrence

Optional once per Distributor element.

Updateable

Can be modified, but not added or deleted, when updating the application.

Element Relationships

Relationship Elements

Parent element

Distributor Element (ADF)

Child elements

None.

Remarks

The distributor quantum duration controls how often Notification Services invokes the distributor to process available work items. Note than the distributor quantum has an effect only when the distributor is idle. When the distributor is processing work items, it waits until it is finished processing the current work item before it attempts to process additional work items.

Shorter quantum durations cause Notification Services to invoke the distributor more frequently, but require more resources. You need to balance the need for responsiveness during idle periods with the processing load placed on the Microsoft SQL Server database engine by running the distributor more frequently. For more information, see Specifying the Generator Quantum Duration.

The format of the XML duration data type is PnYnMnDTnHnMnS. For more information about XML data types, see Primitive XML Data Types in the MSDN Library.

Example

The following example shows how to define a distributor quantum duration of 1 minute and 30 seconds.

<QuantumDuration>P0DT00H01M30S</QuantumDuration>

See Also

Reference

Application Definition File Reference

Other Resources

Specifying the Generator Quantum Duration
Updating Instances and Applications

Help and Information

Getting SQL Server 2005 Assistance