About Usage Logging Extension functions
The usage logging extension supports retrieving usage information that BIRT iHub captures and writing that information to a log file.
AcIsThreadSafe
Specifies whether the Usage 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
USAGELOGEXT_API int AcIsThreadSafe ( );
AcLogUsage
Called by BIRT iHub for every transaction it logs.
Syntax
USAGELOGEXT_API void AcLogUsage (UsageInformation* usagenfo);
Parameter
usageInfo
The usage information that BIRT iHub captures.
AcStartUsageLog
Specifies the path to the usage log file and the BIRT iHub to monitor. For example, if you write the usage information to a database, AcStartUsageLog 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
USAGELOGEXT_API int AcStartUsageLog (const char* serverHome, const WideChar* server, const WideChar* cluster);
Parameters
serverHome
The path to the usage 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.
AcStopUsageLog
Stops logging usage information and releases resources.
Syntax
USAGELOGEXT_API void AcStopUsageLog ( );