gtpm2m1m | Migration Guide: Program Update Tapes |
The following section discusses the migration considerations for Transmission Control Protocol/Internet Protocol (TCP/IP) application tools.
See the APEDIT for APAR PJ25375 for information about prerequisite APARs.
TCP/IP application tools implements the ZDTCP command, used to assess network connectivity as part of TCP/IP diagnosis. TCP/IP application tools provides the following functions:
To deal with TCP/IP support and the Internet, TPF systems must handle both alphanumeric host names and numeric IP addresses. Included in TCP/IP application tools is support for the gethostbyaddr and gethostbyname application programming interface (API) functions to enable socket applications like the Domain Name System (DNS) application to:
TCP/IP application tools provides you with the ability to use alphanumeric host names and numeric IP addresses through programs that query a DNS server for information about a specific domain. TCP/IP application tools uses the gethostbyaddr API function to allow the DNS application to get the host name when given the IP address and the gethostbyname API function to allow the DNS application to get the IP address when given the host name.
TCP/IP application tools implements common Internet commands to display a requested IP address, the amount of time the request took to travel the network, and to indicate the IP addresses used to reach the requested node.
There are no changes.
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 TPF C/C++ Language Support User's Guide and TPF Application Programming for more information about the C/C++ language.
Table 414 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 414. Changes to Build Scripts for TCP/IP Application Tools
Build Script | Type | New, Changed, or No Longer Supported? | Description of Change |
---|---|---|---|
CISOBS | DLM | Changed | Added the CGTIME library member object file. |
CLTNBS | DLM | New | Build script for the CLTN dynamic load module (DLM). |
CLTRBS | DLM | New | Build script for the CLTR DLM. |
COMXBS | DLM | Changed | Added the CGTHBA, CGTHBN, and CINTOA library object files. |
CPG0BS | DLM | Changed | Changed to pair with the E0I1 translate table. |
There are no changes.
Table 415 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 415. Changes to General Use C/C++ Language Header Files for TCP/IP Application Tools
C/C++ Language Header File | New, Changed, or No Longer Supported? | Do You Need to Recompile Segments? |
---|---|---|
icmp.h | New | Not Applicable |
ioctl.h | Changed | No |
ip.h | Changed | No |
i$tcpc.h | New | Not Applicable |
i$tcpn.h | New | Not Applicable |
nameser.h | New | Not Applicable |
netdb.h | New | Not Applicable |
sysgtime.h | New | Not Applicable |
socket.h | Changed | No |
udp.h | New | Not Applicable |
Table 416 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? |
---|---|---|
c$ck2sn.h | Changed | No |
c$iscfdt.h | Changed | No |
c$isclnt.h | Changed | No |
c$syseq.h | Changed | No |
Table 417 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 417. Changes to Library Interface Scripts for TCP/IP Application Tools
Library Interface Script | New, Changed, or No Longer Supported? | Description of Change |
---|---|---|
CISOXV | Changed | Added linkage for the gettimeofday function. |
COMXXV | Changed | Added linkage for the gethostbyaddr, gethostbyname, and inet_ntoa API functions. |
Table 418 summarizes the library member (object file) changes.
This information is presented in alphabetic order by the name of the library
member (object file).
Table 418. Changes to Library Members (Object Files) for TCP/IP Application Tools
Library Member (Object File) | Library Module Name | New, Changed, or No Longer Supported? | Type | Description of Change |
---|---|---|---|---|
CGTHBA | COMX | New | C Language | Processes the gethostbyaddr API function. |
CGTHBN | COMX | New | C Language | Processes the gethostbyname API function. |
CGTIME | CISO | New | C Language | Processes the gettimeofday API function. |
CINTOA | COMX | New | C Language | Processes the inet_ntoa API function. |
C511 | COMX | Changed | C Language | Changed for NETSTAT support. |
C513 | COMX | Changed | C Language | Changed for NETSTAT, PING, and TRACERTE support. |
C514 | COMX | Changed | C Language | Changed for NETSTAT support. |
C515 | COMX | Changed | C Language | Changed for NETSTAT support. |
C525 | COMX | Changed | C Language | Changed for NETSTAT support. |
C536 | COMX | Changed | C Language | Changed for PING and TRACERTE support. |
C539 | COMX | Changed | C Language | Changed for PING and TRACERTE support. |
There are no changes.
Table 419 summarizes changes to members (object files). This information is presented in alphabetic order by the name of the member (object file).
Notes:
Table 419. Changes to Members (Object Files) for TCP/IP Application Tools
Member (Object File) | DLM/DLL | New, Changed, or No Longer Supported? | Type | Description of Change |
---|---|---|---|---|
CLCA | CLCA | Changed | C Language | Changed to obtain storage for the NETSTAT table. |
CLCE | CLCE | Changed | C Language | Changes for NETSTAT support. |
CLTN | CLTN | New | C Language | ZDTCP command parser. |
CLTQ | CLTN | New | C Language | ZDTCP command with the PING parameter message handler. |
CLTR | CLTR | New | C Language | TCP/IP restart. |
CLTS | CLTN | New | C Language | ZDTCP command with the NETSTAT parameter message handler. |
CLTT | CLTN | New | C Language | ZDTCP command with the TRACERTE parameter message handler. |
CLTU | CLTN | New | C Language | ZDTCP command with the DNS parameter message handler. |
CPGS | CPGSBS | Changed | C Language | Updated the TPF Application Requester (TPFAR) translation table. |
There are no changes.
There are no changes.
There are no changes.
There are no changes.
Table 420 summarizes fixed file record changes. This
information is presented in alphabetic order by the name of the fixed file
record.
Table 420. Changes to Fixed File Records for TCP/IP Application Tools
Fixed File Record | New, Changed, or No Longer Supported? | Description of Change |
---|---|---|
#IBMM4 | Changed | A new miscellaneous record is used to retain the primary and secondary name servers. Ordinal numbers 150 to 157 must be available. |
The following section summarizes the macro changes. This information is presented in alphabetic order by the type of macro.
There are no changes.
There are no changes.
Table 421 summarizes the data macro changes. This information
is presented in alphabetic order by the name of the data macro.
Table 421. Changes to Data Macros for TCP/IP Application Tools
Data Macro | New, Changed, or No Longer Supported? | Do You Need to Reassemble Programs That Use This Data Macro? |
---|---|---|
CK2SN | Changed | No |
ISCFDT | Changed | No |
There are no changes.
Table 422 summarizes the selected equate macro changes. This
information is presented in alphabetic order by the name of the selected
equate macro.
Table 422. Changes to Selected Equate Macros for TCP/IP Application Tools
Selected Equate Macro | New, Changed, or No Longer Supported? | Do You Need to Reassemble Programs? |
---|---|---|
SYSEQ | Changed | No |
There are no changes.
Table 423 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. See TPF System Generation for a complete description of the
SIP skeleton and internal macros. If the 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 423. Changes to SIP Skeleton and Internal Macros for TCP/IP Application Tools
SIP Skeleton and Internal Macro | New, Changed, or No Longer Supported? |
---|---|
SPPGML | Changed |
There are no changes.
Table 424 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. See TPF System
Generation for a complete description of the SIP Stage II macros.
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 424. Changes to SIP Stage II Macros for TCP/IP Application Tools
SIP Stage II Macro | New, Changed, or No Longer Supported? |
---|---|
IBMPAL | Changed |
There are no changes.
There are no changes.
There are no changes.
Table 425 summarizes segment changes. This information is
presented in alphabetic order by the name of the segment.
Table 425. Changes to Segments for TCP/IP Application Tools
Segment | Type | Link-Edit Module (Where Offline Segment Is Linked) | New, Changed, or No Longer Supported? | Description of Change |
---|---|---|---|---|
CLC0 | Real-Time Assembler | Not Applicable | Changed | Changed to issue cremc to the CLTR program during system restart. |
CVAB | Real-Time Assembler | Not Applicable | Changed | Added the entry for the ZDTCP command. |
The following section summarizes system equate changes.
Table 426 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 426. Changes to SYSEQ Tags for TCP/IP Application Tools
SYSEQ Tag | Equate Value | New, Changed, or No Longer Supported? |
---|---|---|
$TCPIPCT | 150 | New |
There are no changes.
The following section summarizes functional and operational changes. This information is presented in alphabetic order by the functional or operational change.
See Appendix A, "PUT 2-15 Interface Changes by Authorized Program Analysis Report (APAR)" for a summary of functional and operational changes by APAR.
Table 427 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 427. Changes to Commands for TCP/IP Application Tools
Command | New, Changed, or No Longer Supported? | Description of Change |
---|---|---|
ZDTCP | New | Added the ZDTCP command with the DNS, NETSTAT, PING, and TRACERTE parameters. |
Table 428 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 428. Changes to Messages and System Errors for TCP/IP Application Tools
Message ID or System Error Number | Message Type | New, Changed, or No Longer Supported? |
---|---|---|
CLCA0001E | Online | New |
CLTR0001I | Online | New |
CLTR0002E | Online | New |
CLTR0003E | Online | New |
CLTR0004E | Online | New |
CLTR0005E | Online | New |
DTCP0001I | Online | New |
DTCP0003I | Online | New |
DTCP0004I | Online | New |
DTCP0005I | Online | New |
DTCP0006I | Online | New |
DTCP0009I | Online | New |
DTCP0010E | Online | New |
DTCP0011E | Online | New |
DTCP0013I | Online | New |
DTCP0020E | Online | New |
DTCP0022E | Online | New |
DTCP0023E | Online | New |
DTCP0024E | Online | New |
DTCP0025E | Online | New |
DTCP0026E | Online | New |
DTCP0027I | Online | New |
DTCP0028E | Online | New |
DTCP0030E | Online | New |
DTCP0031E | Online | New |
DTCP0040E | Online | New |
DTCP0041E | Online | New |
DTCP0042I | Online | New |
DTCP0051E | Online | New |
DTCP0052E | Online | New |
DTCP0053E | Online | New |
DTCP0054E | Online | New |
There are no changes.
There are no changes.
There are no changes.
There are no changes.
There are no changes.
Table 429 summarizes changes to the publications in the TPF
library. This information is presented in alphabetic order by the
publication title. See TPF Library Guide for
more information about the TPF library.
Table 429. Changes to TPF Publications for TCP/IP Application Tools
Publication Title | Softcopy File Name | Description of Change |
---|---|---|
TPF C/C++ Language Support User's Guide | GTPCLU08 | Updated with information about the gettimeofday function. |
Messages (System Error and Offline) and Messages (Online) | Not Appliable | Updated with information about messages and system errors that were added, changed, and no longer supported for TCP/IP application tools. |
TPF Migration Guide: Program Update Tapes | GTPMIG08 | Updated with migration considerations for TCP/IP application tools. |
TPF Operations | GTPOPR08 | Updated with information about the commands that were added and changed for TCP/IP application tools. |
TPF Transmission Control Protocol/Internet Protocol | GTPCLW04 | Updated with information about the gethostbyaddr, gethostbyname, and inet_ntoa API functions. |
There are no changes.
The following API functions were ported to the TPF 4.1 system:
See TPF Transmission Control Protocol/Internet Protocol for information about these API functions. See TPF C/C++ Language Support User's Guide and OS/390 C/C++ Run-Time Library Reference for information about the gettimeofday API function.
There are no changes.
There are no changes.
To verify that TCP/IP application tools has been installed correctly, do the following.
Additional Information:
See TPF Operations for more information about the ZCLAW and ZDTCP commands.
Use the following procedure to install TCP/IP application tools in your TPF 4.1 system.