CoreRMO::Construct Mapping


Creates mapping relationships between two sets of instances or groups and returns the number of new mappings created by the operation. 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
  <mapping>1..1
	<fromSet>1..1</fromSet>
	<toSet>1..1</toSet>
	<fromCategory>1..1</fromCategory>
	<toCategory>1..1</toCategory>
	<relationship>1..1</relationship>
  </mapping>
</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
  <rowsAffected>1..1</rowsAffected>
</executeData>

Elements and Attributes

The following table describes the XML elements and attributes. Unless otherwise indicated, the data type is string.

Element Description, relationships, and attributes
executeData Description:
Encapsulates the procedure's input and output data.

Children:
mapping (minOccurs="1" maxOccurs="1")

fromCategory Description:
Category of objects mapped to the toCategory objects: resourceInstance, resourceGroup, consumerInstance, or consumerGroup.

Parent:
mapping

fromSet Description:
Set of objects mapped to the toSet objects.

Parent:
mapping

mapping Description:
Encapsulates a description of a mapping set.

Children:
fromCategory (minOccurs="1" maxOccurs="1")
fromSet
(minOccurs="1" maxOccurs="1")
toCategory (minOccurs="1" maxOccurs="1")
toSet
(minOccurs="1" maxOccurs="1")
relationship (minOccurs="1" maxOccurs="1")

relationship Description:
Name of the relationship.

Note  The Resource Manager reserves a special mapping, "Allocation," for internal use to represent allocations. For this reason, you should refrain from using "Allocation" as the name of a relationship.

Parent:
mapping

rowsAffected Description:
Integer that specifies the number of new mappings created by this operation.

Parent:
executeData

toCategory Description:
Category of objects mapped to the fromCategory objects: resourceInstance, resourceGroup, consumerInstance, or consumerGroup.

Parent:
mapping

toSet Description:
Set of objects mapped to the fromSet objects.

Parent:
mapping

Example

<request>
  <data/>
  <procedure>  
	<execute procedure="Add Resource To Candidates" namespace="CoreRMO"> 
	<executeData>
		<resourceInstance>
		<instanceName>iis-1</instanceName>
		<instanceLocation>Lab A, Building B</instanceLocation>
		<typeName>IISServer</typeName>
		</resourceInstance>
		<candidates>
		<targetSet>serverSet</targetSet>
		<rank>1</rank>
		</candidates>
	</executeData>
	</execute>
	<execute procedure="Add Resource Group To Candidates" namespace="CoreRMO"> 
	<executeData>
		<candidates>
		<targetSet>groupSet</targetSet>
		</candidates>
		<resourceGroup>
		<groupName>BroadBandServerGroup</groupName>
		</resourceGroup>
	</executeData>
	</execute>
	<execute procedure="Construct Mapping" namespace="CoreRMO"> 
	<executeData>
		<mapping>
		<fromSet>serverSet</fromSet>
		<toSet>groupSet</toSet>
		<fromCategory>resourceInstance</fromCategory>
		<toCategory>resourceGroup</toCategory>
		<relationship>isABroadBandServer</relationship>
		</mapping>
	</executeData>
	<after source="executeData" sourcePath="rowsAffected" destination="data" />
	</execute>
  </procedure>
</request>

Remarks

Resource Manager uses mappings internally to associate consumers with resources. Other uses of mappings include identifying group membership or resource ownership.

New mappings can be created only if they do not already exist in the mapping table.

See Also

CoreRMO Provider, Delete Mapping


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