Name – Echelon OpenLNS User Manual

Page 644

Advertising
background image

OpenLNS Programmer's Reference

607

support changeable types, then the value of the MaxLength

property will always match the value of the Length property.

You can determine if a network variable supports changeable

types by reading the network variable’s

ChangeableTypeSupport property.
If the device supports changeable types, and the

configuration properties are avaliable, then this property will

be set to the maximum network variable length as defined by

SCPTmaxNvLength configuration property reported by the

device for that network variable. In this case, reading this

property is the same as reading that configuration property

directly. It may result in an attempt to read the value from

the device, if the configuration property value is unknown to

OpenLNS.
You can determine if the configuration properties for a device

are available by reading the ConfigPropertiesAvailable

property of the Interface object used by the device. If the

network variable supports changeable types and the

configuration properties are not available, or the device does

not contain a SCPTmaxNvLength configuration property

for the network variable, this property will be set to –1.

Availability

Local, full, and lightweight clients.

Syntax

maximum = networkVariable.MaxLength

Element

Description

maximum

The maximum length of the network

variable, in bytes.

networkVariable

The

NetworkVariable

object to be

acted upon.

Data Type

Long.

Read/Write

Read only.

Added to API

LNS Release 3.20.

Added to API

LNS Release 3.0.

Name

Summary

Specifies the name of an object as a character string. This

property is case sensitive. Searches by name must match

case.
This property can be a maximum of 85 characters long, but it

may not contain the forward slash (/), back slash (\), period

(.), and colon (:) characters.

Availability

Local, full, lightweight, and independent clients. Note that

some objects that contain this property are not available to

Independent clients.

Syntax

stringValue = object.Name

Advertising