pisn_evmexceptionsx

This function returns exception values for points which have previously been registered with the PI System exception server (Update Manager subsystem).

C format

int32 PIPROC pisn_evmexceptionsx(

int32 PIPTR *count,

int32 PIPTR *ptnum,

PI_EVENT PIPTR *values,

int32 funccode);

Returns

100

All values have been returned

>0

System error

Success

-1

Point not found

-75

No points signed up for exceptions

-77

Exception buffer overflowed

-982

Invalid funccode

-991

Not implemented

-992

Bad length for bval

-998

Memory allocation error

-15010

Value truncated

 

Arguments

count (passed, modified)

When passed, indicates the number of values to retrieve in this evmexceptions call. When returned, indicates the number actually retrieved.

ptnum (modified)

PI point number.

values (modified)

Event returned for ptnum.

funccode (passed)

Code indicating type of call. Three values are possible:

GETFIRST: obtains data from the PI System and returns data for the first PI point.
GETNEXT returns data for the next PI point.
GETSAME: returns the same data value as returned by the last call using GETNEXT or GETFIRST.

Usage Notes

A call using the function code GETFIRST must be made first, otherwise PI_NOMOREVALUES will be returned.

The points must first be registered with the Update Manager using the pisn_evmestablish function. If a point’s exception values are no longer needed, pisn_evmdisestablish may be used to remove it from the update manager’s list of points to queue.

Enabling Operational Intelligence