Echelon i.LON 100 e2 Internet Server - Manual (Page 56)

5.2.1.2 DataServerGet
You can use the DataServerGet function to retrieve the configuration of any data point that
you have added to the
i. LON 100 Data Server. Each NVL data point to be returned must be
identified by an <NVL> element within the <Data> parameter, and each NVC data point
must be identified by an <NVC> element. You must reference the specific data point to be
returned by its index number (UCPTindex) or its name (UCPTpointName) within each of
these elements, as shown below.
You can request the configurations of any mixture of NVL or NVC data points in a single call
to DataServerGet. The following example requests that the configuration of two data points
be returned. One is referenced by its index number, and the other is referenced by its name.
Note that the child element for each data point is called <NVL>: this would be <NVC> for an
NVC data point.
NOTE: You should not attempt to retrieve the configuration of more than 100 data points
with a single call to this function.
<Data>
Parameter <Data>
<iLONDataServer>
<NVL>
<UCPTindex>0</UCPTindex>
</NVL>
<NVL>
<UCPTpointName>NVL_nvoSwitch</UCPTpointName>
</NVL>
</iLONDataServer>
</Data>
<Result>
Parameter <iLONDataServer>
<NVL>
<UCPTindex>0</UCPTindex>
<UCPTpointName>NVL_nviRequest</UCPTpointName>
<UCPTlocation>iLON100</UCPTlocation>
<UCPTdescription>Node request message input</UCPTdescription>
<UCPTformatDescription>SNVT_obj_request</UCPTformatDescription>
<UCPTdpSize>3</UCPTdpSize>
<UCPTbaseType>BT_STRUCT</UCPTbaseType>
<UCPTunit></UCPTunit>
<SCPTmaxSendTime>0.0</SCPTmaxSendTime>
<SCPTminSendTime>0.0</SCPTminSendTime>
<SCPTmaxRcvTime>0.0</SCPTmaxRcvTime>
<UCPTdefOutput>0,RQ_NORMAL</UCPTdefOutput>
<UCPTsettings>0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0</UCPTsettings>
<UCPTdirection>DIR_IN</UCPTdirection>
</NVL>
<NVL>
<UCPTindex>1</UCPTindex>
<UCPTpointName>NVL_nvoSwitch</UCPTpointName>
<UCPTlocation>MainBuilding\FirstFloor\Light</UCPTlocation>
<UCPTdescription>Light switch
Tdescription> </UCP
<UCPTformatDescription>SNVT_switch</UCPTformatDescription>
<UCPTdpSize>6</UCPTdpSize>
<UCPTbaseType>BT_STRUCT</UCPTbaseType>
<UCPTunit></UCPTunit>
<SCPTmaxSendTime>0.0</SCPTmaxSendTime>
<SCPTminSendTime>0.0</SCPTminSendTime>
<SCPTmaxRcvTime>0.0</SCPTmaxRcvTime>
<UCPTdefOutput>100.0 1</UCPTdefOutput>
<UCPTsettings>0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0</UCPTsettings>
i. LON 100 Internet Server Program 5-12 mer’s Reference