Switching from embedded listeners to an integration node listener

Configure your integration node and integration servers that are associated with an integration node 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

IBM® MQ Server and ensure that a queue manager is specified.

About this task

You can change the configuration for integration servers that are associated with an integration node so that HTTP or SOAP nodes use the integration node listener. HTTP nodes and SOAP nodes use the integration server (embedded) listener by default, but you might want to switch to using the integration node listener.

The commands that are 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.


  1. Check that the integration node is running.
  2. If you disabled the integration node listener, run the mqsichangeproperties command to restart it.
    For example:
    mqsichangeproperties integrationNodeName  -b NodeHttpListener -o HTTPListener 
    	-n startListener -v true
  3. To switch to using the integration node listener for a specific integration server that is associated with the integration node, use the mqsichangeproperties command to change the integration server configuration.
    • The integration node must be stopped for the switch to work. If the node is running, stop it by using the following command

      mqsistop integrationNodeName

    • To use the mqsichangeproperties command, adapt one of the following examples:
      mqsichangeproperties integrationNodeName -f -e server_name -o ExecutionGroup 
      	-n httpNodesUseEmbeddedListener -v false
      mqsichangeproperties integrationNodeName -f -e server_name -o ExecutionGroup 
      	-n soapNodesUseEmbeddedListener -v false
  4. Optional: If you want to use HTTP applications on multiple integration servers, you need to change the HTTP/HTTPS ports to be unique for each integration server. By default the HTTP port is set to 7800 and the HTTPS port is set to 7843. Configure your integration servers by setting properties in the server.conf.yaml file, as described in Configuring an integration server by modifying the server.conf.yaml file
  5. Restart the integration node to ensure that your changes take effect.


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