TagVal (Tag-based PE function)

Find a point's Archive value at a given time.

Syntax

TagVal(tagname [, time])

Arguments

tagname

A tagname.

time

Optional. A time expression. If you omit this argument, '*' is used.

Returns

The archived value of tagname at time. This value is interpolated unless the point has the Step attribute of 1 (or Resolution Code of 4 for PI2).

Exceptions

If point does not exist, or has no archived value at time, returns an error value.

Example

TagVal('tag1')

• Return of the value of 'tag1' at current time

  TagVal('digitaltag', 't+11h')

• Return of the value of 'digitaltag' at 11am today

  TagVal('enum_att1')

• Return value of enum_att1, an attribute from an enumeration set at current time

  TagVal('tag1','23-aug-2012 15:00:00'). - Return of the value of 'tag1' at 3pm on August 23, 2012

• Return of the value of 'tag1' at 3pm on August 23rd, 2012

  Note: To check the syntax of the performance equation, use the Pipetest Utility.

NextEvent (page ), NextVal (page ), PrevEvent (page ), PrevVal (page )