BlockModelRMO::Add Resource Capacity Data

Associates block-model resource capacity information with a candidate set of resource instances previously defined in the Resource Manager Database using the CoreRMO Provider. 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
	<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

Add 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:
 Maximum actual capacity of the resource instance. Must be a positive integer. If not provided, the value for actualMax defaults to the defaultActualMax value registered by Add Resource Type Data for this resource type.

Parent:
resourceInstance

candidates Description:
 Encapsulates data needed to describe the candidate set.

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. Must be a positive integer.

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. Applies to both virtual and actual capacity. The percentage must be a positive integer greater than or equal to 0, or less than or equal to 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")
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. The resource types associated with these instances must have already been registered using Add Resource Type Data, and no instance must have been previously registered with Add Resource Capacity Data.

Parent:
candidates

virtualMax Description:
 Maximum virtual capacity of the resource instance. Must be a positive integer.

Parent:
resourceInstance

warningPc Description:
Percentage that represents the allocation level at which to raise a warning notification for the operator. Applies to both virtual and actual capacity. 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="Add Resource Capacity Data" namespace="BlockModelRMO"> 
	<executeData>
		<candidates>
		<targetSet>serverSet</targetSet>
		</candidates>
		<resourceInstance>
		<actualMax>1000</actualMax>
		<virtualMax>0</virtualMax>
		<warningPc>85</warningPc>
		<maxFillPc>95</maxFillPc>
		</resourceInstance>
	</executeData>
	</execute>
  </procedure>
</request>

Remarks

All nodes for capacity data are optional. Unspecified values default to the values defined for the resource type using Add Resource Type Data.

This function will fail if the resources do not exist, if resource type data does not exist for the resource types associated with the resource instances in the target set, or if resource capacity data already exists for any of the resources in the resource set.

See Also

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

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