gtpm2m1c | Migration Guide: Program Update Tapes |
The following section discusses the migration considerations for TCP/IP resource management.
See the APEDIT for APAR PJ24525 for information about prerequisite APARs.
TCP/IP resource management provides:
If communication across a socket stops, the socket can still stay open until one of the following occurs:
Socket sweeper support closes inactive socket descriptors after a specified period of time so the inactive socket descriptors can be free for another communication session.
You can define one or more subsystems in your TPF 4.1 system. Socket subsystem support enables socket applications to issue socket application programming interface (API) function calls from any TPF 4.1 subsystem.
You can take sample data collection runs during TCP/IP processing and produce a system summary report that contains the number of socket reads for each second. Programmers can analyze the performance of their socket applications with the help of this data.
Additional support to systems with multiple TCP/IP offload devices attached and for socket applications that issue a bind with the wildcard option is provided with error code EINACTWS and an update to an existing error code EINACT.
C542 screens all connection requests before they are returned to the server application.
TCP/IP resource management contains five major items:
There are no changes.
The following section summarizes interface changes.
The following section summarizes C/C++ language changes. This information is presented in alphabetic order by the type of C/C++ language information. See the TPF C/C++ Language Support User's Guide and TPF Application Programming for more information about the C/C++ language.
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). |
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 |
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 |
There are no changes.
There are no changes.
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. |
There are no changes.
Table 291 summarizes changes to members (object files). This information is presented in alphabetic order by the name of the member (object file).
Notes:
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. |
There are no changes.
There are no changes.
There are no changes.
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. |
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 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 |
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 |
There are no changes.
There are no changes.
There are no changes.
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 |
There are no changes.
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 |
There are no changes.
There are no changes.
There are no changes.
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. |
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 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. |
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 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. |
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 |
There are no changes.
There are no changes.
There are no changes.
There are no changes.
There are no 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. |
There are no changes.
There are no changes.
There are no changes.
There are no changes.
There are no changes.
Use the following procedure to install TCP/IP resource management in your TPF 4.1 system.
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.