BlockModelRMO::Rank By Capacity


Ranks the resources in a candidate set according to one of the four resource capacity metrics. The rank can be based either on order of decreasing available capacity (default) or increasing available capacity (for best fit). 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
	<rankUsing>1..1</rankUsing>
	<rankLowestCapacityFirst>0..1</rankLowestCapacityFirst>
	<minRank>0..1</minRank>
  </resourceInstance>
  <candidates>1..1
	<targetSet>1..1</targetSet>
  </candidates>
</executeData>

XML Output Schema

Rank By Capacity 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
candidates Description:
Encapsulates data needed to interact with a 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")

minRank Description:
Starting rank. All ranks assigned to resources will be this value or higher.

Note  The lowest rank value implies highest rank when ordering resources for allocation.

Defaults to 1 if not specified.

Parent:
resourceInstance

rankLowestCapacityFirst Description:
Integer indicating whether to rank in order of decreasing capacity ("0", default) or increasing capacity ("1").

Parent:
resourceInstance

rankUsing Description:
Capacity metric to use for ranking. Valid values are "actualFree", "actualMax", "virtualFree", and "virtualMax".

Parent:
resourceInstance

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

Parent:
executeData

Children:
minRank (minOccurs="0" maxOccurs="1")
rankLowestCapacityFirst
(minOccurs="0" maxOccurs="1")
rankUsing
(minOccurs="1" maxOccurs="1")

targetSet Description:
Candidate set that contains the resource instances to rank.

Parent:
candidates

Example

<request>
  <data/>
  <procedure>  
	<execute procedure="Find Resources" namespace="CoreRMO"> 
	<executeData>
		<candidates>
		<targetSet>serverSet</targetSet>
		</candidates>
		<resourceInstance>
		<typeName>IISServer</typeName>
		</resourceInstance>
	</executeData>
	</execute>
	<execute procedure="Rank By Capacity" namespace="BlockModelRMO"> 
	<executeData>
		<candidates>
		<targetSet>serverSet</targetSet>
		</candidates>
		<resourceInstance>
		<rankUsing>actualFree</rankUsing>
		<minRank>1</minRank>
		</resourceInstance>
	</executeData>
	</execute>
  </procedure>
</request>

See Also

BlockModelRMO Provider, Resource Manager, Select By Capacity


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