Starting in SAS® Event Stream Processing 2.3, users can write and register their own aggregate functions that can be used by aggregate windows. When a SAS Event Stream Processing application calls dfESPengine::initialize(), SAS Event Stream Processing searches for a library of the user-defined aggregate functions.
- On Linux, the library is called libdfxesp_udaf-<major_number>.so, where <major_number> is from the SAS Event Stream Processing version information, which is in the format <major_number>.<minor_number>. For example, when running SAS Event® Stream Processing 3.1, the library name is libdfxesp-3.so. SAS Event Stream Processing loads the library from $DFESP_HOME/lib.
- On Windows, the library is called dfxesp_udaf<major_number><minor_number>.dll, where <major_number>< minor_number> is from the SAS Event Stream Processing version information, which is in the format <major_number>.<minor_number>. For example, when running SAS Event Stream Processing 3.1, the library name is dfxesp_udaf31.dll. ESP load the library from $DFESP_HOME/bin.
If the library is not found, a warning message is issued. On Linux the message is as follows:
2015-06-24T11:11:00,468; WARN ; 00000024; DF.ESP; (dfESPengine.cpp:307); dfESPengine::loadUDAFs() for engine engine: Unable to load user defined aggregate function plugin libdfxesp_udaf-3.so, from: /opt/SASHome/SASEventStreamProcessingEngine/3.1.0/lib/, message: Error loading dependency library
On Windows, the message is as follows:
2015-07-01T15:08:03,122; WARN ; 00000022; DF.ESP; (dfESPengine.cpp:307); dfESPengine::loadUDAFs() for engine esp: Unable to load user defined aggregate function plugin dfxesp_udaf31.dll, from: C:\Progra~1\SASHome\SASEventStreamProcessingEngine\3.1.0\bin\, message: Error loading dependency library
If your SAS Event Stream Processing application or XML model does not use any user-defined aggregate functions, you can ignore this message.
If your SAS Event Stream Processing application or XML model does use user-defined aggregate functions, complete the following steps to resolve this issue:
- Ensure that the library that contains the user-defined aggregate functions is named correctly for the SAS Event Stream Processing version.
- Verify that the library was copied to the path that is specified in the warning message.
- Verify that the SAS Event Stream Processing program or XML server has the correct permissions to the library.