Previous Next  

Element: Channel

Document type

Module

Document XPath

/Module/Connections/Channel

Schema XPath

/ConfigRecord/Module/Connections/Channel

Description

The Channel element contains Source and Destination elements that define communication channels between two or more partitions. For each source you may define one or more destinations.

To define channels, add a Connections element to your Module document:

<Module ... Id="1">
 ...
 <Connections>
 </Connections>
 ...
</Module>
			

Add a channel element for each channel. Each channel must have a unique Id:

<Connections>
 <Channel
  Id="1">
 </Channel>
</Connections>
			

Add a Source element to the Channel. The Source element identifies the partition that contains the source port (PartitionNameRef) and the name of the port itself (PortNameRef). The port named must be configured as a source port in the related ApplicationDescription, PartitionDescription, or PseudoPartitionDescription document.

<Connections>
 <Channel Id="1">
  <Source
   PartitionNameRef="my-application-B-partition"
   PortNameRef="output1"/>
</Connections>
			

The name used for PartitionNameRef is the name of the partition that contains the application (not the name of the application itself).

Add as many destination ports as required for the channel. As with source ports, destination ports are identified by partition name and port name:

<Connections>
 <Channel Id="1">
  <Source
   PartitionNameRef="my-application-B-partition"
   PortNameRef="output1"/>
  <Destination
   PartitionNameRef="my-application-A-partition"
   PortNameRef="input1"/>
  <Destination
   PartitionNameRef="my-application-C-partition"
   PortNameRef="input1"/>
 </Channel>
 <Channel Id="2">
  <Source
   PartitionNameRef="my-application-B-partition"
   PortNameRef="output2"/>
  <Destination
   PartitionNameRef="my-application-A-partition"
   PortNameRef="input2"/>
  <Destination
   PartitionNameRef="my-application-C-partition"
   PortNameRef="input2"/>
 </Channel>
</Connections>
			
Use

Optional, unbounded

Children

Destination

Source

Attributes

Id

Restrictions

Attribute: Id

Document XPath
/Module/Connections/Channel/@Id
Schema XPath
/ConfigRecord/Module/Connections/Channel/@Id
Description

The numeric identifier for the channel. This identifier is used on the target to match the channel’s source and destination ports.

Use

Required

Target location

ConfigRecord

XML data type

IdentifierValueType

Destination data type

Unsigned 32 bit integer

Behavior if not specified

N/A

Values with special meanings

None

Restrictions



Generated on 2007-10-15 17:17:22.