gtpm2m1mMigration Guide: Program Update Tapes

Transmission Control Protocol/Internet Protocol (TCP/IP) Application Tools (APAR PJ25375)

The following section discusses the migration considerations for Transmission Control Protocol/Internet Protocol (TCP/IP) application tools.

Prerequisite APARs

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

Functional Overview

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:

Architecture

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.

Operating Environment Requirements and Planning Information

There are no changes.

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 TPF C/C++ Language Support User's Guide and TPF Application Programming for more information about the C/C++ language.

Build Scripts

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.

Dynamic Load Module (DLM) Stubs

There are no changes.

General Use C/C++ Language Header Files

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

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

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.

Table 416. Changes to Implementation-Specific C/C++ Language Header Files (IBM Use Only) for TCP/IP Application Tools

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

Library Interface Scripts

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.

Library Members (Object Files)

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.

Link-Edited Modules

There are no changes.

Members (Object Files)

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

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

There are no changes.

Fixed File Records

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.

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

There are no changes.

Data Macros

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

General Macros

There are no changes.

Selected Equate Macros

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

Structured Programming Macros (SPMs)

There are no changes.

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

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

System Initialization Program (SIP) Stage I Macros and Statements

There are no changes.

System Initialization Program (SIP) Stage II Macros

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

System Communication Keypoint (SCK) Generation Macros

There are no changes.

System Macros

There are no changes.

System Macros (IBM Use Only)

There are no changes.

Segments

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.

System Equates

The following section summarizes system equate changes.

SYSEQ Tags

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

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

Messages and System Errors

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

Performance or Tuning Changes

There are no changes.

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

Host System Changes

There are no changes.

Application Programming Interface (API) 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.

Database Changes

There are no changes.

Feature Changes

There are no changes.

Installation Validation

To verify that TCP/IP application tools has been installed correctly, do the following.

  1. Cycle the TPF 4.1 system to NORM state.
  2. Enter ZCLAW DISPLAY ALL and ensure that at least one offload device is connected.
  3. Enter ZDTCP DNS DISPLAY and check that no DNS server information is displayed.
  4. Enter ZDTCP PING ipaddress (where ipaddress is the dotted decimal address of a node in your network). If the node is connected, the TPF 4.1 system then responds with the time it took to travel the network.
  5. Enter ZDTCP TRACERTE host (where host is the dotted decimal form of an IP address connected to your network). If the node is connected, then the TPF 4.1 system responds with the route taken to it. The response is saved until the ZDTCP command completes, so the response may seem slow. Also, the node must be within 16 hops or it is considered unreachable.
  6. Enter the ZDTCP command with the NETSTAT parameter specified and ensure that either the DTCP0003I message or the DTCP0042I message is displayed.

Additional Information:

See TPF Operations for more information about the ZCLAW and ZDTCP commands.

Migration Scenarios

Use the following procedure to install TCP/IP application tools in your TPF 4.1 system.

  1. Install program update tape (PUT) 8.
  2. Run the system allocator (SALO) to include the CLTN and CLTR segments.
  3. Ensure that #IBMM4 ordinals 150 to 157 are defined.
  4. Produce the object code for the changed COMMXV and CISOXV library interface scripts.
  5. Recompile all new and changed DLM members and library members.
  6. Link-edit the new and changed build scripts, including the COMX and CISO libraries.
  7. Reassemble the CLC0 and CVAB segments.
  8. Load the updated object code to your TPF 4.1 system.
  9. Perform an initial program load (IPL).