LogDataChangeEvent()

Logs an application change event to the application Historian.

Note: The LogDataChangeEvent() function works only in object scripts, not in symbol scripts.

Category

Miscellaneous

Syntax

LogDataChangeEvent(EquipmentitemName, Description, OldValue, NewValue, TimeStamp);

Parameters

EquipmentitemName

Equipment.item name as a tag name.

Description

Description of the object.

OldValue

Old value of the equipment.item.

NewValue

New value of the equipment.item.

TimeStamp

The time stamp associated with the logged event. The timestamp can be UTC or local time. The TimeStamp parameter is optional. The timestamp of the logged event defaults to Now() if a TimeStamp parameter is not included.

Remarks

A symbol script still compiles if the LogDataChangeEvent() function is included. However, a warning message is written to the log at run time that the function is inoperable.

Example

This example logs an event when a pump starts or stops with a timestamp of the current time when the event occurred.

LogDataChangeEvent(TC104.pumpstate, "Pump04", OldState, NewState);

Related Topics

Miscellaneous Functions