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.
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.
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
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.
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.
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.
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.
The adapter polls the event store of its application for events and sends the events as business object messages to the integration broker.
The adapter receives request business objects sent from the integration broker to the application.
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:
Changes the adapter from the Paused or Inactive state to Active
Changes the adapter from the Paused or Active state to Inactive
Changes the adapter from Active state to Paused
Stops the adapter. This action terminates the connector startup script, closing the connection with the application and freeing any allocated resources. The connector remains shut down until restarted. The connector cannot be restarted from Adapter Monitor. See "Starting an Adapter" for instructions on starting and restarting.
The following two commands do not directly affect the processing of the connector, but do affect what the Adapter Monitor displays about the connector:
Removes this adapter configuration from Adapter Monitor. This does not change the adapter or alter its state.
Triggers a GETSTATUS command which gets the current status of the connector agent
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.
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.