WorkItemTimeout Element (ADF)
Specifies the amount of time a distributor thread can take to complete a work item assigned to it before the job is canceled and the work item is returned to the available work item pool.
Syntax
<NotificationClasses>
<NotificationClass>
...
<Protocols>
<Protocol>
<ProtocolExecutionSettings>
...
<WorkItemTimeout>
Element Characteristics
| Characteristic | Description |
|---|---|
Data type |
duration. |
Default value |
15 minutes. |
Occurrence |
Optional once per ProtocolExecutionSettings element. |
Updates |
Can be added, deleted, and modified when updating the application. |
Element Relationships
| Relationship | Elements |
|---|---|
Parent element |
|
Child elements |
None. |
Remarks
A work item consists of notifications within a single batch that will be delivered through the same delivery channel. Notification Services divides notification batches into work items to take advantage of batch processing and to deliver notifications via multiple delivery channels in parallel.
When a distributor thread is free, it picks up an available work item to format and deliver. The WorkItemTimeout value configures a time limit for formatting and delivery of the notifications in that work item. If the distributor exceeds the timeout, it returns the work item to the pool of available work items so it can be processed by another distributor thread, assuming there is a retry schedule.
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 specify that a distributor thread can take two minutes to complete a work item.
<WorkItemTimeout>P0DT00H02M00S</WorkItemTimeout>
See Also
Reference
RetrySchedule Element (ADF)
Application Definition File Reference
Other Resources
Specifying the Delivery Protocol Name and Fields
Updating Instances and Applications