Owner manual

OpenLNS Programmer's Reference 727
Validate
Summary
This is a standard ActiveX control event used for visual
controls. This event is not applicable for the Object Server.
ObjectStatus
An ObjectStatus object can be accessed through the Status property or the ReportMask
property of a LonMarkObject.
If the object was accessed through the Status property, the object represents a status report.
In this case, the properties of the ObjectStatus object reflect the current status of the
LonMarkObject. Some LonMarkObjects, however, do not support all of the status attributes
contained in an ObjectStatus object; therefore, some of the information contained in this
object may not be useful.
You can use the ReportMask property to determine which status attributes are supported. If
you access an ObjectStatus object through the ReportMask property, the object represents a
report mask. In this case, the values of each property of the ObjectStatus object reflect
whether the LonMarkObject supports the related status attribute.
For example, consider the ResetComplete property of the ObjectStatus object. The
ResetComplete property contained in an ObjectStatus object accessed through the Status
property indicates whether the most recent reset of the LonMarkObject has completed. The
ResetComplete property contained in an ObjectStatus object accessed through the
ReportMark property indicates whether or not the LonMarkObject can be reset. If the
LonMarkObject cannot be reset, then the ResetComplete property in the ObjectStatus object
accessed through the Status property would not contain useful information.
Note: Some properties contain the same information, whether the LonMarkObject
represents a report mask or a status report. These properties include the ClassId, InvalidId,
InvalidRequest, ObjectId, Parent, and the Summary properties.
The device containing the LonMarkObject must be in the configured/online state
(lcaStateCnfgOnline) to successfully read the properties in this object. The
LonMarkObject’s Request property can be used to refresh or clear the information contained
in the Status and ReportMask properties. See the LonMark Application Layer
Interoperability Guidelines for more information on LonMarkObjects.
The following table summarizes the ObjectStatus object.
Description
A status report for a LonMarkObject or a report of applicable
status attributes.
Added to API
Prior to LNS Release 3.0.
Accessed Through
LonMarkObject object.
Default Property
None.
Methods
None.
Properties
• AlarmNotifyDisabled
• ClassId
• CommFailure
• Disabled
• ElectricalFault
• FailSelfTest
• FeedbackFailure