Resolution:
On z/OS systems running more than one TCP/IP stack, customers need to be able to specify which stack should be used for communications. This article describes how to specify a stack name using XML to the TCP/IP RELAY Parameter File.

Revision Log:
    May 26, 2010 This solution is being re-issued as the original XML statements did not get published correctly.
    May 27, 2010 This solution is being re-issued to correct a minor error in formatting XML statements for publishing.

Environment:
z/OS systems running TIBCO Object Service Broker for z/OS 5.0.0 with more than one TCP/IP stack.

Resolution:
TCP/IP support has been completely redesigned in TIBCO Object Service Broker for z/OS 5.0.0 to make it more efficient. The network definitions were also changed from an assembly based construct to a more dynamic XML based format.

If you look in the "TIBCO® Object Service Broker for z/OS Installing and Operating Software Release 5.0", "Appendix B Configuring Communications", section "TCP/IP Protocol Parameters for the RELAY Parameter File", on page 384, you will see that you can specify a parameter "tcpname=" to identify the TCP/IP stack to use.

So for example, to change usage from the default TCP/IP stack to one called "TCPROD" you would change the TCP/IP Relay file definition from:

- - - - - - - - -
From:

<relay xmlns="http://www.tibco.com/OSB/relayparms.xsd">
<tcpipparms tcbnum="3" maxtcbsockets="50" />
<directory>
  <node name="S6ELDOBA">
  <tcpip host="STAR.NA.TIBCO.COM" port="10065" />
  </node>
  <node name="S6ELNEEA">
  <tcpip host="LION.NA.TIBCO.COM" port="10067" />
  </node>
</directory>
</relay>

- - - - - - - - -
To:

<relay xmlns="http://www.tibco.com/OSB/relayparms.xsd">
<tcpipparms tcbnum="3" maxtcbsockets="50" tcpname="TCPROD" />
<directory>
  <node name="S6ELDOBA">
  <tcpip host="STAR.NA.TIBCO.COM" port="10065" />
  </node>
  <node name="S6ELNEEA">
  <tcpip host="LION.NA.TIBCO.COM" port="10067" />
  </node>
</directory>
</relay>

- - - - - - - - -

by including tcpname="TCPROD" in the second line.


References:
1) TIBCO® Object Service Broker for z/OS Installing and Operating Software Release 5.0, "Appendix B Configuring Communications", section "Configuring TCP/IP".

How can we specify a specific TCP/IP stack in the TCP/IP Relay Parameter File?