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).

Arguments

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

Remarks

Schema Definition

Input

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

Sample Code

Example XML Request

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.

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

Example XML Response

Add Resource Capacity Data does not return data.

Applies To