gtpm2m36 | Migration Guide: Program Update Tapes |
The following section discusses the migration considerations for TCP/IP enhancements for PUT 15.
See the APEDIT for APARs PJ28026, PJ28029, PJ28034, PJ28064, PJ28067, PJ28093, and PJ28087 for information about prerequisite APARs.
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:
There are no changes.
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.
There are no hardware requirements.
The following section contains information about software requirements.
The following section summarizes the communication changes.
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.
The following section summarizes interface changes.
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.
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. |
There are no changes.
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 |
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.
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 |
There are no changes.
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. |
Table 1152 summarizes changes to members. This information is presented in alphabetic order by the name of the member.
Notes:
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. |
There are no changes.
There are no changes.
There are no changes.
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. |
There are no changes.
The following section summarizes the macro changes. This information is presented in alphabetic order by the type of macro.
There are no changes.
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 |
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 |
There are no changes.
There are no changes.
There are no changes.
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 |
There are no changes.
There are no changes.
There are no changes.
There are no changes.
There are no changes.
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. |
There are no changes.
There are no 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.
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. |
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 |
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.
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.
There are no changes.
There are no changes.
There are no 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. |
There are no 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.
There are no changes.
There are no changes.
There are no changes.
Use the following procedure to install TCP/IP enhancements for PUT 15 on your TPF 4.1 system:
Additional Information: