Instruction Manual

i.LON 100 Internet Server Programmer’s Reference 3-3
3.3 DataPointWrite
You can use the DataPointWrite function to write to the value of any data point in your
network. You must reference the data point to be modified by the name (UCPTpointName)
assigned to it in i.LON 100 Data Server in the input you supply to the function, as in the
example below. The <UCPTpointName> of a data point is defined when it is created and
added to the i.LON 100 Data Server. You can create data points with the i.LON 100
Configuration Software or with the DataServerSet function.
Chapter 5, Data Server, describes the DataServerSet function. However, you should review
Chapter 4, i.LON 100 Applications and the SOAP/XML Interface, before attempting to use
the function. For instructions on creating data points with the i.LON 100 Configuration
Software, see the i.LON 100 Internet Server User‘s Guide.
If the specified data point is a structure, you can specify the field (UCPTfieldName) whose
value should be written to by the function. Table 3 describes the rest of the parameters you
will need to supply as input to this function.
You can only write to the value of one data point at a time with this function. However, you
can use the DataServerWrite function to write to the values of multiple data points at once.
Chapter 5, Data Server, describes the DataServerWrite 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 DataPointWrite. For programming samples writen in Microsoft
Visual Basic .NET that call this function (and will fill in the SOAP message with the input
data shown below), see Using the DataPoint Functions With Visual Basic .NET on page 3-11.
Input Parameters
<UCPTpointName>NVL_nvo01Switch</UCPTpointName>
<UCPTfieldName>
<UCPTvalueDef>100.0</UCPTvalueDef>
value</UCPTfieldName>
<UCPTpriority>25</UCPTpriority>
<UCPTpropagate>1</UCPTpropagate>
Return Parameter
<Result>
<UCPTpointName>NVL_nvo01Switch</UCPTpointName>
<UCPTfieldName>value</UCPTfieldName>
</Result>
Table 3 describes the properties that you will need to supply as input when you call the
DataPointWrite function. The function returns the name of the data point written to.
Table 3 DataPointWrite Input Properties
Property Description