BlockModelRMO::Query Resource Allocations

Returns all allocations between a resource instance and a set of consumers. 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
	<instanceName>1..1</instanceName>
	<typeName>1..1</typeName>
	<instanceLocation>1..1</instanceLocation>  
  </resourceInstance>
  <candidates>0..1
	<consumerTargetSet>0..1</consumerTargetSet>
  </candidates>
</executeData>

XML Output Schema

The following code fragment shows the format for data this procedure returns. For more information on individual elements and attributes, see the Elements and Attributes table.

<executeData>1..1
 <allocations>0..1
  <consumerInstance>0..unbounded
	<instanceName>1..1</instanceName>
	<typeName>1..1</typeName>
	<actualUsed>1..1</actualUsed>
	<virtualUsed>1..1</virtualUsed>
  </consumerInstance>
  </allocations>
</executeData>

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
actualUsed Description:
Actual resource capacity allocated to the consumer.

Parent:
consumerInstance

allocations Description:
List of allocations.

Parent:
executeData

Child:
consumerInstance (minOccurs="0" maxOccurs="*")
candidates Description:
 Encapsulates data needed to describe the candidate set for consumer instances. If the candidate set is omitted, all allocations associated with the resource instance are returned.

Parent:
executeData

Child:
consumerTargetSet (minOccurs="0" maxOccurs="1")
consumerInstance Description:
Encapsulates data needed to describe a consumer instance.

Parent:
executeData

Children:
actualUsed (minOccurs="1" maxOccurs="1")
instanceName (minOccurs="1" maxOccurs="1")
typeName (minOccurs="1" maxOccurs="1")
virtualUsed (minOccurs="1" maxOccurs="1")
consumerTargetSet Description:
 Set of consumers to query.

Parent:
candidates

executeData Description:;
Encapsulates the procedure's input and output data.

Children:
allocations (minOccurs="0" maxOccurs="1")
resourceInstance (minOccurs="1" maxOccurs="1")
instanceLocation Description:
Location of the resource instance.

Parent:
resourceInstance

instanceName Description:
Name of the instance.

Parents:
consumerInstance (input), resourceInstance (output)
resourceInstance Description:
Encapsulates data required to describe a resource instance.

Parent:
allocations

Children:
instanceLocation (minOccurs="1" maxOccurs="1")
instanceName (minOccurs="1" maxOccurs="1")
typeName (minOccurs="1" maxOccurs="1")
typeName Description:
Name of the type associated with this instance.

Parents:
resourceInstance (input), consumerInstance (output)
virtualUsed Description:
Virtual resource capacity allocated to the consumer.

Parent:
consumerInstance

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

Parent:
executeData

Children:
instanceLocation (minOccurs="1" maxOccurs="1")
instanceName (minOccurs="1" maxOccurs="1")
typeName (minOccurs="1" maxOccurs="1")

Example

<request>
  <data/>
  <procedure>  
	<execute procedure="Query Resource Allocations" namespace="BlockModelRMO"> 
	<executeData>
		<resourceInstance>
		<instanceName>iis-1</instanceName>
		<typeName>IISServer</typeName>
		<instanceLocation>Lab A, Building B</instanceLocation>
		</resourceInstance>
	</executeData>
	<after source="executeData" sourcePath="allocations" destination="data" />
	</execute>
  </procedure>
</request>

See Also

BlockModelRMO Provider, Query Consumer Allocations, Resource Manager

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