Instruction Manual

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>

<NVL>

</NVL>

<NVL>

<UCPTpointName>NVL_nvoSwitch</UCPTpointName>

</NVL>

</iLONDataServer>

</Data>

Parameter

<NVL>

<UCPTpointName>NVL_nviRequest</UCPTpointName>

<UCPTdescription>Node request message input</UCPTdescription>

<UCPTformatDescription>SNVT_obj_request</UCPTformatDescription>

<UCPTbaseType>BT_STRUCT</UCPTbaseType>

<UCPTdefOutput>0,RQ_NORMAL</UCPTdefOutput>

</NVL>

<NVL>

<UCPTpointName>NVL_nvoSwitch</UCPTpointName>

<UCPTlocation>MainBuilding\FirstFloor\Light</UCPTlocation>

<UCPTdescription>Light switch Tdescription> </UCP

<UCPTformatDescription>SNVT_switch</UCPTformatDescription>

<UCPTbaseType>BT_STRUCT</UCPTbaseType>

i.LON 100 Internet Server Program5-12 mer’s Reference