Integration Server 10.3 | Built-In Services Reference Guide | StartEvent Folder | Summary of Elements in this Folder | pub.event:auditError
 
pub.event:auditError
WmPublic. Specification for audit error event handlers.
Input Parameters
time
String Date and time at which the audit error occurred. This parameter is in the format yyyy-MM-dd HH:mm:ss.SSS (for example, "2004-10-28 14:46:39.505").
destination
String Specifies the audit log destination to which the audit logging system attempted to write when the error occurred.
Value
Audit logger where the error occurred…
ServiceDBDest
Service audit logger
ErrorDBDest
Error audit logger
SessionDBDest
Session audit logger
ProcessAuditDBDest
Process audit logger
CoreAuditDBDest
All other audit loggers
message
String Error message of the exception.
stackTrace
String Stack trace for the exception.
errorCode
String Optional. The SQL error code returned with the exception.
Output Parameters
None.
Usage Notes
Remember to register your event handler using pub.event:addSubscriber. Set the EventType input variable to Audit Error Event.
An audit error event is fired in the following situations:
*When a SQLException is encountered while trying to insert an audit record into the audit logging database.
*When Integration Server initializes and cannot connect to the audit logging database.
*When the Service logger is configured to retry failed auditing attempts, the audit error event is fired for the initial failure and each subsequent failure.
When you subscribe to an audit error event, you can supply a filter to limit the events that your event handler receives. The filter applies to the concatenated values of the destination and errorCode fields. You can use the asterisk (*) as a wildcard character in the filter. The following table shows how you can use filters to limit the events that your event handler will receive:
This filter...
Limits the events that the event handler receives to...
YourSearchTerm
Events that contain only YourSearchTerm.
*YourSearchTerm
Events that contain YourSearchTerm at the end of the audit error event value.
YourSearchTerm*
Events that contain YourSearchTerm at the beginning of the audit error event value.
*YourSearchTerm*
Events that contain YourSearchTerm anywhere within the audit error event value.
Use the watt.server.event.audit.async server parameter to indicate whether event handlers for audit error events are invoked synchronously or asynchronously. When this parameter is set to true, Integration Server invokes the event handlers that subscribe to audit error events asynchronously. When this parameter is set to false, Integration Server invokes the event handlers that subscribe to audit error events synchronously. The default is true (asynchronous).