BlockModelRMO::Update Resource Capacity Data

Updates capacity data associated with a set of resource instances. The update can either be relative or absolute. Relative updates add to previous values; absolute updates overwrite them. 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
   <resourceInstance>1..1
	<updateAbsolute>0..1</updateAbsolute> 
	<actualMax>0..1</actualMax> 
	<virtualMax>0..1</virtualMax> 
	<warningPc>0..1</warningPc> 
	<maxFillPc>0..1</maxFillPc> 
	<fillRatio>0..1</fillRatio> 
  </resourceInstance> 
  <candidates>1..1
	<targetSet>1..1</targetSet> 
  </candidates> 
</executeData>

XML Output Schema

Update Resource Capacity Data 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
actualMax Description:
 Actual maximum capacity for the resource instance. For relative updates (updateAbsolute is 0), this value can be either positive (to increase) or negative (to decrease). However, for absolute updates (updateAbsolute is 1), this value must be positive.

Parent:
resourceInstance

candidates Description:
 Contains the elements used to describe candidate sets.

Parent:
executeData

Child:
targetSet (minOccurs="1" maxOccurs="1")
executeData Description:
Encapsulates the procedure's input data.

Children:
candidates (minOccurs="1" maxOccurs="1")
resourceInstance (minOccurs="1" maxOccurs="1")
fillRatio Description:
Percentage of virtual resource capacity; used to calculate actual resource capacity from virtual capacity. For relative updates (updateAbsolute is 0), this value can be either positive (to increase) or negative (to decrease). However, for absolute updates (updateAbsolute is 1), this value must be positive. If the resource instance has consumers allocated to it, the allocations are automatically updated if the fillRatio changes.

Parent:
resourceInstance

maxFillPc Description:
Maximum percentage of total capacity that can be allocated to resource consumers. When a resource reaches this level, consumers will no longer be allocated to it. This value applies to both virtual and actual capacity. For relative updates (updateAbsolute is 0), this value can be either positive (to increase) or negative (to decrease). However, for absolute updates (updateAbsolute is 1), this value must be positive. The resulting value must be between 0 and 100.

Parent:
resourceInstance

resourceInstance Description:
Encapsulates data needed to describe capacity attributes of a resource instance.

Parent:
executeData

Children:
actualMax (minOccurs="0" maxOccurs="1")
fillRatio (minOccurs="0" maxOccurs="1")
maxFillPc (minOccurs="0" maxOccurs="1")
updateAbsolute (minOccurs="0" maxOccurs="1")
virtualMax (minOccurs="0" maxOccurs="1")
warningPc (minOccurs="0" maxOccurs="1")
targetSet Description:
 Candidate set of resource instances with which the resource capacity data will be associated.

Parent:
candidates

updateAbsolute Description:
 Boolean (0 or 1) that specifies whether the update is relative (adding to previous values) or absolute (overwriting previous values). The default value is 0 (relative).

Parent:
resourceInstance

virtualMax Description:
 Maximum virtual capacity of the resource instance. For relative updates (updateAbsolute is 0), this value can be either positive (to increase) or negative (to decrease). However, for absolute updates (updateAbsolute is 1), this value must be positive.

Parent:
resourceInstance

warningPc Description:
Percentage that represents the allocation level at which to raise a notification for the operator. This value applies to both virtual and actual capacity. For relative updates (updateAbsolute is 0), this value can be either positive (to increase) or negative (to decrease). However, for absolute updates (updateAbsolute is 1), this value must be positive. The resulting value must be a positive integer that is less than or equal to the maxFillPC value.

Parent:
resourceInstance

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="Update Resource Capacity Data" namespace="BlockModelRMO"> 
	<executeData>
		<candidates>
		<targetSet>serverSet</targetSet>
		</candidates>
		<resourceInstance>
		<warningPc>80</warningPc>
		<maxFillPc>90</maxFillPc>
		<updateAbsolute>1</updateAbsolute>
		</resourceInstance>
	</executeData>
	</execute>
  </procedure>
</request>

See Also

Add Resource Capacity Data, BlockModelRMO Provider, Query Resource Capacity Data, Resource Manager

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