IBM Integration Bus, Version 9.0.0.8 Operating Systems: AIX, HP-Itanium, Linux, Solaris, Windows, z/OS

See information about the latest product version

Switching from embedded listeners to a broker-wide listener

Configure your broker and integration servers to use the broker-wide listener for HTTP or SOAP nodes in one or more integration servers.

You can change the configuration for integration servers so that HTTP or SOAP nodes use the broker-wide listener. HTTP nodes use the broker-wide listener by default, but you might have configured some integration servers to use the embedded listener, and now want to switch back to using the broker-wide listener.

The commands shown in the examples here are split across multiple lines for ease of reading; when you enter the command, you must use a single line.

Check that the broker is running.
If you disabled the broker-wide listener, run the mqsichangeproperties command to restart it. For example:
```
mqsichangeproperties IB9NODE -b httplistener -o HTTPListener 
	-n startListener -v true
```
To switch to using the broker-wide listener for a specific integration server, use the mqsichangeproperties command or the IBM® Integration Explorer to change the integration server configuration.
- To use the mqsichangeproperties command, adapt one of the following examples:
```
mqsichangeproperties IB9NODE -e exgroup1 -o ExecutionGroup 
	-n httpNodesUseEmbeddedListener -v false
```
```
mqsichangeproperties IB9NODE -e exgroup1 -o ExecutionGroup 
	-n soapNodesUseEmbeddedListener -v false
```
  IB9NODE is the name of your broker; exgroup1 is the name of your integration server.
  If you want to change the status for all integration servers, you can omit the specific integration server name:
```
mqsichangeproperties IB9NODE -o ExecutionGroup 
	-n httpNodesUseEmbeddedListener -v false
```
  This command does not change the status of the listener for SOAP messages processed by SOAP nodes; only messages to and from HTTP nodes are affected.
- To use the IBM Integration Explorer, complete the following steps:
  1. In the Navigator view, expand the broker and right-click the integration server with which you want to work
  2. Select Properties
  3. On the Extended tab, clear the SOAP Nodes Use Embedded Listener check box or the HTTP Nodes Use Embedded Listener check box, as required.
    If you are working with a broker at a version that does not support broker-wide listeners for SOAP nodes, there is no check box for the SOAP Nodes Use Embedded Listener property. If you are working with a broker at a version that does not support embedded listeners for HTTP nodes, there is no check box for the HTTP Nodes Use Embedded Listener property. In both of these cases, you see the following message: Unsupported property for this Integration Server.
Stop and restart the broker to ensure that your changes take effect.

For more information about this command, and examples of changing other properties associated with a broker or integration server, see the description of the mqsichangeproperties command.

bc55190_.htm |

Last updated Friday, 21 July 2017