Echelon LNS - Manual (Page 223)

LNS Programmer's Guide 209
monitor point’s
FilterCode
property.
Set MsgMonitorPointOptions =_
MyMsgMonitorPoint.DefaultOptions
MsgMonitorPointOptions.FilterCode = 62
Set MyMsgMonitorPoint.DefaultOptions =_
MsgMonitorPointOptions
NOTE: Because temporary monitor points are only used in a single client
session, their
DefaultOptions
are not accessible. If you attempt to
acquire the DefaultOptions property through a temporary monitor
point, the LCA:#161 lcaErrNotAllowedOnTemporaryObject
exception will be thrown. All temporary monitor points are instantiated
with the default options selected in step 1.
3. When a monitor set is opened, each message monitor point will use the
default options established in either step 1 or 2. If you want to use
different options for a monitor point during a given monitoring session,
you can do so by writing to the
MsgMonitorPoint
object’s
CurrentOptions
property. Remember that these changes will take
effect for the current session only.
You can change these defaults by writing to the
CurrentOptions
property. The following code sample sets the current values for a message
monitor point’s
Priority
property.
Set MsgMonitorPointOptions = MsgMonPoint.CurrentOptions
MsgMonitorPointOptions.Priority = True
Set MsgMonPoint.CurrentOptions = MsgMonitorPointOptions
NOTE: The MsgOptions, DefaultOptions and CurrentOptions
properties are not passed by reference. When you modify a
MsgMonitorOptions object returned by any of these properties, the changes
will not take effect until the modified object is passed back to the
MsgOptions, DefaultOptions or CurrentOptions property of the
applicable monitor set or monitor point.
MsgMonitorOptions Object
The three properties mentioned in this section (
MsgOptions
,
DefaultOptions
,
CurrentOptions
) all provide access to a
MsgMonitorOptions
object. The
MsgMonitorOptions
object contains a set of properties that define the behavior of
message monitor points when they are enabled. Table 9.3 lists and describes these
properties. The default values listed in Table 9.3 are the defaults that are initially
applied to the MsgMonitorOptions object accessed through a monitor set’s MsgOptions
property.