Agent Contexts

 Top  Previous  Next

This section describes Agent-specific variables, functions and events that are available in context provided by Agent.

Public Variables (Properties)

DATE

 

Variable Name:

date

Records:

1

Availability:

Root context

Record Format:

Field Name

Field Description

Field Type

Notes

date

Value of the real-time clock onboard the programmable controller or PC running Agent.

Date

MODTIME

This variable contains timestamps for the latest modification time of every "device setting" variable in Agent's device contexts. These modification times are usually stored in EEPROM to assure correct synchronization after restarts.

After each synchronization of device settings between AggreGate Server and Agent, the server updates variable modification times stored in the Agent by setting this variable. When a device setting is modified internally (e.g. using the device's keypad and LCD screen), Agent must properly update its modification time to keep the new values from being overwritten by the old ones, stored in the server cache, during the next synchronization.

In some cases, Agent may not support modification times for some or all device setting variables. The modtime variable should not contain records for such variables. Even if it does, their modification timestamps must be set to NULL.

 

Variable Name:

date

Records:

0...unlimited

Availability:

Device contexts

Record Format:

Field Name

Field Description

Field Type

Notes

variable

Name of device setting variable.

String

modtime

Date/time of the last modification of this variable's value.

Date

Nullable

Public Functions [?]

SYNCHRONIZED

Instructs Agent that synchronization with AggreGate Server is finished and it may start sending events.

 

Function Name:

synchronized

Input Records:

0

Input Format:

None

Output Records:

0

Output Format:

none