Echelon OpenLNS - Manual (Page 919)

OpenLNS Programmer's Reference 882
FALSE. Device discovery has
completed execution without
being halted or the
application has exited.
systemObject The System object to be acted on
Data Type Boolean.
Read/Write Read only.
Added to API Prior to LNS Release 3.0.
DomainId
Summary Identifies the domain ID.
The domain ID is stored as a string of hexadecimal digits.
For example, a 3-byte domain ID would be represented like
this: "32a0cf". Domain IDs can be 1, 3, or 6 bytes in length.
When setting the DomainId property, any characters beyond
those required are ignored. Changes to the domain ID will
automatically be propagated to all application devices and
routers unless one or more devices is using authentication.
In that case, an exception will be returned.
The ability to set this property may be useful in the
predefined components installation scenario involving many
similarly configured sites. In such a scenario, it is more
efficient to load an OpenLNS database containing basic
configuration into every site, and change the domain ID of
the site immediately prior to commissioning, than to create
each database separately.
The following is an example sequence:
1. Create a basic configuration database by initializing the
Object Server, setting the System object’s MgmtMode
property to lcaMgmtModeDeferConfigUpdates (1),
creating program templates by importing binary external
interface files, defining devices (without Neuron Ids), and
adding connections. Save the database by copying the
network database directory.
2. During commissioning, load the database by coping the
database above and adding it to the global database.
3. Set the DomainId property to the domain ID for the site.
This must be a unique value. One way to ensure that the
DomainId property is assigned a unique value is to set
the InstallOptions property to lcaSharedMedia before
creating the network. This will result in the OpenLNS
Object Server assigning a value equivalent to the Neuron
ID of the OpenLNS Server computer to the DomainId
property, which is guaranteed to be a unique value.
4. Set the System object’s MgmtMode property to
lcaMgmtModePropagateConfigUpdates (0).