BlockModelRMO::Verify Resource Capacity Data


Checks that the resource capacity data in the Resource Manager Database is within acceptable tolerance of the passed-in capacity data. 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>
	<instanceLocation>1..1</instanceLocation>
	<typeName>1..1</typeName>
	<actualMax>0..1</actualMax> 
	<maxPCAboveActualMax>0..1</maxPCAboveActualMax>
	<maxPCBelowActualMax>0..1</maxPCBelowActualMax>
	<actualFree>0..1</actualFree> 
	<maxPCAboveActualFree>0..1</maxPCAboveActualFree>
	<maxPCBelowActualFree>0..1</maxPCBelowActualFree>
	<virtualMax>0..1</virtualMax> 
	<maxPCAboveVirtualMax>0..1</maxPCAboveVirtualMax>
	<maxPCBelowVirtualMax>0..1</maxPCBelowVirtualMax>
	<virtualFree>0..1</virtualFree> 
	<maxPCAboveVirtualFree>0..1</maxPCAboveVirtualFree>
	<maxPCBelowVirtualFree>0..1</maxPCBelowVirtualFree>
  </resourceInstance>
</executeData> 	 

XML Output Schema

Verify Resource Capacity Data 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:
Correct value for actualFree.

Parent:
resourceInstance

actualMax Description:
Correct value for actualMax.

Parent:
resourceInstance

executeData Description:
Encapsulates the procedure's input data.

Child:
resourceInstance (minOccurs="1" maxOccurs="1")

instanceLocation Description:
Location of the resource instance whose capacity data is being verified.

Parent:
resourceInstance

instanceName Description:
Name of the resource instance whose capacity data is being verified.

Parent:
resourceInstance

maxPCAboveActualFree Description:
Maximum percentage above the correct value to allow actualFree before raising a notification.

Parent:
resourceInstance

maxPCAboveActualMax Description:
Maximum percentage above the correct value to allow actualMax before raising a notification.

Parent:
resourceInstance

maxPCBelowActualFree Description:
Maximum percentage below the correct value to allow actualFree before raising a notification.

Parent:
resourceInstance

maxPCBelowActualMax Description:
Maximum percentage below the correct value to allow actualMax before raising a notification.

Parent:
resourceInstance

maxPCAboveVirtualFree Description:
Maximum percentage above the correct value to allow virtualFree before raising a notification.

Parent:
resourceInstance

maxPCAboveVirtualMax Description:
Maximum percentage above the correct value to allow virtualMax before raising a notification.

Parent:
resourceInstance

maxPCBelowVirtualFree Description:
Maximum percentage below the correct value to allow virtualFree before raising a notification.

Parent:
resourceInstance

maxPCBelowVirtualMax Description:
Maximum percentage below the correct value to allow virtualMax before raising a notification.

Parent:
resourceInstance

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

Parent:
executeData

Children:
actualFree (minOccurs="0" maxOccurs="1")
actualMax
(minOccurs="0" maxOccurs="1")
instanceLocation
(minOccurs="1" maxOccurs="1")
instanceName
(minOccurs="1" maxOccurs="1")
maxPCAboveActualFree
(minOccurs="0" maxOccurs="1")
maxPCAboveActualMax (minOccurs="0" maxOccurs="1")
maxPCAboveVirtualFree (minOccurs="0" maxOccurs="1")
maxPCAboveVirtualMax
(minOccurs="0" maxOccurs="1")
maxPCBelowActualFree (minOccurs="0" maxOccurs="1")
maxPCBelowActualMax (minOccurs="0" maxOccurs="1")
maxPCBelowVirtualFree (minOccurs="0" maxOccurs="1")
maxPCBelowVirtualMax (minOccurs="0" maxOccurs="1")
typeName (minOccurs="1" maxOccurs="1")
virtualFree (minOccurs="0" maxOccurs="1")
virtualMax (minOccurs="0" maxOccurs="1")

typeName Description:
Type associated with the resource instance.

Parent:
resourceInstance

virtualMax Description:
Correct value for virtualMax.

Parent:
resourceInstance

virtualFree Description:
Correct value for virtualFree.

Parent:
resourceInstance

Example

<request>
  <data/>
  <procedure>  
	<execute procedure="Verify Resource Capacity Data" namespace="BlockModelRMO"> 
	<executeData>
		<resourceInstance>
		<instanceName>iis-1</instanceName>
		<instanceLocation>Lab A, Building B</instanceLocation>
		<typeName>IISServer</typeName>
		<actualFree>900</actualFree>
		<maxPCAboveActualFree>5</maxPCAboveActualFree>
		<maxPCBelowActualFree>5</maxPCBelowActualFree>
		</resourceInstance>
	</executeData>
	</execute>
	<execute procedure="Retrieve Notifications" namespace="CoreRMO"> 
	<after source="executeData" sourcePath="notifications" destination="data" />
	</execute>
  </procedure>
</request>

Remarks

If values differ from the acceptable tolerances, notifications are added to the notification table. These notifications can then be raised as events or retrieved as XML using the CoreRMO Provider functions Raise Notifications As Events and Retrieve Notifications, respectively.

See Also

BlockModelRMO Provider, Resource Manager


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