Event Viewer
Use the Event Viewer to view and research events.
An event tells you 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 that 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 if the system detected a non-critical error in a document).
Most types of documents are re-sent 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 Partner Gateway includes predefined events. Through
the product's Alerts feature, the Account Admin module,
you can create event-based alerts. You can identify 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 Partner Gateway includes the event types listed
in Table 16.
Table 16. 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. |
Searching for events
- Click Viewers > Event Viewer.
Events are organized by severity from left to right in the Event
Viewer Search window. Information on the left is the least severe
event type; Critical information located on the right side of the
window is the most severe. 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.
Note:
Debug events cannot be viewed by all users.
- Select the search criteria from the drop-down lists.
Table 17. Event search criteria
Value |
Description |
Start date and time |
Date and time the first event occurred. |
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. |
Descend |
Sort in either descending or ascending order. |
Results per page |
Number of records displayed per page. |
Refresh |
Default setting is Off. When Refresh is On,
the Event Viewer first performs a new query, then remains in refresh
mode. |
Refresh Rate |
Controls how often search results are refreshed
(Community Manager only). |
- 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 window. The next window
refresh reflects the new selected event type.
Viewing event details
- Click Viewers > Event Viewer.
- Select the search criteria from the drop-down lists.
- Click Search.
- From the displayed list of events, click the View details icon
next to the event you want to view.
- From the displayed event details, click the View details icon
next to the document that you want to view, if one exists.
- Click the Display raw document icon to view the raw document,
if one exists.
- Click the View validation errors icon to view validation errors.
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.
