[Page]IgnoreValueQuality
- Last UpdatedJul 19, 2023
- 3 minute read
You can use tag elements (such as "Tag1", "Tag1.Field") and tag element items (such as "Tag1.Field.Q") in Cicode expressions. However, by default, when a tag element or an element item is not accessible, or the element quality is not "Good", graphic objects will indicate that state by displaying some alert messages or dithering.
|
|
|
UNINTENDED EQUIPMENT OPERATION If you change the value of this parameter to 1, no dithering or background color will visually identify that an element is not Good or is not accessible, even if the parameters to display such an identifier have been set elsewhere. In such a case the operator may operate the plant inappropriately by relying on incorrect data. Use the QualityIsOverride() Cicode function or similar method to identify if a tag element has been overridden. Failure to follow these instructions can result in death, serious injury, or equipment damage. |
However, you have the option to disable the default behavior and to display values even when the element quality is not "Good". This option is controlled by the IgnoreValueQuality Cicode task context attribute, which provides equivalent functionality to [Page] ComBreak, which is now obsolete .
Allowable Values:
-
0 - The Control Client supports the existing behaviour (#COM) except dithering (dots) will be not shown on text objects when an error is indicated by #<Error Message> (refer to table of error codes below).
-
1 - The quality of tag subscriptions will be completely ignored. This is equivalent to having previously used the (now obsolete) [Page] ComBreak = 0. The numeric or text objects will display a "bad" quality value and animation will continue. No dithering will be shown.
-
2 - The text or numeric objects will display "bad" quality values. The background color of the text / numeric objects will change to indicate the quality status. The background colors for QUAL_BAD and QUAL_UNCR are defined by [Page]BadTextBackgroundColor and [Page]UncertainTextBackgroundColor Citect.ini parameters.
If [Page]IgnoreValueQuality=0 the following short alert messages may be displayed on graphical pages when the Quality of a tag is 'NOT GOOD'. Refer to Cicode and General Errors for more information.
|
ERROR |
ERROR Number |
Parameter Set |
|
|---|---|---|---|
|
ShowUncertainText=0, |
>(Default) |
||
|
Genie not Associated |
323 |
#ASS |
#ASS |
|
Divide by zero |
273 |
#DIV/0 |
#DIV/0 |
|
Cicode stack overflow |
295 |
#STACK |
#STACK |
|
Out of memory |
272 |
#MEM |
#MEM |
|
Format overflow |
344 |
#OVR |
#OVR |
|
The unit the tag is on has not been connected to yet |
32 |
#WAIT |
#WAIT |
|
Waiting for initial data. Property not ready |
423 |
#PEND |
#PEND |
|
The tag is not known by the server |
53 |
#COM |
#COM |
|
No Error |
0 |
#OK |
#BAD/#UNC |
|
Value is out of range |
257 |
#RANGE |
#BAD/#UNC |
|
Tag in Last Usable Value |
525 |
#COM |
#BAD/#UNC |
|
General software error |
256 |
#COM |
#BAD/#UNC |
|
General software error |
256 |
#ERR |
#BAD/#UNC |
Default Value:
0
You can override the IgnoreValueQuality setting for a particular page by using the Ignore Quality field on the Page Properties dialog in Graphics Builder.
Note: The quality of tags referenced by items, ex. Tag1.v or Tag1.Field.t, is GOOD and its timestamps are 0 (INVALID TIMESTAMP). Therefore they give no visual indication of quality, error or change in handling state such as control inhibit or override mode regardless of the setting used for the [Page]IgnoreValueQuality parameter.