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:
executeDataChild:
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:
resourceInstancerankLowestCapacityFirst Description:
Integer indicating whether to rank in order of decreasing capacity ("0", default) or increasing capacity ("1").Parent:
resourceInstancerankUsing Description:
Capacity metric to use for ranking. Valid values are "actualFree", "actualMax", "virtualFree", and "virtualMax".Parent:
resourceInstanceresourceInstance Description:
Encapsulates data needed to describe a resource instance.Parent:
executeDataChildren:
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:
candidatesExample
<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
Top of Page
) 1999-2002 Microsoft Corporation. All rights reserved.