Creating a foreign destination on a bus

You can create a foreign destination on a service integration bus. A foreign destination represents a destination that is defined in another bus (a foreign bus). You use a foreign destination when you need to override messaging defaults, security settings, or both for an individual destination on a foreign bus.

About this task

Figure 1. Creating a foreign destination on a service integration busThis figure shows how a foreign destination bus can be created on a service integration bus. In the figure, you can see the foreign destination pointing to a target destination on another bus.

This figure shows a foreign destination that points to a target destination on another bus. There is also a JMS connection factory and JMS queue that an application uses without being aware of the associated foreign destination.

The foreign destination encapsulates the name of the target destination that exists in the foreign bus (Identifier property) and the name of that foreign bus (Bus property). An application that is to use the foreign destination to exchange messages with the target destination must specify the Identifier and Bus properties.

For example, an administrator wants JMS applications to connect to one bus, BusA, and send messages to a JMS queue backed by a queue, targetQueue, on another bus, BusB. The administrator connects the buses, creates a foreign destination on BusA and sets the following properties on the foreign destination and JMS queue:
Table 1. Example property settings. The table provides an example of how the properties can be set when creating a foreign destination on a service integration bus. The first column of the table lists the JMS queue names. The second column contains the identifier and bus names of the foreign destination on a service integration bus, for example, BusA. The third column contains the identifier of the queue on a service integration bus, for example, BusB.
JMS queue Foreign destination (on BusA) Queue (on BusB)

Queue name targetQueue

Bus name BusB

Identifier targetQueue

Bus BusB

Identifier targetQueue

To define a new foreign destination, use the administrative console to complete the following steps.

Procedure

  1. In the navigation pane, click 服務整合 -> 匯流排.
  2. In the content pane, click the name of the bus that you want to create the foreign destination on.
  3. In the content pane, under Destination resources, click Destinations. A list of any existing bus destinations is displayed.
  4. To create a destination, click New.
    1. On the Create new destination page, select Foreign.
    2. Click Next.
    3. In the Identifier field, type the name of the target destination that exists in the foreign bus. The identifier that you specify must match the name of the target destination that exists in the foreign bus. If the foreign destination is a IBM MQ destination, the identifier must be in the form qName@qmName where qName is the name of the queue and qName is the name of the queue manager. For example, the identifier for a queue called WMQ21 on queue manager QM02 would be WMQ21@QM02.
    4. In the Bus field, type the name of the foreign bus that hosts the target destination. On the bus where you are creating the foreign destination, a foreign bus connection that represents this foreign bus must be already defined.
  5. Optional: Specify the following properties for the destination. These will override the destination defaults.
    Description
    An optional description of the destination, for administrative purposes.
    讓生產者可以置換預設可靠性
    預設可靠性
    最大努力非持續性
    傳訊引擎停止或失效時捨棄的訊息。訊息也可能因為用來傳送訊息的連線無法使用,或系統資源受到限制,而遭到捨棄。
    快速非持續性
    傳訊引擎停止或失效時捨棄的訊息。如果用來傳送訊息的連線無法使用,也可能捨棄訊息。
    可靠非持續性
    傳訊引擎停止或失效時捨棄的訊息。
    可靠持續性
    當傳訊引擎失敗時,可能會捨棄訊息。
    確定持續性
    不捨棄訊息。
    Note: 可靠性層次越高,效能影響越大。

    如需服務整合可靠性層次的相關資訊,請參閱Message reliability levels - JMS delivery mode and service integration quality of service

    可靠性上限
    最大努力非持續性
    快速非持續性
    可靠非持續性
    可靠持續性
    確定持續性

    如需服務整合可靠性層次的相關資訊,請參閱Message reliability levels - JMS delivery mode and service integration quality of service

  6. Click Next.
  7. On the Confirm foreign destination creation page, review the summary of actions.
    • To create the foreign destination, click Finish.
    • If you want to change any of the destination properties, click Previous, then change the properties on the preceding pages.
  8. 儲存對主要配置所做的變更。

What to do next

Ensure that you have defined a foreign bus connection (to identify the target bus) and the target destination on that bus.

You can change properties or configure further properties of the foreign destination. See 配置匯流排目的地內容.

If you want to override security settings for the destination, see Administering destination roles.


指出主題類型的圖示 作業主題



時間戳記圖示 前次更新: July 9, 2016 11:15
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=tjo0007_
檔名:tjo0007_.html