gtpm2m2cMigration Guide: Program Update Tapes

Transmission Control Protocol/Internet Protocol Support for the TPF Application Requester (APAR PJ27079)

The following section discusses the migration considerations for TCP/IP support for the TPF Application Requester.

Prerequisite APARs

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

Functional Overview

The TPF Application Requester (TPFAR) feature has been enhanced to support connectivity by using Transmission Control Protocol/Internet Protocol (TCP/IP). This adds an additional level of operability with relational databases that use Distributed Relational Database Architecture (DRDA) level 3. Data can now be shared between database servers that are compliant with DRDA level 3 and a TPF application using the TPFAR feature. The communication manager providing TCP/IP network protocol support (CMNTCPIP) and the security manager (SECMGR) are supported at DRDA level 5. No other features of DRDA level 3 have been added.

An existing TPFAR application will continue to run without the need to recompile, reassemble, or reload. In addition, application programs that currently use the TPFAR feature can take advantage of new functions without recompiling, but rather by reconfiguring the internal Structured Query Language (SQL) database management system directory (SDD) by using the ZSQLD command to specify connection information for the TCP/IP host. The SDD has been expanded to 10 ordinals and modified to use processor unique fixed file record IBMMP4. This involves the migration of fixed file records from IBMM4 to IBMMP4. The ZSQLD command has been updated to allow you to associate an Internet Protocol (IP) address with a database name as well as to determine whether access to this database should be by a Systems Network Architecture (SNA) or TCP/IP connection. You can specify either a host name or an IP address to choose the TCP/IP host that you want to connect to. The ZSQLD parser has also been updated to receive the ZSQLD parameters in any order. See TPF Operations for more information about the ZSQLD command.

Hotcons are now supported to include TCP/IP socket connections. Previously, only hot conversations for LU 6.2 were supported. The TPF socket sweeper is disabled while connections are in the hotcon table. See TPF ACF/SNA Network Generation for more information about hotcons.

Note:
Socket sweeper enhancements (APAR PJ26917), which is part of program update tape (PUT) 12, is required for TCP/IP support for the TPF Application Requester.

Support is provided for both offload and native stack devices.

Architecture

TCP/IP support for the TPFAR feature is based on DRDA level 3. DRDA is a connection protocol for distributed relational database processing that describes the contents of all the data objects that flow on either commands or replies between the application requester (AR) and the application server (AS).

The basis for DRDA is Distributed Data Management Architecture (DDM). DDM is the architecture that allows an application program to work on data that resides in a remote system. DDM describes the common interfaces for the interchange of data; specifically, the commands, parameters, data objects, and reply messages. DDM levels are broken down into manager levels for the various components. The new manager levels supported with TCP/IP support for the TPFAR feature are CMNTCPIP and SECMGR.

Operating Environment Requirements and Planning Information

There are no changes.

Interface Changes

The following section summarizes interface changes.

C/C++ Language

The following section summarizes C/C++ language changes. This information is presented in alphabetic order by the type of C/C++ language information. See the TPF C/C++ Language Support User's Guide and TPF Application Programming for more information about the C/C++ language.

Build Scripts

Table 757 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 757. Changes to Build Scripts for TCP/IP Support for the TPF Application Requester

Build Script Type New, Changed, or No Longer Supported? Description of Change
CPGBBS DLM New Created to support the translate table.
CRDABS DLM Changed CREF was added to CRDABS.
CREABS DLM Changed CREF was added to CRDEBS.

Dynamic Load Module (DLM) Stubs

There are no changes.

General Use C/C++ Language Header Files

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

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

Table 758. Changes to General Use C/C++ Language Header Files for TCP/IP Support for the TPF Application Requester

C/C++ Language Header File New, Changed, or No Longer Supported? Do You Need to Recompile Segments?
c$icmn.h Changed Yes
c$iddm.h Changed Yes
c$iddmeq.h Changed Yes
c$idir.h Changed Yes
c$ihctcb.h Changed Yes
c$imer.h Changed Yes
c$isddcb.h Changed Yes
c$istpcb.h Changed Yes
c$syseq.h Changed Yes

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

There are no changes.

Library Interface Scripts

There are no changes.

Library Members (Object Files)

There are no changes.

Link-Edited Modules

There are no changes.

Members (Object Files)

There are no changes.

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

Table 759. Changes to Copy Members for TCP/IP Support for the TPF Application Requester

Copy Member Type CSECT Where Copy Member Is Located DLM Where CSECT Is Located New, Changed, or No Longer Supported? Description of Change
CCEB Control Program CCENBK Not Applicable Changed Updated to support TCP/IP hotcons.
CRD0 Control Program CCNUCL Not Applicable Changed Updated to support Distributed Relational Database Architecture (DRDA) level 3.

Fixed File Records

Table 760 summarizes fixed file record changes. This information is presented in alphabetic order by the name of the fixed file record.

Table 760. Changes to Fixed File Records for TCP/IP Support for the TPF Application Requester

Fixed File Record New, Changed, or No Longer Supported? Description of Change
IBMMP4 Changed Updated to move the SDD entries to a processor unique record.

Macros

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

Advanced Program-to-Program Communications (APPC) Macros

There are no changes.

Communication Macros and Statements

There are no changes.

Data Macros

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

Table 761. Changes to Data Macros for TCP/IP Support for the TPF Application Requester

Data Macro New, Changed, or No Longer Supported? Do You Need to Reassemble Programs Using This Data Macro?
CFMDC Changed Yes
CZ1SE Changed Yes
IDDMEQ Changed Yes
IHCTCB Changed Yes
ISTPCB Changed Yes
SNAKEY Changed Yes

General Macros

There are no changes.

Selected Equate Macros

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

Table 762. Changes to Selected Equate Macros for TCP/IP Support for the TPF Application Requester

Selected Equate Macro New, Changed, or No Longer Supported? Do You Need to Reassemble Programs?
SYSEQ Changed Yes

Structured Programming Macros (SPMs)

There are no changes.

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

Table 763 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. 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 763. Changes to SIP Skeleton and Internal Macros for TCP/IP Support for the TPF Application Requester

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

System Initialization Program (SIP) Stage I Macros and Statements

There are no changes.

System Initialization Program (SIP) Stage II Macros

Table 764 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. 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 764. Changes to SIP Stage II Macros for TCP/IP Support for the TPF Application Requester

SIP Stage II Macro New, Changed, or No Longer Supported?
IBMPAL Changed

System Communication Keypoint (SCK) Generation Macros

There are no changes.

System Macros

There are no changes.

System Macros (IBM Use Only)

There are no changes.

Segments

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

Table 765. Changes to Segments for TCP/IP Support for the TPF Application Requester

Segment Type Link-Edit Module (Where Offline Segment Is Linked) New, Changed, or No Longer Supported? Description of Change
CRDA C Language CREA, CRDA Changed Updated with support for TCP/IP.
CRDB C Language CREA, CRDA Changed Updated with support for TCP/IP.
CRDC C Language CREA, CRDA Changed Updated with support for TCP/IP.
CRDE C Language CREA, CRDA Changed Updated with support for TCP/IP
CRDF C Language CREA, CRDA Changed Updated with support for TCP/IP.
CRDH C Language CREA, CRDA Changed Updated with support for TCP/IP.
CRDI C Language CREA, CRDA Changed Updated with support for TCP/IP.
CRDK C Language CREA, CRDA Changed Updated with support for TCP/IP.
CRDM C Language CREA, CRDA Changed Updated with support for TCP/IP.
CRDO C Language CRDU Changed Updated with support for TCP/IP.
CRDP C Language CRDU Changed Updated with support for TCP/IP.
CRDU C Language CRDU Changed Updated with support for TCP/IP.
CRDV C Language CRDU Changed Updated with support for TCP/IP.
CRDZ C Language CREA, CRDA Changed Updated with support for TCP/IP.
CRD9 Real-Time Assembler Not Applicable Changed Updated with support for TCP/IP.
CREA C Language CREA, CRDA Changed Updated with support for TCP/IP.
CREB C Language CREA, CRDA Changed Updated with support for TCP/IP.
CREF C Language CREA, CRDA New Created to support TCP/IP.
CREG C Language CREA, CRDA Changed Updated with support for TCP/IP.
CREH C Language CREA, CRDA Changed Updated with support for TCP/IP.
CREI C Language CREA, CRDA Changed Updated with support for TCP/IP.
CREK C Language CREA, CRDA Changed Updated with support for TCP/IP.
CSKA Real-Time Assembler Not Applicable Changed Updated with support for TCP/IP.
CSNAM Real-Time Assembler CISO Changed Updated with support for TCP/IP.

System Equates

The following section summarizes system equate changes.

SYSEQ Tags

Table 766 summarizes changes to equates that are not configuration dependent (in SYSEQ). This information is presented in alphabetic order by the name of the SYSEQ tag.

Table 766. Changes to SYSEQ Tags for TCP/IP Support for the TPF Application Requester

SYSEQ Tag Equate Value New, Changed, or No Longer Supported?
#AR_SDD1 2 New
#AR_SDD2 3 New
#AR_SDD3 4 New
#AR_SDD4 5 New
#AR_SDD5 6 New
#AR_SDD6 7 New
#AR_SDD7 8 New
#AR_SDD8 9 New
#AR_SDD9 10 New
#AR_SDD10 11 New
#AR_SDD_EOT 0 New

User Exits

There are no changes.

Functional and Operational Changes

The following section summarizes functional and operational changes. This information is presented in alphabetic order by the functional or operational change.

See Appendix A, "PUT 2-15 Interface Changes by Authorized Program Analysis Report (APAR)" for a summary of functional and operational changes by APAR.

Commands

Table 767 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 767. Changes to Commands for TCP/IP Support for the TPF Application Requester

Command New, Changed, or No Longer Supported? Description of Change
ZNKEY Changed Updated the MAXHCT parameter.
ZSQLD Changed Updated with new parameters for TCP/IP options.

Messages and System Errors

Table 768 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 768. Changes to Messages and System Errors for TCP/IP Support for the TPF Application Requester

Message ID or System Error Number Message Type New, Changed, or No Longer Supported?
0007E7 System Error New 
0007E8 System Error New 
CRD90021I Online Changed
NKEY0021E Online No Longer Supported
NKEY0022E Online No Longer Supported
NKEY0121E Online New
NKEY0122E Online New
SQLD0017I Online No Longer Supported
SQLD0018I Online No Longer Supported
SQLD0051W Online No Longer Supported
SQLD0052W Online No Longer Supported
SQLD0117I Online New
SQLD0118I Online New
SQLD0151W Online New
SQLD0152W Online New

Performance or Tuning Changes

There are no changes.

Storage Considerations and Changes

The TPFAR feature uses one socket for each connection, so the number of available sockets must, at least, equal the number of connections. Use the MAXSOCK parameter of the SNAKEY macro to set the maximum number of sockets. If hotcons are used, sockets are then saved in the hotcon table (HCT). See TPF ACF/SNA Network Generation for more information about the SNAKEY macro and the hotcon table.

System Initialization Program (SIP) and System Generation Changes

To use TCP/IP support for the TPFAR feature you must have sockets defined, so the MAXSOCK parameter of the SNAKEY macro must be greater than zero. See TPF ACF/SNA Network Generation for more information about the SNAKEY macro.

Loading Process Changes

There are no changes.

Online System Load Changes

There are no changes.

Publication Changes

Table 769 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 769. Changes to TPF Publications for TCP/IP Support for the TPF Application Requester

Publication Title Softcopy File Name Description of Change
TPF ACF/SNA Network Generation GTPACF0B Updated the MAXHCT parameter and added new definitions.
TPF Application Requester User's Guide GTPARU04 Updated with information about TCP/IP support for the TPF Application Requester.
TPF Library Guide GTPDOC0C 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, and no longer supported for TCP/IP support for the TPF Application Requester.
TPF Migration Guide: Program Update Tapes GTPMG201 Updated with migration considerations for TCP/IP support for the TPF Application Requester.
TPF Operations GTPOPR0C Updated the ZSQLD command for TCP/IP support for the TPF Application Requester.
TPF Program Development Support Reference GTPPDV0C Updated with a terminology change for TCP/IP support for the TPF Application Requester.

Host System Changes

There are no changes.

Application Programming Interface (API) Changes

There are no changes.

Database Changes

There are no changes.

Feature Changes

TCP/IP support for the TPF Application Requester adds support for the TPFAR feature only.

Installation Validation

When you perform an initial program load (IPL) of the TPF 4.1 system, a Structured Query Language (SQL) database management system directory (SDD) migration message is displayed indicating that the SDD has been migrated successfully. If this message is not displayed, TCP/IP support for the TPF Application Requester has not been installed. After migration, all SDD modifications are saved in the new IBMMP4 fixed file records. The SDD migration message will continue to be displayed during TPF restart until an entry is added or modified in the SDD that will cause the SDD to be filed (for example, a ZSQLD command with the ADD parameter specified). See TPF Operations for more information about the ZSQLD command.

Migration Scenarios

To install TCP/IP support for TPFAR on your TPF 4.1 system, you must install program update tape (PUT) 12.

Notes:

  1. Once you have installed TCP/IP support for the TPF Application Requester, all database modifications that you have made to the SDD by using the ZSQLD commnd are filed in the IBMMP4 fixed file record. See TPF Operations for more information about the ZSQLD command. If you need to fall back to a level of code that does not have TCP/IP support for the TPF Application Requester (for example, to resolve a problem), all the database modifications that have been filed in fixed file record IBMMP4 become unavailable as soon as you load the back-level code. However, the database modifications filed in IBMMP4 will become available again at the next migration.

  2. Socket sweeper enhancements (APAR PJ26917), which is part of PUT 12, is required for TCP/IP support for the TPF Application Requester.