Usage Note 58546: Controlling which TCP/IP ephemeral ports SAS®9 uses under z/OS
SAS® components that perform network communications use TCP/IP ephemeral ports. These ports are typically used only within the host system where they are allocated and therefore usually do not need to be opened on a firewall.
SAS features that use ephemeral ports include the following:
- SAS code that acts as a client:
- FILENAME FTP engine
- FILENAME EMAIL engine
- the HTTP procedure
- a SAS/CONNECT® client that issues a SIGNON statement
- SAS Spawner environments such as the following:
- SAS/CONNECT Spawner
- SAS® Integration Technologies Object Spawner
- the servers that they spawn
Controlling Ephemeral Ports on z/OS
Beginning with z/OS 2.1, IBM introduced the TCP/IP EPHEMERALPORTS parameter . When you configure this parameter, SAS clients, Spawners, and Servers will use the ephemeral port range defined by EPHEMERALPORTS.
If you need to restrict the range further, or if EPHEMERALPORTS is not implemented, you can set the following TK environment variables in the TKMVSENV file allocated to the SAS session:
- set TCP_EPH_MAP_ENABLED=1
- set TCP_EPH_MAP_FIRST=beginning-of-port-range
- set TCP_EPH_MAP_LAST=end-of-port-range
Notes:
- Starting with SAS 9.2, the default setting is
TCP_EPH_MAP_ENABLED=1.
- The SAS/CONNECT Spawner’s SASDAEMONPORT does not honor the SAS environment variables
TCP_EPH_MAP_FIRST and TCP_EPH_MAP_LAST. To dedicate the SASDAEMONPORT, use the Spawner’s -SASDAEMONSERVICE parameter.
- If the SAS environment variables (
TCP_EPH_MAP_FIRST and TCP_EPH_MAP_LAST) specify a port range that differs from the TCP/IP EPHEMERALPORTS parameter, SAS client code and SAS servers will use the SAS defined range.
Operating System and Release Information
| SAS System | Base SAS | z/OS | 9.2 | | 9.2 TS2M0 | |
| z/OS 64-bit | 9.2 | | 9.2 TS2M0 | |
| Microsoft® Windows® for 64-Bit Itanium-based Systems | 9.2 | | 9.2 TS2M0 | |
| Microsoft Windows Server 2003 Datacenter 64-bit Edition | 9.2 | | 9.2 TS2M0 | |
| Microsoft Windows Server 2003 Enterprise 64-bit Edition | 9.2 | | 9.2 TS2M0 | |
| Microsoft Windows XP 64-bit Edition | 9.2 | | 9.2 TS2M0 | |
| Microsoft® Windows® for x64 | 9.2 | | 9.2 TS2M0 | |
| Microsoft Windows Server 2003 Datacenter Edition | 9.2 | | 9.2 TS2M0 | |
| Microsoft Windows Server 2003 Enterprise Edition | 9.2 | | 9.2 TS2M0 | |
| Microsoft Windows Server 2003 Standard Edition | 9.2 | | 9.2 TS2M0 | |
| Microsoft Windows Server 2003 for x64 | 9.2 | | 9.2 TS2M0 | |
| Solaris for x64 | 9.2 | | 9.2 TS2M0 | |
| OpenVMS on HP Integrity | 9.2 | | 9.2 TS2M0 | |
| Linux for x64 | 9.2 | | 9.2 TS2M0 | |
| Linux | 9.2 | | 9.2 TS2M0 | |
| HP-UX IPF | 9.2 | | 9.2 TS2M0 | |
| 64-bit Enabled Solaris | 9.2 | | 9.2 TS2M0 | |
| 64-bit Enabled HP-UX | 9.2 | | 9.2 TS2M0 | |
| 64-bit Enabled AIX | 9.2 | | 9.2 TS2M0 | |
| Windows Vista for x64 | 9.2 | | 9.2 TS2M0 | |
| Windows Vista | 9.2 | | 9.2 TS2M0 | |
| Microsoft Windows XP Professional | 9.2 | | 9.2 TS2M0 | |
| Microsoft Windows Server 2008 for x64 | 9.2 | | 9.2 TS2M0 | |
| Microsoft Windows Server 2008 R2 | 9.2 | | 9.2 TS2M0 | |
*
For software releases that are not yet generally available, the Fixed
Release is the software release in which the problem is planned to be
fixed.
| Date Modified: | 2026-02-16 15:00:28 |
| Date Created: | 2016-07-01 17:56:29 |