Parameter values for TCP/IP server connections

You can change the connection behavior for TCPIPServer nodes by using the mqsichangeproperties command.

Any changes that you make affect current connections in the integration server, and are temporary. When the integration server is next started, all connections are active again.

TCP/IP connection behavior is managed by the server connection manager. To change the connection properties, you must run mqsichangeproperties and specify the integration node name, -o, and the -n or -v parameters.

  • The -o parameter represents the TCP/IP connection behavior that you want to change. The action is expressed in the following format:

    -o TCPIP/<action>/Server

    Where <action> can take one of the following values:

    • Start. Starts connections to the TCP/IP server.
    • Stop. Forcibly stops all connections to the connection manager, and no new connections are made. TCPIPServerOutput and TCPIPServerReceive nodes will return error BIP3567. A TCPIPServerInput node waits for new data from connections.
    • Quiesce. Quiescing stops new connections from being made. You must supply a timeout value for the quiesce by specifying -n quiesceTimeoutSec, otherwise, the quiesce continues until all clients have disconnected.
  • The -n parameter represents the connection methods, and takes the following values:
    • port. Use port if the TCP/IP server connection is defined by a port number. Use -v to provide the port number.
    • TCPIPServer. Use TCPIPServer if you are using a TCP/IP configurable service to manage the connection. Use -v to provide the name of the TCP/IP configurable service.
    • quiesceTimeoutSec. If you are quiescing the connection, you must set quiesceTimeoutSec, or else the quiesce continues forever. If the quiesce is not completed before the timeout, then the connections are forcibly closed. Use -v to provide the timeout value in seconds.
For example, change the TCP/IP connection manager to start the server connection on port 1445:
mqsichangeproperties IBNODE -e default -o TCPIP/start/Server -n port -v 1445
Change the TCP/IP connection manager to stop the server connection on port 1445:
mqsichangeproperties IBNODE -e default -o TCPIP/stop/Server -n port -v 1445
Change the TCP/IP connection manager to quiesce the server connection on port 1445. In this example, the timeout has a value of 30 seconds:
mqsichangeproperties IBNODE -e default -o TCPIP/quiesce/Server -n port,quiesceTimeoutSec -v 1445,30