IBM TCP/IP Version 3 Release 2 for MVS/ESA

September 10, 1996
Announcement Number: 296-317


Document's Table of Contents:




At a Glance

Highlights of IBM TCP/IP Version 3 Release 2 for MVS/ESA:

  • High performance native sockets

  • Exploitation of MVS architecture with improvements in:
      Performance Reliability Diagnostic information
  • Fault tolerant attachment
      Virtual IP addressing Traffic splitting RouteD enhancements
  • Enhanced National Language Support

  • Network Print Facility (NPF) FIFO support

  • Enhanced Multiple TCP/IP stack support

  • Dynamic Buffer Management

  • Internet protocol over Channel Data Link Control (IP/CDLC)

  • Dynamic four-digit device address

  • Restartable Virtual Machine Communication Facility (VMCF) and Termination Notification Facility (TNF) enhancements



Overview

IBM TCP/IP Version 3 Release 2 for MVS/ESA(TM) brings the power and resources of your S/390(R) to the Internet and open multivendor networking environments. IBM TCP/IP Version 3 Release 2 for MVS/ESA provides extensive application support including client/server applications, industry-standard application programming interfaces, and network connectivity options. Applications and data can be shared transparently across MVS(R), UNIX, VAX, OS/2(R), Windows+ 95, Windows NT, Windows 3.1, VM, AIX(R), DOS and other environments. TCP/IP industry-standard applications enable the user to send messages, transfer files, share printers, and access remote resources. TCP/IP Version 3 Release 2 also includes support to connect CICS(TM), IMS(TM), and DB2(R) applications, as well as other mission critical functions, to the customer's TCP/IP or Internet network.

TCP/IP is an integral part of IBM's networking blueprint to provide open, multivendor, multiprotocol solutions.

As TCP/IP continues to evolve into the commercial and networking infrastructure, IBM's support will meet the challenge of these new customer environments.

IBM TCP/IP Version 3 Release 2 for MVS/ESA restructures the cross address space communications support and includes new functions that make it easier to write user application programs. TCP/IP Version 3 Release 2 directly exploits the MVS/ESA architecture, significantly improves performance, provides numerous availability/recovery enhancements, has additional accounting capability, more diagnostic information, and improved management capability.



Intended Customers

IBM TCP/IP Version 3 Release 2 for MVS/ESA is provided for MVS/ESA, OpenEdition(R), and OS/390(TM) customers with Internet, multivendor or multiprotocol networking requirements. TCP/IP Version 3 Release 2 provides both open networking connectivity with an MVS system and TCP/IP-based applications that many businesses require such as file transfer, mail, CICS Sockets, IMS Sockets, DB2 access, fault tolerant network attach, and remote logon.



Key Prerequisites

TCP/IP Version 3 Release 2 is designed to operate on any IBM processor that supports MVS/SP(TM) Versions 4.3 or later, or OS/390. The amount of storage required depends on the configuration options.

Basic product functions require MVS/SP Versions 4.3 or later, or OS/390. Other software may be required depending on the applications and optional features.

Planned Availability Date

September 27, 1996



DESCRIPTION

IBM TCP/IP Version 3 Release 2 (V3R2) for MVS/ESA provides the following new and enhanced applications, services, and functions for S/390 hosts on a TCP/IP network.



High Performance Native Sockets (HPNS)

HPNS is a new function, for key TCP/IP application program interfaces (APIs), which directly exploits the MVS/ESA architecture. HPNS is the base for TCP/IP Version 3 Release 2 performance and RAS improvements by avoiding the invocation of the IUCV/VMCF path. Path length and CPU cycles are significantly reduced in the S/390 host.

Applications written on previous versions of TCP/IP for MVS can run unchanged.

Applications written to the following API's, previously shipped with IBM TCP/IP Version 3 Release 1 for MVS, will benefit from the HPNS function if relinked with the V3R2 version of the sockets libraries.

  • C Socket API
  • C Socket API for CICS
  • CALL Instruction API
  • CALL Instruction API for CICS
  • CALL Instruction API for IMS
  • Macro API (Additional performance benefit if application programs written to this API are also reassembled with the V3R2 version of the sockets libraries.)
Note: Once the socket programs have been relinked to exploit the HPNS function and IBM TCP/IP Version 3 Release 2 for MVS/ESA, they will not be compatible with prior releases of TCP/IP.

Applications programmed to the Virtual Machine Communication Facility (VMCF) and Inter-User Communication Vehicle Sockets (IUCV) interfaces will continue to run on IBM TCP/IP Version 3 Release 2 for MVS/ESA unchanged. To gain the performance improvements, customers should migrate any application written to the VMCF or IUCV interfaces to use C Socket API, C Socket API for CICS, CALL Instruction API, CALL Instruction API for CICS, CALL Instruction API for IMS, or Macro API as described above.

Note: IBM TCP/IP V3R2 for MVS/ESA is the last release that will support the IUCV and VMCF interfaces.

OpenEdition users who plan to migrate applications written to the VMCF or IUCV interfaces should consider OpenEdition integrated sockets which will also improve the application performance.

The following IBM supplied TCP/IP applications are shipped with IBM TCP/IP V3 R2 for MVS/ESA enabled for HPNS:

    C File Transfer Protocol (FTP) Server
    Kerberos
    Line Printer Redirector (LPR) Client
    MISCSERV
    NCPROUTE
    Network Computing System (NCS) interface
    Network Database Client/Server
    Portmapper (Sun RPC) Server
    RouteD Server
    Remote Execution Server (REXEC)
    Remote Procedure Call (RPC)
    Simple Network Management Protocol (SNMP) Agent
    X Window Client
Enhanced Programming Capability with HPNS: All the interfaces enabled for HPNS have been re-written to improve performance. New functions are included that simplify the client application programming by consolidating previous functions into fewer calls. MVS Access List Entry Token (ALET) support provides flexibility for the programmer and reduced data moves thereby improving performance. Programs written in C++ are supported with the C Sockets library.

New User Exits: TCP/IP Version 3 Release 2 provides new flexibility for programs coded to the macro API. Programmers now have the capability to do application recovery via a new exit that is called when an unsolicited event takes place. In addition, upon completion of any function, you can specify to either invoke an exit or post an Event Control Block (ECB).



Reliability, Availability, and Serviceability Enhancements

Numerous enhancements in this release improve the reliability, availability and serviceability of the TCP/IP stack and its applications. IBM TCP/IP Version 3 Release 2 for MVS/ESA reduces the time required for problem solving with new MVS standard traces (component trace), IPCS trace formatting, and EBCDIC eyecatchers including service information in control blocks and modules. System debuggers can now dynamically trace problems through several key components.

Control block eyecatchers aid diagnosticians and new IPCS formatting ability allows the viewing of problem data areas. TCP/IP Version 3 Release 2 HPNS interfaces now issue standard MVS dumps with information designed to aid in faster problem diagnosis. The TCP/IP stack now recovers from certain failures. All application recovery routines have been enhanced, now TCP/IP Version 3 Release 2 provides specific error numbers (errnos) to application programmers instead of abending the program. In addition, new messages have been added where applicable to more fully explain error conditions.

Other changes in this release aid in accounting. TCP/IP Version 3 Release 2 provides additional SMF data. Data movements occur under the application task and more TCP/IP processing runs at application priority; this makes it possible to allocate data processing costs to the applications that are using the resources.



NPF FIFO Support

NPF has been modified so that print jobs that are sent to a given printer will be sent in a predictable FIFO (First-In, First-Out) order, based on the times at which they are received by NPF. For information on an enhanced Netspool and a new TCP/IP print component, IP PrintWay, refer to Software Announcement 296-328, dated September 10, 1996.



Enhanced Multiple TCP/IP Stack Support

TCP/IP Version 3 Release 2 allows you to run up to eight TCP/IP stacks in one system image, allowing you to dedicate a stack to a particular key application or set of applications to support your business needs.



National Language Support

IBM TCP/IP Version 3 Release 2 for MVS/ESA enhances double-byte character set (DBCS), and single-byte character set (SBCS) support for the following applications: LPD Server, LPR, FTP Server and client, SMTP, W-Windows, JTelnet, CICS, IMS, NDB (RPC and XDR), NPF ISPF Panels. The following new code pages are supported:

  • Big-5, a multibyte PC code page, defined by several software companies in the Republic of China.
  • Simplified Chinese
  • Korean Standard
  • SBCS Kana (EUC KANA G2)
The Line Print Daemon (LPD) server supports the printing of a file with both SBCS and DBCS characters.

There is more flexibility in the selection of the SBCS tables used for DBCS FTP data transfers. Prior to TCP/IP Version 3 Release 2, the SBCS translation table used for DBCS data transfer was determined by the particular DBCS data type selected. Now you can specify the SBCS and the DBCS translation tables you want used.



IP over Channel Data Link Control

The IP over Channel Data Link Control (CDLC) function provides direct IP communication across the channel to 3745/3746 devices running NCP V7R3, or higher, or 3746 Model 950. This enhancement reduces host CPU cycles and improves throughput, when compared to using SNALINK, by sending and receiving IP datagrams natively on the channel, rather than encapsulated in SNA frames.

This function has been made available for IBM TCP/IP Version 3 Release 1 for MVS via PTF.



Fault Tolerant Network Attachment

Enhancements to RouteD (the dynamic route update server) and support for virtual addresses enhance availability. Additional RouteD enhancements provide routing control functions.

Virtual IP addressing (VIPA) frees TCP/IP hosts from dependence on particular network attachments to MVS. It provides an IP address that selects a TCP/IP stack without selecting a specific network attachment. Multiple virtual IP addresses can be defined for a TCP/IP stack.

RouteD provides automatic and transparent recovery from controller, interface, and network failures. RouteD supports defining primary and alternate interfaces to the same (sub)net and supports dynamic switch of network traffic to backup controllers and interfaces. Now RouteD can speed up down-stream route switching in certain configurations. A number of new RouteD input and output filters and processing options provide more control over routing. For instance, you can use traffic splitting to use one interface for inbound traffic, another for outbound traffic.

These functions have also been made available on IBM TCP/IP Version 3 Release 1 for MVS via PTF.



Dynamic Buffer Management

Dynamic buffer management provides improved storage management. It is no longer necessary to initially allocate the maximum space required for TCP/IP buffers. Now TCP/IP will expand and contract the amount of storage used for input/output buffers based on the current application needs, enabling you to better support peak demand and also freeing storage for other business applications in periods of lower demand.

This function has also been made available on IBM TCP/IP Version 3 Release 1 for MVS via PTF.



Restartable VMCF and TNF Enhancements

VMCF and TNF are two MVS address spaces that contain tables used by the TCP/IP system. Prior to these enhancements, an MVS IPL was required to activate changes to these tables. With this release of TCP/IP you can modify these tables without an MVS IPL. Additional functions provided by the enhancements include:

  • New procedures, commands, and messages that make both subsystems restartable

  • Error detection of subsystem initialization problems

  • Capability to allow the system name to be changed on restart

  • Ability to display current users and to remove users from the VMCF and TNF tables

  • Ability to request proper termination of the subsystem
This function has also been made available on IBM TCP/IP Version 3 Release 1 for MVS via PTF.



Dynamic UCBs/4-digit Device Addresses

With IBM TCP/IP V3 R2 for MVS/ESA it is now possible to define TCP/IP communications devices such as 3172, CTCA, 374X, RS/6000(TM) using 4-digit device addresses. This provides more I/O generation flexibility to customers with large I/O configurations. Dynamic device definition no longer requires an IPL for changes to devices used by IBM TCP/IP Version 3 Release 2 for MVS/ESA.

This function has also been made available on IBM TCP/IP Version 3 Release 1 for MVS via PTF.



Summary of TCP/IP Version 3 Release 2 Functions

Below is a list of some of the available functions of IBM TCP/IP for MVS.

TCP/IP Client/Server Applications

  • File Transfer Protocol (FTP)
  • TELNET Protocol
  • Simple Mail Transfer Protocol (SMTP)
  • Network Database Client/Server
  • Line Printer Redirector/Line Printer Daemon Support
  • X Window System
  • Network File System

    This distributed data storage technique is provided as part of the Data Facility System Managed Storage/MVS (DFSMS/MVS(R)) product.

  • REXEC Client/Server
TCP/IP Application Development Services
  • Remote Procedure Call (RPC) libraries (Sun -- Open Network Computing)
  • Sockets Extended
      C Socket API CALL Instruction API
  • Macro API
  • Network Computing System (NCS) interface

    NCS is a programmer toolkit that allows programmers to distribute processing power to other hosts. NCS is similar to RPC in that it allows a higher level of program calls.

TCP/IP Management Services
  • Simple Network Management Protocol (SNMP)
  • Routing Information Protocol (RIP) (RouteD)
  • Domain Name Server (DNS)
  • NCPROUTE
  • Portmapper (RPC)
Optional Features

The following priced and unpriced features are available with IBM TCP/IP Version 3 Release 2 for MVS/ESA:

  • CICS-to-TCP/IP Sockets interface (optional feature)
  • IMS-to-TCP/IP Sockets interface (optional feature)
  • Kerberos Security Services (specify feature)

    Kerberos provides a security function that allows a client/server pair to verify the authenticity of its partner. In order to communicate with the Kerberos server, the client/server application pair must use the Kerberos libraries/Kerberos ticket-granting services.

  • Network Print Facility (specify feature)
  • Offloading of TCP/IP protocol processing (optional feature)
  • OpenEdition MVS Applications (specify feature)

    OpenEdition MVS allows you to write applications to UNIX-based open, vendor independent standards and provides support for Telnet, FTPD, REXECD, REXEC, Remote Shell Server, Remote Procedure Call, X Window Client, and OSF/Motif.



PRODUCT POSITIONING

TCP/IP is today's primary choice as an open multivendor networking protocol. It is the key networking protocol supporting communications on the Internet. The selection of TCP/IP allows customers to connect multivendor systems to optimize their computing system resources.

TCP/IP is an integral part of the Communications Server for OS/390. IBM TCP/IP Version 3 Release 2 for MVS/ESA will be integrated in OS/390 Release 3. Customers with OS/390 Release 1 or Release 2 are able to order a IBM TCP/IP Version 3 Release 2 for MVS/ESA at no additional charge and receive the benefits of this release immediately.

IBM TCP/IP Version 3 Release 2 for MVS/ESA enhances the IBM family of TCP/IP products, which include TCP/IP on MVS, VM, OS/2, OS/400, DOS, the AIX family, Internet Connection for Windows, and the System/88.

Customers with TCP/IP networks in place or planned should install TCP/IP Version 3 Release 2 to gain significantly improved performance and reduced CPU cycles, many improvements in reliability, availability and serviceability, along with other enhanced function.

Customers installing TCP/IP Version 3 Release 2 will gain additional benefits by utilizing a single, industry-standard applications interface based on Berkley Software Distribution Sockets (BSD R4.3) with IBM-provided TCP services, CICS, IMS, DB2 and user-written programs.

TCP/IP Version 3 for MVS is a prerequisite of MVS/ESA SP Version 5 OpenEdition Distributed Computing Environment Base Services feature first announced on April 6, 1994, in Software Announcement 294-152, providing an object oriented, UNIX application environment for the S/390. (OpenEdition is also an element of OS/390.)

TCP/IP Version 3 for MVS is a prerequisite of IBM Internet Connection Server for MVS/ESA announced October 31, 1995, in Software Announcement 295-462, providing a ideal platform for an internet or intranet web server.

Users of IBM TCP/IP Version 2 for MVS should consider moving to TCP/IP Version 3 Release 2 to obtain Network Print Facility, Telnet server enhancements, IMS access to TCP/IP, improved application program interfaces, expanded NLS/DBCS features, and improved performance, availability, manageability and serviceability.

Users with SNA networks can install TCP/IP on their host processors and use their existing SNA wide area backbone to transmit TCP/IP traffic between IBM TCP/IP hosts via a parallel or ESCON(R) channel capitalizing on the SNA investment.

Refer to Software Announcement 296-328 for information on an enhanced Netspool and a new TCP/IP print component, IP PrintWay. NetSpool combined with IP PrintWay should be considered IBM's strategic replacement for NPF. Significant future enhancements are not planned for NPF.

Note: IBM TCP/IP Version 3 Release 2 for MVS/ESA does not include the Pascal FTP server as stated in Software Announcement 294-529, dated September 13, 1994. Customers should migrate to the C FTP server prior to installing TCP/IP Version 3 Release 2.



EDUCATION SUPPORT

The IBM education offerings updated to include information regarding IBM TCP/IP Version 3 Release 2 for MVS/ESA, include:

    G3787 TCP/IP Networking Workshop

    G3886 TCP/IP for MVS and VM Implementation

Call IBM Education and Training at 800-IBM-TEACH (426-8322) for education catalogs, schedules and enrollments.



REFERENCE INFORMATION

Open Blueprint(TM): IBM TCP/IP Version 3 Release 2 for MVS/ESA provides the capability for distributed parts of an application or applications to request service from the other part and await reply. Its implementation is consistent with the RPC function described in IBM's Open Blueprint. It supports the Distributed Computing Environment (DCE) RPC industry-standard interface from X/Open to facilitate open, distributed, multivendor interoperability.

The standards supported and implemented comprehensively include the TCP/IP network and application protocols. Many features of TCP/IP Version 3 Release 2 are based, in part, on the following Requests for Comments (RFCs). Refer to the product documentation for specific information.

768       User Datagram Protocol
791       Internet Protocol
792       Internet Control Message Protocol
793       Transmission Control Protocol
821       Simple Mail Transfer Protocol
822       Standard for the Format of ARPA Internet Text
           Messages
823       DARPA Internet Gateway
826       Ethernet Address Resolution Protocol or
           Converting Network Protocol Addresses to
           48 Bit Ethernet Address for Transmission on
           Ethernet Hardware
854       Telnet Protocol Specification
856       Telnet Binary Transmission
857       Telnet Echo Option
862       Echo Protocol
863       Discard Protocol
864       Character Generator Protocol
877       Standard for the Transmission of IP Datagrams
           over Public Data Networks
885       Telnet End of Record Option
903       Reverse Address Resolution Protocol
904       Exterior Gateway Protocol Formal
           Specification
919       Broadcasting Internet Datagrams
922       Broadcasting Internet Datagrams in the
           Presence of Subnets
950       Internet Standard Subnetting Procedure
952       DOD Internet Host Table Specification
959       File Transfer Protocol
974       Mail Routing and the Domain Name System
1009      Requirements for Internet Gateways
1013      X Window System Protocol, Version 11:
           Alpha Update
1014      XDR: External Data Representation Standard
1027      Using ARP to Implement Transparent Subnet
           Gateways
1032      Domain Administrators Guide
1033      Domain Administrators Operations Guide
1034      Domain Names -- Concepts and Facilities
1035      Domain Names -- Implementation and
           Specification
1042      Standard for the Transmission of IP
           Datagrams over IEEE 802 Networks
1044      Internet Protocol on Network System's
           HYPERchannel: Protocol Specification
1055      Nonstandard for Transmission of IP Datagrams
           over Serial Lines: SLIP
1057      RPC: Remote Procedure Call Protocol
           Version 2 Specification
1058      Routing Information Protocol
1091      Telnet Terminal-Type Option
1094      NFS: Network File System Protocol
           Specification
1118      Hitchhikers Guide to the Internet
1122      Requirements for Internet
           Hosts -- Communication Layers
1123      Requirements for Internet
           Hosts -- Application and Support
1155      Structure and Identification of Management
           Information for TCP/IP-Based Internets
1156      Management Information Base for Network
           Management of TCP/IP-based Internets
1157      Simple Network Management Protocol (SNMP)
1179      Line Printer Daemon Protocol
1180      TCP/IP Tutorial
1183      New DNS RR Definitions
           (Updates RFC 1034, RFC 1035)
1187      Bulk Table Retrieval with the SNMP
1188      Proposed Standard for the Transmission of
           IP Datagrams over FDDI Networks
1198      FYI on the X Window System
1207      FYI on Questions and Answers: Answers to
           Commonly Asked "Experienced Internet User"
           Questions
1208      Glossary of Networking Terms
1213      Management Information Base for Network
           Management of TCP/IP-Based Internets:
           MIB-II
1215      Convention for Defining Traps for Use with
           the SNMP
1228      SNMP-DPI Simple Network Management Protocol
           Distributed Program Interface
1229      Extensions to the Generic-Interface MIB
1230      IEEE 802.4 Token Bus MIB IEEE 802 4 Token
           Bus MIB
1231      IEEE 802.5 Token Ring MIB IEEE 802.5 Token
           Ring MIB
1268      Application of the Border Gateway Protocol
           in the Internet
1269      Definitions of Managed Objects for the
           Border Gateway Protocol (Version 3)
1270      SNMP Communications Services
1325      FYI on Questions and Answers: Answers to
           Commonly Asked "New Internet User"
           Questions
1340      Assigned Numbers
1348      DNS NSAP RRs
1351      SNMP Administrative Model
1352      SNMP Security Protocols
1353      Definitions of Managed Objects for
           Administration of SNMP Parties
1354      IP Forwarding Table MIB
1356      Multiprotocol Interconnect on X.25 and ISDN
           in the Packet Mode
1374      IP and ARP on HIPPI
1381      SNMP MIB Extension for X.25 LAPB
1382      SNMP MIB Extension for the X.25 Packet Layer
1387      RIP Version 2 Protocol Analysis
1388      RIP Version 2 -- Carrying Additional
           Information
1389      RIP Version 2 MIB Extension
1390      Transmission of IP and ARP over FDDI Networks
1393      Traceroute Using an IP Option
1398      Definitions of Managed Objects for the
           Ethernet-like Interface Types
1540      IAB Official Protocol Standards



TECHNICAL INFORMATION



Specified Operating Environment

Hardware Requirements: IBM TCP/IP Version 3 Release 2 for MVS/ESA is designed to operate in a virtual storage environment in any IBM system configuration that supports the operating systems specified in the Software Requirements section.

Attachment of IBM TCP/IP Version 3 Release 2 for MVS/ESA to the network requires one of the following network processors and associated components or equivalent:

  • IBM 3172 Interconnect Controller with the Interconnect Controller Program
  • TCP/IP Offload to IBM 3172 Interconnect Controller Model 003 and its required software
  • IBM 8232 LAN Channel Station
  • IBM Open Systems Adaptor
  • High Performance Parallel Interface (HiPPI)
  • IBM RS/6000(TM) Parallel Channel Attachment
  • IBM RS/6000 ESCON Channel Attachment
  • IBM 3720 Communication Controllers for X.25 or SNALINK without NCP IP Dynamics (NCPROUTE)
  • IBM 3745/46 Communication Controller for:
  • IBM 3746 Model 950 Nways* Multiprotocol Controller
  • HYPERchannel A220 Processor
  • A network attachment device using the Continuously Executing Transfer Interface (CETI)
Software Requirements: IBM TCP/IP Version 3 Release 2 for MVS/ESA requires, at a minimum, operating system MVS/ESA SP Version 4 Release 3 (5695-047 or 5695-048); earlier versions, releases, and modifications are not supported. IBM TCP/IP Version 3 Release 2 for MVS/ESA also operates with MVS/ESA SP Version 5 (5655-068 or 5655-069), OS/390 (5645-001) and later versions, releases, and modifications of these operating systems, unless otherwise stated.

Certain IBM TCP/IP Version 3 Release 2 for MVS/ESA functions require the use of the appropriate level of associated IBM licensed programs. The following TCP/IP Version 3 Release 2 functions have the minimum programming requirements shown below. These functions also operate with later versions and releases of these required programs unless otherwise stated. If you are running IBM TCP/IP Version 3 Release 2 for MVS/ESA on OS/390 (5645-001) many of the programming requirements are included in the OS/390, noted below (OS/390 base or OS/390 optional).

  • To install TCP/IP Version 3 Release 2
    • SMP/E V1.8 or later, (or OS/390 base)
  • For interactive use of all client commands except when running OpenEdition applications on MVS V5.2.2
    • TSO/E V2.5 (5685-025), (or OS/390 base)
  • Telnet and SMTPNOTE require TSO/E V2.5 (5685-025), (or OS/390 base)

  • Telnet server (3270 and line mode) requires ACF/VTAM(R) V3.4.2 for MVS/ESA (5685-085), or later, (or OS/390 base)

  • SNALINK LU0 and LU6.2 support require:
    • ACF/VTAM(R) V3.4.2 for MVS/ESA (5685-085), or later, (or OS/390 base)
    • ACF/NCP V6.3 (5688-231) (Ethernet only), or
    • ACF/NCP V7.1 (5648-063), or later (Ethernet and/or Token Ring)
  • NCPROUTE Server requires:
    • ACF/VTAM V3.4.2 for MVS/ESA (5685-085), or later, (or OS/390 base)
    • ACF/NCP V7.1 (5648-063), or later
    • IBM C/370(TM) Runtime Library V2.2 (5688-188), or
    • IBM AD/Cycle(R) LE/370 Runtime Library V1.3 (5688-198), or later, (or OS/390 base)
  • X.25 Interface Support requires:
    • X.25 NPSI V3.4 (5688-035), or later, for 3745 or 3720
    • X.25 NPSI V2.1 (5668-719) for 3725
  • Domain name server (authoritative mode), Network Database System (NDB) client/server, or FTP DB2 query require DB2 V2.3 (5665-DB2), or later

  • SNMP (monitor) client support requires NetView(R) V1.3 for MVS (5685-152), or later

  • IBM GDDM(R) through X-Windows System requires:
    • GDDM/MVS V2.3 (5665-356), or
    • GDDM/MVS V3.1 (5695-167) or later, (or OS/390 base)
  • FTP Server requires:

    MVS/ESA SP V4.3 or later (or OS/390 base) and one of the following DFP or DFSMS(TM) releases:

    • DFP V3.1 (5665-XA3) or later
    • DFSMS V1.1 (5695-DF1) or later, (or OS/390 base)
    One of the following C runtime libraries:
    • IBM C/370 Runtime Library V2.2 (5688-188)
    • IBM AD/Cycle LE/370 Runtime Library V1.3 (5688-198), or later, (or OS/390 base)
    File access protection for FTP requires RACF(TM) V1.9 (5740-XXH), or later, or equivalent, (or OS/390 optional)

  • CICS Sockets requires CICS/MVS(R) V3.1 (5685-083), or later

  • IMS Sockets requires IMS V4 (5685-013)

  • OS/2 Offload requires:
    • OS/2 Warp Connect 3.0
    • TCP/IP 3.0 for OS/2 (base kit only)
  • IBM TCP/IP V3.2 for MVS functions written in C Language require:
    • IBM C/370 Runtime Library V2.2 (5688-188), or
    • IBM AD/Cycle LE/370 Runtime Library V1.3 (5688-198), or later, or
    • Language Support feature of OpenEdition/MVS (5655-068, 5655-069), (or OS/390 base)
    These functions include:
      C sample programs Domain Name Server FTP C server Kerberos Services LPR MISCSERV NCPROUTE NDB System Client and Server Network Computing System (NCS) Non-OpenEdition X Window System NPF ISPF interface Portmapper server Remote procedure call (RPC) RouteD server RPCinfo SNMP client and server Socket API REXECD REXEC RSH
  • Customer-written programs, if written in C, that interface to:
      X Window System client Remote Procedure Call TCP protocol boundary UDP protocol boundary DPI, or IP protocol boundary
    require the following:
    • IBM C/370 Runtime Library V2.2 (5688-188), or
    • IBM AD/Cycle LE/370 Runtime Library V1R3 (5688-198), or later
    plus one of the following compilers:
    • IBM C/C++ V3.1 for MVS/ESA (5655-121) or later, (or OS/390 optional) , or
    • IBM SAA(R) AD/Cycle C/370 V1.2 (5688-216),
  • Customer-written programs, if written in C++, that interface to the C Sockets Library require the following:
    • IBM AD/Cycle LE/370 Runtime Library V1.4 (5688-198), or later (or OS/390)
    • IBM C/C++ V3.1 for MVS/ESA (5655-121) or later, (or OS/390 optional)
  • Customer-written programs, if written in Pascal, that interface to:
      TCP protocol boundary UDP protocol boundary DPI or IP
    require IBM VS Pascal Compiler and Runtime Library (5668-767)

  • OpenEdition X Window system requires:
    • IBM C/370 Runtime Library V2.2 (5688-188), or
    • IBM AD/Cycle LE/370 Runtime Library V1.3 (5688-198), or later, (or OS/390 base)
  • Network Print Facility requires:
    • ISPF/PDF V3.5 (5665-402) (or OS/390 base)
    • ACF/VTAM V3.4.2 for MVS/ESA (5685-085), or later, (or OS/390 base)
    • JES2 SP 4.2, or later, (or OS/390 base), or
    • JES3 SP 4.2.1, (5695-048) or later, with PTF UY75262, (or OS/390 optional)
    • ACF/NCP V7.1 (5648-063), or later
  • TCP/IP OpenEdition Applications Feature requires:
    • MVS 5.2.2 OpenEdition Shell and Utilities feature, (or OS/390 base)
    • IBM C/C++ for MVS/ESA Language Support feature or Language Environment(R) for MVS and VM Version 1.5 (5688-198), or higher, (or OS/390 optional)
    • FTP requires DFSMS Version 1.2 (5695-DF1) or later, (or OS/390 base)
    • File access protection for FTP requires RACF V2.1 (5695-039) or later, or equivalent, (or OS/390 optional)
    • OE FTP DB2 Query requires DB2 V2.3 (5665-DB2), or higher.
    • IBM C/C++ for MVS/ESA V3.1 (5655-121), or later, (or OS/390 optional),or IBM SAA AD/Cycle C/370 Compiler V1.2 (5688-216) for customer-written programs in C that interface to an OE feature:
      • REXEC, REXECD, RSHD
      • RPC
      • X Window System
Compatibility: IBM TCP/IP Version 3 Release 2 for MVS/ESA is upwardly compatible with IBM TCP/IP Version 3 Release 1 for MVS.

IBM TCP/IP Version 3 Release 2 for MVS/ESA OS/2 Offload Feature is not changed from IBM TCP/IP Version 3 Release 1 for MVS. It is not necessary to reinstall.

As stated Software Announcement 294-529, dated September 13, 1994, this release does not support the Pascal FTP Server.

Performance Considerations

  • TCP/IP Version 3 Release 2 exploits MVS ESA architecture

  • TCP/IP Version 3 Release 2 includes enhanced interfaces which provide significant performance improvement for mission critical IBM supplied TCP/IP applications such as the FTP Server, Telnet, socket applications (CICS, IMS) and user applications written to the HPNS interfaces. TCP/IP Version 3 Release 2 will provide significant reduction in CPU utilization and increased throughput. In addition, initial testing indicates improvements in storage utilization and significant reduction in CPU utilization in a high workload environment. Early TCP/IP Version 3 Release 2 performance information will be available at general availability on the TCP/IP home page at Internet address:
      http://www.raleigh.ibm.com/tcm/tcmprod.html
  • IBM TCP/IP Performance Tuning Guide
    • The performance tuning guide will be updated for TCP/IP Version 3 Release 2 to help customers with monitoring, tuning and capacity planning. Performance measurements are scheduled to be completed after general availability. The updated book is scheduled to be available and autoshipped to customers after general availability.
User Group Requirements: This announcement satisfies or partially satisfies four requirements from one or more of the world wide user group communities, which include Australasian SHARE/GUIDE (ASG), COMMON, COMMON Europe, GUIDE International, G.U.I.D.E. Europe, Japan GUIDE/SHARE (JGS), Guide Latin American (LAG), SHARE EUROPE and SHARE Incorporated.
  • RES001 -- High Performance Native Sockets

  • HDW024 -- Channel Attached Router, IP to IP connection to 3745/3746 across the channel

  • RES006 -- Support for 4-Digit UCB Addresses (names)

  • GAT017 -- Fault Tolerant and load balancing functions



Security, Auditability, and Control

The announced program uses the security and auditability features of the MVS operating system.

The security and auditability feature of TCP/IP Version 3 Release 2 is the Kerberos function, which provides an additional security capability when used in the programming of interoperating TCP/IP applications. The Kerberos server allows an application server to verify the authenticity of a requesting application client.

Note: The Kerberos Security Feature is subject to U.S. Export Licensing Controls. Questions concerning eligibility or U.S. licensing requirements should be directed to your local Export Regulation Coordinator/Executive (ERC/ERE).

User management is responsible for evaluation, selection, and implementation of security features, administrative procedures, and appropriate controls in application systems and communication facilities.



ORDERING INFORMATION



Current Licensees

Current licensees of 5655-HAL IBM TCP/IP Version 3 Release 1 for MVS must order this release via MES. Ordering instructions are scheduled to be mailed from IBM Software Manufacturing Solutions (SMS) to all current licensees by October 11, 1996. IBM TCP/IP Version 3 Release 1 for MVS may still be ordered.



New Licensees

Orders for new licenses will be accepted now.

Shipment will begin on the planned availability date.

New users of TCP/IP Version 3 Release 2 should specify:

          Type        Model

5655 HAL

For ordering information on the base program, IBM TCP/IP Version 3 Release 2 for MVS/ESA refer to Software Announcements 295-471, dated November 7, 1995, and 294-529, dated September 13, 1994. New basic license ordering instructions for OS/390 licensees and new basic machine-readable material for Release 2 is shown below.



Basic License Ordering Instructions for OS/390 (5645-001) Licensees

Customers licensed on the designated machine for OS/390 (5645-001) which includes TCP/IP Version 3 Release 1 are eligible to order IBM TCP/IP Version 3 Release 2 for MVS at no-charge by specifying program number 5655-HAL, feature number 9001 for asset registration, the media feature number(s) of the desired medium, and the following no-charge feature numbers as applicable.

Note: To be eligible to order CICS Sockets or IMS Sockets at no additional charge you must be licensed for the equivalent feature of OS/390 on the designated machine.

This no-charge option for OS/390 licensees will be available for ordering until March 28, 1997. Effective March 28, 1997, feature numbers 3950, 3951, and 3952 will be withdrawn from marketing.

                                                  Feature
Title                                             Number

TCP/IP V3R2 MVS for OS/390 3950 CICS Sockets R2 for OS/390 3951 IMS Sockets R2 for OS/390 3952

Note: IBM authorizes you to make copies of IBM TCP/IP Version 3 Release 2 for MVS/ESA media at no-charge for use on all systems licensed for OS/390 (5645-001) which includes TCP/IP Version 3 Release 1. In order to copy IMS Sockets and/or CICS Sockets you must have a license for the equivalent OS/390 optional feature. These copies need not be reported to IBM.

Basic Machine-Readable Material: To order, select the feature numbers of the desired distribution medium for Release 2.

                     Feature
Environment          Number        Distribution Medium

MVS ESA Basic 5962 9/6250 magnetic tape Basic License 5963 3480 tape cartridge 5710 4-mm tape

MVS ESA DES 5975 9/6250 magnetic tape Kerberos 5976 3480 tape cartridge 5711 4-mm tape

MVS ESA 5988 9/6250 magnetic tape non-DES 5989 3480 tape cartridge Kerberos 5712 4-mm tape

MVS OE 6041 9/6250 magnetic tape Applications 6042 3480 tape cartridge 5716 4-mm tape

CICS Sockets 6011 9/6250 magnetic tape Feature 6012 3480 tape cartridge 5713 4-mm tape

IMS Sockets 6021 9/6250 magnetic tape Feature 6022 3480 tape cartridge 5714 4-mm tape

Network Print 6031 9/6250 magnetic tape Facility Feature 6032 3480 tape cartridge 5715 4-mm tape

Unlicensed Documentation: A memo, program directory and one copy of the following publications are supplied automatically with the basic machine-readable material:

                                                  Order
Title                                             Number

IBM TCP/IP for MVS License Program Specification GC31-7173

IBM TCP/IP for MVS Messages and Codes SC31-7132

IBM TCP/IP for MVS User's Guide SC31-7136

IBM TCP/IP Performance and Tuning Guide* SC31-7188

IBM TCP/IP for MVS Customization and Administration SC31-7134

IBM TCP/IP for MVS Planning and Migration Guide SC31-7189

*     This publication will not be updated at general availability,
      and will automatically be shipped to users of record when
      updated.

One copy of the following publication is supplied automatically with the CICS Sockets optional feature:

                                                  Order
Title                                             Number

IBM TCP/IP for MVS: CICS TCP/IP Socket Interface Guide and Reference SC31-7131

One copy of the following publication is supplied automatically with the IMS Sockets optional feature:

                                                  Order
Title                                             Number

IBM TCP/IP for MVS: IMS TCP/IP Application Development Guide and Reference SC31-7186

One copy of the following publication is supplied automatically with the Network Print Facility optional feature:

                                                  Order
Title                                             Number

IBM TCP/IP for MVS: Network Print Facility SC31-8074

One copy of the following publication is supplied automatically with the OpenEdition Applications optional feature:

                                                  Order
Title                                             Number

IBM TCP/IP for MVS: OpenEdition Applications SC31-8069

Additional copies of unlicensed publications will be available for a fee after product availability. These copies may be ordered from your IBM representative, through the System Library Subscription Service (SLSS) or by direct order.

The optional publications below will be available at product availability. The first copy of both books is available at no charge to licensees of basic material by specifying feature number 7131.

                                                  Order
Title                                             Number

IBM TCP/IP for MVS: Programmer's Reference SC31-7135 IBM TCP/IP for MVS: Application Programming Interface Reference SC31-7187

Displayable Softcopy Publications

IBM TCP/IP Version 3 Release 2 for MVS/ESA manuals, licensed and unlicensed, except for Licensed Program Specification will be offered in displayable softcopy form on the Networking Softcopy Collection Kit.

The displayable manuals are available to licensees of the basic material by specifying the no-charge feature number 7064 (CD-ROM) IBM TCP/IP Version 3 Release 2 for MVS/ESA.

Additional copies are available for a fee using SLSS, or the 5636-PUB Library Offering. Specify order numbers SK2T-6012 (feature number 2003 and 5003).

These displayable manuals can be used with the BookManager(R) READ licensed programs in any of the supported environments. Terms and conditions for use of the machine-readable files are shipped with the files.

The Networking Softcopy Collection Kit contains the licensed books for IBM TCP/IP Version 3 Release 2 for MVS/ESA. The licensed books are locked (encrypted) on the CD-ROM and require you to enter a 20-digit access key to unlock the books. The access key is supplied to licensed users with the software as part of the packing list. You can also obtain the access key by contacting IBM with a toll free phone number, by sending a fax, or by e-mail. A list of the worldwide IBM Key Generation Centers with phone/fax/e-mail information is in the CD Showcase(TM) Product Catalog on the CD-ROM.

Once the licensed books are unlocked you can:

  • View them directly from the CD-ROM

  • Download the licensed books to your workstation or server hard drive and add them to the product library (non-licensed) bookshelf.
Licensed Documentation: The following licensed material will be available from IBM at product availability. To order, contact your IBM representative.

The first copy is available at no charge to licensees of basic material by specifying the 7xxx feature number. Use the 8xxx feature number to order additional copies for a fee.

IBM TCP/IP Version 3 Release 2 for MVS/ESA

                                  Single    Additional
                                  Copy      Copies
                      Order       Feature   Feature
Title                 Number      Number    Number       Price

IBM TCP/IP for MVS: Diagnosis Guide LY43-0105 7130 8170 $80.50

Subsequent updates (technical newsletters or revisions between releases) to the publications shipped with the product will be distributed to the user of record for as long as a license for this software remains in effect. A separate publication order or subscription is not needed.



TERMS AND CONDITIONS

The terms for IBM TCP/IP Version 3 Release 2 for MVS/ESA as previously announced in Software Announcements 295-471 and 294-529, licensed under the IBM Customer Agreement are unaffected by this announcement with the following exception.

TCP/IP Version 3 Release 2 is offered at no-charge only for use on systems where you have installed a licensed copy of OS/390 (5645-001) which contains TCP/IP Version 3 Release 1.

IBM authorizes you to make copies of the TCP/IP V3R2 for MVS/ESA media at no-charge for use on all systems where you have an OS/390 (5645-001) license which includes IBM TCP/IP Version 3 Release 1. To be eligible to copy TCP/IP Version 3 Release 2 IMS Sockets and/or CICS Sockets features, you must have a license for the equivalent optional feature of OS/390 on the designated machine. These copies need not be reported to IBM.



Usage Restriction

Only those customers licensed on the designated machine for OS/390 (5645-001) which includes IBM TCP/IP Version 3 Release 1 are eligible to order IBM TCP/IP Version 3 Release 2 for MVS at no-charge.

Note: To be eligible to order CICS Sockets or IMS Sockets at no-charge you must be licensed for the equivalent optional function of OS/390 on the designated machine. This no-charge option will be removed on March 28, 1997.



CHARGES

Charges are unaffected by this announcement.

One-Time Charge: Customers who pay a one-time charge for a licensed program receive enhancements and future releases, if any, at no additional charge. Significant new function may be offered as an optional feature and charged for separately. If a replacement program is announced and the customer elects to license the replacement program, a time-based upgrade credit may apply.

Distributed Feature One-Time Charge: Customers who pay a one-time charge for additional distributed features may copy machine-readable program material and documentation. One copy may be made for each additional distributed feature ordered.

Variable Charges: The applicable graduated one-time charge or graduated monthly license charge will be based on the group of the designated machine on which the licensed program is licensed for use. If the program is designated to a processor in a group for which no charge is listed above, the charge of the next higher group listed applies.

For upgrades of one-time charge licenses to a machine in a higher group, the upgrade charge will be the difference in the then current charges between the two groups. For downgrades of one-time charge licenses to a machine in a lower group, there will be no adjustment or refund of one-time charges paid.

For upgrades or downgrades of monthly license charge licenses, the monthly license charge applicable to the higher or lower group will apply.

Entry Support License One-Time Charge: One-Time charge authorizes use only on IBM Entry End User/390 machines.

For additional information, refer to Software Announcements 295-471, dated November 7, 1995, and 294-529, dated September 13, 1994.

(TM)  Trademark of International Business Machines Corporation in the
      United States or other countries or both.
(R)   Registered trademark of International Business Machines
      Corporation in the United States or other countries or both.
+     Registered trademark of Microsoft Corporation

Share this page

Digg Linked In

Contact IBM

Feedback