Adapter Monitor is a perspective 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.
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 in either of the following ways:
In either method, the Adapter Monitor window displays:
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 menu bar in WebSphere Studio Application Developer Integration Edition, choose Window>Preferences>Adapter Monitor Preferences, and set values for the following:
Enter a numeric value for the number of seconds that will elapse between each poll of the adapter status.
Enter a numeric value for the maximum number of messages that will be displayed by Fault Queue Manager.
Choose Apply or OK.
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.
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.
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 adapter remains shut down until restarted. The adapter cannot be restarted from Adapter Monitor.
The following two commands do not directly affect the processing of the connector, but do affect what the Adapter Monitor displays about the connector:
Deletes this adapter configuration from the Adapter Monitor. This does not change the adapter or alter its state; it only deletes the entry from the Adapter Monitor.
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, 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):
The Fault Queue Manager lists and enables you to handle the failed event messages from two types of interaction patterns: the HubRequest (synchronous event delivery) interaction pattern and the Agent Delivery (asynchronous event delivery) interaction pattern for container managed events.
You can either delete event messages from the queue, or attempt to resubmit them.
To resubmit an event, mark the checkbox 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 cannot 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.