beautypg.com

Getprogramid, Open – Echelon OpenLNS User Manual

Page 900

background image

OpenLNS Programmer's Reference

863

of the local client ( for example

"192.168.0.3").

Added to API

Prior to LNS Release 3.0.

GetProgramId

Summary

Returns the program ID contained within a specified external

interface (XIF) file

.

You can only use this method with a text-based XIF (.XIF

extension). You can not use it with a binary XIF (.XFB

extension).

Availability

Local, full, and lightweight clients.

Syntax

programID = systemObject.GetProgId(

XifPath

)

Element

Description

programID

A String containing the program

ID.

systemObject

The System

object to be acted on.

XifPath

A String containing the path to the

XIF file.

Added to API

Prior to LNS Release 3.0.

Open

Summary

Opens the system object for use by attaching the system's

network interface and setting up the system's OpenLNS

Server

.

This method initializes the System

object, starts up the

underlying OpenLNS Server, and attaches to the L

ON

W

ORKS

network. See the Open method of the ObjectServer for

information on how to initialize the ObjectServer.
If the application program is not a remote client, the

NetworkInterface for the

System

needs to be selected before

invoking this method (System

.NetworkServiceDevice.NetworkInterface).
When opening a system for the first time, you can set several

properties of the System

object that control the configuration

and operation of OpenLNS prior to invoking this method. If

you do not set these properties, they will be assigned the

following default values by this method:

Property

Default

DomainId

If lcaSharedMedia is specified for

the InstallOptions property

(below), then a unique 6-byte

DomainId based on the Neuron ID