beautypg.com

Committtransaction, Deconfignetwork, D committransaction m – Echelon OpenLNS User Manual

Page 888

background image

OpenLNS Programmer's Reference

851

engineered system mode).
Closing the system does not turn off monitor set monitoring

and control. Monitor set monitoring and control continues

until the Network object calls its Close method.

Availability

Local, full, and lightweight clients.

Syntax

systemObject.

Close

Element

Description

systemObject

The

System

object to be closed.

Added to API

Prior to LNS Release 3.0.

CommittTransaction

Summary

Commits the current transaction. All database updates

made since the transaction started will be marked as

complete when you call this method.
If the

MgmtMode

property is set to

lcaMgmtModePropagateConfigUpdates (0) when you

call this method, all database updates will be propogated to

the devices on the network as part of the commit process.
See the

CancelTransaction

method for information on

canceling a transaction. If there is no active transaction, an

error is returned.
The

StartTransaction

method will fail and return an

exception if any operation that modified the database failed

during the transaction. If an "update type error" occurs, then

the committed transaction has successfully modified the

database, but has been unable to update one or more

application devices. An "update type error" will cause a

Network

Service exception in the range 4030-4089 to be

thrown. For more information on Network Service

exceptions, see

Network Service Errors

in Chapter 4

.

Availability

Local, full, and lightweight clients.

Syntax

systemObject.

StartTransaction

Element

Description

systemObject

The

System

object to be acted on.

Added to API

Prior to LNS Release 3.0.

DeconfigNetwork

Summary

Deconfigures the devices and routers associated with a

system in a group of user-specified domains.

This method is only available on Local client applications. It

is typically used to reset devices in a development

environment to a common state, or to prepare devices in a

network for new installations that utilize the background