You use this procedure to create JMS Connection Factory References.
You are in the Configuration Management → Infrastructure → Application Resources function.
1. Choose Create New Resource → New JMS Connection Factory Reference. The New JMS Connection Factory Reference Creation screen area opens.
2. Choose Settings.
3. Complete the following fields:
● 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.
You can enter descriptive text about the Connection Factory. However, this is not required.
4. Choose a factory type from the SAP Factory Type dropdown list box.
● 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:
i. Choose Add New Property from the Properties screen area.
ii. Enter initial-context-factory in the Name field. This is a mandatory property.
iii. Enter the implementation of javax.naming.spi.InitialContextFactory that your client uses to obtain the initial naming context in the Value field.
iv. Choose Add New Property from the Properties screen area.
v. Enter provider-url in the Name field. This is a mandatory property.
vi. Enter the provider URL in <host>[:<port>] format in the Value field.
vii. Choose Add New Property from the Properties screen area.
viii. Enter security-principal in the Name field. This is an optional property.
ix. 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.
x. Choose Add New Property from the Properties screen area.
xi. Enter security-credentials in the Name field. This is an optional property.
xii. 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.
5. Complete the following fields:
· 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.
Enter a password corresponding to the user name.
6. To create additional properties, choose the Properties tab.
7. Choose Add New Property.
8. Enter a name and value for the property.
9. To create an alias, choose the Aliases tab.
10. Choose Add New Alias.
11. Enter a name for the alias.
12. To save the JMS Connection Factory Reference, choose the Save button.