gtpm2m0zMigration Guide: Program Update Tapes

Transmission Control Protocol/Internet Protocol (TCP/IP) Offload Support (APAR PJ21791)

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

Prerequisite APARs

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

Functional Overview

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

Open Connectivity, which allows socket applications on the TPF 4.1 system to communicate through a TCP/IP offload device with socket applications on remote TCP/IP devices.

Enhanced Role in the Internet, which allows the TPF 4.1 system to connect to the Internet through a TCP/IP offload device.

Industry Standard Socket application programming interface (API), which provides an industry standard API that contains ISO-C socket function calls. You can use the socket API on the TPF 4.1 system to create socket applications that can communicate with other socket applications on remote TCP/IP devices.

Client/Server Environment where you can use the socket API to create socket applications that allow the TPF 4.1 system to function as either a client or server.

Ease of Porting Socket Applications because the ISO-C socket function calls use an industry standard API, you can easily port socket applications to the TPF 4.1 system.

Architecture

TCP/IP offload support is an offload implementation based on the TCP/IP offload device. Socket applications in the TPF 4.1 system communicate through a TCP/IP offload device to other socket applications in remote TCP/IP devices.

A socket API, which consists of standard ISO-C socket function calls, is provided with TCP/IP offload support. You can use the socket API to create socket applications for the TPF 4.1 system.

When a TPF application issues a socket function call, the call is sent to a TCP/IP offload device using the Common Link Access to Workstation (CLAW) protocol. The TCP/IP offload device then communicates with the remote node using TCP/IP. The TCP/IP offload device uses the CLAW protocol to pass the socket API return code back to the TPF 4.1 system. The TPF system then presents the return code to the application that issued the socket function call.

See TPF Transmission Control Protocol/Internet Protocol for more information about TCP/IP offload support and the socket API.

Operating Environment Requirements and Planning Information

To ensure that your TPF 4.1 system performs correctly with TCP/IP offload support, you must establish the required operating environment. The following section describes hardware and software requirements specific to TCP/IP offload 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

The following section contains information about hardware requirements.

Control Units

The following section discusses types of devices and control units.

Communication Control Units

TCP/IP offload support provides support for the IBM 3172 Model 3 Interconnect Controller with the IBM 3172 Offload Feature installed.

Software (Programming Requirements)

The following section contains information about software requirements.

Communication

The following section summarizes the communication changes.

Operating Environment for TCP/IP-Based Communication

Transmission Control Protocol/Internet Protocol (TCP/IP) offload support requires an IBM 3172 Model 3 Interconnect Controller with the IBM 3172 Offload Feature installed.

The IBM 3172 Model 3 Interconnect Controller can be attached to the TPF 4.1 system using either a parallel channel adapter or an Enterprise Systems Connection (ESCON) channel adapter.

Programming Request for Price Quotation (PRPQ)

You must order PRPQ 5799-QWZ to obtain the software for the IBM 3172 Offload Feature mentioned in Hardware and Software (Programming Requirements). Call TPF Systems to order PRPQ 5799-QWZ.

Table 144. Programming Request for Price Quotation (PRPQ) for TCP/IP offload support

PRPQ and Product Feature Description
5799-QWZ for TCP/IP Offload Support Contains the following features:

Feature Number
Description

 9001 
Asset registration on the TPF 4.1 system.

 4003 
IBM 3172 Offload Feature.

 5805 
The TPF TCP/IP Offload program (shipped on diskettes), which is preloaded when the 4003 feature number is specified during ordering. In addition, you will receive the following publications:

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. See TPF Transmission Control Protocol/Internet Protocol for more information about the C/C++ language functions provided with TCP/IP offload support.

Build Scripts

Table 145 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 145. Changes to Build Scripts for TCP/IP Offload Support

Build Script Type New, Changed, or No Longer Supported? Description of Change
CLA1BS DLM New Build script for the CLA1 DLM.
CLA2BS DLM New Build script for the CLA2 DLM.
CLA3BS DLM New Build script for the CLA3 DLM.
CLA4BS DLM New Build script for the CLA4 DLM.
CLCABS DLM New Build script for the CLCA DLM.
CLCBBS DLM New Build script for the CLCB DLM.
CLCCBS DLM New Build script for the CLCC DLM.
CLCDBS DLM New Build script for the CLCD DLM.
CLCEBS DLM New Build script for the CLCE DLM.
CLCHBS DLM New Build script for the CLCH DLM.
CLCIBS DLM New Build script for the CLCI DLM.
CLCJBS DLM New Build script for the CLCJ DLM.
CLCKBS DLM New Build script for the CLCK DLM.
CLCMBS DLM New Build script for the CLCM DLM.
CLCQBS DLM New Build script for the CLCQ DLM.
CLCRBS DLM New Build script for the CLCR DLM.
CLCXBS DLM New Build script for the CLCX DLM.
CLSUBS DLM New Build script for the CLSU DLM.
CLZKBS DLM New Build script for the CLZK DLM.
COMXBS DLM New Build script for the COMX library.

Dynamic Load Module (DLM) Stubs

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

DLM Stub New, Changed, or No Longer Supported?
CLA1 New
CLA2 New
CLA3 New
CLA4 New
CLCD New
CLCE New
CLCH New
CLCI New
CLCJ New
CLCL New
CLCM New
CLCQ New
CLCX New
CLSX New

General Use C Language Header Files

Table 147 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 147. Changes to General Use C Language Header Files for TCP/IP Offload Support

General Use C Language Header File TARGET (TPF) ISO-C New, Changed, or No Longer Supported? Do You Need to Recompile Segments?
c$ck2sn.h X X Changed No
c$eb0eb.h X X Changed No
c$icadap.h   X New Not Applicable
c$icpath.h   X New Not Applicable
c$isccdt.h   X New Not Applicable
c$iscfdt.h   X New Not Applicable
c$iscipt.h   X New Not Applicable
c$isclnt.h   X New Not Applicable
c$isiucv.h   X New Not Applicable
c$isqlmc.h X X Changed No
c$itrtbl.h   X New Not Applicable
claw.h   X New Not Applicable
ioctl.h   X New Not Applicable
ip.h   X New Not Applicable
socket.h   X New Not Applicable
sysapi.h X X Changed No
types.h   X New Not Applicable

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

There are no changes.

Library Interface Scripts

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

Library Interface Script New, Changed, or No Longer Supported? Description of Change
COMXXV New Communications related functions.

Library Members (Object Files)

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

Table 149. Changes to Library Members (Object Files) for TCP/IP Offload Support

Library Member (Object File) Library Module Name New, Changed, or No Longer Supported? Type Description of Change
C501 COMX New Assembler Processes the claw_accept function.
C502 COMX New Assembler Processes the claw_closeadapter function.
C503 COMX New Assembler Processes the claw_connect function.
C504 COMX New Assembler Processes the claw_disconnect function.
C505 COMX New Assembler Processes the claw_end function.
C506 COMX New Assembler Processes the claw_initialization function.
C507 COMX New Assembler Processes the claw_openadapter function.
C508 COMX New Assembler Processes the claw_query function.
C509 COMX New Assembler Processes the claw_send function.
C510 COMX New Assembler CLAW block processing.
C511 COMX New C Language Processes the socket accept function.
C512 COMX New C Language Processes the socket activate_on_receipt function.
C513 COMX New C Language Processes the socket bind function.
C514 COMX New C Language Processes the socket close function.
C515 COMX New C Language Processes the socket connect function.
C516 COMX New C Language Processes the socket gethostid function.
C517 COMX New C Language Processes the socket gethostname function.
C518 COMX New C Language Processes the socket getpeername function.
C519 COMX New C Language Processes the socket getsockname function.
C520 COMX New C Language Processes the socket getsockopt function.
C521 COMX New C Language Processes the socket htonl function.
C522 COMX New C Language Processes the socket htons function.
C523 COMX New C Language Processes the socket inet_addr function.
C524 COMX New C Language Processes the socket ioctl function.
C525 COMX New C Language Processes the socket listen function.
C526 COMX New C Language Processes the socket ntohl function.
C527 COMX New C Language Processes the socket ntohs function.
C528 COMX New C Language Processes the socket read function.
C529 COMX New C Language Processes the socket recv and recvfrom functions.
C530 COMX New C Language Processes the socket select function.
C531 COMX New C Language Processes the socket send function.
C532 COMX New C Language Processes the socket sendto function.
C533 COMX New C Language Processes the socket setsockopt function.
C534 COMX New C Language Processes the socket shutdown function.
C535 COMX New C Language Processes the socket sock_errno function.
C536 COMX New C Language Processes the socket socket function.
C537 COMX New C Language Processes the socket write function.
C538 COMX New C Language Processes the socket writev function.
C539 COMX New C Language Allocate an inter-user communication vehicle (IUCV) block.
C540 COMX New C Language Pass an inter-user communication vehicle (IUCV) block to the CLAW service routine.
C541 COMX New C Language Creates an inter-user communication vehicle (IUCV) block and sends the setsockopt function call to the TCP/IP offload device.

Link-Edited Modules

There are no changes.

Members (Object Files)

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

Member (Object File) DLM/DLL New, Changed, or No Longer Supported? Type Description of Change
CLA1 CLA1 New C Language Sends notification when there is a Common Link Access to Workstation (CLAW) adapter failure and deactivates the connection between the TPF 4.1 system and the workstation application.
CLA2 CLA2 New C Language Sends notification when a CLAW path is being disconnected.
CLA3 CLA3 New C Language Sends notification when a CLAW connection request is received from a remote user.
CLA4 CLA4 New C Language Nonsocket message user exit.
CLCA CLCA New C Language CLAW cycle-up processing.
CLCB CLCB New C Language CLAW cycle-down processing.
CLCC CLCC New C Language Retrieves the CLAW device table (CDT) from fixed file record type #IBMM4.
CLCD CLCD New C Language Gets the current core copy of the CLAW device table (CDT) and saves it on file.
CLCE CLCE New C Language Disconnects the TCP/IP offload device.
CLCF CLCB New C Language Socket cycle-down process; disconnects all connections between the TPF 4.1 system and the TCP/IP offload devices.
CLCH CLCH New C Language Socket activation user exit.
CLCI CLCI New C Language Socket deactivation user exit.
CLCJ CLCJ New C Language Socket restart.
CLCK CLCK New C Language Offload restart.
CLCM CLCM New C Language Nonsocket deactivation user exit.
CLCN CLCC New C Language Initializes the CLAW trace parameters during restart.
CLCQ CLCQ New C Language Nonsocket activation user exit.
CLCR CLCR New C Language Processes the socket system errors.
CLCX CLCX New C Language Socket system error user exit.
CLSU CLSU New C Language Receives unsolicited messages from the TCP/IP offload device that indicate state changes.
CLZD CLZK New C Language Processes the ZCLAW ADD command.
CLZE CLZK New C Language Processes the ZCLAW DELETE command.
CLZF CLZK New C Language Processes the ZCLAW ACTIVATE command.
CLZG CLZK New C Language Processes the ZCLAW INACTIVATE command.
CLZH CLZK New C Language Processes the ZCLAW HELP command.
CLZI CLZK New C Language Processes the ZCLAW TRACE command.
CLZJ CLZK New C Language Processes the ZCLAW DISPLAY command.
CLZK CLZK New C Language Processes the initial call to all the ZCLAW command.
CLZL CLZK New C Language Processes the ZCLAW STATUS command.
CLZM CLZK New C Language Subroutine for the ZCLAW INACTIVATE command.
CLZN CLZK New C Language Subroutine for the ZCLAW INACTIVATE command.
CLZO CLZK New C Language Subroutine for the ZCLAW STATUS command.
CLZP CLZK New C Language Subroutine for the ZCLAW ACTIVATE command.

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

Table 151. Changes to Copy Members for TCP/IP Offload Support

Copy Member Type CSECT Where Copy Member Is Located New, Changed, or No Longer Supported? Description of Change
CCPU Control Program CCNUCL Changed Added an entry for CPMCLAW.
CIDP Control Program CCCPSE Changed Defined dump overrides for CLAW system errors.
CIEF Control Program CCCIEF Changed Added return codes for the EVNTC and POSTC macros.
CLBA Control Program CCLAW1 New Deletes a CLAW logical link.
CLBB Control Program CCLAW1 New Notifies the host application when a logical link is deleted.
CLBC Control Program CCLAW1 New Handles interrupts in the CLAW device interface.
CLBD Control Program CCLAW1 New Adds pending read CLAW message queue elements to the read channel program.
CLBE Control Program CCLAW1 New Initiates CLAW I/O.
CLBF Control Program CCLAW1 New Processes a DISCONNECT request from the host application.
CLBG Control Program CCLAW1 New Handles transaction requests from the host application.
CLBH Control Program CCLAW1 New Periodic scanning routine.
CLBI Control Program CCLAW1 New Notifies the application of a completed SEND request.
CLBJ Control Program CCLAW1 New Adds pending write CLAW message queue elements to the write channel program.
CLBK Control Program CCLAW1 New Polling routine to check for completed messages.
CLBL Control Program CCLAW1 New Notifies the workstation application when a logical link is deleted.
CLBM Control Program CCLAW1 New Attaches completed write CLAW message queue elements to the CLAW device interface extension block, which is defined by the ICLTRB data macro.
CLBN Control Program CCLAW1 New Queues RECEIVE requests from the workstation application.
CLBO Control Program CCLAW1 New Issues an ACCEPT request in response to a CONNECT request from the workstation.
CLBP Control Program CCLAW1 New Translate tables.
CLBQ Control Program CCLAW1 New Queues CLAW message queue elements for READ requests.
CLBR Control Program CCLAW1 New Returns signed out pages to the CLAW device interface.
CLBS Control Program CCLAW1 New Queues SEND requests from the host application.
CLBT Control Program CCLAW1 New Removes the completed writes from the active CLAW message queue element queue.
CLBU Control Program CCLAW1 New Removes the completed reads from the active CLAW message queue element queue.
CLBV Control Program CCLAW1 New CLAW request dispatcher.
CLBW Control Program CCLAW1 New Queues CLAW message queue elements for WRITE requests.
CLBX Control Program CCLAW1 New Processes a CONNECT request from the host application.
CLBY Control Program CCLAW1 New Close and cleanup processor; cleans up adapter control blocks, frees up attached control blocks, and stops I/O to the workstation.
CLBZ Control Program CCLAW1 New Build CLAW message queue elements from pending write CLAW device interface extension blocks, defined by the ICLTRB data macro.
CLB0 Control Program CCLAW1 New Return completed READ requests to the host application.
CLB1 Control Program CCLAW1 New Process a CLAW transaction subrequest for logical link 0.
CLB2 Control Program CCLAW1 New CLAW device interface main entry point.
CLB3 Control Program CCLAW1 New Handles I/O interrupts for CLAW devices.
CLB4 Control Program CCLAW1 New Performs the CLAW initialization function by setting up permanent work areas, channel programs, and control blocks.
CLB5 Control Program CCLAW1 New Handles the CLAW process trace function.
CLB6 Control Program CCLAW1 New CLAW application programming interface (API) services prolog.
CLHH Control Program CCSTOR Changed Updated to allow the MALOC macro to be called from the control program (CP).
CLHL Control Program CCCLHR Changed Updated to allow CLAW devices to be polled.
CLWB Control Program CCLAW3 New Unsuspends an entry control block (ECB) after a CLAW API call.
CLWF Control Program CCLAW3 New Performs the CLAW post-interrupt routine for SEND COMPLETE processing.
CLWG Control Program CCLAW3 New Post-interrupt routine for FAIL ADAPTER processing.
CLWI Control Program CCLAW3 New CLAW CONNECT cleanup.
CLWJ Control Program CCLAW3 New CLAW DISCONNECT cleanup.
CLWK Control Program CCLAW3 New Post-interrupt routine for a RECEIVE request with an error.
CLWM Control Program CCLAW3 New Post-interrupt routine for an ACCEPT request from the workstation.
CLWN Control Program CCLAW3 New Starts the internal generation of RECEIVE requests to the CLAW device interface after a host application issues an ACCEPT or an ACCEPT is received from a CLAW workstation application.
CLWP Control Program CCLAW3 New Post-interrupt routine for a RECEIVE request without an error.
CLWQ Control Program CCLAW3 New Returns a page to the available list after the READ COMPLETE routines copy data from that page.
CLWS Control Program CCLAW3 New Performs internally the equivalent of the claw_closeadapter function.
CLWT Control Program CCLAW3 New Performs internally the equivalent of the claw_disconnect function.
CLWU Control Program CCLAW3 New CLAW buffer trace facility.
CLWV Control Program CCLAW3 New CLAW process trace facility.
CLWW Control Program CCLAW3 New Catastrophic dump lock picking routine.
CLWX Control Program CCLAW3 New Suspend an ECB after a CLAW API call.
CLWY Control Program CCLAW3 New CLAW buffer/process trace common segment.
CLW1 Control Program CCLAW3 New Root segment for post-interrupt processing.
CLW2 Control Program CCLAW3 New Performs fail processing on the CLAW adapter.
CLW3 Control Program CCLAW3 New Drops the adapter control block from the active queue.
CLW4 Control Program CCLAW3 New Returns storage block to CLAW control block pool.
CLW5 Control Program CCLAW3 New Obtains storage block from the CLAW control block pool.
CLW6 Control Program CCLAW3 New CLAW macro interface processing.
CLW7 Control Program CCLAW3 New Locates CLAW control blocks.
CLW8 Control Program CCLAW3 New Processes CLAW device interface subrequests.
CLW9 Control Program CCLAW3 New Post-interrupt routine for initialization complete processing.
CPSE Control Program CCCPSE Changed Updated to define the CLAW unlock routine.
CT15 Control Program CCCTIN Changed Updated to carve out storage defined in the new MSAT3 table.

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 152 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 152. Changes to Communication Macros and Statements for TCP/IP Offload Support

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

Data Macros

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

Table 153. Changes to Data Macros for TCP/IP Offload Support

Data Macro New, Changed, or No Longer Supported? Do You Need to Reassemble Programs Using This Data Macro?
CK2SN Changed No
DCTSWC Changed Yes
EB0EB Changed No
ICADAP New Not Applicable
ICDDOR New Not Applicable
ICDIOB New Not Applicable
ICGBLK New Not Applicable
ICLAWB New Not Applicable
ICLAWE New Not Applicable
ICLAWG New Not Applicable
ICLAWP New Not Applicable
ICLCFC New Not Applicable
ICLCFG New Not Applicable
ICLCON New Not Applicable
ICLIBK New Not Applicable
ICLIOI New Not Applicable
ICLLOG New Not Applicable
ICLTRB New Not Applicable
ICLWRC New Not Applicable
ICMSGB New Not Applicable
ICNBLK New Not Applicable
ICPATH New Not Applicable
ICPERM New Not Applicable
ICPOLL New Not Applicable
ICQBLK New Not Applicable
ICRBLK New Not Applicable
ICRCCW New Not Applicable
ICSGBK New Not Applicable
ICTRCE New Not Applicable
ICUBLK New Not Applicable
ICWCCW New Not Applicable
IDSTTR Changed Yes
ISCFDT New Not Applicable
ISIUCV New Not Applicable
ITRTBL New Not Applicable

General Macros

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

Table 154. Changes to General Macros for TCP/IP Offload Support

General Macro New, Changed, or No Longer Supported? Do You Need to Reassemble Programs?
MALOC Changed No
POSTC Changed No

Selected Equate Macros

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

Table 155. Changes to Selected Equate Macros for TCP/IP Offload Support

Selected Equate Macro New, Changed, or No Longer Supported? Do You Need to Reassemble Programs?
CLAWC New Not Applicable
CZOCP Changed Yes
CZ1SE Changed No
ECBEQ Changed No
IEQCE2 Changed No

Structured Programming Macros (SPMs)

There are no changes.

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

Table 156 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 contorl language (JCL) jobs from the SIP Stage II deck.

Table 156. Changes to SIP Skeleton and Internal Macros for TCP/IP Offload Support

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

System Initialization Program (SIP) Stage I Macros and Statements

Table 157 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 157. Changes to SIP Stage I Macros and Statements for TCP/IP Offload Support

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

System Initialization Program (SIP) Stage II Macros

Table 158 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 158. Changes to SIP Stage II Macros for TCP/IP Offload 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 159 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 159. Changes to System Macros for TCP/IP Offload Support

System Macro New, Changed, or No Longer Supported? Do You Need to Reassemble Programs?
CLAWCC New Not Applicable
GCLAC New Not Applicable
IBMSVC Changed Not Applicable
IDATB Changed Yes
RCLAC New Not Applicable
TCLAC New Not Applicable

System Macros (IBM Use Only)

Table 160 summarizes system macro (IBM use only) changes. This information is presented in alphabetic order by the name of the system macro.

Table 160. Changes to System Macros (IBM Use Only) for TCP/IP Offload Support

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

Segments

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

Table 161. Changes to Segments for TCP/IP Offload Support

Segment Type Link-Edit Module (Where Offline Segment Is Linked) New, Changed, or No Longer Supported? Description of Change
CCLAW1 CSECT Not Applicable New CLAW device interface code; performs I/O to and from CLAW devices.
CCLAW3 CSECT Not Applicable New CLAW service routines.
CLA5 Real-Time Assembler Not Applicable New CLAW entry point (EP) process root.
CLCL Real-Time Assembler Not Applicable New Writes CLAW trace record to tape.
CLC0 Real-Time Assembler Not Applicable New Socket/CLAW Restart; initializes tables and blocks.
CLSX Real-Time Assembler Not Applicable New Socket catastrophic routine; takes a catastrophic dump if there are no more file descriptors available.
CLTD Offline Assembler CLTD40 New CLAW data trace postprocessor.
CLTP Offline Assembler CLTP40 New CLAW process trace postprocessor.
CPLKMP CSECT Not Applicable Changed Added CCLAW1 and CCLAW3.
CPSA Real-Time Assembler Not Applicable Changed Added code to go to the socket error handler if the ECB is a socket ECB.
CSK0 Real-Time Assembler Not Applicable Changed Added code to display CLAW values from keypoint record 2 (CTK2) for the ZNKEY command.
CTKR Real-Time Assembler Not Applicable Changed Added code to schedule socket cycle-down processing.
CTKS Real-Time Assembler Not Applicable Changed Added code to schedule socket restart processing.
CTKT Real-Time Assembler Not Applicable Changed Added code to schedule socket cycle-up processing.
CTU1 Real-Time C Language Not Applicable Changed Added code to update the event device table for CLAW devices.
CTU3 Real-Time C Language Not Applicable Changed Added code to post the event in the event device table for CLAW devices.
CVAB Real-Time Assembler Not Applicable Changed Added code to route ZCLAW commands to the CLZK DLM for processing.

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 162. Changes to ECB User Exits for TCP/IP Offload Support

Function User Exit Activated In User Exit Program New, Changed, or No Longer Supported? Description of Change
Nonsocket Message User Exit CLA5 CLA4 New Allows messages to be routed to specific nonsocket applications.
Socket Activation User Exit CLCJ, CLCK CLCH New Allows you to activate server applications.
Socket Deactivation User Exit CLCE, CLCF CLCI New Allows socket applications to clean up socket application resources.
Nonsocket Deactivation User Exit CLA1, CLA2, CLCB, CLZN CLCM New Allows nonsocket Common Link Access to Workstation (CLAW) applications to deactivate nonsocket CLAW application resources.
Nonsocket Activation User Exit CLCA, CLZP CLCQ New Allows nonsocket CLAW applications to be activated.
Socket System Error User Exit CLCR CLCX New Allows you to clean up the socket application resources for an entry control block (ECB).

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 163 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 163. Changes to Commands for TCP/IP Offload Support

Command New, Changed, or No Longer Supported? Description of Change
ZCLAW ACTIVATE New Activates a CLAW workstation.
ZCLAW ADD New Defines the CLAW workstation and CLAW host name for a processor.
ZCLAW DELETE New Deletes CLAW workstation definitions.
ZCLAW DISPLAY New Displays information about CLAW workstations.
ZCLAW INACTIVATE New Deactivates a CLAW workstation.
ZCLAW RESET New Resets the ZCLAW command lock.
ZCLAW STATUS New Displays status information about the active CLAW workstations.
ZCLAW TRACE New Starts and stops the CLAW trace functions.
ZNKEY Changed Added support for the CLAWADP, CLAWFD, and CLAWIP parameters.

Messages and System Errors

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

Message ID or System Error Number Message Type New, Changed, or No Longer Supported?
009100 System Error New
009101 System Error New
009102 System Error New
009103 System Error New
009104 System Error New
009105 System Error New
009106 System Error New
009107 System Error New
00910A System Error New
009110 System Error New
009111 System Error New
009112 System Error New
009113 System Error New
009114 System Error New
009115 System Error New
009116 System Error New
CLAW0001I Online New
CLAW0002E Online New
CLAW0003I Online New
CLAW0004E Online New
CLAW0005E Online New
CLAW0006E Online New
CLAW0007E Online New
CLAW0008I Online New
CLAW0009E Online New
CLAW0010I Online New
CLAW0011I Online New
CLAW0013I Online New
CLAW0014E Online New
CLAW0015E Online New
CLAW0018E Online New
CLAW0019E Online New
CLAW0021E Online New
CLAW0022E Online New
CLAW0023E Online New
CLAW0024E Online New
CLAW0026I Online New
CLAW0027E Online New
CLAW0028E Online New
CLAW0029E Online New
CLAW0030E Online New
CLAW0033E Online New
CLAW0035E Online New
CLAW0036E Online New
CLAW0037I Online New
CLAW0038E Online New
CLAW0039E Online New
CLAW0040E Online New
CLAW0041E Online New
CLAW0042E Online New
CLAW0043E Online New
CLAW0044I Online New
CLAW0045E Online New
CLAW0046I Online New
CLAW0047I Online New
CLAW0048E Online New
CLAW0071I Online New
CLAW0072I Online New
CLAW0073I Online New
CLAW0074I Online New
CLAW0082I Online New
CLAW0083E Online New
CLAW0084I Online New
CLAW0085E Online New
CLAW0086I Online New
CLAW0088E Online New
CLAW0089I Online New
CLAW0090E Online New
CLAW0091E Online New
CLAW0092I Online New
CLAW0093E Online New
CLAW0094I Online New
CLAW0095E Online New
CLAW0096E Online New
CLAW0097I Online New
CLAW0098I Online New
CLAW0099E Online New
CLCL0066W Online New
CLCL0067E Online New
CLC00001I Online New
SOCK0001E Online New
SOCK0002E Online New
SOCK0003E Online New
SOCK0004E Online New

Performance or Tuning Changes

Use the SNAKEY macro to define the size of the main storage tables that are used by TCP/IP offload support. See TPF Transmission Control Protocol/Internet Protocol for information about the recommended size of these tables.

Storage Considerations and Changes

There are no changes.

System Initialization Program (SIP) and System Generation Changes

The new COMX library requires 69 688 bytes in the core resident program area (CRPA) and 21 #XPRG records. Therefore, you may need to increase the size of the CRPA and define more #XPRG records. See TPF System Generation for more information.

Loading Process Changes

There are no changes.

Online System Load Changes

There are no changes.

Publication Changes

Table 165 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 165. Changes to TPF Publications for TCP/IP Offload Support

Publication Title Softcopy File Name Description of Change
TPF ACF/SNA Network Generation GTPACF04 Updated the description of the SNAKEY macro to include information about the new parameters that were added for TCP/IP offload support.
TPF Application Programming GTPAPP04 Updated with information about the new C header files that were added for TCP/IP offload support.
TPF C Language Support User's Guide GTPCLU04 Added references to TPF Transmission Control Protocol/Internet Protocol for information about the CLAW API and socket API functions.
TPF Concepts and Structures GTPCON02 Added a high-level description of TCP/IP offload support.
TPF Library Guide GTPDOC04 Updated with definitions for new terminology in the master glossary.
Messages (System Error and Offline) and Messages (Online) Not Applicable Updated with information about the messages and system errors that were added, changed, and no longer supported for TCP/IP offload support.
TPF Migration Guide: Program Update Tapes GTPMIG04 Updated with migration considerations for TCP/IP offload support.
TPF Operations GTPOPR04 Updated with information about the commands that were added and changed for TCP/IP offload support.
TPF Program Development Support Reference GTPPDR04 Updated with information about the new dump labels that were added for TCP/IP offload support.
TPF Programming Standards GTPPSM04 Updated with information about the C header files and equate macros that were added for TCP/IP offload support and do not conform to TPF standards.
TPF System Generation GTPSYG04 Added references to TPF Transmission Control Protocol/Internet Protocol for information about TCP/IP offload support.
TPF System Installation Support Reference GTPINR04 Updated with information about ECB control program (CP) user exits that were added for TCP/IP offload support.
TPF System Macros GTPSYS04 Updated with information about the system macros that were added and changed for TCP/IP offload support.
TPF Transmission Control Protocol/Internet Protocol GTPCLW00 Published a new publication for TCP/IP offload support. This publication contains information for the application programmer, system programmer, and operator.

Host System Changes

There are no changes.

Application Programming Interface (API) Changes

TCP/IP offload support provides a socket application programming interface (API) that contains ISO-C socket function calls. You can use the socket API to create socket applications on the TPF 4.1 system that can communicate with other socket applications on remote TCP/IP devices.

See TPF Transmission Control Protocol/Internet Protocol for more information about the socket API.

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 offload support in your TPF 4.1 system.

  1. Configure your network for TCP/IP offload support. See TPF Transmission Control Protocol/Internet Protocol for information.
  2. Install PUT 4, which contains TCP/IP offload support (APAR PJ21791), on the TPF 4.1 system. Be sure to do the following:
    1. Compile without TARGET(TPF) all required C programs. The required C programs are listed in Interface Changes.
    2. Assemble all required real-time assembler programs. The required real-time assembler programs are listed in Interface Changes.
    3. Assemble all required CSECTs. The required CSECTs are listed in Table 161.
    4. Generate stubs for the programs that are called externally by the new TCP/IP offload support DLMs.
    5. Generate the library stubs for the library functions in the newly created COMX library. This step is needed for only the basic subsystem (BSS).
    6. Create a new system allocator (SALO) that includes the following:
      • New COMX library
      • New TCP/IP offload support DLMs
      • New TCP/IP offload support real-time assembler programs.
    7. Recompile and run SALO to create an updated IPAT and TABLE.
    8. Link-edit all of the applicable C programs, making sure that you pick up the updated CSTRTD (C startup code) from APAR PJ21167 for the ISO-C DLMs.
    9. Link-edit the new COMX library, making sure that you pick up the updated CSTRTL (library startup code) from APAR PJ21167.
    10. Link-edit the control program (CPS0).
  3. Update the following user exits, if appropriate:
    • Nonsocket Message User Exit (CLA4)
    • Socket Activation User Exit (CLCH)
    • Socket Deactivation User Exit (CLCI)
    • Nonsocket Deactivation User Exit (CLCM)
    • Nonsocket Activation User Exit (CLCQ)
    • Socket System Error User Exit (CLCX).

    See TPF System Installation Support Reference for more information about these user exits.

  4. Use the SNAKEY macro to define the following information in keypoint record 2 (CTK2):
    • Number of CLAW adapters using the CLAWADP parameter
    • Number of file descriptors using the CLAWFD parameter
    • Number of local Internet Protocol (IP) addresses using the CLAWIP parameter.

    See TPF Transmission Control Protocol/Internet Protocol for information about the values to specify for these parameters. See TPF ACF/SNA Network Generation for more information about the SNAKEY macro.

  5. Load the updated keypoint record 2 (CTK2) to a processor in the TPF 4.1 system.
  6. Perform an initial program load (IPL) on that processor.
  7. After the processor reaches 1052 state, define the CLAW host name for that processor by entering the ZCLAW ADD command with the HOSTNAME parameter specified.

    See TPF Transmission Control Protocol/Internet Protocol for more information about defining the CLAW host name. See TPF Operations for more information about the ZCLAW ADD command.

  8. Define the Common Link Access to Workstation (CLAW) workstations for the processor by entering the ZCLAW ADD command.

    See TPF Transmission Control Protocol/Internet Protocol for more information about defining CLAW workstations. See TPF Operations for more information about the ZCLAW ADD command.

  9. Cycle the processor to CRAS state or above by entering the ZCYCL command.

    See TPF Operations for more information about the ZCYCL command.

  10. Activate the CLAW workstations by entering the ZCLAW ACTIVATE command.

    See TPF Transmission Control Protocol/Internet Protocol for more information about activating CLAW workstations. See TPF Operations for more information about the ZCLAW ACTIVATE command.

  11. Repeat steps 5-10 on each additional processor in your loosely coupled TPF 4.1 system where you want to install TCP/IP offload support.

Fallback Scenarios

If the conversion to TCP/IP offload support is not successful, you will need to fall back to the previous TPF environment, correct the problem, and try the conversion again.

Use the following procedure to fall back to the previous TPF environment.

  1. Use the SNAKEY macro to update keypoint record 2 (CTK2) and assign a zero value to the following SNAKEY parameters:
    • CLAWADP
    • CLAWFD
    • CLAWIP.

    See TPF ACF/SNA Network Generation for more information about the SNAKEY macro and these parameters.

  2. Load the updated keypoint record 2 (CTK2) to the TPF 4.1 system.
  3. Perform an initial program load (IPL) for the TPF 4.1 system.