You can choose between integration node listeners and integration server (embedded) listeners to manage HTTP messages in your HTTP or SOAP flows. Learn about the two types of listener, how ports are assigned to them, and how you can switch from one to the other for individual integration servers.
The choice of listener also affects integration services and REST APIs. Integration services use a SOAPInput node, so they use the listener specified for SOAP nodes. REST APIs use an HTTPInput node, so they use the listener specified for HTTP nodes.
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 if you want to use an integration node listener. However, if you use HTTP nodes or SOAP nodes with the integration server embedded listener, IBM MQ is not required.
mqsireportproperties integrationNodeName -e default -o HTTPConnector -r
mqsireportproperties integrationNodeName -e default -o HTTPSConnector -r
mqsireportproperties integrationNodeName -e default -o ExecutionGroup -n soapNodesUseEmbeddedListener
mqsireportproperties integrationNodeName -e default -o ExecutionGroup -n httpNodesUseEmbeddedListener
HTTPConnector:
ListenerPort: 7080
HTTPSConnector:
ListenerPort: 7083
mqsireportproperties integrationNodeName -b NodeHttpListener -o HTTPConnector -r
mqsireportproperties integrationNodeName -b NodeHttpListener -o HTTPSConnector -r
mqsichangeproperties integrationNodeName -b NodeHttpListener -o HTTPConnector
-n ListenerPort -v 8085
Run
the following command to change the port on which the integration node listener for integration node
integrationNodeName listens for HTTPS
messages:mqsichangeproperties integrationNodeName -b NodeHttpListener -o HTTPSConnector
-n ListenerPort -v 8086
You can configure one or more integration servers so that HTTP nodes that you deploy to those integration servers use the embedded listener, or so that SOAP nodes that you deploy to those integration servers use the integration node listener.
Because the option to use the embedded listener is at the integration server level, you can change your configuration such that some integration servers that are associated with an integration node use the integration node listener for HTTP nodes, SOAP nodes, or both, and other integration servers use the embedded listener for HTTP nodes, SOAP nodes, or both.
However, if you disable the integration node listener, the integration server listeners are used for all HTTP and SOAP nodes, even if you have not explicitly enabled support for them.
The HTTPRequest node always communicates directly through the HTTP transport, and is therefore unaffected by your choice.
If you change the listener and port that are processing your HTTP or HTTPS messages, you must ensure that you also update your applications to use the updated configuration.