About Error Logging Extension functions
This section provides an alphabetical list of the Error Logging Extension functions. Each entry includes a general description of the function, its syntax, and a description of its parameters.
The Error Logging Extension supports retrieving error information that BIRT iHub captures and writing that information to a log file.
AcIsThreadSafe
Indicates whether the Error Logging Extension is multithread-safe. If the extension is not multithread-safe, AcIsThreadSafe must return False and BIRT iHub serializes all calls to the extension.
Syntax
ERRORLOGEXT_API int AcIsThreadSafe ( );
AcLogError
Called by BIRT iHub for every error it encounters.
Syntax
ERRORLOGEXT_API void AcLogError (ErrorInformation* errorInfo);
Parameter
errorInfo
The error information that BIRT iHub captures.
AcStartErrorLog
Specifies the path to the error log file and the BIRT iHub to monitor. For example, if you write the error information to a database, AcStartErrorLog provides a placeholder to open the database connection.
The server and cluster parameters are WideChar pointers. The function uses the data type WideChar for Unicode compatibility. Actuate pushes out all string data in UCS-2 format.
Syntax
ERRORLOGEXT_API int AcStartErrorLog (const char* serverHome,
const WideChar* server, const WideChar* cluster);
Parameters
serverHome
The path to the error log file. The path must be $AC_SERVER_HOME/bin.
server
The name of the BIRT iHub to monitor.
cluster
The name of the cluster of which the BIRT iHub is a member.
AcStopErrorLog
Stops logging error information and releases resources.
Syntax
ERRORLOGEXT_API void AcStopErrorLog ( );