RTE_TCP_KDEB_INTERFACELIST

Directs all components in the runtime environment to connect to a specific TCP/IP local interface.

The RTE_TCP_KDEB_INTERFACELIST parameter sets the value of the KDS_TEMS_TCP_KDEB_INTERFACELIST and Kpp_AGT_TCP_KDEB_INTERFACELIST parameters.

This parameter offers an easy way to set all components to the same values, rather than setting parameters individually for each component.

If the z/OS® image has more than one TCP/IP interface or network adapter, you can use this parameter to direct components to connect to a specific TCP/IP local interface.

Required?

No

Default value

!* (exclamation point followed by an asterisk)

Runtime members

See the KppENV member of the RKANPARU library.

Values

Character string, maximum length 44, specifying one or more network interfaces to use.

To set a network interface list, supply one of the following values:

  • The host name or IP address of the preferred interface.
  • A list of host names or IP addresses, in descending order of preference. Use a blank (space) to separate the entries.
  • An asterisk (*) to prefer the interface associated with the default host name for the z/OS image. To display this value, enter TSO HOMETEST at the command line.
  • An exclamation point followed by an asterisk (!*) to use only the interface associated with the default host name for the z/OS image.
  • An exclamation point followed by a host name or IP address (!hostname) to use only the interface associated with hostname.
Note:
  • If you set the value of this parameter to !* or !hostname, you must specify the same value for every component and product configured in all runtime environments on the same z/OS image.
  • In the default character set (LANG=en_US.ibm-037), the code for an exclamation point is x'5A'. If you are using a character set other than the default, a different character might map to that code. To require a specific network interface, use the character that maps to x'5A' in your character set.

For a high-availability hub, specify the value of this parameter as !dvipa_hostname, where dvipa_hostname is the private DVIPA name set for the KDS_TEMS_TCP_HOST parameter.