Echelon OpenLNS - Manual (Page 893)

OpenLNS Programmer's Reference 856
registration is used, an error will cause all device
registrations to fail. If registration is done in the
background, the background registration tasks are performed
outside of the scope of the explicit transaction, so a
registration failure will only impact the effected device. The
other registration tasks will continue to completion (provided
no additional errors occur).
If the specified domainId string is an empty string, the
OpenLNS Server will perform the discovery on the
zero-length domain. When discovery is performed on a
domain other than the application domain, it may not be
possible to discover all devices on the network. For example,
in a multiple channel system, devices which reside on the far
side of a configured router will not be detected because the
router will only forward messages addressed on the
application domain. In addition, any device using the same
addressing information (domain, subnet and Node ID) as the
NetworkServiceDevice for the System will not be discovered.
By necessity, discovery messages are addressed on the
domain whose devices are to be discovered.
Availability Local, full, and lightweight clients.
Syntax numDevDiscovered =
systemObject.DiscoverDevices(backgroundReg, domainId)
Element Description
numDevDiscovered An Integer value set to the number
of devices discovered.
systemObject The System object to be acted on.
backgroundReg A Boolean type specifying whether
discovered devices are registered in
the background.
TRUE. Devices are registered in
the background as part of
the discovery transaction .
FALSE. Devices are registered in
the foreground as part of
the discovery transaction.
domainId A String specifying the domain on
which to discover devices.
If the specified domainId string is
an empty string, the OpenLNS
Server will perform the discovery
on the zero-length domain.
Added to API Prior to LNS Release 3.0.
DoEventSync
Summary Sustains network synchronization.