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 a broker-wide listener to embedded listeners

Configure your broker and integration servers so that some or all of the HTTP or SOAP nodes use an integration server (embedded) listener. SOAP nodes use an embedded listener by default. You might have changed them to use the broker-wide listener, but now want to return to using embedded listeners.

You can change the configuration for one or more integration servers so that HTTP or SOAP nodes deployed in these integration servers use the embedded listener.

Check that the broker is running.
If you want all HTTP and SOAP nodes in all integration servers to use the embedded listener, you can change the broker configuration to disable the broker-wide listener. Run the mqsichangeproperties command to change the broker configuration. Do not run this command if you want to keep the broker-wide listener active for at least one of your integration servers.
```
mqsichangeproperties IB9NODE -b httplistener -o HTTPListener 
	-n startListener -v false
```
All integration servers detect this change of status, and use the embedded listener when they are restarted, regardless of their own specific configuration. Therefore, you can switch to using embedded listeners for all integration servers by running this single command.
If you disable the broker-wide listener in this way, you can configure an integration server to use the same port or ports that the broker-wide listener was using for HTTP, HTTPS, or both. Reusing the port numbers means that you do not have to change your client applications to send messages to a different port number.
To switch to using the embedded 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 soapNodesUseEmbeddedListener -v true
```
```
mqsichangeproperties IB9NODE -e exgroup1 -o ExecutionGroup 
	-n httpNodesUseEmbeddedListener -v true
```
  IB9NODE is the name of your broker; exgroup1 is the name of your integration server.
- 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, select 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 implement your changes.

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

bc55200_.htm |

Last updated Friday, 21 July 2017