Echelon OpenLNS - Manual (Page 762)

OpenLNS Programmer's Reference 725
applied to both the OpenLNS database
and the physical devices.
1 lcaMgmtModeDeferConfigUpdates
Network configuration changes are applied
only to the OpenLNS network database.
Added to API LNS Release 3.20.
OnSystemNssIdle
Summary Indicates that an OpenLNS Server idle message was raised .
When you call the BeginNssIdleEvent method to enable this
event, you will specify an interval. This event will then be
fired at that interval while your application is waiting for
lengthy network operations to complete. Instances of this
event will be returned synchronously, and if your application
does not handle the event in a timely manner, then your
application may hang.
This event allows your application to execute code while
OpenLNS is busy with an operation. This may be the case
when you change the value of the MgmtMode property from
lcaMgmtModeDeferConfigUpdates (1) to
lcaMgmtModePropagateConfigUpdates (0), or if you are
commissioning a device. The main thread of your application
will need to wait for these operations to complete, so you
could use this event to refresh the display of your client
application, so that the user knows it is not stuck.
You can only make the following OpenLNS calls from within
the this event’s handler:
•
You can access the ServiceStatus property to determine
the status of the service OpenLNS is trying to perform.
• If an operation is taking too long for OpenLNS to execute,
you can cancel it with the CancelTransaction method
from the event handler.
• If you are performing a network recovery, you can access
the RecoveryStatus property from the event handler, and
then determine the status of the network recovery.
You can disable this event with the EndNssIdleEvent
method.