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

i. LON 100 Internet Server Programmer’s Reference 3-7
3.4 DataPointRead
You can use the DataPointRead function to retrieve the current value assigned to a data
point, as well as the values of several properties associated with the data point. You can use
this function with any data point in your network.
You must reference the data point whose you value you want to read by its name
(UCPTpointName) in the input you supply to the function, as in the example below. If the
data point is a structure, you can specify the field whose value is to be retrieved by filling in
the optional property.
You can only read the value of one data point at a time with this function. However, you can
use the DataServerRead function to read the values of multiple data points at once. Chapter
5, Data Server, describes the DataServerRead function. However, you should review Chapter
4, i.LON 100 Applications and the SOAP/XML Interface, before attempting to use the
function.
The sample below shows how the input parameters are filled into the SOAP message sent to
the i. LON 100 when you call DataPointRead. For programming samples writen in Microsoft
Visual Basic .NET that call this function (and will fill in the SOAP message with the input
parameters shown below), see Using the DataPoint Functions With Visual Basic .NET on
page 3-11.
Input Parameters NVL_nvo03Switch
state
Return Parameters
NVL_nvo03Switch
state
MainBuilding\First Floor\Meetingroom\Light
<
pd
<UCPTvalue>1</UCPTvalue>
UCPTpointU ateTime>2001-07-24T01:47:22.000+03:00</UCPTpointUpdateTime>
<UCPTvalueDef></UCPTvalueDef>
</UCPTunit>
AL_NO_CONDITION</UCPTpointStatus> us>
250</UCPTpriority>
SNVT_switch
BT_STRUCT
Table 5 describes the properties that the DataPointRead function returns in the
parameter. Note that the and properties are also
supplied as input in the parameter.
Table 5 DataPointRead Output Properties
Property Description