Owner manual

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.