gtpm2m36Migration Guide: Program Update Tapes

TCP/IP Enhancements for PUT 15 (APARs PJ28026, PJ28029, PJ28034, PJ28064, PJ28067, PJ28093, and PJ28087)

The following section discusses the migration considerations for TCP/IP enhancements for PUT 15.

Prerequisite APARs

See the APEDIT for APARs PJ28026, PJ28029, PJ28034, PJ28064, PJ28067, PJ28093, and PJ28087 for information about prerequisite APARs.

Functional Overview

TCP/IP enhancements for PUT 15 continue to build on the functions provided with TCP/IP native stack support, Open Systems Adapter (OSA)-Express support, and Domain Name System (DNS) support. See TCP/IP Native Stack Support (APAR PJ26683), OSA-Express Support (APAR PJ27333), and Domain Name System (DNS) Support (APAR PJ27268) for more information.

TCP/IP enhancements for PUT 15 increase the usability and functionality of TCP/IP native stack support, OSA-Express support, and DNS support with the following APARs:

Architecture

There are no changes.

Operating Environment Requirements and Planning Information

To ensure that your TPF 4.1 system performs correctly with TCP/IP enhancements for PUT 15, you must establish the required operating environment. The following section describes hardware and software requirements specific to TCP/IP enhancements for PUT 15.

Operating Environment Requirements and Planning Information provides information about the minimum system configuration requirements that are necessary to operate the TPF 4.1 system. You may find it helpful to review that chapter along with the following information.

Hardware

There are no hardware requirements.

Software (Programming Requirements)

The following section contains information about software requirements.

Communication

The following section summarizes the communication changes.

Operating Environment for TCP/IP-Based Communication

If your system is running on an IBM System/390 G5 or G6 processor, apply the OSA-Express polling enhancements (APAR PJ28064) with OSA-Express microcode level 4.19 or higher for optimal performance. You can apply APAR PJ28064 and the OSA-Express microcode independently.

Interface Changes

The following section summarizes interface changes.

C/C++ Language

The following section summarizes C/C++ language changes. This information is presented in alphabetic order by the type of C/C++ language information. See the TPF C/C++ Language Support User's Guide and TPF Application Programming for more information about the C/C++ language.

Build Scripts

Table 1148 summarizes changes to the build scripts used by the build tool. This information is presented in alphabetic order by the name of the build script.

Table 1148. Changes to Build Scripts for TCP/IP Enhancements for PUT 15

Build Script Type New, Changed, or No Longer Supported? Description of Change
APAR PJ28029
CLTNBS DLM Changed Updated to support the operator interface to resolve host names and IP addresses.

Dynamic Load Module (DLM) Stubs

There are no changes.

General Use C/C++ Language Header Files

Table 1149 summarizes the general use C/C++ language header file changes. This information is presented in alphabetic order by the name of the general use C/C++ language header file.

General use means these header files are available for your use.

Table 1149. Changes to General Use C/C++ Language Header Files for TCP/IP Enhancements for PUT 15

C/C++ Language Header File New, Changed, or No Longer Supported? Do You Need to Recompile Segments? Segments to Recompile
APAR PJ28034
c$ck2sn.h Changed No Not Applicable
APAR PJ28064
c$ck2sn.h Changed No Not Applicable

Implementation-Specific C/C++ Language Header Files (IBM Use Only)

Table 1150 summarizes the general use C/C++ language header file changes that are for IBM use only. This information is presented in alphabetic order by the name of the general use C/C++ language header file.

Table 1150. Changes to Implementation-Specific C/C++ Language Header Files (IBM Use Only) for TCP/IP Enhancements for PUT 15

C/C++ Language Header File (IBM Use Only) New, Changed, or No Longer Supported? Do You Need to Recompile Segments? Segments to Recompile
APAR PJ28026
i$netd.h Changed No Not Applicable

Library Interface Scripts

There are no changes.

Link-Edited Modules

Table 1151 summarizes changes to the link-edited modules shipped by IBM, which should go into a data set with attributes DCB=(RECFM=U,LRECL=80,BLKSIZE=1200). This information is presented in alphabetic order by the name of the link-edited module.

Table 1151. Changes to Link-Edited Modules for TCP/IP Enhancements for PUT 15

Link-Edited Module New, Changed, or No Longer Supported? Description of Change
APAR PJ28026
CLTV Changed Updated for Internet daemon listen backlog support.
CLTX Changed Updated for Internet daemon listen backlog support.
APAR PJ28029
CLTN Changed Updated to support the operator interface to resolve host names and IP addresses.
APAR PJ28093
CDNF Changed Updated for DNS server wildcard support.
CDNS Changed Updated for DNS server wildcard support.

Members

Table 1152 summarizes changes to members. This information is presented in alphabetic order by the name of the member.

Notes:

  1. You must recompile or reassemble a member if it has changed.

  2. You must prelink and link a dynamic load module (DLM) if it has changed.

Table 1152. Changes to Members for TCP/IP Enhancements for PUT 15

Member DLM/DLL/LLM Name Type New, Changed, or No Longer Supported? Member Type Description of Change
APAR PJ28026
CINET1 CLTV DLM Changed C Language Updated for Internet daemon listen backlog support.
CINET4 CLTX DLM Changed C Language Updated for Internet daemon listen backlog support.
APAR PJ28029
CLTL CLTN DLM New C Language Added to support the operator interface to resolve host names and IP addresses.
CLTN CLTN DLM Changed C Language Updated to support the operator interface to resolve host names and IP addresses.
APAR PJ28093
CDNF CDNF DLM Changed C++ Language Updated for DNS server wildcard support.
CDNS CDNS DLM Changed C++ Language Updated for DNS server wildcard support.

Object Code Only (OCO) Stubs

There are no changes.

Configuration Constant (CONKC) Tags

There are no changes.

Control Program Interface (CINFC) Tags

There are no changes.

Copy Members

Table 1153 summarizes the copy member changes. This information is presented in alphabetic order by the name of the copy member.

Table 1153. Changes to Copy Members for TCP/IP Enhancements for PUT 15

Copy Member Type New, Changed, or No Longer Supported? Segment Where Copy Member is Included Name of Link-Edited Module DLM, DLL, LLM, or Control Program Description of Change
APAR PJ28034
CTTO Control Program Changed CCTCP1 CPS0 Control Program Updated for IP packet network prioritization.
APAR PJ28064
CLHL Control Program Changed CCCLHR CPS0 Control Program Updated for OSA-Express polling enhancements.
CTME Control Program Changed CCNUCL CPS0 Control Program Updated for OSA-Express polling enhancements.
CT15 Control Program Changed CCCTIN CPS0 Control Program Updated for OSA-Express polling enhancements.
APAR PJ28067
CTTO Control Program Changed CCTCP1 CPS0 Control Program Updated for the OSA-Express gateway selection enhancement.

Fixed File Records

There are no changes.

Macros

The following section summarizes the macro changes. This information is presented in alphabetic order by the type of macro.

Advanced Program-to-Program Communications (APPC) Macros

There are no changes.

Communication Macros and Statements

Table 1154 summarizes changes to the communication macros and statements. This information is presented in alphabetic order by the name of the SNA communication macro or statement.

Table 1154. Changes to Communication Macros and Statements for TCP/IP Enhancements for PUT 15

Communication Macro or Statement New, Changed, or No Longer Supported? Do You Need to Reassemble Programs? Programs to Reassemble
APAR PJ28034
SNAKEY Changed Yes CTK2
APAR PJ28064
SNAKEY Changed Yes CTK2

Data Macros

Table 1155 summarizes the data macro changes. This information is presented in alphabetic order by the name of the data macro.

Table 1155. Changes to Data Macros for TCP/IP Enhancements for PUT 15

Data Macro New, Changed, or No Longer Supported? Do You Need to Reassemble Programs Using This Data Macro? Programs to Reassemble
APAR PJ28034
CK2SN Changed No Not Applicable
APAR PJ28064
CK2SN Changed No Not Applicable
IOSAB Changed No Not Applicable
IOSAD Changed No Not Applicable
ISOCK Changed No Not Applicable

General Macros

There are no changes.

Selected Equate Macros

There are no changes.

Structured Programming Macros (SPMs)

There are no changes.

System Initialization Program (SIP) Skeleton and Internal Macros (Inner Macros)

Table 1156 summarizes the system initialization program (SIP) skeleton and internal macro changes. This information is presented in alphabetic order by the name of the SIP skeleton and internal macro. If the SIP skeleton and internal macro (inner macro) is changed, you must reassemble the SIP Stage I deck and run the appropriate job control language (JCL) jobs from the SIP Stage II deck.

Table 1156. Changes to SIP Skeleton and Internal Macros for TCP/IP Enhancements for PUT 15

SIP Skeleton and Internal Macro New, Changed, or No Longer Supported?
APAR PJ28029
SPPGML Changed

System Initialization Program (SIP) Stage I Macros and Statements

There are no changes.

System Initialization Program (SIP) Stage II Macros

There are no changes.

System Communication Keypoint (SCK) Generation Macros

There are no changes.

System Macros

There are no changes.

System Macros (IBM Use Only)

There are no changes.

Segments

Table 1157 summarizes segment changes. This information is presented in alphabetic order by the name of the segment.

Table 1157. Changes to Segments for TCP/IP Enhancements for PUT 15

Segment Type Link-Edit Module (Where Offline Segment Is Linked) New, Changed, or No Longer Supported? Description of Change
APAR PJ28034
CSK0 Real-Time Assembler Not Applicable Changed Updated for IP packet network prioritization.
APAR PJ28064
CCOSAE Object Code Only CPS0 Changed Updated for OSA-Express polling enhancements.
COES Object Code Only Not Applicable Changed Updated for OSA-Express polling enhancements.
CSK0 Real-Time Assembler Not Applicable Changed Updated for OSA-Express polling enhancements.
APAR PJ28087
CTS8 Real-Time Assembler Not Applicable Changed Updated for greater than 32 KB socket send support.

System Equates

There are no changes.

User Exits

There are no changes.

Functional and Operational Changes

The following section summarizes functional and operational changes. This information is presented in alphabetic order by the functional or operational change.

See Appendix A, "PUT 2-15 Interface Changes by Authorized Program Analysis Report (APAR)" for a summary of functional and operational changes by APAR.

Commands

Table 1158 summarizes command changes. This information is presented in alphabetic order by the name of the command. See TPF Operations for a complete description of all commands.

Attention: Changes to commands can impact any automation programs you are using in your complex.

Table 1158. Changes to Commands for TCP/IP Enhancements for PUT 15

Command New, Changed, or No Longer Supported? Description of Change
APAR PJ28026
ZINET ADD Changed Updated to add the BACKLOG parameter.
ZINET ALTER Changed Updated to add the BACKLOG parameter.
ZINET DISPLAY Changed Updated the display messages to include the BACKLOG parameter.
APAR PJ28029
ZDTCP Changed Updated to add the NSLOOKUP parameter.
APAR PJ28034
ZNKEY Changed Updated to add the IPTOS parameter.
APAR PJ28064
ZNKEY Changed Updated to add the OSABUFF parameter.

Messages and System Errors

Table 1159 summarizes message (offline and online messages) and system error changes.

The message IDs or system error numbers are listed in numeric order preceded by their alphabetic prefix. Some offline and online messages do not have a standard message ID. For these, the messages are presented in alphabetic order based on the initial message text; or for those messages that begin with variable information, the initial message text that follows that variable information. See Messages (System Error and Offline) and Messages (Online) for a complete description of all messages and system errors.

Attention: Changes to offline messages, online messages, and system errors may impact any automation programs you are using in your complex.

Table 1159. Changes to Messages and System Errors for TCP/IP Enhancements for PUT 15

Message ID or System Error Number Message Type New, Changed, or No Longer Supported?
APAR PJ28026
INET0119E Online New
INET0122E Online New
APAR PJ28029
DTCP0007I Online New

Performance or Tuning Changes

For Internet daemon listen backlog support, use the BACKLOG parameter of the ZINET ADD or ZINET ALTER command to define the number of connection requests that can be queued before being rejected. See TPF Operations for more information about the ZINET ADD and ZINET ALTER commands.

For OSA-Express polling enhancements, use the OSABUFF parameter on the SNAKEY macro to define the number of OSA read buffers associated with each OSA-Express connection. Determine the number of buffers to allocate based on the number of messages received per second and the average size of the messages. See TPF Transmission Control Protocol/Internet Protocol for more information about OSA read buffers. See TPF ACF/SNA Network Generation for more information about the SNAKEY macro.

Storage Considerations and Changes

For OSA-Express polling enhancements, the amount of storage required for the OSA read buffers depends on the value specified for the OSABUFF parameter on the SNAKEY macro. See TPF Transmission Control Protocol/Internet Protocol for more information about OSA read buffers and the storage requirements. See TPF ACF/SNA Network Generation for more information about the SNAKEY macro.

System Initialization Program (SIP) and System Generation Changes

There are no changes.

Loading Process Changes

There are no changes.

Online System Load Changes

There are no changes.

Publication Changes

Table 1160 summarizes changes to the publications in the TPF library. This information is presented in alphabetic order by the publication title. See the TPF Library Guide for more information about the TPF library.

Table 1160. Changes to TPF Publications for TCP/IP Enhancements for PUT 15

Publication Title Softcopy File Name Description of Change
APAR PJ28026
Messages (Online) Not Applicable Updated with information about messages that were added, changed, and no longer supported for Internet daemon listen backlog support.
TPF Migration Guide: Program Update Tapes GTPMG205 Updated with migration considerations for Internet daemon listen backlog support.
TPF Operations GTPOPR0F Updated with information about the commands that were added and changed for Internet daemon listen backlog support.
APAR PJ28029
Messages (Online) Not Applicable Updated with information about messages that were added, changed, and no longer supported for the operator interface to resolve host names and IP addresses.
TPF Migration Guide: Program Update Tapes GTPMG205 Updated with migration considerations for the operator interface to resolve host names and IP addresses.
TPF Operations GTPOPR0F Updated with information about the commands that were added and changed for the operator interface to resolve host names and IP addresses.
APAR PJ28034
TPF ACF/SNA Network Generation GTPACF0E Updated with information about changes to the SNAKEY macro for IP packet network prioritization.
TPF Migration Guide: Program Update Tapes GTPMG205 Updated with migration considerations for IP packet network prioritization.
TPF Operations GTPOPR0F Updated with information about the commands that were added and changed for IP packet network prioritization.
TPF Transmission Control Protocol/Internet Protocol GTPCLW0B Updated with information about IP packet network prioritization.
APAR PJ28064
TPF ACF/SNA Network Generation GTPACF0E Updated with information about changes to the SNAKEY macro for OSA-Express polling enhancements.
TPF Migration Guide: Program Update Tapes GTPMG205 Updated with migration considerations for OSA-Express polling enhancements.
TPF Operations GTPOPR0F Updated with information about the commands that were added and changed for OSA-Express polling enhancements.
TPF Transmission Control Protocol/Internet Protocol GTPCLW0B Updated with information about OSA-Express polling enhancements.
APAR PJ28067
TPF Migration Guide: Program Update Tapes GTPMG205 Updated with migration considerations for the OSA-Express gateway selection enhancement.
APAR PJ28093
TPF Migration Guide: Program Update Tapes GTPMG205 Updated with migration considerations for DNS server wildcard support.
TPF Transmission Control Protocol/Internet Protocol GTPCLW0B Updated with information about DNS server wildcard support.
APAR PJ28087
TPF Migration Guide: Program Update Tapes GTPMG205 Updated with migration considerations for greater than 32 KB socket send support.
TPF Transmission Control Protocol/Internet Protocol GTPCLW0B Updated with information about greater than 32 KB socket send support.

Host System Changes

There are no changes.

Application Programming Interface (API) Changes

With greater than 32 KB socket send support, the send, sendto, and write socket API functions were updated to support up to 1 GB of data on each send call. See TPF Transmission Control Protocol/Internet Protocol for more information about these socket functions.

Database Changes

There are no changes.

Feature Changes

There are no changes.

Installation Validation

There are no changes.

Migration Scenarios

Use the following procedure to install TCP/IP enhancements for PUT 15 on your TPF 4.1 system:

  1. Unpack program update tape (PUT) 15. See TPF Memo to Licensees for more information about unpacking the tape.
  2. Install the following:
  3. Run the system allocator (SALO) using SPPGML additions for newly created segments to create an updated program allocation table (PAT) and system allocator (SAL) table.
  4. Assemble the SIP stage I deck to create a SIP stage II deck.
  5. Run SIP stage II.
  6. Run the CBLD program for the build scripts listed in Table 1148.
  7. Reassemble or recompile the following:
  8. For IP packet network prioritization (APAR PJ28034), define the IPTOS parameter on the SNAKEY macro.
  9. For OSA-Express polling enhancements (APAR PJ28064), define the OSABUFF parameter on the SNAKEY macro.
  10. Reassemble and load CTK2 to your TPF 4.1 system.
  11. Load the link-edited modules listed in Table 1151.
  12. IPL your TPF 4.1 system.
  13. For Internet daemon listen backlog support (APAR PJ28026), use the BACKLOG parameter of the ZINET ADD or ZINET ALTER command to define a listen backlog value for your Internet server applications.

Additional Information: