Echelon OpenLNS - Manual (Page 687)

OpenLNS Programmer's Reference 650
DefaultOptions
Summary Contains the default monitoring options that are applied
each time the monitor set containing this network variable or
network variable 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 network variable monitor points, the options contained in
the DefaultOptions property default to the options set in the
permanent monitor set’s NvOptions property.
The default options cannot be accessed in server-independent
mode; therefore, Independent clients cannot read or write to
the DefaultOptions property.
The NvMonitorOptions object contained within this property
is not passed by reference. If you acquire an
NvMonitorOptions 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. DefaultOptions
Element Description
defOptions The NvMonitorOptions object
containing the default options for this
monitor point.
monPoint The NvMonitorPoint object to be acted
on.
Data Type NvMonitorOptions object.
Read/Write Read/write.
Note: The CurrentOptions properties of monitor points in
MonitorSet objects created as temporary monitor sets are not
accessible. If you attempt to acquire the CurrentOptions
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 CurrentOptions property.