beautypg.com

Echelon OpenLNS User Manual

Page 185

background image

OpenLNS Programmer's Reference

148

retrieved.
If you specify an invalid index, an LCA,

#90 lcaValueOutOfRange exception is

thrown.

count

Specify the number of elements to be

retrieved.
If this number exceeds the value of the

ConfigProperty

object’s

Dimension

property,

an LCA, #90 lcaValueOutOfRange

exception is thrown.

options

Use this element to determine whether

OpenLNS will read the raw values of the

ConfigProperty

array elements from the

OpenLNS database or the physical

application device.
The possible values for this element, which

are stored in the

ConstDataSourceOptions

constant, are as follows:
0 lcaDataSourceOptionsNormal
The raw value array will be read directly

from the device if the

ConfigProperty

is

device-specific.

If the ConfigProperty is not device-specific,

the raw value array will be read from the

database, as long as it is stored there.
If the value of the ConfigProperty does not

exist in the database, then the raw value

value array will read directly from the

device, as long as the network management

mode (MgmtMode property) is set to

lcaMgmtModePropagateConfigUpdate

s (0).
If the ConfigProperty is not device-specific,

its value is not in the database, and the

network management mode is set to

lcaMgmtModeDeferConfigUpdates (1),

then an exception will be thrown when you

invoke the GetRawValuesEx method.

1 lcaDataSourceOptionsFromDevice
The raw value array is read directly from

the device.
2

lcaDataSourceOptionsDatabaseOnly
The raw value array is read from the

OpenLNS database.