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.
- Check that the broker is running.
- 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.
- 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:
- In the Navigator view, expand the broker and right-click the execution
group with which you want to work
- Select Properties
- 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.
- 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.