Integration Server 10.7 | Built-In Services Reference Guide | Event Folder | Summary of Elements in this Folder | pub.event:exception
 
pub.event:exception
WmPublic. Specification for exception event handlers.
Input Parameters
time
String Date and time that the event occurred, in the format yyyy/MM/dd HH:mm:ss.SS.
Note:
You can set the format by specifying the watt.server.dateStampFmt property.
error
String Optional. Error message of the exception.
localizedError
String Optional. Error message in the language that corresponds to the locale of your webMethods installation.
errorType
String Exception type that was thrown.
errorDump
String More detailed information about the exception.
service
String Optional. Fully qualified name of the service that generated the event.
user
String User that requested the service that generated the event.
callStack
Document List Optional. The call stack information describing where the exception occurred, including the fully qualified name of a service on the stack and an index that identifies the last executed flow step in that service. Each document represents a service on the call stack. The first document in the list represents the service that threw the exception and the last document in the list represents the top-level service. The structure of this document is defined by pub.event:callstackItem.
pipeline
Document Optional. State of the pipeline at the time the exception occurred.
threadID
String Thread ID identifying the thread that invoked the service.
ssnid
String Session ID during which the exception occurred.
errorMsgID
String Optional. The identification number for the error message.
errorDetails
Document Optional. Additional exception information provided by the author of the Java service. For more information about constructing exceptions to return additional information, see the webMethods Integration Server Java API Reference for the com.wm.util.LocalizedException class.
nestedErrorInfo
Document Optional. Nested errors and exceptions, if any. The structure of this document is defined by pub.event:exceptionInfo.
Output Parameters
None.
Usage Notes
Remember to register your handler with the Event Manager.
Not all exception handlers that you code will log information.
Use the watt.server.event.exception.async server parameter to indicate whether event handlers for exception events are invoked synchronously or asynchronously. When this parameter is set to true, Integration Server invokes the event handlers that subscribe to exception events asynchronously. When this parameter is set to false, Integration Server invokes the services that subscribe to the exception events synchronously. The default is true (asynchronous).
When you subscribe an event handler to an exception event, you can create a filter for the service field to specify the services whose exception events you want to subscribe to. That is, you can specify which services' exception events invoke the event handler.