Provisioning Schema::queueContext
Element that encapsulates configuration data for queued provisioning requests. This element is part of the provisioning schema of Microsoft. Provisioning Framework (MPF).
Parent
Child
Attributes
- onFailure
- Optional. Enumeration that specifies the handling of a queued action, once the specified number of retries has been exhausted.
- "continue": Fails the requests and continues.
- "queueToOperator": Queues the request for operator intervention. The operator can then choose to retry the request later.
- queueId
- ID that the Queue Manager generates for a queued action. MPF automatically populates this ID into the queueContext node.
- retryCount
- Optional. UI2 (2-byte unsigned integer) that specifies the number of times the queued action is to be retried on failure.
- priority
- Optional. I2 (2-byte integer) that specifies the priority of the queued job lower the number specified the higher the priority. Priorities are divided in three categories high(-50 and less) medium(-50 -- 0) and low( greater than 0). Within QM there are three in-memory queues mapping to each category and jobs within each category are ordered based on their priority when they are picked from the persistent store.
- retryInterval
- Optional. UI2 (2-byte unsigned integer) that specifies the number of milliseconds to wait between retries.
- retainSuccessfulResponses
- Optional. Boolean (Bool value 0 or 1) that specifies if responses from the successfully executed queued jobs need to be retained or not. in case if not then MPF would delete the queued jobs once they are successfully executed. The flag does not effect the behaviour of failed queued jobs. In case if no value is specified then default value configured for Queue Managers in property store is picked.
- retryStopOnFailure
- Optional. Hexadecimal error code (for example, "0x80070057") that sets a return error check. Whenever a queued job fails and returns the specified error code in the response XML, the job is retried only once (instead of the number of times specified by retryCount).
- retryType
- Optional. Enumeration that specifies the type of retry interval for a failed queued action.
- "constant" (default): The same interval (retryInterval) is used for all retries.
- "exponential": The retry interval increases exponentially based on the formula retryInterval * 2 number of retries.
- "linear": The retry interval increases in a linear fashion based on the formula retryInterval * number of retries.
Example
<request xmlns="http://maps/specs/prov.xml"> <context> <queueContext retryCount="3" retryInterval="300"/> </context> <procedure> <execute namespace="SimpleSco" procedure="Write Request"> <forEach name="organization" root="data" path="organizations/organization" /> <before source="organization" destination="executeData" /> </execute> </procedure> </request>See also
Top of Page
) 1999-2002 Microsoft Corporation. All rights reserved.