Event Viewer

The Event Viewer allows you to search for events by time, date, event type, event code, and event location. The Hub Admin can also search by participant, Source IP, and Event ID.

The data that the Event Viewer generates identifies, among other things, the Event Code, TimeStamp, and Source IP, and allows you to view the event and document details to diagnose the problem. You can also view the raw document, which identifies the field, value, and reason for the error.

An event tells you know that something unusual has happened in the system. An event can let you know that a system operation or function was successful (for example, a participant was successfully added to the system, or a participant connection was successfully created between Community Manager and participant). An event can also identify a problem (for example, the system could not process a document or the system detected a non-critical error in a document). Most types of documents are resent multiple times, so when a document fails and generates an alert, it is something that you should investigate and correct to prevent similar failures in the future.

WebSphere Business Integration Connect includes predefined events. Use the product's Alerts feature, Account Admin module, to create event-based alerts. This process identifies the events that are of concern to you. Then use the Contacts feature, also in the Account Admin module, to identify the staff members that the system will notify if those events occur.

The Event Viewer displays events based on specific search criteria. You can locate a specific event and then research why it occurred. The Event Viewer allows you to search for events by time, date, event type (debug, information, warning, error, and critical), event code (for example, 210031), and event location.

Data available through the Event Viewer includes event name, time stamp, user, and participant information. This data helps you identify the document or process that created the event. If the event is related to a document, you can also view the raw document, which identifies the field, value, and reason for the error.

Event types

WebSphere Business Integration Connect includes the following event types.

Table 14. Event types
Event type Description

Debug

Debug events are used for low-level system operations and support. Their visibility and use is subject to the permission level of the user. Not all users have access to Debug events.

Information

Informational events are generated at the successful completion of a system operation. These events are also used to provide the status of documents currently being processed. Informational events require no user action.

Warning

Warning events occur due to non-critical anomalies in document processing or system functions that allow the operation to continue.

Error

Error events occur due to anomalies in document processing that cause the process to terminate.

Critical

Critical events are generated when services are terminated due to system failure. Critical events require intervention by support personnel.

Performing Event Viewer tasks

Table 15. Event Viewer tasks
What do you want to do? See

Search for events.

page Searching for events

View event details.

page Viewing event details

Searching for events

  1. Click Viewers > Event Viewer.

    Events are organized by severity from left to right in the Event Viewer Search screen. Information on the left is the least severe event type; Critical on the right is the most severe. (Debug events cannot be viewed by all users.) For any selected event, that event and all events with greater severity are displayed in the Event Viewer. For example, if the Warning event type is selected in the search criteria, Warning, Error, and Critical events are displayed. If Informational events are selected, all event types are displayed

  2. Select the search criteria from the drop-down lists.
    Table 16. Event Search criteria
    Value Description

    Start date and time

    Date and time the first event occurred. Default is ten minutes prior.

    End date and time

    Date and time the last event occurred.

    participants

    Select all participants or a specific participant (Community Manager only).

    Event type

    Type of event: Debug, Info, Warning, Error, or Critical.

    Event code

    Search on available event codes based on selected event type.

    Event location

    Location where event was generated: all, unknown, source (from), target (to).

    Sort by

    Value used to sort results.

    Ascend or Descend

    Sort in ascending or descending order.

    Results per page

    Number of records displayed per page.

    Refresh

    Default setting is Off. When Refresh is On, the Event Viewer will first perform a new query, then remain in refresh mode.

    Refresh Rate

    Controls how often search results are refreshed (Community Manager only).

  3. Click Search. The system displays a list of events.
Tip:
The event list can be re-filtered based on the event type selected at the top of the Event Viewer screen. The next screen refresh reflects the new selected event type.

Viewing event details

  1. Click Viewers > Event Viewer.
  2. Select the search criteria from the drop-down lists.
  3. Click Search. The system displays a list of events.
  4. Click the View details icon next to the event you want to view. The system displays event details and associated documents.
  5. Click the View details icon next to the document that you want to view, if one exists.
  6. Click the Display raw document icon to view the raw document, if one exists.
  7. Click the View validation errors icon to view validation errors.

When the error message No valid encryption certificate found is displayed, neither the primary nor the secondary certificate is valid. The certificates might be expired or they might have been revoked. If the certificates were expired or revoked, you see the corresponding event (No valid encryption certificate found) in the Event Viewer.

Tip:
If a duplicate document event is displayed in the Event Viewer Detail, view the previously sent original document by clicking the View original document icon in Document Details.

Copyright IBM Corp. 2003, 2005