beautypg.com

Echelon OpenLNS User Manual

Page 107

background image

OpenLNS Programmer's Reference

70

commissioning, and lcaCommissionUpdatesCurrent (0)

after a successful commission.
This property will be set to

lcaCommissionUpdatesPending (1) if any changes have

been made to the database that affect the configuration of a

router or application device, and those changes have not yet

been propagated to the device. Changes may not yet have

been propagated to the device because the network

management mode is set to

lcaMgmtModeDeferConfigUpdates (1), or because the

transaction has not yet been committed. If these updates are

attempted but fail, this property will be set to

lcaCommissionUpdatesFailed (2).
You can force a retry of any failed updates with the

RetryUpdates method, or you can set up retry updates at an

interval of your choice by setting the UpdateInterval property

to a positive value. The CommissionStatus property will be

restored to lcaCommissionUpdatesCurrent (0) after the

updates have been successfully propagated to the physical

devices.

Availability

Local, full, and lightweight clients.

Syntax

commStatusValue = object.CommissionStatus

Element

Description

object

The device object to be acted on.

commStatusValue The commission status of this object.

The values for this element, which

are stored in the commStatusValue

constant, are as follows:

0

lcaCommissionUpdatesCurrent
No outstanding commission updates

are pending.
1

lcaCommissionUpdatesPending
Commission updates are currently

pending, or in progress. When

database changes are made that

affect a device’s configuration, this

value represents the commission

status of the device.
The commission status will be

changed to

lcaCommissionUpdatesCurrent

(0) when the changes are successfully

propogated to the device, or to

lcaCommissionUpdatesFailed (2)

if there is a failure to propogate the