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
-
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
- Enter the following MVS command from SDSF, where procname is the name of the
TCP/IP stack:
-
Configure the shared port in z/OS to use
SHAREPORTWLM
.-
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
-
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.
-
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.
-
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,
ThePORT# PROT USER FLAGS RANGE SAF NAME 1111 TCP ZCHA* DASW
S
flag indicates that the port is shared and theW
flag indicates that the port uses WLM server-specific recommendations. -
Update the existing
httpEndpoint
element in server.xml to use the shared port.For example,<httpEndpoint id="defaultHttpEndpoint" host="*" httpPort="1111" httpsPort="-1" />