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).

Arguments

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

Remarks

Schema Definition

Input



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

Sample Code

Example XML Request

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.



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

Example XML Response

Verify Resource Capacity Data does not return data.

Applies To