Remotenetworkname – Echelon OpenLNS User Manual

Page 573

Advertising
background image

OpenLNS Programmer's Reference

536

RemoteNetworkName

Summary

Allows the name of the network as seen in the

RemoteNetworks

and

VNINetworks

to be changed.

When a Full client network is opened for the first time on a

computer, an entry is made in the RemoteNetworks and

VNINetworks collections which identifies the network as
r_<Network Name>

(i.e. if the network name is HVAC, the

name in the RemoteNetworks and VNINetworks collections

will be r_HVAC). It is possible to change this name before

opening the network for the first time(and thus creating the

RemoteNetworks and VNINetworks entries) by setting this

property immediately before the Network object's Open

method is called. The new network name will be available in

the RemoteNetworks and VNINetworks collections as soon as

the Open method is called.
If multiple Full client networks that use the same name will

be opened from a computer, this allows them to be uniquely

identified. Additionally, this allows the same network to have

multiple RemoteNetworks and VNINetworks entries, each

with a different name (and each containing its own collection

of monitor sets).

Availability

Local, full, and lightweight clients.

Syntax

networkObject.RemoteNetworkName = networkName

Element

Description

networkObject

The

Network

object to be acted on.

networkName

The new name of the network.
This can be a maximum of 85

characters long.
The network name may not include

the following characxters: forward

slash (/), back slash (\), period (.),

and colon.

Data Type

String.

Read/Write

Read/write.

Added to API

LNS Release 3.0.

Advertising