beautypg.com

3 using the set function on a lonworks network, Using the set function on a l, Orks – Echelon i.LON SmartServer 2.0 User Manual

Page 205: Network -5, Network

background image

i.LON SmartServer 2.0 Programmer’s Reference

14-5

Property Description

Specifies when network configuration changes are propagated
over the network to devices. This property can be one of the
following values:

LCA_ONNET. Changes are sent immediately to the

devices on the network. Use LCA_ONNET if you are
installing an engineered network, or if you are designing
and installing an ad-hoc network at the same time.

LCA_OFFNET. Changes are stored in the network

database and then sent to the devices on the network when
you place the SmartServer OnNet. Use LCA_OFFNET if
you are designing an engineered network.

Specifies the network interface to be used for communication
between the LNS Server and the network. To specify that the
SmartServer is not attached to a network, you can omit this
property in a Set function. This may be desired if you are
performing network design tasks.

The domain length, index and key. If both the length and key
are provided in a Set function, but they don’t match, an error is
thrown.

14.1.3

Using the Set Function on a L

ON

W

ORKS

Network

You can use the Set function to overwrite the configuration of a network, or to create a new network.
The input parameters you supply to the function will include one or more elements. Each
element includes a property (case-insensitive) that specifies a unique network to
be created or modified.

Each element may also include a series of properties that define the configuration of the new
(or modified) network. This set of properties is the same, whether you are creating a new network or
modifying an existing network. The previous section, Using the Get Function on a L

ON

W

ORKS

Network, details the properties you can include in the Set function.

You can set multiple networks with a single Set message. However, you should not attempt to create
or write to more than 100 networks with a single call to the Set function.

Request (using the SmartServer Web service, create a new network and set it to Standalone
mode)



MyNewNetwork_1

xsi:type="number">873906929

MyNewNetwork

xsi:type="string">//WebService[UCPTindex=4]

SYNC_STANDALONE

LCA_ONNET

X.Default.SmartServer_RNI


Note: In the Set function, you need to specify the property of the current network on
the SmartServer. You can use the List and Get functions to get the network currently on the