Beginsystemmgmtmodechangeevent – Echelon OpenLNS User Manual

Page 886

Advertising
background image

OpenLNS Programmer's Reference

849

validated until the session is ended.
The only network operations you can perform within sessions

are those related to changes in the physical topology of your

network. These operations include moving devices and

routers, adding and removing routers, and setting the class of

routers.
As a result, the methods you can use within a session include

the following: PreMove, MoveEx, PostMove, Add, and Remove.

You can also write to the Class property of a router.
If you attempt to access any other properties, or invoke any

other methods, within a session, then the NS, #294

lcaErrNsNotAllowedInASession exception will be thrown.
A given client can have at most one session in progress at a

time. A session must be part of an explicit transaction. A

transaction may contain more than one session. Changes

made in a session will not be committed until the transaction

that contains that session is committed.

Availability

Local, full, and lightweight clients.

Syntax

systemObject.

BeginSession

sessionClass

Element

Description

systemObject

The System

object to be acted on.

sessionClass

The session class.
Currently, the only valid value is

lcaSessionMove, which is

contained in the

ConstSessionClass

constant.

Added to API

Prior to LNS Release 3.0.

BeginSystemMgmtModeChangeEvent

Summary

Registers your application for the

OnSystemMgmtModeChangeEvent

. The

OnSystemMgmtModeChangeEvent

will then be fired each

time the system’s management mode changes.
You can disable the

OnSystemMgmtModeChangeEvent

by

invoking the

EndSystemMgmtModeChangeEvent

method. You can use the MgmtMode property to read or

write to the system management mode.

Availability

Local, full, and lightweight clients.

Syntax

system.BeginSystemMgmtModeChangeEvent

Element

Description

systemObject

The System

object to be acted on.

Added to API

Prior to LNS Release 3.0.

Advertising