Adapter for JMS 6.1 SP1 | webMethods Adapter for JMS Documentation | webMethods Adapter for JMS Installation and User’s Documentation | Adapter Services | Configuring MessageConsumer Services
 
Configuring MessageConsumer Services
 
Using MessageConsumer Services
The MessageConsumer service enables you to synchronously receive messages from a JMS Destination (Queue/Topic). You configure MessageConsumer services based on specific adapter connections. After you follow the steps in this section to configure the MessageConsumer service, you can invoke it from a flow or Java service. You use the MessageConsumer service in combination with other Adapter for JMS services that enable you to convert JMS messages into documents that you can use within other services in Designer.
To use MessageConsumer services, you provide values for the service's input signature in the pipeline. For more information about using MessageConsumer services, see Using MessageConsumer Services.
You can use the same configured MessageConsumer service to retrieve messages from multiple JMS Destinations, provided that the JMS Destinations are all available using the same adapter connection.
*To configure a MessageConsumer service
1. Review the steps in Before Configuring or Managing Adapter Services.
2. Start Designer.
3. Right-click the package in which the service should be contained and select New > Adapter Service.
4. Select the parent namespace and type a name for the adapter service. Click Next.
5. Select Adapter for JMS as the adapter type and click Next.
6. Select the appropriate Adapter Connection Name and click Next.
7. From the list of available templates, select the MessageConsumer template and click Finish.
The service is created and its parameters and controls are displayed in the adapter service editor. 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 Service Template, as necessary.
8. On the Receive Message tab, the Destination Type field will be populated with either Topic or Queue. This value is determined by the service's associated adapter connection.
9. The Input/Output tab shows the service's input and output signatures. To use the MessageConsumer service, you provide values for the signature input within the service pipeline in Designer. See Using MessageConsumer Services for instructions on using the MessageConsumer service.
10. For information about configuring the Input/Output, Settings, Audit, Permissions, and Results tabs, see the webMethods Service Development Help for your release.
11. Select File > Save.