Double Word Data Point Tag

Help Contents

Introduction

The Double Word Data Point Tag Double word tag icon represents a 32-bit unsigned integer data tag with a range of 0 to 4294967295.

Configuration Properties

The Double Word Data Point Tag supports the configuration properties of the Data Point Tag plus these properties:

Property Type Version Description
NormalColor STRING 3.1 The value of the Color property when the tag is normal quality.
HistoricEnable BOOL 2.5 Whether the value of the tag is stored in the historian.
HistoricSignificantChange UDINT 2.5 The amount the tag value must change before a new value is stored in the historian.
HistoricSampleInterval TIME 2.5 The maximum time interval between consecutive values recorded in the historian. The historian will add a new record to the history if:
  • This time interval has elapsed, and
  • There has been no significant change in the tag value during that time.
HistoricSampleCount UDINT 2.5 The number of sample values to retain in the historian.
HistoricListRecordLimit UDINT 3.30 The number of records to show, when selecting Show Historic Data on the Standard Tag Menu. This value provides the row-count parameter to the FETCH FIRST clause for the SQL statement behind the list. If HistoricListRecordLimit is set to less than 1, the driver rounds the value up to 1. Using very large values may cause the Show Historic Data command to take a long time to complete.
TemporaryTrendInterval TIME 3.30 The default time interval of the X Axis in a Temporary Trend of this tag. Values less than 5 minutes are automatically rounded up to 5 minutes by the driver.

Dynamic Properties

The Double Word Data Point Tag supports the dynamic properties of the Data Point Tag plus these properties:

Property Type Description
Value UDINT The current value of the tag
Color DWORD Indicates the state of the tag using color
IsForced BOOL Indicates whether the tag has been forced (true), or not forced (false)
UnforcedValue UDINT The current value of the tag when this tag has been forced to a fixed value
UnforcedQuality INT The quality of the current value when this tag has been forced to a fixed value
UnforcedTimestamp DATE_AND_TIME The timestamp of the last update when this tag has been forced to a fixed value
UnforcedColor DWORD The color of the tag when this tag has been forced to a fixed value

Color Property

The Color property provides an indication of the state of the tag using color:

Tag StateConditionColor Value
The tag is forced IsForced = True The ForcedColor defined in the Database Root Tag
The quality is bad Quality < 192 The BadQualityColor defined in the Database Root Tag
Otherwise The NormalColor defined above.

TagErrorCode Property

When the Quality of the tag data is 'Bad', the TagErrorCode property indicates the reason for the error:

ErrorCodeDescription
0No error.
1The tag is not associated with a valid data source.
2The data source reference is valid, but the data source has a configuration error.
3The offset of the tag is outside the boundary of the data source.
4The data type is String, but the source value is not a valid double word.
5There was an error converting the data.

Tag Commands

A tag command is an action you can trigger on a tag. The Double Word Data Point Tag supports these tag commands:

Tag Command Version Description
ForceValue 1.3 Overrides the tag to show a fixed constant value. If the tag value is from a data source, updates from the data source are placed in a set-aside area. Note: The override is applied to the tag in the Fernhill SCADA database, and not to the data source.
RemoveForce 1.3 Removes any override currently active on the tag. The actual value from the data source is restored from the set-aside area. If there is no override currently active, RemoveForce has no effect.

Relationships to Other Tag Types

The Double Word Data Point Tag builds on the features of these tag types:

The Double Word Data Point Tag is used as a building block for these tag types:

Further Information

Core Tag

To learn about properties common to all tags.

Data Point Tag

To learn about other types of data tag.

Glossary

For the meaning of terms used in Fernhill SCADA.