Echelon LNS - Manual (Page 206)

LNS Programmer's Guide 192
Section Description
Using Configuration Properties
In a Monitor and Control
Application
In some cases, you may want to write an
application to control the values of the
configuration properties on the devices on your
network. This section provides guidelines to follow
when doing so.
Data Formatting This section describes how your application can
format the data it obtains through monitor points
and data points.
Temporary and Permanent Monitor Sets
As of LNS Turbo Edition, there are two separate types of
MonitorSet
objects:
permanent
MonitorSet
objects, which can be used in multiple client sessions, and
temporary
MonitorSet
objects, which can only be used in a single client session. This
section describes when you should use each type.
Permanent Monitor Sets
Each
Network
object contains a
MyVNI
property, which returns an
AppDevice
object
representing your application’s Network Service Device. You can use this
AppDevice
to
access all the
MonitorSet
objects that are stored in the LNS database for your Network
Service Device (i.e. the monitor sets that have been created for applications running on
your PC). Echelon recommends that you use the
MyVNI
property to access
MonitorSet
objects when you need to create or modify the configuration of the
MonitorSet
objects.
To access MonitorSet objects for actual monitor and control operations, you should use
the
CurrentMonitorSets
property of the
Network
object.
The
CurrentMonitorSets
property returns a collection of all the
MonitorSet
objects
on the network that are currently stored in your Network Service Device. This will be
useful if you have created monitor sets while the system management mode is set to
lcaMgmtModeDeferConfigUpdates
. Although those monitor sets exist in the LNS
database (and can be accessed through the
MyVni
property), they will not be
commissioned into the Network Service Device, and cannot be enabled or used for
monitor and control operations until the system management mode is set to
lcaMgmtModePropagateConfigUpdates
. When the system management mode is set to
lcaMgmtModePropagateConfigUpdates
, the new monitor sets will be commissioned
into your Network Service Device and added to the CurrentMonitorSets collection,
and the CurrentMonitorSets collection will contain the same collection of monitor sets
as the MyVni collection.
The collection accessed through the
CurrentMonitorSets
property allows access to all
the monitor sets you can currently use on a network. The collection accessed through the
MyVni
property allows access to these monitor sets, and those not yet commissioned into
your Network Service Device. All the monitor sets obtained through the
CurrentMonitorSets property are runtime monitor sets, meaning that you can open
them and enable them for monitoring operations. However, you cannot change their
configuration when you access them through the CurrentMonitorSets collection. As
noted previously, you should use the collection obtained through the
MyVni
property
when you need to change the configuration of your client’s local
MonitorSet
objects.