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

Advertising

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

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 <Item> elements. Each
<Item> element includes a <UCPTname> property (case-insensitive) that specifies a unique network to
be created or modified.

Each <Item> 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

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)

<UCPTname>MyNewNetwork_1</UCPTname>

<UCPThandle

xsi:type="number">873906929</UCPThandle>

<UCPTname>MyNewNetwork</UCPTname>

<UCPTservicePath

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

</LnsDatabase>

<UCPTlnsSync xsi:type="string" LonFormat="UCPTlnsSync">SYNC_STANDALONE</UCPTlnsSync>

<UCPTmgmtMode xsi:type="string" LonFormat="UCPTmgmtMode">LCA_ONNET</UCPTmgmtMode>

<UCPTlnsNetworkInterface>X.Default.SmartServer_RNI</UCPTlnsNetworkInterface>

</Item>

</iLonItem>
</Set>

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

Advertising