Adapter for IBM Power 10.11 | Adapter Listeners and Notifications | Configuring Listeners
 
Configuring Listeners
When you configure a dataqueue listener, you specify information that the Integration Server uses to read data from IBM Power dataqueue.
Before you configure the dataqueue listeners, you must configure an adapter connection. You create webMethods Adapter for IBM Power connections using the Integration Server Administrator.
*Perform the following steps to configure a dataqueue listener:
1. In the Adapters menu in Integration Server Administrator's navigation area, click webMethods Adapter for IBM Power.
2. Click Listeners.
3. In the Listeners page, click Configure New Listener.
4. In the Listener Types page, select DataQueue Listener.
5. In the Configure Listener Type page, provide values to the following fields:
Field
Description
Package
Package in which to create the listener. Use Designer to create the package before specifying the value in this field. For general information about creating packages, see the webMethods Service Development Help for your release.
Note:
Configure the listener in a user-defined package rather than in the adapter's package. For other important considerations when creating packages for webMethods Adapter for IBM Power, see Adapter Package Management.
Folder Name
Folder in which to create the listener.
Listener Name
Name of the listener.
Connection Name
Name of the webMethods Adapter for IBM Power connection that the listener must use to connect to the IBM Power system.
Note:
Use a connection with Service Type as DATAQUEUE to access dataqueues.
Retry Limit
Number of times the adapter tries to reconnect, if the adapter fails to connect to or loses connection with the IBM Power system.
Retry Backoff Timeout
Time in seconds that must elapse between each of the retries specified in the Retry Limit.
Library Name
Name of the library where the dataqueue exists.
Queue Name
Name of the dataqueue which must be monitored.
Queue Type
Type of dataqueue. Possible values are:
*Sequential. Dataqueue organized in a linear or sequential (FIFO or LIFO) order.
*Keyed. Dataqueue organized as key-value pair. The key-value pair allows direct access to messages based on the specific identifier (key).
Key Type
List of the IBM Power native data types in which the key is stored in the dataqueue if the Queue Type is Keyed.
Key Length
Length of the key in bytes if the Queue Type is Keyed. Specify the Key Length as 0 if the Queue Type is Sequential.
Key Value
Value of the key if the Queue Type is Keyed.
Key Compare Type
Type of comparisons to perform on the Key Value if the Queue Type is Keyed. Possible values are:
*EQ. Equal.
*NE. Not equal.
*LT. Less than.
*LE. Less than or equal.
*GT. Greater than.
*GE. Greater than or equal.
Note:
The listener name is prefixed by the folder name and is separated by a colon. For example, if the folder name is Folder1 and the listener name is Listener1, then the listener name in the Listeners page will be Folder1:Listener1.
6. Click Save Listener. If the parameters are valid, the listener you created appears on the page.
7. To monitor the dataqueue, enable the listener. For more information on enabling listeners, see Enabling Listeners.