Configuring properties for TCP/IP

If you are deploying message flows that contain TCP/IP Nodes, and those nodes use a configurable service, set up your TCPIPClient/Server configurable services before the message flows are deployed.

Before you begin

Procedure

  • To create a TCPIPClient configurable service, use the web user interface or the mqsicreateconfigurableservice command, as shown in the following example. There is no need to stop and start the integration server for changes to a TCPIPClient configurable service to take effect.
    This example creates a TCPIPClient configurable service named myTCPIPClientConfigurableServiceName that connects to the TCP/IP host localhost, and uses port12345 for the connections into that server:
    mqsicreateconfigurableservice myBroker -c TCPIPClient -o myTCPIPClientConfigurableServiceName -n Hostname,Port -v localhost,12345
    BIP8071I: Successful command completion.  
  • To change the properties of a TCPIPClient configurable service, use the web user interface or the mqsichangeproperties command, as shown in the following example. There is no need to stop and start the integration server for changes to a TCPIPClient configurable service to take effect.
    This example changes the connections that are used by the TCPIPClient configurable service myTCPIPClientConfigurableServiceName.
    mqsichangeproperties myBroker -c TCPIPClient -o myTCPIPClientConfigurableServiceName -n Hostname,AlternativePort -v newhost,otherhost:45678
    BIP8071I: Successful command completion.  
  • To create a TCPIPServer configurable service, use the web user interface or the mqsicreateconfigurableservice command, as shown in the following example. You must stop and start the integration server for changes to a TCPIPServer configurable service to take effect.
    This example creates a TCPIPServer configurable service named myTCPIPServerConfigurableServiceName that listens on port 12345, and has a maximum of 1000 connections into that server:
    mqsicreateconfigurableservice myBroker -c TCPIPServer -o myTCPIPServerConfigurableServiceName -n Port,MaximumConnections -v 12345,1000
    BIP8071I: Successful command completion.  
  • To change the properties of a TCPIPServer configurable service, use the web user interface or the mqsichangeproperties command, as shown in the following example. You must stop and start the integration server for changes to a TCPIPServer configurable service to take effect.
    This example changes the connections that are used by the TCPIPServer configurable service myTCPIPServerConfigurableServiceName.
    mqsichangeproperties myBroker -c TCPIPServer -o myTCPIPServerConfigurableServiceName -n Port,ExpireConnectionSec -v 54321,60
    BIP8071I: Successful command completion.  
  • To configure a TCPIPClient socket to make 100 connections at deployment or startup time, use the mqsicreateconfigurableservice command. By default, the client connections are not made until they are required by one of the TCP/IP nodes. There is no need to stop and start the integration server for changes to a TCPIPClient configurable service to take effect.
    In this example, the TCPIPClient configurable service called Task10 is configured to run on port 14150, and 100 connections are created.
    mqsicreateconfigurableservice IBNODE -c TCPIPClient -o Task10 
    -n Port,MinimumConnections -v 14150,100
  • To configure a TCPIPServer socket so that connections expire after a specified time, use the mqsicreateconfigurableservice command. The TCP/IP node can specify either the port to be used or the name of the configurable service. You must stop and start the integration server for changes to a TCPIPServer configurable service to take effect.
    In this example, the TCPIPServer configurable service called Task9 is configured to run on port 14149. The connections expire when they have not been used for 5 seconds.
    mqsicreateconfigurableservice BRK6 -c TCPIPServer -o Task9 
    -n Port,ExpireConnectionSec -v 14149,5