By default, Patch Bay is configured to use Local JMS and SQL JMS. These providers and the connection factories they use are specified through Nucleus components of class atg.dms.patchbay.JMSProviderConfiguration. For example, to configure SQL JMS, Oracle ATG Web Commerce includes a component of this class named /atg/dynamo/messaging/DynamoSQLJMSProvider. The properties file for this component includes these lines:

providerName=sqldms
topicConnectionFactoryName=dynamo:/atg/dynamo/messaging/SqlJmsProvider
queueConnectionFactoryName=dynamo:/atg/dynamo/messaging/SqlJmsProvider
XATopicConnectionFactoryName=dynamo:/atg/dynamo/messaging/SqlJmsProvider
XAQueueConnectionFactoryName=dynamo:/atg/dynamo/messaging/SqlJmsProvider
supportsTransactions=true
supportsXATransactions=true

You generally should not need to modify any of these settings for Local JMS or SQL JMS. However, you can configure Patch Bay to work with additional JMS providers. See Using Patch Bay with Other JMS Providers for more information.

You can designate a JMS provider as the default provider in Patch Bay by setting the defaultJMSProvider property of the /atg/dynamo/messaging/MessagingManager component to point to the component that configures the provider. By default, this property points to the DynamoSQLJMSProvider component, which configures SQL JMS. Designating a provider as the default simplifies configuration of the destinations for that provider, and makes it easier to switch between providers. See Connecting to Destinations for more information.

You can also declare JMS providers at the top of the Patch Bay configuration file, using tags that correspond to the properties of JMSProviderConfiguration. Note, however, that a JMS provider declared this way cannot be designated as the default provider.

These tags are equivalent to the DynamoSQLJMSProvider properties shown above:

<!-- SQL JMS provider -->
<provider>
  <provider-name>
    sqldms
  </provider-name>
  <topic-connection-factory-name>
    dynamo:/atg/dynamo/messaging/SqlJmsProvider
  </topic-connection-factory-name>
  <queue-connection-factory-name>
    dynamo:/atg/dynamo/messaging/SqlJmsProvider
  </queue-connection-factory-name>
  <xa-topic-connection-factory-name>
    dynamo:/atg/dynamo/messaging/SqlJmsProvider
  </xa-topic-connection-factory-name>
  <xa-queue-connection-factory-name>
    dynamo:/atg/dynamo/messaging/SqlJmsProvider
  </xa-queue-connection-factory-name>
  <supports-transactions>
    true
  </supports-transactions>
  <supports-xa-transactions>
    true
  </supports-xa-transactions>
</provider>