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

actualMax 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:
resourceInstance

candidates 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:
executeData

Children:
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:
candidates

virtualFree 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:
resourceInstance

virtualMax 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:
resourceInstance

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

BlockModelRMO Provider, Rank By Capacity, Resource Manager


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