Using Adapter Monitor and Fault Queue Manager

Adapter Monitor is a perspective of the System Manager that enables you to change the state of an adapter, and, through Fault Queue Manager, to handle events that have failed and 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:

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 WSADIE menu bar, choose Window>Preferences>Adapter Monitor Preferences, and set values for the following:

Choose Apply or OK.

Loading an adapter

To use Adapter Monitor, first start the queue manager. Then start the adapter and load the adapter into the Adapter Monitor view (you can also start the adapter after loading it into the Adapter Monitor view.

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

To load the adapter in Adapter Monitor, right click Integration Broker and choose Load Adapter. The following dialog appears:

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

Adapter Monitor displays

When you load an adapter, an icon for the adapter appears under the Integration Broker 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 you have loaded the adapter, you can then perform actions from Adapter Monitor to change the state of the adapter.

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 button from the toolbar or menu bar.

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.

Change 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, listed in the order in which they were received.

To display information from the queue manager about any listed fault queue message, double-click the message field. Information for that message is displayed in the editor view panel (read only):

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.

To resubmit an event, mark the check box in the Message ID field for the event, right click, and choose Resubmit.

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, showing 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, 2003