
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.
Kommentare zu diesen Handbüchern