Echelon OpenLNS - Manual (Page 488)

OpenLNS Programmer's Reference 451
• A static or dynamic message tag may only appear in one
connection (it may be a hub or target, but not both). A
msg_in tag may appear in multiple connections.
• If a static or dynamic tag is a hub, its targets may be a
mix of declared tags, dynamic tags and msg_in tags.
• When a msg_in tag is a hub, its targets must all be static
tags or dynamic tags because the msg_in tag may only be
used to receive messages.
Note: These requirements prevent the creation of mirrored
connections. In addition, neither type of message tag may be
used for turnaround connections, connections where the hub
and target both lie on the same application device.
Availability Local, full, and lightweight clients.
Syntax nvMtObject.AddTarget targetObject
Element Description
nvMtObject The hub MessageTag object.
targetObject The MessageTag object to be added to
the target list.
Added to API Prior to LNS Release 3.0.
Connect
Summary Connects a hub message tag to the message tags contained in
the hub's pending target list.
This method creates a new connection or adds to an existing
one. The connection consists of the hub and its targets. The
hub is the message tag object upon which the method is
invoked.
Before invoking the Connect method, one or more targets
must be added to the hub's pending target list using the
AddTarget method. When the method is invoked, the
OpenLNS Server defines the connection (using the
parameters specified in the hub's ConnectDescTemplate
object) and, if the MgmtMode property is set to
lcaMgmtModePropagateConfigUpdates (0), it connects
the objects on the network, then clears the hub's pending
target list.
As part of the connection process, the OpenLNS Server
updates the hub object's MtTargets property, as appropriate.
If a new connection is created, the hub object is also added to
the appropriate MessageTags property of the system's
Connections object.
When you create large or complex connections that require
calling the Connect method more than once, you should use
the StartTransaction and CommitTransaction methods to
group the calls into a single transaction.