Micromod Micro-PWC: 53PW6000 MicroPWC Configuration Guide - Manual (Page 335)

Micro-PWC CONFIGURATION GUIDE
@aGlance/IT Server Interface 315
11.3.3.1 Server Specific Parameters for History Related Methods
The @aGlance/IT methods used to access the historical, historical block, archival and archival block data-
base include AAG_GetHistory, AAG_GetHistEvent, AAG_GetHistStat and AAG_PutHistory. Each of these
methods passes parameters to the @aGlance/IT server for the Micro-PWC. Some of the parameters
passed must be in a format specific to the server.
11.3.3.1.1 Server Specific AAG_GetHistory Method Parameters
The AAG_GetHistory method returns the historical values for a specified list of tag and attribute names.
The time range is defined by a start time, an interval time, and a number of intervals. For each time inter-
val, a value is returned for each of the tag/attribute pairs.
When this method is used by an @aGlance/IT client during a session with an @aGlance/IT server for the
Micro-PWC, the start, interval and time_list parameters of this method require that a server specific format
be used for time specification.
The start parameter is a pointer to a character string which contains the start time. The start time must be
in the format:
HH:MM:SS DD-MMM-YY.
The interval is a pointer to a character string containing the time interval. The following format is used to
specify the interval by defining the number of days, hours, minutes and seconds in the interval using the
following format:
DD:HH:MM:SS
The time_list parameter of the GetHistory method is a list of times associated with each historical record.
(The time_list parameter is of the AAGTime data type.) This list is filled in by the server. The number of
entries in the list is determined by the number of requested time intervals specified in the GetHistory count
parameter.
11.3.3.1.2 Server Specific AAG_GetHistEvent Method Parameters
The AAG_GetHistEvent allows clients to retrieve compressed historical data from a server. No time interval
is specified for receiving interpolated data. Instead, a start time and end time are specified by the client,
and the server returns historical values as stored in the historical, archival, historical block or archival block
database compressed and without interpolation.
The start parameter is a pointer to a character string which contains the start time. The start time must be
in the format:
HH:MM:SS DD-MMM-YY.
The end parameter is a pointer to a character string which contains the end time. The end time must be in
the format:
HH:MM:SS DD-MMM-YY.
The time_list parameter is a list of time stamps returned by the server, which specifies the times at which
samples were recorded. Time stamps are in the format:
HH:MM:SS DD-MMM-YY
11.3.3.1.3 Server Specific AAG_GetHistStat Method Parameters
The GetHistStat method is used by a client to retrieve statistical data from a server. Statistical values
returned include the maximum, minimum, average, and standard deviation over a time period.