beautypg.com

Dataserverset, Dataserverset -17, 3 dataserverset – Echelon i.LON 100 e2 Internet Server User Manual

Page 61

background image

i.

LON 100 Internet Server Programmer’s Reference

5-17

5.2.1.3 DataServerSet

Use the DataServerSet function to overwrite the configuration of an NVL or NVC data point,
or to create an NVC data point and add it to the Data Server. Each NVL data point to be

written to must be identified by an element within the parameter, and each

NVC data point must be identified by an element. You must reference the specific
data point to be written by its index number (UCPTindex) or its name (UCPTpointName)

within each of these elements, as shown below.
The rest of properties that you must fill in within each data point element define the
configuration of the data point within the Data Server. This set of properties is the same,

whether you are creating a new data point or modifying an existing data point. The previous
section, DataServerGet, describes each of these properties in detail.
It is important to realize that when you modify an existing data point with the

DataServerSet function, any optional properties such as ,
, and left out of the

parameter will be erased. Old values will not be carried over, so you must fill in every

property, or make sure that the data point is linked to a template defining the values any of
these properties, when writing to an existing data point. Otherwise, these properties will be

set to a null value.
The following example re-writes the configuration of a data point called NVL_nvo01Switch.
Because this is an NVL data point, its new configuration is contained within an

element.

NOTE: You can create or write to multiple data points with a single call to DataServerSet.

However, you should not attempt to create or write to more than 100 data points with a

single call to this function. Additionally, to optimize the memory available to the

i.

LON 100,

you should not have more than 800 data points in your network at any time.