WebSphere Message Broker, Version 8.0.0.7 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 execution groups so that some or all of the HTTP or SOAP nodes use an execution group (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 execution groups so that HTTP or SOAP nodes deployed in these execution groups use the embedded listener.
  1. Check that the broker is running.
  2. If you want all HTTP and SOAP nodes in all execution groups 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 execution groups.
    mqsichangeproperties MB8BROKER -b httplistener -o HTTPListener 
    	-n startListener -v false
    All execution groups 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 execution groups by running this single command.

    If you disable the broker-wide listener in this way, you can configure an execution group 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.

  3. To switch to using the embedded listener for a specific execution group, use the mqsichangeproperties command or the WebSphere® Message Broker Explorer to change the execution group configuration.
    • To use the mqsichangeproperties command, adapt one of the following examples:
      mqsichangeproperties MB8BROKER -e exgroup1 -o ExecutionGroup 
      	-n soapNodesUseEmbeddedListener -v true
      mqsichangeproperties MB8BROKER -e exgroup1 -o ExecutionGroup 
      	-n httpNodesUseEmbeddedListener -v true
      MB8BROKER is the name of your broker; exgroup1 is the name of your execution group.
    • To use the WebSphere Message Broker Explorer, complete the following steps:
      1. In the Navigator view, expand the broker and right-click the execution group 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 Execution Group.

  4. 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 execution groups, see the description of the mqsichangeproperties command.
Notices | Trademarks | Downloads | Library | Support | Feedback

Copyright IBM Corporation 1999, 2016Copyright IBM Corporation 1999, 2016.

        
        Last updated:
        
        Last updated: 2016-05-23 14:48:00


Task topicTask topic | Version 8.0.0.7 | bc55200_