beautypg.com

Echelon OpenLNS User Manual

Page 90

background image

OpenLNS Programmer's Reference

53

exist on the network, and respond to queries. If the device is

installed, it must contain the expected domain/subnet/node

address, and respond to subnet/node messages on that

address. It must also contain the expected program ID, and

the expected network management authentication setting

(enabled or disabled). If network management authentication

is enabled on the device, it must contain the correct system

authentication key. Furthermore, the test verifies that there

are no other nodes that respond with the tested nodes

subnet/node address.
The results of the test are contained in the AppDevice

object

's LastTestInfo property.

This service analyzes the result with the assumption that the

node's network image is up-to-date; therefore, ensure that

the node is up-to-date by invoking this service only while the

MgmtMode property is set to

lcaMgmtModePropagateConfigUpdates (0). This is

because discrepancies between the OpenLNS database and

the current configuration of the device on the network are

normal, and can be expected while the management mode is

lcaMgmtModeDeferConfigUpdates (1). These

discrepancies will typically be resolved automatically when

the system manage mode has been changed to

lcaMgmtModePropagateConfigUpdates (0).
For more information on the Test method, see the Testing

Devices and Detecting Device Failures section in Chapter 6 of

the OpenLNS Programmer’s Guide.

Availability

Local, full, and lightweight clients.

Syntax

testStatus = deviceToTest.Test

Element

Description

testStatus

An Integer value with the results returned

by the test.

The enumerated values for testStatus, which

are contained in the ConstTestResults

constant, are as follows:
0 lcaTestResultGood
The device passed all applicable tests.
1 lcaTestResultComm
The OpenLNS Server was unable to

communicate with the device using either

Neuron ID or its subnet/node addressing.

The Network Service Device might not be

attached to the network, the Network

Service Device might be unconfigured, the

target device might not be attached to the

network, the target device may be powered

off, or the target device may be faulty.