Chapter 7 ADU Server Methods
58 Agent Data Unit Server Programmer’s Guide
For example, field quark was set twice, once at ADU creation (11:37:00am, by Scott, to “truth”)
and again at ADU transfer (11:38:00, by Jane, to “charm”). Specifying flags =
ADU_GSGETTIME | ADU_GSGETVALUE | ADU_GSGETWHO would yield:
Input Parameters
Output Parameters
Returns
header[0] = ADU_GSGETVALUE; //first subelement is the text
header[1] = ADU_GSGETTIME; //second is time
header[2] = ADU_GSGETWHO; //third is who
names[?] = “quark”; //one of the names returned will be quark
values[?][0][0] = “truth”; //values[13] is parallel to names[13], and the
//first value that was set was “truth”
values[?][0][1] = “8145264302”; //the time_t it was set (11:37:00am)
values[?][0][2] = “Scott”; //Scott set it
values[?][1][0] = “charm”; //next value set was “charm”
values[?][1][1] = “8145264362”; //set at this time
values[?][1][2] = “Jane”; //by this loginid
aduid An ADUID of an existing ADU.
flags One or more of the ADU_GSGET flags, OR'd together.
Flags are:
#define ADU_GSGETVALUE 0x01
#define ADU_GSGETTIME 0x02
#define ADU_GSGETWHO 0x04
headers A list of ADU_GSGET values.
names A list of ADU data names.
values A list of data values (one per name), which are lists of value histories
(one per value), which are lists of fields (text, when, and who).
VESP_SUCCESS Request was successful.
VESP_ERROR ADUID was not found.