beautypg.com

Serveridentifier – Echelon OpenLNS User Manual

Page 574

background image

OpenLNS Programmer's Reference

537

ServerIdentifier

Summary

Provides an identification string for the OpenLNS Server

that has opened this network, which enables networks with

the same name on different servers to be differentiated

.

When the ObjectServer object's RemoteFlag property is set to

True before the ObjectServer is opened, the Networks

collection will contain all of the remote full or lightweight

client networks (see the Flags property) which have been

opened by an OpenLNS Server application. It is possible that

two or more of these networks opened with different

OpenLNS Server applications will have the same name

(multiple networks opened on a single OpenLNS Server must

have unique names). This property allows these networks to

be differentiated by provided a string representing a 4-byte

hexadecimal value that uniquely identifies the LNS Sever.

Availability

Local, full, and lightweight clients.

Syntax

serverId = networkObject.ServerIdentifier

Element

Description

serverId

The unique 4-byte identifyer of the

OpenLNS Server application which

has opened this network.

If this Network object is

accessed from the

RemoteNetworks or

VNINetworks collections, this

property will contain "0000".

If this Network object is

accessed from the Networks

collection with the RemoteFlag

property having been set to

False, this property will contain

"000".

Once this value has been set, it is

persistent through the OpenLNS

Server and/or the application

exiting and restarting.

networkObject

The

Network

object to be acted on.

Data Type

String.

Read/Write

Read only.

Added to API

LNS Release 3.0.