TrnBrowseOpen Fields
- Last UpdatedNov 01, 2024
- 3 minute read
The fields in the following table can be used with the TrnBrowseOpen Cicode function.
|
Field Name |
Description |
Length |
Values |
|---|---|---|---|
|
ACQERROR |
Acquisition error. |
6 |
Numeric value (integer). |
|
CLUSTER |
Cluster name. |
16 |
The name of the cluster the trend tag is associated with. |
|
COMMENT |
Comment |
254 |
A user-defined string. |
|
DEADBAND |
The deadband set for a trend tag. |
16 |
A numeric value (real) that indicates how much the value of a trend tag can fluctuate within a defined threshold without updates being sent through to the system. The threshold is represented as a percentage of the tag's engineering range. The default value is 0 (zero), which captures every value change. |
|
ENG_UNITS |
Engineering units. |
8 |
The engineering units that the value represents. The predefined values (see below) are in the Help.dbf in the bin directory, but the user may specify it as a free text: %, Amps, deg, ft, ft/min, ft/s, ft/sec, gal, gal/h, gal/min, gal/s, gal/sec, Hz, kg, kg/h, kg/min, kg/s, kg/sec, km/h, kPa, kW, litres, lt, lt/h, lt/min, lt/s, lt/sec, m/min, m/s, m/sec, metres, Rev, Rev/h, RPM, t, t/h, Tonnes, Volts, Watts. |
|
EQUIPMENT |
The name of the associated piece of equipment. |
254 |
This can be a name that represents a single piece of equipment, or a name that also reflects the location of the equipment within the equipment hierarchy (where a period (.) is used to indicate levels in the hierarchy). |
|
EXPRESSION |
Logged variable name. |
65 |
The logged variable name (<clustername>.<tagname>). If the expression contains simple Cicode containing a single tag name, such as "LT131" or "LT131<1000", the tag name is returned (in both these cases LT131). If the expression contains a function call or more than one tag name, an empty string is returned. |
|
FILENAME |
File where the trend data is to be stored. |
253 |
The complete path to the file or a path substitution. |
|
FILES |
The number of history files stored on the hard disk (for this tag). |
4 |
The maximum number of files that can specifies per trend tag is 999. |
|
FORMAT |
Trend tag format. |
11 |
The format of the variable/expression being logged. The format is used by the trend scales and trend cursor displays. |
|
HISTORIAN |
Determines if the trend tag will be included in an automated configuration process within the Historian environment. |
6 |
True or False (blank). |
|
ITEM |
Name of equipment item. |
63 |
The name configured in the trend tag's Item Name field. |
|
LSL |
Lower specification limit. |
16 |
This value is used by SPC tags as the lower limit to determine process capability. When used in conjunction with the USL, it provides a tolerance for your process. |
|
NAME |
Trend tag name. |
79 |
The name assigned to the trend data. |
|
PRIV |
Privilege. |
16 |
Numeric value (integer) that represents the level of privilege an operator requires to display trend data. |
|
SAMPLEPER |
Sample period of the trend. |
16 |
Sampling periods of greater than one second use the format hh:mm:ss. If a single digit is used without the colon (:), it will be represent seconds. Sampling periods of less than one second are entered as decimals. For example, a period of 200 milliseconds would be 0.2. |
|
SDEVIATION |
Standard deviation. |
16 |
For SPC tags, this is the calculation override for process standard deviation (s bar). |
|
SPCFLAG |
SPC flag. |
4 |
Indicates that a tag is a Statistical Process Control (SPC) tag. |
|
STORMETHOD |
Storage method for the data. |
16 |
"Scaled" or "Floating Point". |
|
SUBGRPSIZE |
The size of each SPC subgroup. |
8 |
Indicates the size of the subgroups for SPC tags. Valid values are 1 - 25 inclusive. |
|
TAGGENLINK |
Indicates if the tag was imported from an I/O device. |
32 |
Name of the I/O device from which this tag was generated. |
|
TIME |
File synchronization time. |
32 |
The time of day when the beginning of the history file is synchronized (in hh:mm:ss). The time is specified in Greenwich Mean Time, not the local time zone. |
|
TRIGGER |
The variable tag that triggers data logging. |
254 |
The configured tag name (<clustername>.<tagname>). If the trigger contains simple Cicode containing a single tag name, such as "LT131<50", the tag name is returned (in this case LT131). If the expression contains a function call or more than one tag name, an empty string is returned. |
|
TYPE |
Trend type. |
16 |
"1" - Periodic "2" - Event "3" - Periodic event. |
|
USL |
Upper specification limit. |
16 |
This value is used by SPC tags as the upper limit to determine process capability. When used in conjunction with the LSL, it provides a tolerance for your process. |
|
XDOUBLEBAR |
Process mean. |
16 |
For SPC tags, determines the calculation override for process mean (X double bar). |