Validate, Objectstatus, N objectstatus – Echelon OpenLNS User Manual

Page 764: E objectstatus

Advertising
background image

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

Advertising