You can use Java™ Message Service (JMS) or other
queues to exchange enterprise service and publish channel data with an external application. When
messages are received or sent, they are written to the queue. These messages remain in the queues
until they are successfully processed or deleted.
Before you begin
Before you can add a queue to an external system, you must create the queue on
the application server. If you add a sequential queue, you must set up a cron task to periodically
poll the queue for messages.
Before you can add a queue to an external system, the system provider must
create the queue on the application server and provide you with the name of the queue. If you add a
sequential queue to the external system, you must set up a cron task to periodically poll the queue
for messages.
About this task
Each external system can have its own inbound and outbound queues, or you can configure
multiple systems to share queues. You can either add your own user-defined
message queues, or modify the existing queues when the predefined inbound and outbound message
queues do not meet your needs. If you want to use additional queues,
the multitenancy manager must create those queues and provide you with the queue names that you can
then configure in the External Systems application.
Procedure
-
In the External Systems application, select the system for which you
want to add a JMS queue.
- Select the Add/Modify Queues action and add a row.
- Enter values in the following fields:
Option |
Description |
Queue JNDI Name |
The name of the JMS queue. |
Queue Connection Factory |
The connection factory that is used for accessing the queue. For a JMS queue, the default
value is jms/mro/int/queues/sqin. |
Maximum Try Count |
The number of times a message is reprocessed after an initial error and before it is written
to the error log and an e-mail notification is sent to the system administrator. |
- Optional: Enter values in the following fields:
Option |
Description |
Initial Context Factory |
The class used to connect to the JMS queue server. |
Provider URL |
The URL of the JMS queue server. |
User ID |
The user ID that is used to access the new queue. |
Password |
The password that is use to access the queue. |
E-mail Address |
The e-mail address of a user who receives notices when transaction errors occur in the
queue. This value is typically the e-mail address of a system administrator. |
- Optional:
If the queue delivers inbound messages and functions as a continuous queue, clear the
Sequential check box.
- Optional: If the queue delivers outbound messages, clear the
Inbound check box.
- Click OK.
- On the System tab, enter values in the following fields as
required:
- Outbound Sequential Queue for the sequential queue for outbound
messages.
- Inbound Sequential Queue for the sequential queue for inbound
messages.
- Inbound Continuous Queue for the continuous queue for inbound
messages.
- Save your changes.