gtpm2m2uMigration Guide: Program Update Tapes

TCP/IP Enhancements for PUT 14 (APARs PJ27451, PJ27491, PJ27714, PJ27617, PJ27625, PJ27650, PJ27679, and PJ27859)

The following section discusses the migration considerations for Transmission Control Protocol/Internet Protocol (TCP/IP) enhancements for PUT 14.

Prerequisite APARs

See the APEDIT for APARs PJ27451, PJ27491, PJ27714, PJ27617, PJ27625, PJ27650, PJ27679, and PJ27859 for information about prerequisite APARs.

Functional Overview

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:

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 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.

Hardware

The following section contains information about hardware requirements.

Communication Devices

Fast Ethernet OSA-Express support supports Fast Ethernet (FENET) OSA-Express adapters.

Software (Programming Requirements)

There are no software requirements.

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 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.

Dynamic Load Module (DLM) Stubs

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

General Use C/C++ Language Header Files

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

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

There are no changes.

Library Interface Scripts

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.

Library Members (Object Files)

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.

Link-Edited Modules

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.

Members (Object Files)

Table 1010 summarizes changes to members (object files). This information is presented in alphabetic order by the name of the member (object file).

Notes:

  1. You must recompile or reassemble a member (object file) if it has changed.

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

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.

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 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.

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 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

Data Macros

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

General Macros

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

Selected Equate Macros

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

Structured Programming Macros (SPMs)

There are no changes.

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

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

System Initialization Program (SIP) Stage I Macros and Statements

There are no changes.

System Initialization Program (SIP) Stage II Macros

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

System Communication Keypoint (SCK) Generation Macros

There are no changes.

System Macros

There are no changes.

System Macros (IBM Use Only)

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

Segments

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.

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 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.

Messages and System Errors

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

Performance or Tuning Changes

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.

Storage Considerations and Changes

There are no changes.

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 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.

Host System Changes

There are no changes.

Application Programming Interface (API) Changes

There are no changes.

Database Changes

There are no changes.

Feature Changes

There are no changes.

Installation Validation

There are no changes.

Migration Scenarios

To install TCP/IP enhancements for program update tape (PUT) 14 on your existing TPF 4.1 system, do the following:

Additional Information: