gtpm2m2c | Migration Guide: Program Update Tapes |
The following section discusses the migration considerations for TCP/IP support for the TPF Application Requester.
See the APEDIT for APAR PJ27079 for information about prerequisite APARs.
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.
Support is provided for both offload and native stack devices.
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.
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 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. |
There are no changes.
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.
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 |
There are no changes.
There are no changes.
There are no changes.
There are no changes.
There are no changes.
There are no changes.
There are no changes.
There are no changes.
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. |
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. |
The following section summarizes the macro changes. This information is presented in alphabetic order by the type of macro.
There are no changes.
There are no changes.
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 |
There are no changes.
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 |
There are no changes.
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.
SIP Skeleton and Internal Macro | New, Changed, or No Longer Supported? |
---|---|
SPPGML | Changed |
There are no changes.
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 |
There are no changes.
There are no changes.
There are no changes.
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. |
The following section summarizes system equate changes.
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 |
There are no 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.
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. |
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.
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 |
There are no 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.
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.
There are no changes.
There are no 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. |
There are no changes.
There are no changes.
There are no changes.
TCP/IP support for the TPF Application Requester adds support for the TPFAR feature only.
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.
To install TCP/IP support for TPFAR on your TPF 4.1 system, you must install program update tape (PUT) 12.
Notes: