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,


int32 funccode);



All values have been returned


System error



Point not found


No points signed up for exceptions


Exception buffer overflowed


Invalid funccode


Not implemented


Bad length for bval


Memory allocation error


Value truncated



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