gtpm2m1cMigration Guide: Program Update Tapes

Transmission Control Protocol/Internet Protocol (TCP/IP) Resource Management (APAR PJ24525)

The following section discusses the migration considerations for TCP/IP resource management.

Prerequisite APARs

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

Functional Overview

TCP/IP resource management provides:

Architecture

TCP/IP resource management contains five major items:

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

Build Scripts

Table 287 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 287. Changes to Build Scripts for TCP/IP Resource Management

Build Script Type New, Changed, or No Longer Supported? Description of Change
CLCWBS DLM New Build script for the CLCW dynamic load module (DLM).
COMXBS DLM Changed Added library member object file (C542).

Dynamic Load Module (DLM) Stubs

Table 288 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 288. Changes to Dynamic Load Module (DLM) Stubs for TCP/IP Resource Management

DLM Stub New, Changed, or No Longer Supported?
CLCW New

General Use C Language Header Files

Table 289 summarizes the general use C language header file changes. This information is presented in alphabetic order by the name of the general use C language header file.

General use means these header files are available for your use.

Table 289. Changes to General Use C Language Header Files for TCP/IP Resource Management

General Use C Language Header File New, Changed, or No Longer Supported? Do You Need to Recompile Segments?
c$ck2sn.h Changed No
c$isccdt.h Changed No
c$iscfdt.h Changed No
c$isclnt.h Changed No
c$sthr.h Changed No
socket.h Changed No

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

There are no changes.

Library Interface Scripts

There are no changes.

Library Members (Object Files)

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

Table 290. Changes to Library Members (Object Files) for TCP/IP Resource Management

Library Member (Object File) Library Module Name New, Changed, or No Longer Supported? Type Description of Change
C510 COMX Changed Assembler Changes to allow system programs to locate a socket control block.
C511 COMX Changed C Language Changes for socket accept user exit.
C512 COMX Changed C Language Changes for sweeper function, subsystem support, and multiple TCP/IP offload device support .
C513 COMX Changed C Language Changes for multiple TCP/IP offload device support.
C514 COMX Changed C Language Changes for multiple TCP/IP offload device support.
C515 COMX Changed C Language Changes for multiple TCP/IP offload device support.
C516 COMX Changed C Language Changes for multiple TCP/IP offload device support.
C517 COMX Changed C Language Changes for multiple TCP/IP offload device support.
C518 COMX Changed C Language Changes for multiple TCP/IP offload device support.
C519 COMX Changed C Language Changes for multiple TCP/IP offload device support.
C520 COMX Changed C Language Changes for multiple TCP/IP offload device support.
C524 COMX Changed C Language Changes for multiple TCP/IP offload device support.
C525 COMX Changed C Language Changes for multiple TCP/IP offload device support.
C528 COMX Changed C Language Changes for multiple TCP/IP offload device support.
C529 COMX Changed C Language Changes for sweeper function, subsystem support, and multiple TCP/IP offload device support.
C530 COMX Changed C Language Changes for sweeper function, subsystem support, and multiple TCP/IP offload device support.
C531 COMX Changed C Language Changes for multiple multiple TCP/IP offload device support.
C532 COMX Changed C Language Changes for multiple TCP/IP offload device support.
C533 COMX Changed C Language Changes for multiple TCP/IP offload device support.
C534 COMX Changed C Language Changes for multiple TCP/IP offload device support.
C536 COMX Changed C Language Changes for the socket sweeper function.
C537 COMX Changed C Language Changes for multiple TCP/IP offload device support.
C539 COMX Changed C Language Changes for multiple TCP/IP offload device support.
C540 COMX Changed C Language Changes for sweeper function, subsystem support, and multiple TCP/IP offload device support.
C542 COMX New C Language Added the socket accept user exit.

Link-Edited Modules

There are no changes.

Members (Object Files)

Table 291 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 291. Changes to Members (Object Files) for TCP/IP Resource Management

Member (Object File) DLM/DLL New, Changed, or No Longer Supported? Type Description of Change
CLA1 CLA1 Changed C Language Changed WTOPC error message from CLAW0076E to CLAW0038E.
CLA2 CLA2 Changed C Language Changed WTOPC error message from CLAW0076E to CLAW0038E.
CLA3 CLA3 Changed C Language Changed to issue WTOPC error message only if at computer room agent set (CRAS) state or higher.
CLCE CLCE Changed C Language Changes for sweeper function, subsystem support, and multiple TCP/IP offload device support.
CLCF CLCB Changed C Language Changes for sweeper function, subsystem support, and multiple TCP/IP offload device support.
CLCK CLCK Changed C Language Changes for the sweeper function.
CLCR CLCR Changed C Language Changes for subsystem support.
CLCW CLCW New C Language Socket sweeper function.
CLSU CLSU Changed C Language Changes for socket subsystem support.
CLZI CLZK Changed C Language Changed to allow data trace and process trace to run at the same time.

Object Code Only (OCO) Stubs

There are no changes.

Configuration Constant (CONKC) Tags

There are no changes.

Control Program Interface (CINFC) Tags

There are no changes.

Copy Members

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

Table 292. Changes to Copy Members for TCP/IP Resource Management

Copy Member Type CSECT Where Copy Member Is Located New, Changed, or No Longer Supported? Description of Change
CLB4 Control Program CCLAW1 Changed Deleted code associated with the DIAG 98 instruction.
CLWP Control Program CCLAW3 Changed Changes for subsystem support, data collection, and multiple TCP/IP offload device support.
CLWW Control Program CCLAW3 Changed Changed to ensure locks for all CLAW control block structures are unheld during system error processing.

Fixed File Records

There are no changes.

Macros

The following section summarizes the macro changes. This information is presented in alphabetic order by the type of macro.

Advanced Program-to-Program Communications (APPC) Macros

There are no changes.

Communication Macros and Statements

Table 293 summarizes changes to the communication macros and statements. This information is presented in alphabetic order by the name of the communication macro or statement.

Table 293. Changes to Communication Macros and Statements for TCP/IP Resource Management

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

Data Macros

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

Table 294. Changes to Data Macros for TCP/IP Resource Management

Data Macro New, Changed, or No Longer Supported? Do You Need to Reassemble Programs Using This Data Macro?
CK2SN Changed No
ISCFDT Changed No
ISTHR Changed No

General Macros

There are no changes.

Selected Equate Macros

There are no changes.

Structured Programming Macros (SPMs)

There are no changes.

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

Table 295 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 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 295. Changes to SIP Skeleton and Internal Macros for TCP/IP Resource Management

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 296 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 296. Changes to SIP Stage II Macros for TCP/IP Resource Management

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 297 summarizes segment changes. This information is presented in alphabetic order by the name of the segment.

Table 297. Changes to Segments for TCP/IP Resource Management

Segment Type Linke-Edit Module (Where Offline Segment Is Linked) New, Changed, or No Longer Supported? Description of Change
CSK0 Real-Time Assembler Not Applicable Changed Added code to change and display the socket sweeper CRET interval.
CTK2 Real-Time Assembler Not Applicable Not Applicable Needs to be reassembled.

System Equates

There are no changes.

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 298. Changes to ECB User Exits for TCP/IP Resource Management

Function User Exit Activated In User Exit Program New, Changed, or No Longer Supported? Description of Change
Socket Accept User Exit C511 C542 New Provides a centralized program to screen all connection requests before they are returned to the socket application. C542 is entered each time the accept() API function call receives a connection request from a client.

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 299 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 299. Changes to Commands for TCP/IP Resource Management

Command New, Changed, or No Longer Supported? Description of Change
ZNKEY Changed Added support for the SOCKSWP parameter.

Messages and System Errors

Table 300 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 300. Changes to Messages and System Errors for TCP/IP Resource Management

Message ID or System Error Number Message Type New, Changed, or No Longer Supported?
CLAW0038E Online Changed

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 301 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 301. Changes to TPF Publications for TCP/IP Resource Management

Publication Title Softcopy File Name Description of Change
TPF ACF/SNA Network Generation GTPACF06 Updated with the SOCKSWP parameter for the SNAKEY macro that was added for TCP/IP resource management.
TPF Library Guide GTPDOC06 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, or no longer supported for TCP/IP resource management.
TPF Migration Guide: Program Update Tapes GTPMIG06 Updated with migration considerations for TCP/IP resource management.
TPF Operations GTPOPR06 Updated with information about the commands that were added or changed for TCP/IP resource management.
TPF System Installation Support Reference GTPINR06 Updated with the socket accept user exit, which was added for TCP/IP resource management.
TPF Transmission Control Protocol/Internet Protocol GTPCLW02 Updated with information about the error codes that were added or changed, and the new SOCKSWP parameter (of the SNAKEY macro) which was added for TCP/IP resource management.

Host System Changes

There are no changes.

Application Programming Interface (API) Changes

There are no changes.

Database Changes

There are no changes.

Feature Changes

There are no changes.

Installation Validation

There are no changes.

Migration Scenarios

Use the following procedure to install TCP/IP resource management in your TPF 4.1 system.

  1. Install PUT 6.
  2. Update the socket activation user exit (CLCH), socket cycle-up user exit (CLCV), and all other appropriate socket applications to switch to subsystems other than the basic subsytem (BSS) if socket subsystem support is needed. See TPF System Installation Support Reference for more information about these user exits.
  3. Update the socket accept user exit (C542). See TPF System Installation Support Reference for more information about this user exit.
  4. If you will be attaching more than one TCP/IP offload device for each processor, update all socket applications to test for the EINACTWS error code. See TPF Transmission Control Protocol/Internet Protocol for more information about the EINACTWS error code.
  5. Set the SOCKSWP parameter in the SNAKEY macro to define the socket sweeper CRET interval in keypoint record 2 (CTK2).

    See TPF Transmission Control Protocol/Internet Protocol for information about the value to specify for this parameter. See TPF ACF/SNA Network Generation for more information about the SNAKEY macro.

  6. Load the updated keypoint record 2 (CTK2).
  7. Recompile all changed ISO-C DLMs (both system and application code), prelink, link-edit, and reload. See Interface Changes for more information about the updated ISO-C programs.
  8. Run the system allocator (SALO) to include the new CLCW segment.
  9. Reassemble the CCLAW1 and CCLAW3 CSECTs.
  10. Link-edit the control program (CPS0).
  11. Link-edit the COMX library because of changes to the library members.
  12. Reassemble CSK0 and C510 assembler segments.
  13. Perform an initial program load (IPL).