The count , start time in times[0] , end time in times[count-1] , and filter expression are passed to obtain an array of compressed Archive events. The rev flag is used to obtain sequential Archive events starting with times[0] and going backwards in time until count or the end time is reached. The filt flag specifies whether a Filtered status or no value is returned at times when the filter expression is not satisfied. The number of values found is returned in count . If sequential events fail the filter, only one Filtered (-244) status is returned for the sequence.

C format

int32 piar_compvaluesfil(

int32 pt,

int32 PIPTR * count,

int32 times[],

float rvals[],

int32 istats[],

char PIPTR * expression,

int32 rev,

int32 filt );



System error




Bad point number


Date not on line


No data for this point for the passed time


Bad time and date


Invalid count parameter


Expression Parsing Error


Network Error


pt (passed)

Point number

count (passed, returned)

Number of values

times (passed, returned)

Time stamps of values. See piar_compvalues

rvals (returned)

Values in engineering units

istats (returned)

Integer or status values

expression (passed)

Expression string

rev (passed)

Reverse sequence flag; TRUE to go backwards from times[0], FALSE to go forwards

filt (passed)

Filter status flag, TRUE to return FilterFailStatus and FALSE to skip values at times when the expression is not satisfied.

Usage Notes

Enabling Operational Intelligence