This pane displays links between this messaging engine and messaging engines in foreign service integration buses.
To view this pane in the console, click the following path:
The messaging engine in the foreign bus must also have a service integration bus link to the local bus. For a connection to be active, the service integration bus links at both ends must be started.
The Configuration tab shows configuration properties for this object. These property values are preserved even if the runtime environment is stopped then restarted. See the information center task descriptions for information about how to apply configuration changes to the runtime environment.
The name of the service integration bus link. In order to work, the name must be the same as the name of the corresponding service integration bus link configured on the target foreign bus.
Required | Yes |
Data type | Text |
The universal unique identifier assigned by the system to the service integration bus link for administrative purposes.
Required | No |
Data type | Text |
An optional description for the service integration bus link, for administrative purposes.
Dynamic updates to this property are effective immediately.
Required | No |
Data type | Text area |
The universal unique identifier assigned by the system to the service integration bus link for administrative purposes.
Required | Yes |
Data type | drop-down list |
The local messaging engine that this service integration bus link is hosted on.
Required | Yes |
Data type | drop-down list |
The messaging engine on the foreign bus to which this service integration bus link connects.
Required | Yes |
Data type | Text |
The initial state of the link, which shows whether the link is started automatically when the messaging engine is started.
Required | No |
Data type | drop-down list |
Range |
|
The destination for an inbound message when the service integration bus link cannot deliver the message to its target bus destination, or to the exception destination that is configured for that target destination, or when the target destination does not exist.
Dynamic updates to this property are effective immediately.
Required | No |
Data type | Radio button |
Default | System |
When this check box is selected, the link prefers to send inbound messages to available queue points of target destinations that are located on the messaging engine on which the link is hosted.
When this check box is not selected, or if no local queue point is available for a target destination, the link workload balances the messages across all available queue points of the target destination. By default the check box is selected.
This option is supported on links running on WebSphere® Application Server Version 7.0. If you are running on an earlier version, the default behavior of preferring local queue points is applied.
Required | Yes |
Data type | Check box |
The Runtime tab shows runtime properties for this object. These properties directly affect the current runtime environment, but are not preserved when that environment is stopped. To preserve runtime property values, change the equivalent property values on the Configuration tab. See the information center task descriptions for information about how to apply configuration changes to the runtime environment.
The runtime status of the service integration bus link.
Status | Meaning |
---|---|
Starting | The service integration bus link is started on the local messaging engine but has no connection to the foreign bus. The service integration bus link is attempting to activate a connection to the foreign bus. The service integration bus link on the foreign bus must also be started to enable the successful activation of a connection between the buses. |
Started | The service integration bus link is started on the local messaging engine and has an active connection to the foreign bus. |
Stopped | The service integration bus link is stopped on the local messaging engine and there is no connection to the foreign bus. |
Unknown | The administrative console cannot contact the server to determine the status. |
Required | No |
Data type | Text |
The type of transport chain used for communication with the foreign bus.
Dynamic updates to this property are effective when the link is restarted.
Required | No |
Data type | Text |
A comma-separated list of endpoint triplets, with the syntax hostName:portNumber:chainName, used to connect to a bootstrap server. For example Merlin:7276:BootstrapBasicMessaging,Gandalf:5557:BootstrapSecureMessaging. If hostName is not specified, the default is localhost. If portNumber is not specified, the default is 7276. If chainName is not specified, the default is BootstrapBasicMessaging. Refer to the information center for more information.
The port for the bootstrap endpoint is the port defined on the service integration bus endpoint address that is configured on the target application server on the foreign bus.
Dynamic updates to this property are effective when the link is restarted.
You only have to modify this property if you have client applications running outside of an application server, or applications on a server in another cell, that want to use this connection factory to connect to the target service integration bus specified on the connection factory.
To use JMS destinations of the default messaging provider, an application connects to a messaging engine on the target service integration bus to which the destinations are assigned. For example, a JMS queue is assigned to a queue destination on a service integration bus.
Client applications running outside of an application server - for example, running in a client container or outside the WebSphere Application Server environment - cannot locate directly a suitable messaging engine to connect to in the target bus. Similarly, an application running on a server in one cell to connect to a target bus in another cell cannot locate directly a suitable messaging engine to connect to in the target bus.
In these scenarios, the clients (or servers in another bus) must complete a bootstrap process through a bootstrap server that is a member of the target bus. A bootstrap server is an application server running the SIB Service, but does not have to be running any messaging engines. The bootstrap server selects a messaging engine that is running in an application server that supports the required target transport chain. For the bootstrap process to be possible, you must configure one or more provider end points in the connection factory used by the client.
A bootstrap server uses a specific port and bootstrap transport chain. The port is the SIB_ENDPOINT_ADDRESS (or SIB_ENDPOINT_SECURE_ADDRESS if security is enabled), of the messaging engine that hosts the remote end of the link. Together with host name, these form the endpoint address of the bootstrap server.
If you want an application to use a bootstrap server with a different endpoint address, you must specify the required endpoint address on the Provider endpoints property of the JMS connection factories that the client application uses. You can specify one or more endpoint addresses of bootstrap servers.
The endpoint addresses for bootstrap servers must be specified in every JMS connection factory that is used by applications outside of an application server. To avoid having to specify a long list of bootstrap servers, you can provide a few highly-available servers as dedicated bootstrap servers. Then you only have to specify a short list of bootstrap servers on each connection factory.
boothost1:7278:BootstrapBasicMessaging or boothost1:7278and for a server assigned secure port 7289, on host boothost2, that uses the predefined transport chain BootstrapTunneledSecureMessaging:
boothost2:7289:BootstrapTunneledSecureMessaging
[ [host_name] [ ":" [port_number] [ ":" chain_name] ] ]where:
[2002:914:fc12:179:9:20:141:42]:7276:BootstrapBasicMessaging. If a value is not specified, the default is localhost.
If port_number is not specified, the default is 7276.
To find either of these values by using the administrative console, click .
The following predefined bootstrap transport chains are provided:
Specifying host_name : chain_name instead of host_name : : chain_name (with two colons) is incorrect. It is valid to enter nothing, or to enter any of the following: "a", "a:", ":7276", "::chain", and so on. The default value applies if you do not specify a value, but you must separate the fields with ":"s.
boothost1:7278:BootstrapBasicMessaging, boothost2:7289:BootstrapTunneledSecureMessaging, [2002:914:fc12:179:9:20:141:42]:7276:BootstrapBasicMessaging
Required | No |
Data type | Text area |
The name of the authentication alias, used to authenticate access to the foreign bus.
Dynamic updates to this property are effective when the link is restarted.
Modified aliases are only visible after a server restart.
Required | No |
Data type | drop-down list |