Switching from embedded listeners to an integration node listener

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

Before you begin

The integration node listener requires access to system queues on the queue manager specified on the integration node, so you must install WebSphere® MQ Server and ensure that a queue manager is specified.

About this task

You can change the configuration for integration servers so that HTTP or SOAP nodes use the integration node listener. HTTP nodes use the integration node listener by default, but you might have configured some integration servers to use the integration server (embedded) listener, and now want to switch back to using the integration node 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.

Procedure

Check that the integration node is running.
If you enabled your integration server to use an MQ Listener, then run the following command to disable this option.
```
mqsichangeproperties integrationNodeName -e server_name -o HTTPConnector 
	-n enableMQListener -v false
```
where integrationNodeName is the name of your integration node and server_name is the name of your integration server.
If you disabled the integration node listener, then run the mqsichangeproperties command to restart it.
For example:
```
mqsichangeproperties integrationNodeName -b httplistener -o HTTPListener 
	-n startListener -v true
```
To switch to using the integration node listener for a specific integration server, use the mqsichangeproperties command to change the integration server configuration.
- To use the mqsichangeproperties command, adapt one of the following examples:
```
mqsichangeproperties integrationNodeName -e server_name -o ExecutionGroup 
	-n httpNodesUseEmbeddedListener -v false
```
```
mqsichangeproperties integrationNodeName -e server_name -o ExecutionGroup 
	-n soapNodesUseEmbeddedListener -v false
```
  If you want to change the status for all integration servers, you can omit the specific integration server name:
```
mqsichangeproperties integrationNodeName -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.
Stop and restart the integration node to ensure that your changes take effect.

Example

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