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:
allocation

allocation Description:
 Encapsulates data required to describe an allocation.

Parent:
executeData

Children:
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:
allocation

executeData Description:
 Encapsulates the procedure's input data.

Child:
allocation (minOccurs="1" maxOccurs="1")
resourceTargetSet Description:
 Set of resource allocations to update.

Parent:
allocation

virtualUsed Description:
 Virtual capacity to allocate to each consumer in the consumerTargetSet node.

Parent:
allocation

Example

<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

Up Top of Page
) 1999-2002 Microsoft Corporation. All rights reserved.