Set up TCP/IP port sharing

Set up port sharing so that IBM® z/OS® Connect servers can listen for inbound requests on the same port.

Procedure

  1. Choose an unreserved port number to be used for the servers' HTTP listeners. This scenario uses port 1111 as an example, but it can be changed if that port is already in use in your environment.
    To display ports that are currently reserved on a single TCP/IP stack, use one of the following methods:
    • Enter the following MVS command from SDSF, where procname is the name of the TCP/IP stack:
      /D TCPIP,<procname>,N,PORTL
    • Enter the UNIX System Services command:
      netstat -o
  2. Configure the shared port in z/OS to use SHAREPORTWLM.
    1. In the TCP/IP profile for the z/OS LPAR, add or update an existing PORT statement to add an entry for the HTTP port that the server listens on.
      In this scenario, port 1111 was chosen, with started task job names that start with "ZCHA" and the SHAREPORTWLM option to allow WLM to manage the incoming workload. The shared port definition in the TCP/IP port profile is as follows.
      PORT 
      1111 TCP ZCHA* SHAREPORTWLM 
    2. Enable the shared port definition.
      Enter the following MVS command from SDSF:
      VARY TCPIP,<procname>,OBEYFILE,<datasetname>
      For further instructions, see the description of the VARY TCPIP,,OBEYFILE command in the z/OS Communications Server: IP System Administrator's Commands documentation.
  3. Confirm that the shared port is active by displaying the ports as you did in Step 1.
    Display ports that are currently reserved on a single TCPIP stack, use one of the following methods.
    For example,
    
    PORT#   PROT   USER FLAGS   RANGE SAF NAME 
    1111   TCP    ZCHA*  DASW 
    
    The S flag indicates that the port is shared and the W flag indicates that the port uses WLM server-specific recommendations.
  4. Update the existing httpEndpoint element in server.xml to use the shared port.
    For example,
    <httpEndpoint id="defaultHttpEndpoint" host="*" httpPort="1111" httpsPort="-1" />