BlockModelRMO::Update Allocation
Updates allocations that exist between consumers in the consumerTargetSet and resources in the resourceTargetSet. Used by Microsoft. Provisioning Framework (MPF).
XML Input Schema
The following code fragment shows the format for sending data to this procedure. For more information on individual elements and attributes, see the Elements and Attributes table.
<executeData>1..1 <allocation>1..1 <resourceTargetSet>1..1</resourceTargetSet> <consumerTargetSet>1..1</consumerTargetSet> <actualUsed>0..1</actualUsed> <virtualUsed>0..1</virtualUsed> </allocation> </executeData>XML Output Schema
Update Allocation does not return data.
Elements and Attributes
The following table describes the XML schema elements and attributes. Unless otherwise indicated, the data type is string.
Element Description, relationships, and attributes actualUsed Description:
Actual capacity to allocate to each consumer in the consumerTargetSet node.If the fill ratio (fillRatio) exists for a resource instance, but an allocation (actualUsed) is not specified, it will be calculated from the virtual allocation (virtualUsed) using the following formula.
actualUsed = ceiling(virtualUsed * fillRatio / 100)
Parent:
allocationallocation Description:
Encapsulates data required to describe an allocation.Parent:
executeDataChildren:
actualUsed (minOccurs="0" maxOccurs="1")
consumerTargetSet (minOccurs="1" maxOccurs="1")
resourceTargetSet (minOccurs="1" maxOccurs="1")
virtualUsed (minOccurs="0" maxOccurs="1")consumerTargetSet Description:
Set of consumers with allocations to update.Parent:
allocationexecuteData Description:
Encapsulates the procedure's input data.Child:
allocation (minOccurs="1" maxOccurs="1")resourceTargetSet Description:
Set of resource allocations to update.Parent:
allocationvirtualUsed Description:
Virtual capacity to allocate to each consumer in the consumerTargetSet node.Parent:
allocationExample
<request> <data/> <procedure> <execute procedure="Add Resource to Candidates" namespace="CoreRMO"> <executeData> <candidates> <targetSet>serverSet</targetSet> </candidates> <resourceInstance> <instanceName>iis-1</instanceName> <instanceLocation>Lab A, Building B</instanceLocation> <typeName>IISServer</typeName> </resourceInstance> </executeData> </execute> <execute procedure="Add Consumer to Candidates" namespace="CoreRMO"> <executeData> <candidates> <targetSet>siteSet</targetSet> </candidates> <consumerInstance> <instanceName>tailspintoys.com</instanceName> <typeName>Website</typeName> </consumerInstance> </executeData> </execute> <execute procedure="Update Allocation" namespace="BlockModelRMO"> <executeData> <allocation> <resourceTargetSet>serverSet</resourceTargetSet> <consumerTargetSet>siteSet</consumerTargetSet> <actualUsed>2</actualUsed> </allocation> </executeData> </execute> </procedure> </request>Remarks
The allocation is updated by the actual and virtual amounts specified. These are relative values; if they are negative, the function reduces the existing allocations.
This function will fail if there are insufficient resources to increase the consumer's current allocation by the amount specified. It will also fail if an attempt is made to reduce the allocation below zero.
See Also
Allocate, BlockModelRMO Provider, Delete Allocation, Move Allocation, Resource Manager
Top of Page
) 1999-2002 Microsoft Corporation. All rights reserved.