Basic Resource Provider Configuration

The JMS resource adapter utilizes a configuration property named resourceProviderDefinitions in the ra.xml file to define resource providers, such as JNDI properties. The resourceProviderDefinitions property is used by the JMS resource adapter to access WebLogic JMS. You can configure multiple resource providers in an ra.xml file.

Note:

When specifying the resourceProviderDefinitions property, you may need to use the per cent character (%) as an escape character if your WebLogic Server JNDI URL includes one or more commas to delimit multiple properties.

For example, if the URL is represented as t3://host:port,host2:port2, then the JMS resource adapter will fail to parse the URL because a comma is inserted after host:port.

To resolve this issue, insert a per cent character (%) immediately prior to the comma. For example: t3://host:port%,host2,port

To configure a resource provider, complete the following steps in the ra.xml file:

1. 1. Specify the resourceProviderDefinitions property as the value of the <config-property-name> element. For example:

      <config-property-name>resourceProviderDefinitions</config-property-name>
      

   2. Specify java.lang.String as the value of the <config-property-type> element. For example:

      <config-property-type>java.lang.String</config-property-type>
      

   3. Define the specific JNDI properties for a resource provider by using the following name-value pair pattern:

      (RP_NAME: jndiEnv=property1=(value1,property2=value2,...))
      

      In this name-value pattern:

   • RP_NAME is a unique name for the JNDI properties of a resource provider and is used with the rpResourceLocation configuration property of the <connection-definition> and <adminobject> elements. For more information, see Sending Outbound JMS Messages.

     Note:

     Each defined resource provider name (RP_NAME) must be unique in the ra.xml file.

   • property1=value1,property2=value2,... is a comma-separated list of name-value pairs that define the JNDI properties for a resource provider.

See Example Resource Provider Configuration for an example configuration.