beautypg.com

Open, Open an – Echelon OpenLNS User Manual

Page 505

background image

OpenLNS Programmer's Reference

468

are not available on Independent clients.

Syntax

object.Enable doPoll

Element

Description

object

The

MonitorSet

object to be enabled.

doPoll

A Boolean value.

TRUE. Turn on polled monitoring for

the network variable monitor

points in the monitor set.

FALSE. Leave polled monitoring of

this monitor set turned off.

Added to API

LNS Release 3. 0.

Open

Summary

Opens a

MonitorSet

object, which causes all the monitor

points in the monitor set to be instantiated

.

You should not open a monitor set in the same explicit

transaction in which it was created, or in which monitor

points were added to it. For more information on using

transactions with LNS, see Programming an OpenLNS

Application in the OpenLNS Programmer’s Guide.
You can enable monitoring with the Enable method after

opening a monitor set, if the doEnable element was set to

False. You can disable monitoring using the Disable method.
If you set the doEnable element to True when you invoke this

method, the client application will be notified of the enabling

of each monitor point in the set via the Object Server's

OnNvMonitorPointEvent and OnMsgMonitorPointEvent

events. This applies to both temporary and permanent

monitor sets.
If you create a permanent monitor set while the network

management mode is set to

lcaMgmtModeDeferConfigUpdates (1), you must change

the management mode to

lcaMgmtModePropagateConfigUpdates (0) before

opening the monitor set. You can change the network

management mode by writing to the value of the MgmtMode

property of the System

object.

Note: You cannot open a monitor set while in engineered

mode. In addition, this method does not apply to MonitorSet

objects that were created as temporary monitor sets. All

temporary MonitorSet objects are opened automatically as

soon they are created. You can create temporary MonitorSet

objects with the CreateTemporaryMonitorSet method.

Availability

Local, full, lightweight, and independent clients. Note that

temporary monitor sets are not available on Independent