gtpm2m2u | Migration Guide: Program Update Tapes |
The following section discusses the migration considerations for Transmission Control Protocol/Internet Protocol (TCP/IP) enhancements for PUT 14.
See the APEDIT for APARs PJ27451, PJ27491, PJ27714, PJ27617, PJ27625, PJ27650, PJ27679, and PJ27859 for information about prerequisite APARs.
TCP/IP enhancements for PUT 14 increase the usability and effectiveness of TCP/IP native stack support and OSA-Express 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 14, you must establish the required operating environment. The following section describes hardware and software requirements specific to TCP/IP enhancements for PUT 14.
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.
The following section contains information about hardware requirements.
Fast Ethernet OSA-Express support supports Fast Ethernet (FENET) OSA-Express adapters.
There are no software requirements.
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 1004 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 1004. Changes to Build Scripts for TCP/IP Enhancements for PUT 14
Build Script | Type | New, Changed, or No Longer Supported? | Description of Change |
---|---|---|---|
APAR PJ27617 | |||
CTIEBS | DLM | New | Created for individual IP trace support. |
Table 1005 summarizes changes to the dynamic load module (DLM)
stubs. This information is presented in alphabetic order by the name of
the DLM stub. See TPF Application Programming
for more information about the DLM stubs.
Table 1005. Changes to Dynamic Load Module (DLM) Stubs for TCP/IP Enhancements for PUT 14
DLM Stub | New or No Longer Supported? |
---|---|
APARs PJ27491 and PJ27714 | |
CMOV | New |
APAR PJ27650 | |
CTFF | New |
Table 1006 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 1006. Changes to General Use C/C++ Language Header Files for TCP/IP Enhancements for PUT 14
C/C++ Language Header File | New, Changed, or No Longer Supported? | Do You Need to Recompile Segments? | Segments to Recompile |
---|---|---|---|
APARs PJ27491 and PJ27714 | |||
socket.h | Changed | No | Not Applicable |
APAR PJ27617 | |||
c$ck2sn.h | Changed | No | Not Applicable |
c$syseq.h | Changed | No | Not Applicable |
APAR PJ27679 | |||
ioctl.h | Changed | No | Not Applicable |
There are no changes.
Table 1007 summarizes changes to the library interface scripts used by
the library interface tool and the build tool. This information is
presented in alphabetic order by the name of the library interface
script.
Table 1007. Changes to Library Interface Scripts for TCP/IP Enhancements for PUT 14
Library Interface Script | New, Changed, or No Longer Supported? | Description of Change |
---|---|---|
APARs PJ27491 and PJ27714 | ||
COMXXV | Changed | Updated to support the tpf_vipac C function. |
Table 1008 summarizes the library member (object file) changes.
This information is presented in alphabetic order by the name of the library
member (object file).
Table 1008. Changes to Library Members (Object Files) for TCP/IP Enhancements for PUT 14
Library Member (Object File) | Library Module Name | New, Changed, or No Longer Supported? | Type | Description of Change |
---|---|---|---|---|
APARs PJ27491 and PJ27714 | ||||
C535 | COMX | Changed | C Language | Updated to support the tpf_vipac C function. |
Table 1009 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 1009. Changes to Link-Edited Modules for TCP/IP Enhancements for PUT 14
Link-Edited Module | New, Changed, or No Longer Supported? | Description of Change |
---|---|---|
APAR PJ27451 | ||
CPS0 | Changed | Updated to support retransmit timeouts. |
APAR PJ27617 | ||
CPS0 | Changed | Updated to add individual IP trace support. |
CTIE | New | Created to allow a formatted display in individual IP trace support. |
APARs PJ27650 and PJ27859 | ||
CPS0 | Changed | Updated with counter fields for the DATAFLOW parameter of the ZSOCK command. |
CTFC | Changed | Updated to add the DATAFLOW parameter to the ZSOCK command. |
Table 1010 summarizes changes to members (object files). This information is presented in alphabetic order by the name of the member (object file).
Notes:
Table 1010. Changes to Members (Object Files) for TCP/IP Enhancements for PUT 14
Member (Object File) | DLM/DLL | New, Changed, or No Longer Supported? | Type | Description of Change |
---|---|---|---|---|
APAR PJ27617 | ||||
CTIE | CTIE | New | C Language | Created to allow a formatted display in individual IP trace support. |
APARs PJ27650 and PJ27859 | ||||
CTFC | CTFC | Changed | C++ Language | Updated to add the DATAFLOW parameter to the ZSOCK command. |
There are no changes.
There are no changes.
There are no changes.
Table 1011 summarizes the copy member changes. This information
is presented in alphabetic order by the name of the copy member.
Table 1011. Changes to Copy Members for TCP/IP Enhancements for PUT 14
Copy Member | Type | CSECT Where Copy Member Is Located | DLM Where CSECT Is Located | New, Changed, or No Longer Supported? | Description of Change |
---|---|---|---|---|---|
APAR PJ27451 | |||||
CTSS40 | Control Program | CCTCP3 | Not Applicable | Changed | Updated the number of TCP sockets that have been cleaned up because of retransmit timeouts. |
APAR PJ27617 | |||||
CTT6 | Control Program | CCTCP1 | Not Applicable | Changed | Updated to allow tracing packets for individual IP trace support. |
CT15 | Control Program | CCCTIN | Not Applicable | Changed | Updated to carve out tables for individual IP trace support. |
APAR PJ27650 | |||||
CTT6 | Control Program | CCTCP1 | Not Applicable | Changed | Updated data flow byte counters for UDP sockets. |
APAR PJ27679 | |||||
CTT6 | Control Program | CCTCP1 | Not Applicable | Changed | Updated for TCP/IP activate on receipt load balancing. |
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 1012 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 1012. Changes to Communication Macros and Statements for TCP/IP Enhancements for PUT 14
Communication Macro or Statement | New, Changed, or No Longer Supported? | Do You Need to Reassemble Programs? | Programs to Reassemble |
---|---|---|---|
APAR PJ27617 | |||
SNAKEY | Changed | Yes | CTK2 |
Table 1013 summarizes the data macro changes. This information
is presented in alphabetic order by the name of the data macro.
Table 1013. Changes to Data Macros for TCP/IP Enhancements for PUT 14
Data Macro | New, Changed, or No Longer Supported? | Do You Need to Reassemble Programs Using This Data Macro? | Programs to Reassemble |
---|---|---|---|
APAR PJ27451 | |||
ISOCK | Changed | No | Not Applicable |
APAR PJ27617 | |||
CK2SN | Changed | No | Not Applicable |
INDTR | New | No | Not Applicable |
ISTAK | Changed | No | Not Applicable |
APAR PJ27625 | |||
IOSCR | Changed | No | Not Applicable |
APAR PJ27650 | |||
ISOCK | Changed | Yes | CCCTIN, CCTCP1, CCTCP3, CMVW, CTFA, CTFB, CTFD, CTF4, CTSK, CTSN, CTSR, CTSW, CTS0 |
APAR PJ27679 | |||
IPWBL | Changed | No | Not Applicable |
ISOCK | Changed | No | Not Applicable |
Table 1014 summarizes the general macro changes. This
information is presented in alphabetic order by the name of the general
macro. See TPF General Macros for a complete
description of all general macros.
Table 1014. Changes to General Macros for TCP/IP Enhancements for PUT 14
General Macro | New, Changed, or No Longer Supported? | Do You Need to Reassemble Programs? | Programs to Reassemble |
---|---|---|---|
APARs PJ27491 and PJ27714 | |||
VIPAC | New | No | Not Applicable |
Table 1015 summarizes the selected equate macro changes. This
information is presented in alphabetic order by the name of the selected
equate macro.
Table 1015. Changes to Selected Equate Macros for TCP/IP Enhancements for PUT 14
Selected Equate Macro | New, Changed, or No Longer Supported? | Do You Need to Reassemble Programs? | Programs to Reassemble |
---|---|---|---|
APAR PJ27617 | |||
CZ1SE | Changed | No | Not Applicable |
SYSEQ | Changed | No | Not Applicable |
There are no changes.
Table 1016 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 1016. Changes to SIP Skeleton and Internal Macros for TCP/IP Enhancements for PUT 14
SIP Skeleton and Internal Macro | New, Changed, or No Longer Supported? |
---|---|
APARs PJ27491 and PJ27714 | |
SPPGML | Changed |
APAR PJ27617 | |
SPPGML | Changed |
APAR PJ27650 | |
SPPGML | Changed |
There are no changes.
Table 1017 summarizes system initialization program (SIP) Stage II
macro changes. This information is presented in alphabetic order by the
name of the SIP Stage II macro. If IBMPAL is changed, you must run the
system allocator (SALO) and load the new program allocation table
(PAT) to the TPF 4.1 system.
Table 1017. Changes to SIP Stage II Macros for TCP/IP Enhancements for PUT 14
SIP Stage II Macro | New, Changed, or No Longer Supported? |
---|---|
APARs PJ27491 and PJ27714 | |
IBMPAL | Changed |
APAR PJ27617 | |
IBMPAL | Changed |
APAR PJ27650 | |
IBMPAL | Changed |
There are no changes.
There are no changes.
Table 1018 summarizes system macro changes that are for IBM use
only. This information is presented in alphabetic order by the name of
the system macro.
Table 1018. Changes to System Macros (IBM Use Only) for TCP/IP Enhancements for PUT 14
System Macro (IBM Use Only) | New, Changed, or No Longer Supported? | Do You Need to Reassemble Programs? | Programs to Reassemble |
---|---|---|---|
APAR PJ27617 | |||
DLTEC | Changed | No | Not Applicable |
Table 1019 summarizes segment changes. This information is
presented in alphabetic order by the name of the segment.
Table 1019. Changes to Segments for TCP/IP Enhancements for PUT 14
Segment | Type | Link-Edit Module (Where Offline Segment Is Linked) | New, Changed, or No Longer Supported? | Description of Change |
---|---|---|---|---|
APAR PJ27451 | ||||
CMV2 | Real-Time Assembler | Not Applicable | Changed | Updated to support the ZVIPA command. |
CTF1 | Real-Time Assembler | Not Applicable | Changed | Updated to support the ZTTCP CLEAR command. |
CTF5 | Real-Time Assembler | Not Applicable | Changed | Updated to display the correct message number and the number of TCP sockets. |
CTF7 | Real-Time Assembler | Not Applicable | Changed | Updated to support the ZTTCP DISPLAY commad. |
APARs PJ27491 and PJ27714 | ||||
CMOV | Real-Time Assembler | Not Applicable | New | Created to support processing to move a VIPA to a new CPU. |
CMV1 | Real-Time Assembler | Not Applicable | Changed | Updated to remove movable VIPA support and to move the support to the CMOV segment. |
APAR PJ27617 | ||||
CSK0 | Real-Time Assembler | Not Applicable | Changed | Updated for the ZNKEY command. |
CTF1 | Real-Time Assembler | Not Applicable | Changed | Updated to add the RIP/NORIP parameter to the ZTTCP TRACE command. |
CTF3 | Real-Time Assembler | Not Applicable | Changed | Updated to add the RIP/NORIP parameter to the ZTTCP TRACE command. |
CTIA | Real-Time Assembler | Not Applicable | New | Created for the ZINIP command. |
CTIB | Real-Time Assembler | Not Applicable | New | Created for the ZINIP command. |
CTIC | Real-Time Assembler | Not Applicable | New | Created for the ZINIP command. |
CTID | Real-Time Assembler | Not Applicable | New | Created for the ZINIP command. |
CTIR | Real-Time Assembler | Not Applicable | New | Created for individual IP trace restart. |
CTSR | Real-Time Assembler | Not Applicable | Changed | Updated to call individual IP trace restart. |
CVAB | Real-Time Assembler | Not Applicable | Changed | Updated for the ZINIP command. |
APAR PJ27625 | ||||
COE7 | Real-Time Assembler | Not Applicable | Changed | Updated to support Fast Ethernet OSA-Express connections. |
COED | Real-Time Assembler | Not Applicable | Changed | Updated to support Fast Ethernet OSA-Express connections. |
APAR PJ27650 | ||||
COEB | Real-Time Assembler | Not Applicable | New | Created to process the DATAFLOW parameter of the ZOSAE command. |
COE1 | Real-Time Assembler | Not Applicable | Changed | Updated to add the DATAFLOW parameter to the ZOSAE command. |
COE8 | Real-Time Assembler | Not Applicable | Changed | Updated the ZOSAE HELP command. |
CTFF | Real-Time Assembler | Not Applicable | New | Created to process the DATAFLOW parameter of the ZSOCK command. |
CTTO | Assembler | Not Applicable | Changed | Updated data flow byte sent counters. |
APAR PJ27679 | ||||
CTSA | Real-Time Assembler | Not Applicable | Changed | Added TCP/IP activate on receipt load balancing support. |
CTSC | Real-Time Assembler | Not Applicable | Changed | Added TCP/IP activate on receipt load balancing support. |
CTSI | Real-Time Assembler | Not Applicable | Changed | Added TCP/IP activate on receipt load balancing 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 1020 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 1020. Changes to Commands for TCP/IP Enhancements for PUT 14
Command | New, Changed, or No Longer Supported? | Description of Change |
---|---|---|
APAR PJ27451 | ||
ZTTCP CLEAR | New | Added to clear TCP/IP statistics. |
ZTTCP DISPLAY | Changed |
The output of the ZTTCP DISPLAY command with the ALL parameter specified now includes read symbolic device address (SDA) and data SDA information for OSA-Express connections. The output of the ZTTCP DISPLAY command with the STATS parameter specified
now includes the number of TCP sockets that have been cleaned up because of
retransmit timeouts.
|
ZVIPA | Changed | The output of the ZVIPA command with the IP parameter specified now includes which CPUs have the specified movable VIPAs defined to them. |
APAR PJ27617 | ||
ZINIP | New | Created to allow for individual Internet Protocol (IP) trace tables. |
ZNKEY | Changed | Updated for individual IP trace tables. |
ZTTCP TRACE | Changed | Updated to add the RIP/NORIP parameter. |
APAR PJ27625 | ||
ZOSAE | Changed | Updated to support Fast Ethernet OSA-Express connections. |
APAR PJ27650 | ||
ZOSAE | Changed | Updated to add the DATAFLOW parameter. |
ZSOCK | Changed | Updated to add the DATAFLOW parameter. |
Table 1021 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 1021. Changes to Messages and System Errors for TCP/IP Enhancements for PUT 14
Message ID or System Error Number | Message Type | New, Changed, or No Longer Supported? |
---|---|---|
APAR PJ27451 | ||
TTCP0020I | Online | No Longer Supported |
TTCP0022I | Online | No Longer Supported |
TTCP0023I | Online | Changed |
TTCP0182I | Online | New |
TTCP0183I | Online | New |
TTCP0184I | Online | New |
VIPA0002I | Online | Changed |
VIPA0010I | Online | New |
APAR PJ27617 | ||
INIP0001I | Online | New |
INIP0002I | Online | New |
INIP0003I | Online | New |
INIP0004I | Online | New |
INIP0005I | Online | New |
INIP0006I | Online | New |
INIP0007I | Online | New |
INIP0008I | Online | New |
INIP0009I | Online | New |
INIP0010I | Online | New |
INIP0011I | Online | New |
INIP0020E | Online | New |
INIP002IE | Online | New |
INIP0022E | Online | New |
INIP0023E | Online | New |
INIP0024E | Online | New |
INIP0025E | Online | New |
INIP0026E | Online | New |
INIP0027E | Online | New |
INIP0028E | Online | New |
INIP0029E | Online | New |
TTCP0034I | Online | New |
TTCP0035I | Online | New |
007813 | System | New |
007814 | System | New |
APAR PJ27650 | ||
OSAE0008I | Online | New |
OSAE0009I | Online | New |
OSAE0010I | Online | New |
SOCK0024I | Online | New |
SOCK0025I | Online | New |
SOCK0026E | Online | New |
SOCK0027E | Online | New |
For applications that can be run on any I-stream and that use the TCP/IP activate_on_receipt or activate_on_receipt_with_length function, use TCP/IP activate on receipt load balancing (APAR PJ27679) to improve performance. APAR PJ27679 allows the TPF 4.1 system to balance the application load across all I-streams by creating the new ECB on the least busy I-stream when the activate_on_receipt or activate_on_receipt_with_length function is completed.
Use the AOR_BALANCE option of the ioctl function to set TCP/IP activate on receipt load balancing support on for a socket.
There are no changes.
There are no changes.
There are no changes.
There are no changes.
Table 1022 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 1022. Changes to TPF Publications for TCP/IP Enhancements for PUT 14
Publication Title | Softcopy File Name | Description of Change |
---|---|---|
APAR PJ27451 | ||
TPF Messages, Volume 2 | GTPMC200 | Updated with information about messages that were added, changed, and no longer supported for display enhancements. |
TPF Migration Guide: Program Update Tapes | GTPMG203 | Updated with migration considerations for display enhancements. |
TPF Operations | GTPOPR0D | Updated with information about the commands that were added and changed for display enhancements. |
APARs PJ27491 and PJ27714 | ||
TPF C/C++ Language Support User's Guide | GTPCLU0D | Updated with the tpf_vipac C function for movable VIPA program interface. |
TPF General Macros | GTPGEN0C | Updated with the VIPAC macro for the movable VIPA program interface. |
TPF Migration Guide: Program Update Tapes | GTPMG203 | Updated with migration considerations for the movable VIPA program interface. |
TPF Transmission Control Protocol/Internet Protocol | GTPCLW09 | Updated with information about using the movable VIPA program interface. |
APAR PJ27617 | ||
TPF ACF/SNA Network Generation | GTPACF0C | Updated with information about the new SNAKEY parameters that were added for individual IP trace support. |
Messages (System Error and Offline) and Messages (Online) | Not Applicable | Updated with information about messages and system errors that were added, changed, and no longer supported for individual IP trace support. |
TPF Migration Guide: Program Update Tapes | GTPMG203 | Updated with migration considerations for individual IP trace support. |
TPF Operations | GTPOPR0D | Updated with information about the commands that were added and changed for individual IP trace support. |
TPF Program Development Support Reference | GTPPDR0D | Updated with the main storage dump labels that were added for individual IP trace support. |
TPF Transmission Control Protocol/Internet Protocol | GTPCLW09 | Updated with information about using individual IP trace support. |
APAR PJ27625 | ||
TPF Library Guide | GTPDOC0D | Updated with definitions for new terminology in the master glossary. |
TPF Migration Guide: Program Update Tapes | GTPMG203 | Updated with migration considerations for Fast Ethernet OSA-Express support. |
TPF Operations | GTPOPR0D | Updated with information about commands that were changed for Fast Ethernet OSA-Express support. |
TPF Transmission Control Protocol/Internet Protocol | GTPCLW09 | Updated with information about using Fast Ethernet OSA-Express support. |
APARs PJ27650 and PJ27859 | ||
TPF Messages, Volume 2 | GTPMC200 | Updated with information about messages that were added, changed, and no longer supported for diagnostic tools. |
TPF Migration Guide: Program Update Tapes | GTPMG203 | Updated with migration considerations for diagnostic tools. |
TPF Operations | GTPOPR0D | Updated with information about the commands that were added and changed for diagnostic tools. |
APAR PJ27679 | ||
TPF Migration Guide: Program Update Tapes | GTPMG203 | Updated with migration considerations for TCP/IP activate on receipt load balancing. |
TPF Transmission Control Protocol/Internet Protocol | GTPCLW09 | Updated with information about TCP/IP activate on receipt load balancing. |
There are no changes.
There are no changes.
There are no changes.
There are no changes.
There are no changes.
To install TCP/IP enhancements for program update tape (PUT) 14 on your existing TPF 4.1 system, do the following:
Additional Information: