Rockwell Automation FactoryTalk Historian SE DataLink 4.2 User Guide - Manual (Page 154)

●
●
●
●
●
FactoryTalk Historian DataLink User Guide
146
Input Functions
PIPutVal()
PIPutVal(tagname, value, time stamp, PIServer, outcell)
PIPutVal supports all FactoryTalk Historian 3 data types (including
string input to string tags), as well as sub-second data. Time stamps are
interpreted using client machine time zone information for FactoryTalk
Historian 3 unless the Use PI Server Time Zone is enabled.
Arguments
Argument Explanation
tagname (string) The tag for which you to write the value to FactoryTalk Historian.
value (reference) The reference to a value to be written, either a string (for digital
states) or a number.
time stamp (string) A time stamp in FactoryTalk Historian time format.
PIServer (string) The target FactoryTalk Historian server.
outcell (reference) A reference to a cell in which the return value of this macro function
is displayed.
Returns
Returns the string value False if the macro function fails and writes an
error message to the outcell. If the write to the FactoryTalk Historian
server succeeds, the string True is returned and the status is written to the
outcell.
PIPutVal() does not verify the user-specified range for a tag before writing.
The range is defined from zero to zero + span, where zero and span are tag
attributes specified during point (tag) creation. FactoryTalk Historian DataLink
returns a value even though Over Range or Under Range may be entered in
FactoryTalk Historian.
Example: