BlockModelRMO::Select By Capacity
Keeps resources in a candidate set that match the required capacity constraints. Constraints can be imposed on both the maximum and free values of actual and virtual capacity. 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> <actualFree>0..1</actualFree> <virtualFree>0..1</virtualFree> </resourceInstance> <candidates>1..1 <targetSet>1..1</targetSet> </candidates> </executeData>XML Output Schema
Select 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 actualFree Description:
Selection criterion for actual free capacity. Only candidates whose actualFree value is greater than or equal to the value here will be selected. Must be a positive integer.Parent:
resourceInstanceactualMax Description:
Selection criterion for actual maximum capacity. Only candidates whose actualMax value is greater than or equal to the value here will be selected. Must be a positive integer.Parent:
resourceInstancecandidates Description:
Encapsulates data needed to interact with a candidate set.Children:
targetSet (minOccurs="1" maxOccurs="1")executeData Description:
Encapsulates the procedure's input data.Children:
candidates (minOccurs="1" maxOccurs="1")
resourceInstance (minOccurs="1" maxOccurs="1")resourceInstance Description:
Describes attributes of a resource instance.Parent:
executeDataChildren:
actualFree (minOccurs="0" maxOccurs="1")
actualMax(minOccurs="0" maxOccurs="1")
virtualFree (minOccurs="0" maxOccurs="1")
virtualMax (minOccurs="0" maxOccurs="1")targetSet Description:
Candidate set containing the resource instances to select from.Parent:
candidatesvirtualFree Description:
Selection criterion for virtual free capacity. Only candidates whose virtualFree value is greater than or equal to the value here will be selected. Must be a positive integer.Parent:
resourceInstancevirtualMax Description:
Selection criterion for virtual maximum capacity. Only candidates whose virtualMax value is greater than or equal to the value here will be selected. Must be a positive integer.Parent:
resourceInstanceExample
<request> <data/> <procedure> <execute procedure="Find Resources" namespace="CoreRMO"> <executeData> <candidates> <targetSet>serverSet</targetSet> </candidates> <resourceInstance> <typeName>IISServer</typeName> </resourceInstance> </executeData> </execute> <execute procedure="Select By Capacity" namespace="BlockModelRMO"> <executeData> <candidates> <targetSet>serverSet</targetSet> </candidates> <resourceInstance> <actualFree>500</actualFree> </resourceInstance> </executeData> </execute> </procedure> </request>Remarks
If more than one selection criteria is specified, only those instances that satisfy all the specified criteria will be selected.
See Also
Top of Page
) 1999-2002 Microsoft Corporation. All rights reserved.