Using Adapter Monitor and Fault Queue Manager

Adapter Monitor and Fault Queue Manager allow you to change the state of an adapter and to handle failed events that have been received by the fault queue.For more information on using System Manager, refer to the IBM WebSphere Interchange Server System Administration Guide.

Adapter Monitor perspective

The Adapter Monitor perspective enables you to administer adapters and, through the Fault Queue Manager panel, to resubmit messages when errors occur in the processing of submitted events.

Adapter Monitor is used only with adapters that have been configured for use with JMS.

Opening Adapter Monitor

You can open Adapter Monitor as follows: In the System Manager perspective, expand a project folder, right-click on a connector definition icon, and choose Adapter Monitor from the pop-up dialog. The Adapter Monitor window displays:

Figure 21. Adapter Monitor perspective


Setting Adapter Monitor preferences

You can set preferences that determine the intervals at which the Adapter Monitor will poll the state of the adapter and the number of messages that will be displayed in the Fault Queue Manager. To set the preferences, from the drop-down menu in WebSphere Studio Application Developer Integration Edition, choose Window>Preferences>Adapter Monitor Preferences, and set values for the following:

Choose Apply or OK.

Loading an adapter

There are two ways to load an adapter:

You can choose to load an adapter either from the adapter's configuration file or from an integration project.

Note:
To start the adapter, use the connector startup script, the Start menu shortcut, Visual Test Connector, or another mechanism that you have set up for starting the specific adapter.

Adapter Monitor displays

When you load an adapter, an icon for the adapter appears under the JMS-based Adapters folder in the top left panel. The icon indicates the current state of the adapter. The act of loading an adapter into Adapter Monitor does not by itself change the state of the adapter. After loading the adapter, you can perform actions to change its state from Adapter Monitor.

The Adapter Monitor displays are refreshed periodically according to the polling time interval that you set for the Adapter Monitor View in its preferences. However, you can perform an immediate refresh at any time by choosing the Refresh views button from the view's toolbar, its drop-down menu, or context menu.

The top left panel of Adapter Monitor is the tree view. It shows JMS-based adapters at the root of the tree and each adapter that has been loaded as tree branches.

The top right panel of Adapter Monitor is the Details panel. The Details panel shows the name of the adapter, its status, and version.

The bottom panel of Adapter Monitor comprises the Fault Queue Manager view. This view shows the messages that have been routed to the queue manager's fault queue. You can use the Fault Queue Manager display to either resubmit or delete messages that were placed in the fault queue as the result of a failed event flow. You can also display additional details of a message in the fault queue by choosing View details.

Changing the state of an adapter

The Adapter Monitor enables you to monitor and change the state of an adapter. The state of an adapter refers to the processing that is (or is not) being performed by an adapter.

Note:
The existence of an adapter "state" presumes that the adapter has been started. An adapter that has not yet been started, or that was shutdown and not restarted, has no state and is not affected by any actions in the Adapter Monitor. For information about starting an adapter, see Starting a connector.
Generally, the adapter performs two types of processing:
Adapter State Request Processing Polling
Active yes yes
Paused yes no
Inactive no no

To change the state of an adapter, right-click on the icon for the adapter, and choose one of the following:

The following two commands do not directly affect the processing of the connector, but do affect what the Adapter Monitor displays about the connector:

Using the Fault Queue Manager Display

The Fault Queue Manager display shows events that have failed and been received by the fault queue. The display shows as many failed messages as you set in the preferences. The messages are listed in the order in which they were received.

You can select one or more messages to view and then choose View details from either the context menu, the toolbar for the view, or the view's drop-down menu list. Information for that message is displayed in a read-only edit view.

Handling failed events

The Fault Queue Manager lists and enables you to handle the failed event messages from two types of interaction patterns: the HubRequest (request/response) and the Agent Delivery for container managed events.

You can either delete event messages from the queue or attempt to resubmit them.

You can select one or more events and then choose Delete or Resubmit from either the context menu, the view's toolbar, or the view's drop-down menu.

Adapter Monitor attempts to resubmit the event. If the event is successfully resubmitted, it is removed from the Fault Queue Manager display.

Messages with null value for the ResubmitTo field can not be resubmitted. An attempt to resubmit an event can fail either because the message itself is invalid, or the ResubmitTo queue is not valid or available.

A message can be invalid because it contains an invalid JMS type or because it cannot be converted to a business object. In either case, when the attempt to resubmit an invalid message fails, Fault Queue Manager displays an error for the invalid message. When you choose OK, the message is not resubmitted, and it is removed from the fault queue display. If you close the dialog without choosing OK, the message will remain in the fault queue display.

If a message is valid but the resubmit attempt fails because the message ResubmitTo queue is null, invalid, or unavailable, a Resubmit dialog appears. The dialog shows the values of the message. You can choose to either retain (by choosing Cancel) or delete (by choosing OK) the message from the queue.

Copyright IBM Corp. 1997, 2004