Echelon OpenLNS User Manual
Page 536
OpenLNS Programmer's Reference
499
message monitor point is opened
.
These options are read when the monitor set containing the
monitor point is opened. Changes to these options will not
take effect until the next time the monitor set is opened. Use
the CurrentOptions property to change the active monitoring
options to use for a monitor point that is currently enabled.
For message monitor points, the options contained in the
DefaultOptions property default to the options set in the
permanent monitor set’s MsgOptions property.
The default options cannot be accessed in server-independent
mode; therefore, Independent clients cannot read or write to
the DefaultOptions property.
The MsgMonitorOptions object contained within this
property is not passed by reference. If you acquire a
MsgMonitorOptions object through the DefaultOptions
property and modify it, you must then explicitly assign the
modified object back to the DefaultOptions property for the
changes to take effect. This following code sample
demonstrates this procedure:
Set defOptions = monPoint.DefaultOptions
defOptions.Authentication = True
Set monPoint.DefaultOptions = defOptions
Availability
Local, full, and lightweight clients.
Syntax
defOptions = monPoint.
Element
Description
defOptions
containing the default options for this
monitor point.
monPoint
on.
Data Type
MsgMonitorOptions
object.
Read/Write
Read/write.
Note: The DefaultOptions properties of monitor points in
MonitorSet objects created as temporary monitor sets are not
accessible. If you attempt to acquire the DefaultOptions
property through a temporary monitor point, the LCA, #161
lcaErrNotAllowedOnTemporaryObject exception is
thrown. This is because these monitor points can only be
used in a singe client session.
If you want a temporary monitor point to use options other
than the defaults for the monitor set, you can change them
with the DefaultOptions property.
Added to API
LNS Release 3.0.