Listeners are used for inbound connections to the Integration Server. They are needed for RPC Listener connections, Reliable RPC Listener connections, and Direct RPC Listener connections.
Adapter notifications monitor an EntireX RPC service and notify the Integration Server when a message arrives on the EntireX RPC service for Reliable RPC.
Important:
Use the Integration Server Wrapper of the EntireX Workbench to
create RPC Listener connections with listeners and Reliable RPC Listener
connections with listeners, notifications, triggers, and document types. This
document describes steps to manually configure these objects. This is needed
for advanced configurations, for example triggers with filters.
The following topics are covered:
A generated trigger object needs a trigger service that it can call. The
input signature for a trigger service needs to have a document reference to the
generated publishable document type. While a Integration Server
service normally does not have such an input signature, we have to use a
workaround to enable the Integration Server service to retrieve the
input data from the publishable document. Therefore you can use the service
com.softwareag.entirex.wmadapter.Deployment:putDocDataToPipeline,
which retrieves all input data from the incoming document and puts it in the
pipeline, where the Integration Server service is able to retrieve
the data.
Start the Integration Server and the Administrator if they are not already running.
Make sure that you have webMethods administrator privileges so that you can access the EntireX Adapter's administrative screens.
Note:
For information on setting user privileges, see
webMethods Integration Server Administrator's
Guide.
Using the Administrator, make sure that the WmEntireX package is enabled. To verify the status of the WmEntireX package, see Enabling and Disabling Packages.
Using the Administrator, configure a valid connection, for instance by copying a generated connection. For more information on configuring connections, see EntireX Adapter Connections (main section).
Start the Developer if it is not already running.
Make sure you are viewing the Developer in the Edit perspective, as described in Switching Perspectives in the webMethods Developer User's Guide.
Using the Developer, create a user-defined package to contain the listener, if you have not already done so. For more information on managing packages, see Package Management.
When you configure listeners of the EntireX Adapter, you specify information that the Integration Server uses to listen for, and get messages on, a specified EntireX broker. The broker is specified in the connection associated with the listener. You configure EntireX Adapter Listeners using the Administrator.
To configure a new listener
In the menu in the Administrator's navigation area, click .
In the menu, click .
On the Listeners screen, click .
On the Listener Types screen, select EntireX Listener.
On the Configure Listener Type screen, in the EntireX Adapter section, use the following fields:
| Field | Description |
|---|---|
| Package | The package in which to create the listener. |
| Folder Name | The folder in which to create the listener. |
| Listener Name | The name of the listener. |
| Connection Name | The connection to associate with the listener. From the list of connections, select an appropriate connection that you created on the Configure Connections Type screen. Use separate connections for the adapter services and the adapter listeners. |
| Retry Limit | The number of times the adapter tries to reconnect if the adapter fails to connect, or loses connection with the EntireX broker. Default: 5. |
| Retry Backoff Timeout | The number of seconds that elapse between each of the retries specified in the retry limit. Default: 10. |
| EntireX Subprogram Names | A list of subprogram names, separated by blanks. This list and the following list of service names is usually generated by the EntireX Workbench. |
| Service Names | A list of Integration Server services, separated by blanks. Each service corresponds to a subprogram name. For the subprogram the service at the same position in the list is called. The lists must have the same number of names. |
Save the listener.
You can test listeners to ensure that you have configured them correctly.
To test a listener
Configure a listener using the Administrator. For instructions on how to configure a listener, see Configuring New Listeners.
For Reliable RPC Listener Connections only (asynchronous calls): Configure a listener notification using the Developer. See the Developer User's Guide for more information.
For Reliable RPC Listener Connections only (asynchronous calls): Enable the listener notification using the Administrator. For instructions on how to enable a listener notification, see Managing EntireX Adapter Notifications.
Enable the listener using the Administrator.
Important:
The broker configured in the connection associated with the
listener must be running while the listener is enabled.
Use an RPC client to call the RPC server specified in the connection associated with the listener.
As a result, the listener receives the call, uses the parameters to call the flow service or the Java service, and returns the results to the RPC client.
Notes:
You can view a listener's parameters using the Administrator or the Developer. You can also view the notification order of a listener.
To view a listener's parameters using the Administrator
In the menu in the navigation area of the Administrator, click .
In the menu, click .
On the listeners page, click the View icon for the listener that you want to see.
As a result, the View Listener screen displays the parameters for the listener. For descriptions of the listener parameters, see Configuring New Listeners.
Click to return to the main listeners screen.
Note:
Alternatively, you can use the Developer. See the Developer
User's Guide for more information.
To prepare to configure or manage EntireX Adapter
notifications
Start your Integration Server and the Administrator, if they are not already running.
Make sure you have webMethods administrator privileges so that you can access the EntireX Adapter's administrative screens. See Administering webMethods Integration Server for information on setting user privileges.
Using the Administrator, make sure the WmEntireX package is enabled. See Enabling and Disabling Packages for instructions.
Using the Administrator, configure an adapter connection to use with the notification. See Configuring Adapter Connections.
Start the Developer if it is not already running.
Make sure you are viewing the Developer in the Edit perspective, as described in Switching Perspectives in your webMethods Developer documentation.
Using the Developer, create a user-defined package to contain the notification, if you have not already done so.
Important:
When you configure notifications, you should always define
them in user-defined packages rather than in the WmEntireX package. For more
information on managing packages for the adapter, see
Package
Management.
Important:
You must enable a notification before you can use it. See
Managing
EntireX Adapter Notifications for
instructions.
When you configure EntireX Adapter notifications, you specify information that the Integration Server uses to read data from an EntireX broker and call a specified flow service or Java service. For more information on notifications, see Listeners and Adapter Notifications (separate sections). Be sure to review the section Before Configuring or Managing Notifications before you configure EntireX Adapter notifications.
Adapter notifications are only used for Reliable RPC Listener Connections.
To configure an EntireX Adapter notification
From the menu, choose New...
Select from the list of elements and click .
Select as the adapter type and click .
Select the appropriate and click .
Select the Asynchronous Listener Notification template and click .
Select an and click .
Type a unique name for the notification and select the appropriate folder. Click .
Select a service to be called when an RPC call arrives at the listener. Click .
The names of the request and reply documents are displayed. Click .
As a result, the editor for the adapter notification appears.
Note:
You can select the Adapter Settings tab at
any time to confirm adapter service properties such as the Adapter
Name, Adapter Connection Name, and
Adapter Notification Template, as
necessary.
Select the Listener Notification tab and choose
the EntireX Subprogram Name. You may select Map Data Types to
String to map all IDL parameters to
java.lang.String. Otherwise, the IDL data types are
mapped to Java primitive data types.
As a result, the tables of output parameters and input parameters display the names, the IDL data types and the Java data types in the pipeline.
Note:
For information on using the Permissions tab
to assign an access control list (ACL) to an element, see the
Developer User's Guide.
From the menu, choose (or ).
Note:
You must schedule and enable the notification using the
Administrator before you can use it. See
Managing
EntireX Adapter Notifications for details.
You must enable an EntireX Adapter notification before you can use it to monitor EntireX brokers for messages. Use the Administrator along with the following procedure to do so.
Note:
You must have webMethods administrator privileges to access the
EntireX Adapter's administrative screens. See the
Administering webMethods Integration Server for information on
setting user privileges.
To enable (or disable) an EntireX Adapter notification
Start the Integration Server Administrator.
From the menu in the navigation area of the Administrator, choose .
From the navigation area, select Listener Notifications.
In the Listener Notifications table, you can enable and disable the notification.
Important:
You cannot enable a notification if the adapter connection
that the notification is using is disabled.
As a result, the name of the package is displayed.
Use the Developer to view a notification. Make sure you are using the Developer in the Edit perspective, as described in Switching Perspectives in your webMethods Developer documentation.
To view a notification
In the Developer Navigation panel, expand the package and folder that contain the notification you want to view.
Select the notification you want to view.
The Developer displays the notification in the service template's Adapter Service Editor.
Use the Developer to edit notifications. Make sure you are using the Developer in the Edit perspective, as described in Viewing Different Perspectives in the Developer in your webMethods documentation. You can change which connection an adapter notification uses.
To edit a notification
In the Developer Navigation panel, expand the package and folder that contain the notification you want to view.
Select the notification you want to edit.
The Developer displays the notification in the notification template's Adapter Notification Editor.
Modify the values for notification's parameters as needed. For detailed descriptions of the notification's parameters, see the section on configuring a notification.
Use the Developer to delete adapter notifications. Make sure you are viewing the Developer in the Edit perspective, as described in Switching Perspectives in your webMethods Developer documentation.
To delete a notification
In the Developer Navigation panel, expand the package and folder that contain the notification you want to delete.
Right-click the notification and then click .
