gtpm2m23Migration Guide: Program Update Tapes

TCP/IP Native Stack Support (APAR PJ26683)

The following section discusses the migration considerations for TCP/IP native stack support.

Prerequisite APARs

See the APEDIT for APAR PJ26683 for information about prerequisite APARs.

Functional Overview

TCP/IP native stack support provides the following benefits to the TPF 4.1 system:

See TPF Transmission Control Protocol/Internet Protocol for more information about TCP/IP native stack support.

Direct Connectivity

Before TCP/IP native stack support, the TPF 4.1 system was required to communicate through a TCP/IP offload device to connect to IP networks. The TPF 4.1 system used the Common Link Access to Workstation (CLAW) protocol to communicate with special software (the offload server) in the offload device, which would then use the TCP/IP stack in the offload device to communicate with the IP networks using standard IP protocols. With TCP/IP native stack support, the TCP/IP stack now resides in the TPF 4.1 system, allowing the TPF 4.1 system to directly connect to IP routers using standard IP protocols.

Improved Network Throughput

Before TCP/IP native stack support, when a TPF application issued a socket API function, the function call was sent to the TCP/IP offload device, processed there, and the TPF application had to wait for the call to be completed. For example, if a TPF application issued a send function call to send data on a socket, the following occurred:

  1. The send function call was sent to the TCP/IP offload device by using the CLAW protocol.
  2. The application entry control block (ECB) was suspended, waiting for send function processing to be completed.
  3. The TCP/IP offload device received the send function call and passed it to the offload server software code.
  4. The offload server code issued the send function call with the same parameters specified by the TPF application.
  5. The TCP/IP stack in the offload device processed the send function call and passed the return code to the offload server code.
  6. The offload server code sent the return code of the send function call back to the CLAW protocol.
  7. The TCP/IP offload device sent the data from the send function call to the IP network.
  8. The TPF 4.1 system received the send function return code information through the CLAW protocol.
  9. The TPF application ECB was activated and the return code from the send function call was passed to the application.

With TCP/IP native stack support, all socket API function calls are processed locally, which improves performance. Now, if a TPF application issues a socket send function call, the following occurs:

  1. The TCP/IP stack in the TPF 4.1 system processes the send function call and passes the return code back to the TPF application.
  2. The TPF 4.1 system sends the data from the send function call to the IP network.

Socket Options

TCP/IP offload support provided support for a subset of the socket options. TCP/IP native stack support provides support for additional socket options that allow you to do the following:

Socket API Function

TCP/IP native stack support provides a new TPF-unique socket API function called activate_on_accept, which performs the same function as the standard accept function, but has the following advantages:

IP Trace Facility

TCP/IP native stack support provides a full function IP trace facility that allows you to do the following:

Architecture

A TCP/IP stack contains the following components:

TCP/IP native stack support uses the IP over CDLC link layer, which allows the TPF 4.1 system to connect to the following IP routers:

Figure 8 shows the TCP/IP layers that reside in the TPF host and those that reside in the 3745 or 3746 IP router.

Figure 8. TCP/IP Layers


TCP/IP native stack support also includes a loopback interface referred to as local sockets. This enables a socket client application to communicate with a socket server application running in the same TPF 4.1 system without having any network connections.

Without TCP/IP native stack support, data sent by remote socket applications remains queued in the offload devices until the TPF socket application requests the data with a read function call. This can limit throughput, especially for sockets where large amounts of data are flowing. With TCP/IP native stack support, data sent by remote socket applications flows into the TPF 4.1 system and is queued there until the TPF socket application requests the data. In this model, data can be delivered to the TPF socket application as fast as the data is sent through the network.

In an IP network, a node can be either a host or a router. The TPF 4.1 system is an IP host; therefore, packets destined for TPF socket applications are the only packets sent by IP routers to the TPF 4.1 system.

The TPF 4.1 system can be connected to one or more IP networks. Each TPF host processor can have one or more local IP addresses defined. If a TPF processor is connected to multiple IP networks, a different local IP address is needed for each IP network. IP addresses must be unique per TPF host. Each TPF host in a loosely coupled complex must have different local IP addresses defined.

See TPF Transmission Control Protocol/Internet Protocol for more information about TCP/IP native stack support.

Operating Environment Requirements and Planning Information

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

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

TCP/IP native stack support supports the following communication control units:

Software (Programming Requirements)

The TPF 4.1 system can connect to the following devices:

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 628 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 628. Changes to Build Scripts for TCP/IP Native Stack Support

Build Script Type New, Changed, or No Longer Supported? Description of Change
COMXBS DLM Changed Updated to support the activate_on_accept function.
CSF4BS DLM New Build script for the ZIPTR command.
UACCBS DLM New Build script for the TCP/IP native stack support accept connection user exit (UACC).
USOKBS DLM New Build script for the select TCP/IP support user exit (USOK).

Dynamic Load Module (DLM) Stubs

Table 629 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 629. Changes to Dynamic Load Module (DLM) Stubs for TCP/IP Native Stack Support

DLM Stub New, Changed, or No Longer Supported?
UACC New
USOK New

General Use C/C++ Language Header Files

Table 630 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 630. Changes to General Use C/C++ Language Header Files for TCP/IP Native Stack Support

C/C++ Language Header File New, Changed, or No Longer Supported? Do You Need to Recompile Segments?
c$ck2sn.h Changed No
c$eb0eb.h Changed No
c$syseq.h Changed No
socket.h Changed No

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

Table 631 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 631. Changes to Implementation-Specific C/C++ Language Header Files (IBM Use Only) for TCP/IP Native Stack Support

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

Library Interface Scripts

Table 632 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 632. Changes to Library Interface Scripts for TCP/IP Native Stack Support

Library Interface Script New, Changed, or No Longer Supported? Description of Change
COMXXV Changed Added the activate_on_accept function.

Library Members (Object Files)

Table 633 summarizes the library member (object file) changes. This information is presented in alphabetic order by the name of the library member (object file).

Table 633. Changes to Library Members (Object Files) for TCP/IP Native Stack Support

Library Member (Object File) Library Module Name New, Changed, or No Longer Supported? Type Description of Change
C511 COMX Changed C Language Added socket checks for TCP/IP native stack support.
C512 COMX Changed C Language Added socket checks for TCP/IP native stack support.
C513 COMX Changed C Language Added socket checks for TCP/IP native stack support.
C514 COMX Changed C Language Added socket checks for TCP/IP native stack support.
C515 COMX Changed C Language Added socket checks for TCP/IP native stack support.
C516 COMX Changed C Language Added socket checks for TCP/IP native stack support.
C517 COMX Changed C Language Added socket checks for TCP/IP native stack support.
C518 COMX Changed C Language Added socket checks for TCP/IP native stack support.
C519 COMX Changed C Language Added socket checks for TCP/IP native stack support.
C520 COMX Changed C Language Added socket checks for TCP/IP native stack support.
C524 COMX Changed C Language Added socket checks for TCP/IP native stack support.
C525 COMX Changed C Language Added socket checks for TCP/IP native stack support.
C528 COMX Changed C Language Added socket checks for TCP/IP native stack support.
C529 COMX Changed C Language Added socket checks for TCP/IP native stack support.
C530 COMX Changed C Language Added socket checks for TCP/IP native stack support.
C531 COMX Changed C Language Added socket checks for TCP/IP native stack support.
C532 COMX Changed C Language Added socket checks for TCP/IP native stack support.
C533 COMX Changed C Language Added socket checks for TCP/IP native stack support.
C534 COMX Changed C Language Added socket checks for TCP/IP native stack support.
C536 COMX Changed C Language Added socket checks for TCP/IP native stack support. Also, updated for APAR PJ26730.
C537 COMX Changed C Language Added socket checks for TCP/IP native stack support.
C538 COMX Changed C Language Added socket checks for TCP/IP native stack support. Also, updated for APAR PJ26730.
CAOACC COMX New C Language Added the activate_on_accept function for TCP/IP native stack support.

Link-Edited Modules

Table 634 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 634. Changes to Link-Edited Modules for TCP/IP Native Stack Support

Link-Edited Module New, Changed, or No Longer Supported? Description of Change
CPS0 Changed Added the new CCTCP1, CCTCP2, and CCTCP3 CSECTs.

Members (Object Files)

Table 635 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 635. Changes to Members (Object Files) for TCP/IP Native Stack Support

Member (Object File) DLM/DLL New, Changed, or No Longer Supported? Type Description of Change
CINET1 CLTV Changed C Language Added checks for no TCP/IP support.
CINET3 CLTW Changed C Language Added checks for no TCP/IP support.
CINET5 CLTV, CLTY, CMAT, CMQS Changed C Language Added checks for no TCP/IP support.
CINET6 CTFT Changed C Language Added checks for no TCP/IP support.
CLTN CLTN Changed C Language Updated for ZDTCP command changes for the NETSTAT parameter.
CLTR CLTR Changed C Language CLTR allocates the NETSTAT table if either or both offload support or native stack is genned. Also, updated for APAR PJ26730.
CLTS CLTN Changed C Language Updated for ZDTCP command changes for the NETSTAT parameter.
CSF4 CSF4 New C Language The format display for the ZIPTR command.

Object Code Only (OCO) Stubs

Table 636 summarizes changes to stubs that are object code only (OCO) only. This information is presented in alphabetic order by the name of the OCO stub.

Table 636. Changes to OCO Stubs for TCP/IP Native Stack Support

Object Code Only (OCO) Stub New, Changed, or No Longer Supported?
CTSA New
CTSB New
CTSI New
CTSJ New
CTS0 New
CTS1 New
CTS2 New
CTS3 New
CTS4 New
CTS5 New
CTS6 New
CTS7 New
CTS8 New
CTS9 New

Configuration Constant (CONKC) Tags

There are no changes.

Control Program Interface (CINFC) Tags

There are no changes.

Copy Members

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

Table 637. Changes to Copy Members for TCP/IP Native Stack Support

Copy Member Type CSECT Where Copy Member Is Located DLM Where CSECT Is Located New, Changed, or No Longer Supported? Description of Change
CCPU Control Program CCNUCL Not Applicable Changed Added the TCP/IP native stack support polling switch.
CIEF Control Program CCCIEF Not Applicable Changed Updated for changes to the POSTC macro address space.
CHSZ Control Program CCNUCL Not Applicable Changed Updated to clear the CE2TCPIP field when the entry control block (ECB) is created.
CLHL Control Program CCCLHR Not Applicable Changed Updated to run Internet Protocol (IP) scan and polling.
CMFL Control Program CCMCDC Not Applicable Not Applicable This copy member was not updated, but changes were made to the IBMSVC macro, which this copy member calls. The CCMCDC CSECT must be reassembled.
CPSE Control Program CCCPSE Not Applicable Changed Updated for TCP/IP native stack support dump formatting.
CTI1 Control Program CCTCP2 Not Applicable New IP Opzero processor.
CTI2 Control Program CCTCP2 Not Applicable New TCP Opzero processor.
CTI3 Control Program CCTCP2 Not Applicable New UDP Opzero processor.
CTI4 Control Program CCTCP2 Not Applicable New RAW Opzero processor.
CTME Control Program CCNUCL Not Applicable Changed Updated to set the TCP/IP native stack support polling switch.
CTSM Control Program CCTCP3 Not Applicable New TCP/IP native stack support block management routines.
CTSS Control Program CCTCP3 Not Applicable New IP scan routines.
CTTA Control Program CCTCP1 Not Applicable New IP channel data link control (CDLC) sense interrupt routine.
CTTO Control Program CCTCP1 Not Applicable New IPSDC macro handler.
CTT1 Control Program CCTCP1 Not Applicable New IP CDLC polling routine.
CTT3 Control Program CCTCP1 Not Applicable New IP CDLC read interrupt routine.
CTT5 Control Program CCTCP1 Not Applicable New IP CDLC interrupt routine.
CTT6 Control Program CCTCP1 Not Applicable New TCP/IP native stack support trace processor.
CTT8 Control Program CCTCP1 Not Applicable New IP CDLC write interrupt routine.
CTX0 Control Program CCTCP1 Not Applicable New IP CDLC build/issue exchange identification (XID) commands.
CTX1 Control Program CCTCP1 Not Applicable New IP CDLC XID interrupt routine.
CTX2 Control Program CCTCP1 Not Applicable New IP CDLC process XID information routine.
CT15 Control Program CCCTIN Not Applicable Changed Updated to allocate storage for TCP/IP native stack support tables.

Fixed File Records

Table 638 summarizes fixed file record changes. This information is presented in alphabetic order by the name of the fixed file record.

Table 638. Changes to Fixed File Records for TCP/IP Native Stack Support

Fixed File Record New, Changed, or No Longer Supported? Description of Change
#IBMMP4 Changed Updated with ordinal 1 for the Internet Protocol (IP) configuration record.

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 639 summarizes changes to the communication macros. This information is presented in alphabetic order by the name of the communication macro or statement.

Table 639. Changes to Communication Macros and Statements for TCP/IP Native Stack Support

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

Data Macros

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

Table 640. Changes to Data Macros for TCP/IP Native Stack Support

Data Macro New, Changed, or No Longer Supported? Do You Need to Reassemble Programs Using This Data Macro?
CK2SN Changed No
DCTSWC Changed No
IPCCW New Not Applicable
IPMTE New Not Applicable
IPWBL New Not Applicable
ISOCK New Not Applicable
ISTAK New Not Applicable

General Macros

There are no changes.

Selected Equate Macros

Table 641 summarizes the selected equate macro changes. This information is presented in alphabetic order by the name of the selected equate macro.

Table 641. Changes to Selected Equate Macros for TCP/IP Native Stack Support

Selected Equate Macro New, Changed, or No Longer Supported? Do You Need to Reassemble Programs?
CVTEQ Changed No
CZ1SE Changed No
IEQCE2 Changed No
SNAEQ Changed No
SYSEQ Changed No

Structured Programming Macros (SPMs)

There are no changes.

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

Table 642 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 642. Changes to SIP Skeleton and Internal Macros for TCP/IP Native Stack Support

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

System Initialization Program (SIP) Stage I Macros and Statements

Table 643 summarizes system initialization program (SIP) Stage I macro and statement changes. This information is presented in alphabetic order by the name of the SIP Stage I macro. See TPF System Generation for a complete description of the SIP Stage I macros. If the SIP Stage I macro is changed, you must run the appropriate job control language (JCL) jobs from the SIP Stage II deck.

See System Initialization Program (SIP) and System Generation Changes for a description of other system generation changes you must make.

Table 643. Changes to SIP Stage I Macros and Statements for TCP/IP Native Stack Support

SIP Stage I Macro New, Changed, or No Longer Supported?
GENSIP Changed

System Initialization Program (SIP) Stage II Macros

Table 644 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 644. Changes to SIP Stage II Macros for TCP/IP Native Stack Support

SIP Stage II Macro New, Changed, or No Longer Supported?
IBMPAL Changed

System Communication Keypoint (SCK) Generation Macros

There are no changes.

System Macros

Table 645 summarizes system macro changes. This information is presented in alphabetic order by the name of the system macro. See TPF System Macros for a complete description of all system macros.

Table 645. Changes to System Macros for TCP/IP Native Stack Support

System Macro New, Changed, or No Longer Supported? Do You Need to Reassemble Programs?
IBMSVC Changed Yes
IDATB Changed Yes

System Macros (IBM Use Only)

Table 646 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 646. Changes to System Macros (IBM Use Only) for TCP/IP Native Stack Support

System Macro (IBM Use Only) New, Changed, or No Longer Supported? Do You Need to Reassemble Programs?
DLTEC Changed Yes
IPSDC New Not Applicable

Segments

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

Table 647. Changes to Segments for TCP/IP Native Stack Support

Segment Type Link-Edit Module (Where Offline Segment Is Linked) New, Changed, or No Longer Supported? Description of Change
CCTCP1 CSECT Not Applicable New Build output messages and input/output (I/O) handling for TCP/IP native stack support.
CCTCP2 CSECT Not Applicable New Opzero processor for TCP/IP native stack support.
CCTCP3 CSECT Not Applicable New Internet Protocol (IP) scan and resource management for TCP/IP native stack support.
CLC0 Real-Time Assembler Not Applicable Changed Updated to no longer allocate the NETSTAT table.
CPLKMP CSECT CPS0 Changed Added CCTCP1, CCTCP2, and CCTCP3 to the linkmap.
CSK0 Real-Time Assembler Not Applicable Changed Updated with new ZNKEY command parameters.
CTF0 Real-Time Assembler Not Applicable New ZIPTR command processor.
CTF1 Real-Time Assembler Not Applicable New ZTTCP command parser.
CTF2 Real-Time Assembler Not Applicable New ZTTCP command processor for the DEFINE, CHANGE, and DELETE parameters.
CTF3 Real-Time Assembler Not Applicable New ZTTCP command processor for the TRACE parameter.
CTF4 Real-Time Assembler Not Applicable New ZTTCP command processor for the ACTIVATE and INACTIVATE parameters.
CTF5 Real-Time Assembler Not Applicable New ZTTCP command processor for the DISPLAY parameter.
CTKR Real-Time Assembler Not Applicable Changed Updated to call TCP/IP native stack support cycle-down code.
CTKS Real-Time Assembler Not Applicable Changed Updated to call TCP/IP native stack support restart.
CTKT Real-Time Assembler Not Applicable Changed Updated to start the TCP/IP native stack support socket sweeper during cycle-up.
CTSA Real-Time Assembler Not Applicable New activate_on_receipt function processor.
CTSB Real-Time Assembler Not Applicable New activate_on_accept function processor.
CTSC Real-Time Assembler Not Applicable New activate_on_receipt function processor. Also, updated for APAR PJ26730.
CTSG Real-Time Assembler Not Applicable New activate_on_accept function processor. Also, updated for APAR PJ26730.
CTSI Real-Time Assembler Not Applicable New ioctl function processor.
CTSJ Real-Time Assembler Not Applicable New getsockname, getpeername, gethostid, and gethostname function processor.
CTSK Real-Time Assembler Not Applicable New TCP/IP native stack support cycle-down.
CTSN Real-Time Assembler Not Applicable New Added for changes to the NETSTAT parameter of the ZDTCP command.
CTSQ Real-Time Assembler Not Applicable New Added TCP/IP support for common (offload and native stack) restart.
CTSR Real-Time Assembler Not Applicable New TCP/IP native stack support restart processing.
CTSU Real-Time Assembler Not Applicable New read and recvfrom function processing.
CTSW Real-Time Assembler Not Applicable New TCP/IP native stack support socket sweeper.
CTS0 Real-Time Assembler Not Applicable New socket function processor.
CTS1 Real-Time Assembler Not Applicable New bind function processor.
CTS2 Real-Time Assembler Not Applicable New connect function processor.
CTS3 Real-Time Assembler Not Applicable New listen function processor.
CTS4 Real-Time Assembler Not Applicable New accept function processor.
CTS5 Real-Time Assembler Not Applicable New getsockopt and setsockopt function processor.
CTS6 Real-Time Assembler Not Applicable New close and shutdown function processor.
CTS7 Real-Time Assembler Not Applicable New read, recv, and recvfrom function processor.
CTS8 Real-Time Assembler Not Applicable New send, sendto, and write function processor.
CTS9 Real-Time Assembler Not Applicable New select function processor.
CTX3 Real-Time Assembler Not Applicable New TCP/IP native stack support exchange identification (XID) link messages. Also, updated for APAR PJ26730.
CVAB Real-Time Assembler Not Applicable Changed Updated to add the ZIPTR and ZTTCP commands.
IPTPRT Offline C Language IPTPRT New IP trace facility for TCP/IP native stack support.

System Equates

The following section summarizes system equate changes.

SYSEQ Tags

Table 648 summarizes changes to equates that are not configuration dependent (in SYSEQ). This information is presented in alphabetic order by the name of the SYSEQ tag.

Table 648. Changes to SYSEQ Tags for TCP/IP Native Stack Support

SYSEQ Tag Equate Value New, Changed, or No Longer Supported?
#IPCFG X'01' New

User Exits

Control Program (CP) User Exits and ECB User Exits summarize the control program (CP) and ECB user exit changes. See TPF System Installation Support Reference for a complete description of all user exits.

Control Program (CP) User Exits

There are no changes.

ECB User Exits

This information is presented in alphabetic order by the name of the function.

Table 649. Changes to ECB User Exits for TCP/IP Native Stack Support

Function User Exit Activated In User Exit Program New, Changed, or No Longer Supported? Description of Change
TCP/IP Native Stack Support Accept Connection C511 UACC New Verifies a remote client connection request.
Select TCP/IP Support C536 USOK New Allows you to select TCP/IP native stack support or TCP/IP offload support.

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 650 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 650. Changes to Commands for TCP/IP Native Stack Support

Command New, Changed, or No Longer Supported? Description of Change
ZDTCP Changed Changed the display for the NETSTAT parameter.
ZIPTR New Displays the Internet Protocol (IP) trace table.
ZNKEY Changed Added new parameters for TCP/IP native stack support.
ZTTCP ACTIVATE New Activates IP routers.
ZTTCP CHANGE New Changes local IP address association.
ZTTCP DEFINE New Defines an IP router or local IP address.
ZTTCP DELETE New Deletes an IP router or local IP address.
ZTTCP DISPLAY New Displays IP routers, local IP addresses, or resources used by TCP/IP native stack support.
ZTTCP INACTIVATE New Deactivates IP routers.
ZTTCP TRACE New Starts or stops the IP trace facility.

Messages and System Errors

Table 651 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 651. Changes to Messages and System Errors for TCP/IP Native Stack Support

Message ID or System Error Number Message Type New, Changed, or No Longer Supported?
007801 System Error New
007802 System Error New
007804 System Error New
007805 System Error New
007806 System Error New
007807 System Error New
CTSR0001I Online New
CTSR0002I Online New
DTCP0041E Online No Longer Supported
DTCP0043E Online New
DTCP0045E Online New
INET0075E Online New
IPTR0001I Online New
IPTR0002I Online New
IPTR0005I Online New
IPTR0007E Online New
IPTR0008E Online New
IPTR0009I Online New
IPTR0010E Online New
IPTS0000I Offline New
IPTS0001E Offline New
IPTS0002E Offline New
IPTS0003E Offline New
IPTS0004E Offline New
IPTS0005E Offline New
IPTS0006E Offline New
IPTS0007E Offline New
IPTS0008E Offline New
IPTS0009E Offline New
IPTS0010E Offline New
IPTS0011E Offline New
TTCP0001I Online New
TTCP0002I Online New
TTCP0003I Online New
TTCP0004I Online New
TTCP0005I Online New
TTCP0006I Online New
TTCP0007I Online New
TTCP0010I Online New
TTCP0011I Online New
TTCP0012I Online New
TTCP0013I Online New
TTCP0014I Online New
TTCP0015I Online New
TTCP0016I Online New
TTCP0017I Online New
TTCP0018I Online New
TTCP0019I Online New
TTCP0020I Online New
TTCP0021I Online New
TTCP0022I Online New
TTCP0030I Online New
TTCP0031I Online New
TTCP0032I Online New
TTCP0033I Online New
TTCP0040I Online New
TTCP0041I Online New
TTCP0042I Online New
TTCP0043I Online New
TTCP0045I Online New
TTCP0047I Online New
TTCP0090W Online New
TTCP0091W Online New
TTCP0100E Online New
TTCP0101E Online New
TTCP0102E Online New
TTCP0103E Online New
TTCP0104E Online New
TTCP0105E Online New
TTCP0106E Online New
TTCP0110E Online New
TTCP0111E Online New
TTCP0112E Online New
TTCP0113E Online New
TTCP0114E Online New
TTCP0115E Online New
TTCP0116E Online New
TTCP0117E Online New
TTCP0118E Online New
TTCP0120E Online New
TTCP0121E Online New
TTCP0122E Online New
TTCP0125E Online New
TTCP0126E Online New
TTCP0127E Online New
TTCP0128E Online New
TTCP0129E Online New
TTCP0130E Online New
TTCP0131E Online New
TTCP0201E Online New
TTCP0202E Online New
TTCP0203I Online New
TTCP0204E Online New
TTCP0205E Online New
TTCP0206E Online New
TTCP0207E Online New
TTCP0208W Online New
TTCP0209E Online New
TTCP0210E Online New
TTCP0211I Online New
TTCP0212E Online New
TTCP0213E Online New
TTCP0214E Online New
TTCP0215E Online New
TTCP0216E Online New
TTCP0217E Online New
TTCP0218E Online New
TTCP0219E Online New
TTCP0220E Online New
TTCP0221E Online New
TTCP0222E Online New

Performance or Tuning Changes

Use the ZTTCP DISPLAY command and the IP trace facility (the ZIPTR command or the offline IPTPRT facility) to monitor your TPF 4.1 system and the IP network. Some things to look for include:

Use the SNAKEY macro to define or change the number of socket block entries, IPMT entries, and read buffers. Use the ZTTCP DEFINE and ZTTCP CHANGE commands to define and change the maximum packet size.

See TPF Transmission Control Protocol/Internet Protocol for more information about performance and tuning considerations for TCP/IP native stack support. See TPF ACF/SNA Network Generation for more information about the SNAKEY macro. See TPF Operations for more information about the ZIPTR and the ZTTCP commands.

Storage Considerations and Changes

Use the SNAKEY macro to define the size of the main storage tables used by TCP/IP native stack support. See TPF Transmission Control Protocol/Internet Protocol for more information about how to determine the size of these tables.

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 652 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 652. Changes to TPF Publications for TCP/IP Native Stack Support

Publication Title Softcopy File Name Description of Change
TPF ACF/SNA Network Generation GTPACF0A Updated with information about new SNAKEY macro parameters for TCP/IP native stack support.
TPF Concepts and Structures GTPCON08 Updated with information about TCP/IP native stack support.
TPF Library Guide GTPDOC0B Updated with definitions for new terminology in the master glossary.
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 TCP/IP native stack support.
TPF Migration Guide: Program Update Tapes GTPMG201 Updated with migration considerations for TCP/IP native stack support.
TPF Operations GTPOPR0B Updated with information about the commands that were added and changed for TCP/IP native stack support.
TPF Program Development Support Reference GTPPDR0B Updated with information about new dump labels for TCP/IP native stack support.
TPF System Generation GTPSYG0B Updated with information about TCP/IP native stack support.
TPF System Installation Support Reference GTPINR0B Updated with information about new user exits for TCP/IP native stack support.
TPF System Macros GTPSYS0B Updated with information about new and changed system macros for TCP/IP native stack support.
TPF Transmission Control Protocol/Internet Protocol GTPCLW07 Updated with information about TCP/IP native stack support.

Host System Changes

There are no changes.

Application Programming Interface (API) Changes

Existing TPF socket applications that are using TCP/IP offload support do not require changes to use TCP/IP native stack support. However, you may need to change the local IP address to which the TPF application binds. With TCP/IP offload support, the TPF application binds to the IP address of the offload device. With TCP/IP native stack support, the TPF application binds to the IP address of the TPF host itself. If you have socket client applications or socket server applications in your TPF 4.1 system that bind to a specific IP address, you may need to change the IP address to which they bind.

TCP/IP native stack support provides support for additional socket options. Your socket applications must issue the setsockopt function call to enable the new options for that socket.

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 native stack support on your existing TPF 4.1 system:

  1. Install program update tape (PUT) 11.
  2. Define the following parameters on the SNAKEY macro in keypoint 2 (CTK2):
    • MAXSOCK
    • MAXIPCCW
    • IPRBUFFS
    • IPRBUFSZ
    • IPMTSIZE
    • SOCKSWP.
  3. Code the select TCP/IP support user exit (USOK) and the TCP/IP native stack support accept connection user exit (UACC), if necessary.
  4. Load the updated CTK2 to your TPF 4.1 system.
  5. IPL the TPF 4.1 system and cycle to 1052 state.
  6. Define the local IP addresses to the TPF 4.1 system by using the ZTTCP DEFINE command.
  7. Define the IP routers to the TPF 4.1 system by using the ZTTCP DEFINE command.
  8. Enter the ZTTCP TRACE command to do the following:
    • Activate the IP trace facility.
    • Select which resources to trace.
    • Set the amount of data to trace.
    • Set whether or not to write IP trace data to a real-time tape.
  9. Activate the IP routers by using the ZTTCP ACTIVATE command.
  10. Cycle the TPF 4.1 system to NORM state.
  11. Activate your socket applications.

Additional Information:

Fallback Scenarios

To disable TCP/IP native stack support, do one of the following:

See TPF System Installation Support Reference for more information about USOK.