Creating remote queues

A user with the Developer role can create remote queues for their environment if the remote queues are enabled for the environment. You can use the remote queues to communicate with the queue managers that are outside the Sterling™ Order Management System application.

About this task

If remote queues are enabled for your environment, you can view the Remote queues tab under Queue configuration in Self Service.

When a queue is added, the binding files are pulled from the IBM MQ server and propagated to the agent (Agent), integration (INTG), and WebSphere Application Server components for the application.

Watch a video to learn how you can connect to the Sterling Order Management System queue manager.

Procedure

Access Self Service with your IBMid.
From the Self Service menu, click Environments.
From the list of environments, select an environment.
In the Queue configuration tab, click Remote queues.
Click Create remote queue.
Enter a queue name.

Note: The remote queue name cannot be same as the existing local or remote queue.
Select a server channel from the list that is supported for the sender-receiver mode of communication.
Five pairs of sender-receiver channels are supported with the following naming conventions.
- Inbound to Sterling Order Management System
```
OMS_{Five-letter tenant code}_{environment type}[nn]_{IN}[nn]
```
  For example, the tenant code = FTEST. The following channels are set in Sterling Order Management System for receiving communication from external queues.
  The environment types are as follows:
  
  PP - Preprod
  
  PR - Prod
  
  DE - DEV
  
  QA - QA
  You must set the following channels with the same names in the external queue manager for successful communication.
  - OMS_FTEST_PP01_IN01
  - OMS_FTEST_PR01_IN01
  - OMS_FTEST_DE01_IN01
  - OMS_FTEST_QA01_IN01
- Outbound to Sterling Order Management System
```
OMS_{Five-letter tenant code}_{environment type}[nn]_{OUT}[nn]
```
  For example, if the tenant code = FTEST, the following channels are set in Sterling Order Management System for sending communication to external queues. You must set the following channels with the same names in the external queue manager for successful communication.
  - OMS_FTEST_PP01_OUT01
  - OMS_FTEST_PR01_OUT01
  - OMS_FTEST_DE01_OUT01
  - OMS_FTEST_QA01_OUT01
Enter a remote queue name. The remote queue name must adhere to the MQ standards.
Specify the name of the remote queue manager.
Enter the usage description for the remote queue.

Results

After the remote queue is configured in Self Service, the connection can be initiated only from the external queue manager to the queue manager in Sterling Order Management System.

You can view the remote queue under the Remote queue section of the Queue configuration tab in Self Service and the Process details - Add Queues under the Processes tab.