Appendix A
HMI Function Reference
A-68
©
National Instruments Corporation
Write Tag on Change (bit array)
Use the Write Tag on Change (bit array) VI to update the Real-Time Database with a new
value for memory, output, and Input/Output tags. The value also is sent to the server if it is
an output or Input/Output tag. The value is updated and sent to the server only if the tag value
is different from the previous time the VI was executed. Use this VI if you do not need to
pass output values to the RTDB and server unless there really is a value change. This saves
you from adding code to your diagram to check value changes.
If the tag is an input only tag, Write Tag on Change (bit array)VI causes a system error
because input tags only can be updated by servers. If the tag is configured as an Input/Output
tag, the tag value is passed to the server when Write Tag on Change (bit array)VI is called but
not written to the RTDB. The RTDB is updated with the new value when the server polls it
and passes it back to the BridgeVIEW Engine. This maintains correct time synchronization
in the RTDB.
tag name is the name of the output tag.
value is the value to be written to the output tag.
generate event (F) determines whether a user change event is generated
for the write operation on the tag. If the tag is configured with event logging
on, this tag event can be displayed in the Event History Display in your
HMI and logged to a .
evt
file. By default, generate event is FALSE.
status returns the current status of the value written in the Real-Time
Database. If status is greater than or equal to 0, the Write Tag on Change
(bit array) operation was successful. If status is less than 0, either the
device server has reported an error indicating there is a problem with the
tag, or BridgeVIEW has reported an error indicating there is a problem
using the tag.
error indicates that an error occurred when executing Write Tag on
Change (bit array) or that the status of the tag is bad. See the status output
for the specific error condition.
shutdown indicates that the BridgeVIEW Engine is shutting down. You
can use shutdown to exit any loop that uses the Write Tag on Change
(bit array).
