![]() |
![]() |
![]() |
> Module > Connections |
Module
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>
Optional, unbounded
A channel must have one and only one source port as identified in a single Source element.
A channel must have one, and may have more than one, destination port as identified in one or more Destination elements.
Every port in the module, as defined in /ApplicationDescription/Ports, /PartitionDescription/Ports, and /PseudoPartitionDescription/Ports, must be assigned to a channel.
Every port defined in the module must be assigned to a channel.
If either the source or the destination of a channel is a direct-access port (as defined by the Attribute attribute of the port configuration with a value DIRECT_ACCESS_PORT) the channel must have a single destination.
If either the source or destination of a channel is DIRECT_ACCESS_PORT, the other endpoint must be either a LOCAL_PORT or a NULL_PORT.
If either the source of the destination of a channel endpoint is a partition direct-access port defined in /PartitionDescription/Ports, the other endpoint must be a a LOCAL_PORT or a NULL_PORT and must be located in the application that is located in the partition (as defined by /PartitionDescription/Application/@NameRef).
The numeric identifier for the channel. This identifier is used on the target to match the channel’s source and destination ports.
Required
ConfigRecord
Unsigned 32 bit integer
N/A
None
The channel identifier must be unique within the module.
Generated on 2007-10-15 17:17:22.