gtpm2m0z | Migration Guide: Program Update Tapes |
The following section discusses the migration considerations for TCP/IP offload support.
See the APEDIT for APAR PJ21791 for information about prerequisite APARs.
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.
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.
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.
The following section contains information about hardware requirements.
The following section discusses types of devices and control units.
TCP/IP offload support provides support for the IBM 3172 Model 3 Interconnect Controller with the IBM 3172 Offload Feature installed.
The following section contains information about software requirements.
The following section summarizes the communication changes.
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.
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:
|
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. See TPF Transmission Control Protocol/Internet Protocol for more information about the C/C++ language functions provided with TCP/IP offload support.
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. |
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 |
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 |
There are no changes.
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. |
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. |
There are no changes.
Table 150 summarizes changes to members (object files). This information is presented in alphabetic order by the name of the member (object file).
Notes:
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. |
There are no changes.
There are no changes.
There are no changes.
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. |
There are no changes.
The following section summarizes the macro changes. This information is presented in alphabetic order by the type of macro.
There are no changes.
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 |
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 |
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 |
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 |
There are no changes.
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 |
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 |
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 |
There are no changes.
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 |
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 |
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. |
There are no changes.
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 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). |
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 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. |
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 |
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.
There are no 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.
There are no changes.
There are no 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. |
There are no 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.
There are no changes.
There are no changes.
There are no changes.
Use the following procedure to install TCP/IP offload support in your TPF 4.1 system.
See TPF System Installation Support Reference for more information about these user exits.
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.
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.
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.
See TPF Operations for more information about the ZCYCL 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.
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.
See TPF ACF/SNA Network Generation for more information about the SNAKEY macro and these parameters.