Creating JMS Connection Factory References

Application Name

Specify a name to which the Connection Factory is assigned. This name is used for the configuration that holds the object.

Factory Name

Enter a name for your Connection Factory. The system uses it to bind the factory in the naming system. You can look up the Connection Factory using this name.

Client ID

Enter a unique client identifier. It is also assigned to the connection that is created with this Connection Factory.

The Client ID is not a required field. If you leave it empty, it defaults to the client ID of the connection factory from the JMS provider.

Description

(Optional) You can enter descriptive text about the Connection Factory.

To use the AS Java JMS Provider, choose Local .

• When you use the AS Java JMS Provider, you have to specify the factory type according to the JMS specification from the JMS Factory Type dropdown list box.

• Optionally, you can also specify the virtual JMS provider to use in the Virtual Provider Name field.

To use a JNDI-based provider, choose JNDI Context :

• Enter a Link Factory Name in the corresponding field. The link factory name is the JNDI name for a JNDI-bound JMS factory from the JMS Provider. This holds for both the AS Java JMS Provider and external JMS Providers.

• Specify the following additional properties:

  1. Choose Add New Property from the Properties screen area.

  2. Enter java.naming.factory.initial in the Name field. This is a mandatory property.

  3. Enter the implementation of javax.naming.spi.InitialContextFactory that your client uses to obtain the initial naming context in the Value field.

  4. Choose Add New Property from the Properties screen area.

  5. Enter java.naming.provider.url in the Name field. This is a mandatory property.

  6. Enter the provider URL in <host>[:<port>] format in the Value field.

  7. Choose Add New Property from the Properties screen area.

  8. (Optional) Enter java.naming.security.principals in the Name field.

  9. In the Value field, enter the name of the entity (user) that is authenticated when the connection to the JMS Provider is established. The Security Principal and the Security Credentials are included in the naming context when the connection factory is looked up from the naming.

  10. Choose Add New Property from the Properties screen area.

  11. (Optional) Enter java.naming.security.credentials in the Name field.

  12. In the Value field, enter the credentials (typically a password) that authenticate the security principal to the JMS Provider.

If you choose Object , you have to specify the following values:

• Object Factory Name

  Enter the Java fully qualified name of the class implementing the javax.naming.spi.ObjectFactory interface.

• Class Name

  Enter the Java fully qualified name of the class that implements javax.jms.QueueConnectionFactory or javax.jms.TopicConnectionFactory interface.

To use the SONIQ MQ JMS Provider, choose SJO . Enter the appropriate SJO file name in the corresponding field.

Library Name

Enter a library that is used to obtain a connection factory instance. This is a library deployed on the server and containing the archive files of the JMS provider, that is, the implementation of the JMS Provider.

User Name

Enter a user name for authentication to the JMS provider. The JMS system assigns it by default to the connections created by this Connection Factory unless you specify a different user name for a connection.

Password

Enter a password corresponding to the user name.