gtpm2m23 | Migration Guide: Program Update Tapes |
The following section discusses the migration considerations for TCP/IP native stack support.
See the APEDIT for APAR PJ26683 for information about prerequisite APARs.
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.
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.
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:
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:
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:
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:
TCP/IP native stack support provides a full function IP trace facility that allows you to do the following:
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.
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.
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.
TCP/IP native stack support supports the following communication control units:
The TPF 4.1 system can connect to the following devices:
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 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). |
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 |
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 |
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.
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 |
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. |
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. |
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. |
Table 635 summarizes changes to members (object files). This information is presented in alphabetic order by the name of the member (object file).
Notes:
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. |
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 |
There are no changes.
There are no changes.
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. |
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. |
The following section summarizes the macro changes. This information is presented in alphabetic order by the type of macro.
There are no changes.
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 |
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 |
There are no changes.
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 |
There are no changes.
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 |
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 |
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 |
There are no changes.
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 |
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 |
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. |
The following section summarizes system equate changes.
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 |
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.
There are no changes.
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. |
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 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. |
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 |
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.
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.
There are no changes.
There are no changes.
There are no 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. |
There are no 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.
There are no changes.
There are no changes.
There are no changes.
Use the following procedure to install TCP/IP native stack support on your existing TPF 4.1 system:
Additional Information:
To disable TCP/IP native stack support, do one of the following:
See TPF System Installation Support Reference for more information about USOK.