Define Optional TCP/IP System Resources

In order for the UPSTREAM Client to communicate with UPSTREAM z/OS Storage Server, two pieces of information are required:

  • The network address of the z/OS Storage Server, usually expressed as 4 decimal numbers separated by periods (e.g., 152.12.93.1). During UPSTREAM startup. the default TCP/IP FDR/UPSTREAM z/OS Storage Server address is displayed, but this address may not be correct for every Client if you have multiple TCP/IP interfaces to the mainframe. When configuring UPSTREAM for TCP/IP on an Client, verify this address with the system programmer or network administrator responsible for TCP/IP on your system.
  • A “well-known port” number, within your TCP/IP z/OS Storage Server system, on which UPSTREAM listens for requests from the Client. By default, UPSTREAM uses port 1972, but this can be changed in the UPSTREAM configuration (UPSTREAM ISPF option 4).

The address and port number need to be supplied when the Client software is configured using TCP/IP (but the port number there also defaults to 1972).

UPSTREAM uses the well-known port number you assign (or the default of 1972) as long as that port is not already in use by some other application. During UPSTREAM testing, that port will probably be available, so no TCP/IP changes are required, but when UPSTREAM is in production, you probably want to reserve that port number to ensure it is always available when UPSTREAM is started.

For IBM's TCP/IP, you need to edit the TCP/IP profile data set. Check with your TCP/IP systems programmer for the name of this data set (probably “TCPIP.PROFILE.TCPIP”). Find the PORT statement in that profile, and add a line as shown below, where 1972 is the port number, TCP is the protocol, and “UPSTREAM” is the name of the UPSTREAM started task (usually the name of the cataloged procedure used to start UPSTREAM). The text after the # is comments:

1972 TCP UPSTREAM#       *well-known port for FDR/UPSTREAM

If the port number is in use by another task when z/OS Storage Server is started, or (for IBM TCP/IP) if the task name in the reserved port list does not match the actual UPSTREAM task name, you will receive a message (from UPSTREAM) indicating that the port is in use. In that case, TCP/IP access is not available until the situation is corrected and FDR/UPSTREAM z/OS Storage Server is restarted.

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*