Add JMS Control Dialog

Use this dialog to add a new or existing JMS control to your web service. A JMS control enables your service to exchange messages with a Java Messaging Service queue or topic.

# Step 1: Specify a Name for This Control

Enter a unique name for this JMS control. The name that you choose will be the variable name that you use to refer to this JMS control in your code.

# Step 2: Use an Existing Control, or Create a New Control

To add an existing JMS control to your service, select the option "Use a JMS control already defined by a CTRL file". Type the path and file name, or click the Browse button to locate the CTRL file.

To create a new JMS control, select the option "Create a new JMS control to use with this service," and enter a name for the new control. The word "Control" will be automatically appended to the name you enter.

## Control Factories

If you make this a control factory, web services can dynamically create multiple instances of this control. To learn more about control factories, see Control Factories: Managing Collections of Controls.

# Step 3: Set Required Attributes for This Control

## JMS Destination Type

If you are creating a new JMS control, you must specify whether the control should exchange messages with a JMS queue or topic. The default setting is "queue."

## Message Type

A JMS control can process one of four types of messages: Text, XML Map, Object or JMS Message.

Text: messages consist of a single string per message. It is up to the entities communicating via JMS to decipher the meaning of the strings that are passed.

XML Map: messages consist of XML. XML maps are used to translate JMS control method parameters (Java objects) into XML elements in messages. To learn about XML maps, see Handling and Shaping XML Messages with XML Maps.

Object: messages consist of serialized Java objects. It is up to the entities communicating via JMS to use appropriate object types that all communicating entities understand.

JMS Message: messages consist of serialized objects that implement javax.jms.Message.

## Destination Name(s)

Next, specify the name of the queue or topic for sending messages in the send-jndi-name attribute, and the name of the queue or topic for receiving messages in the receive-jndi-name attribute. Click the Browse button to select from a list of possible JNDI names defined in WebLogic Server.

Finally, specify the name of the connection factory to create connections to the queue or topic in the connection-factory-jndi-name attribute. Click the Browse button for a list of available connection factory names.

Related Topics

Controls: Using Resources from a Web Service

JMS Control: Using Java Message Service Queues and Topics from Your Web Service

Creating a New JMS Control

Using a JMS Control