3 using the set function on a network variable, 4 using the delete function on a network variable, Using the set function on a network variable -45 – Echelon i.LON SmartServer 2.0 User Manual

Page 245

Advertising

i.LON SmartServer 2.0 Programmer’s Reference

14-45

Property Description

The frequency in which the SmartServer’s internal data server
polls the network variable. The recommended minimum poll
rate is 30 seconds; the maximum poll rate is 1 second.

The default poll rate for network variables is 600 seconds. You
should set poll rates for the data points of the external devices
that are connected to the SmartServer.

Note: The actual poll rate is determined by calculating the least
common denominator of all the poll rates set for the data point
from the applications to which it has been added.

14.7.3

Using the Set Function on a Network Variable

You can use the Set function to overwrite the configuration of a network variable, or to create a new
network variable. The input parameters you supply to the function will include one or more <Item>
elements. Each <Item> element includes a <UCPTname> property that specifies a unique network
variable 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 variable. This set of properties is the same whether you are creating a new
network variable or modifying an existing network variable.

• If you are creating a new network variable, you need to specify the <UCPTnvIndex> and

<UCPTformatDescription> properties; all other properties are optional.

• If you are modifying an existing network variable, you must specify the <UCPTnvIndex>

property. In addition, all other properties should be filled; otherwise the values stored in them are
erased. The previous section, Using the Get Function on Network Variables, details the properties
you can include in the Set function.

You can set multiple network variables with a single Set message. However, you should not attempt to
create or write to more than 100 network variables with a single call to the Set function. The following
example demonstrates how to create a new network variable.

Request (add a data point to a functional block)

<UCPTname>Building 2/Channel 1/DIO-5/Digital Output[0]/DO_Digital_1</UCPTname>

<UCPTnvIndex>1</UCPTfbIndex>
<UCPTformatDescription>#0000000000000000[0].SNVT_switch</UCPTformatDescription>
</Item>
</iLonItem>
</Set>

Response

<Item>

<UCPTname>Building 2/Channel 1/DIO-5/Digital Output[0]/DO_Digital_1</UCPTname>

</Item>

</iLonItem>
</SetResponse>

14.7.4

Using the Delete Function on a Network Variable

You can use the Delete function to delete a network variable on the SmartServer, or in an LNS
network database via the LNS Proxy Web service. The Delete function takes an <Item> element with

Advertising