Skip navigation.
Downloads | Product Documentation | Support

Administration Console Online Help

# Create foreign destinations

A Foreign Destination represents either a queue or a topic. It contains the destination JNDI name that is looked up on the foreign JNDI provider and the JNDI name that the destination is mapped to on the local WebLogic Server. When the foreign destination is looked up on the local server, a lookup is performed on the remote JNDI directory, and the destination object is returned from that directory.

To configure a foreign destination, follow these steps:

1. If you have not already done so, in the Change Center of the Administration Console, click Lock & Edit (see Use the Change Center).
2. In the Administration Console, navigate to the foreign server resource that you want to configure:
   - Navigate to JMS Resources in System Modules
   - Navigate to JMS resources in an application module
3. Click the Configuration > Destinations tab.
4. In the resulting Foreign Destinations table, click New.

   Note: Once you create a foreign destination, you cannot rename it. Instead, you must delete it and create another one that uses the new name.

5. On the Create a New Foreign Destination page:
   1. In Name, enter a name for the foreign destination.
   2. In Local JNDI Name specify the name that the remote object will be bound to in the local server's JNDI tree and is used to look up the object on the local server.
   3. In Remote JNDI Name, specify the name of the remote object that will be looked up in the remote JNDI directory.

   For more information about these fields, refer to Configuration Options.

6. Click OK.
7. To activate these changes, in the Change Center of the Administration Console, click Activate Changes.
   Not all changes take effect immediately—some require a restart (see Use the Change Center).

After you finish

Continue by configuring a foreign connection factory. You can configure one or more connection factories and destinations (queues or topics) for each foreign server.