gtpm2m2w | Migration Guide: Program Update Tapes |
The following section discusses the migration considerations for unlimited pool segment support.
See the APEDIT for APAR PJ27484 for information about prerequisite APARs.
Unlimited pool segment support enhances the recoup, pool directory update (PDU), pool generation, pool reallocation, and pool deactivation utilities in a TPF 4.1 system environment by doing the following:
Section 2 of the long-term directory reference table (LTDRT), which describes pool directories, is limited to 125 pool segments. Segment DYD0, which contains assembled pool segment information, is limited to 190 pool segments. The problem is that large TPF customer sites have more than 125 defined pool segments. Unlimited pool segment support eliminates pool segment restrictions by eliminating section 2 of the LTDRT and the assembled pool section information from program segment DYD0.
Section 2 of the LTDRT has been replaced by the IBM pool allocation resource table (IPART), which resides in main storage. ZPOOL GENERATION CREATE command processing no longer uses DYD0 to extract pool segment information. This information is now retrieved directly from the FACE table (FCTB).
Recoup and PDU processing sequentially searches the LTDRT to find the bit in a specific pool directory that represents a specific file address, but the LTDRT is a fixed file and the sequential search mechanism can be slow. Unlimited pool segment support replaces section 2 of the LTDRT with the IPART, which resides in main storage, and uses a combination index and B-tree search mechanism for quicker searches to improve recoup and PDU processing performance.
Pool generation and reallocation procedures have been changed. You no longer have to build an online pool maintenance available (OPMAAA) table or online pool maintenance deactivation (OPMBBB) table in the DYD0 segment because unlimited pool segment support eliminates the need for these tables. Internal processing calls to the RTCUC macro with the POOLSEGMENT parameter specified returns data similar to what existed in the OPMAAA table. Internal processing calls to the RTCUC macro with the DEACTIVATEDSEGMENT parameter specified returns data similar to what existed in the OPMBBB table. See TPF Database Reference for more information about pool generation and reallocation procedures.
There are no changes.
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 1041 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 1041. Changes to Build Scripts for Unlimited Pool Segment Support
Build Script | Type | New, Changed, or No Longer Supported? | Description of Change |
---|---|---|---|
BBLDBS | DLM | New | Created for unlimited pool segment support. |
There are no changes.
There are no changes.
Table 1042 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 1042. Changes to General Use C/C++ Language Header Files for Unlimited Pool Segment Support
C/C++ Language Header File | ISO-C | New, Changed, or No Longer Supported? | Do You Need to Recompile Segments? |
---|---|---|---|
c$cinfc.h | X | Changed | No |
c$cy3d.h | X | New | No |
c$cy7p.h | X | New | No |
c$fctb.h | X | Changed | No |
c$fgn0.h | X | Changed | No |
c$fps0.h | X | Changed | No |
c$frg0.h | X | Changed | No |
c$syseq.h | X | Changed | No |
Table 1043 summarizes the general use C/C++ language header file
changes that are for IBM use only. This information is presented in
alphabetic order by the name of the general use C/C++ language header
file.
C/C++ Language Header File (IBM Use Only) | ISO-C | New, Changed, or No Longer Supported? | Do You Need to Recompile Segments? |
---|---|---|---|
i$breq.h | X | Changed | No |
i$part.h | X | New | No |
i$recp.h | X | Changed | No |
There are no changes.
There are no changes.
There are no changes.
Table 1044 summarizes changes to members (object files). This information is presented in alphabetic order by the name of the member (object file).
Notes:
Table 1044. Changes to Members (Object Files) for Unlimited Pool Segment Support
Member (Object File) | DLM/DLL | New, Changed, or No Longer Supported? | Type | Description of Change |
---|---|---|---|---|
BBLD01 | BBLD | New | Real-Time Assembler | Created for unlimited pool segment support. |
BBUILD | BBLD | New | C Language | Created for unlimited pool segment support. |
BOFI | BOFI | Changed | C Language | Updated for unlimited pool segment support. |
BOF1 | BOF1 | Changed | C Language | Updated for unlimited pool segment support. |
There are no changes.
There are no changes.
Table 1045 summarizes the control program interface (CINFC) tag
changes. The information in this table is ordered numerically by the
equate value.
Table 1045. Changes to CINFC Tags for Integrated Online Pool Maintenance and Recoup Support
CINFC Tag | Equate Value | New, Changed, or No Longer Supported? |
---|---|---|
CMMIPART | 297 | New |
CMMLTDRT | 297 | No Longer Supported |
Table 1046 summarizes the copy member changes. This information
is presented in alphabetic order by the name of the copy member.
Table 1046. Changes to Copy Members for Unlimited Pool Segment Support
Copy Member | Type | CSECT Where Copy Member Is Located | DLM Where CSECT Is Located | New, Changed, or No Longer Supported? | Description of Change |
---|---|---|---|---|---|
CICR | Control Program | CCNUCL | Not Applicable | Changed | Updated for unlimited pool segment support. |
CTI0 | Control Program | CCCTIN | Not Applicable | Changed | Updated for unlimited pool segment support. |
RTCU | Control Program | CCDBAF | Not Applicable | Changed | Updated for unlimited pool segment support. |
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.
There are no changes.
Table 1047 summarizes the data macro changes. This information
is presented in alphabetic order by the name of the data macro.
Table 1047. Changes to Data Macros for Unlimited Pool Segment Support
Data Macro | New, Changed, or No Longer Supported? | Do You Need to Reassemble Programs Using This Data Macro? | Programs to Reassemble |
---|---|---|---|
FC0TB | Changed | No | Not Applicable |
IDSPS | New | No | Not Applicable |
IPART | New | No | Not Applicable |
LTDRT | Changed | No | Not Applicable |
Table 1048 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 1048. Changes to General Macros for Unlimited Pool Segment Support
General Macro | New, Changed, or No Longer Supported? | Do You Need to Reassemble Programs? | Programs to Reassemble |
---|---|---|---|
ADDDLC | New | No | Not Applicable |
ADDDRC | New | No | Not Applicable |
RTCUC | Changed | No | Not Applicable |
SUBDLC | New | No | Not Applicable |
SUBDRC | New | No | Not Applicable |
Table 1049 summarizes the selected equate macro changes. This
information is presented in alphabetic order by the name of the selected
equate macro.
Table 1049. Changes to Selected Equate Macros for Unlimited Pool Segment Support
Selected Equate Macro | New, Changed, or No Longer Supported? | Do You Need to Reassemble Programs? | Programs to Reassemble |
---|---|---|---|
BRPEQ | Changed | No | Not Applicable |
CINFC | Changed | No | Not Applicable |
SYSEQ | Changed | No | Not Applicable |
There are no changes.
Table 1050 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 1050. Changes to SIP Skeleton and Internal Macros for Unlimited Pool Segment Support
SIP Skeleton and Internal Macro | New, Changed, or No Longer Supported? |
---|---|
SKSYCN | Changed |
SPPGML | Changed |
Table 1051 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 1051. Changes to SIP Stage I Macros and Statements for Unlimited Pool Segment Support
SIP Stage I Macro | New, Changed, or No Longer Supported? |
---|---|
RAMFIL | Changed |
Table 1052 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 1052. Changes to SIP Stage II Macros for Unlimited Pool Segment Support
SIP Stage II Macro | New, Changed, or No Longer Supported? |
---|---|
IBMPAL | Changed |
There are no changes.
Table 1053 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 1053. Changes to System Macros for Unlimited Pool Segment Support
System Macro | New, Changed, or No Longer Supported? | Do You Need to Reassemble Programs? | Programs to Reassemble |
---|---|---|---|
SYCON | Changed | No | Not Applicable |
There are no changes.
Table 1054 summarizes segment changes. This information is
presented in alphabetic order by the name of the segment.
Table 1054. Changes to Segments for Unlimited Pool Segment Support
Segment | Type | Link-Edit Module (Where Offline Segment Is Linked) | New, Changed, or No Longer Supported? | Description of Change |
---|---|---|---|---|
B0P0 | Real-Time Assembler | Not Applicable | Changed | Updated for unlimited pool segment support. |
B0P5 | Real-Time Assembler | Not Applicable | Changed | Updated for unlimited pool segment support. |
B0SH | Real-Time Assembler | Not Applicable | Changed | Updated for unlimited pool segment support. |
B1A8 | Real-Time Assembler | Not Applicable | Changed | Updated for unlimited pool segment support. |
B1A9 | Real-Time Assembler | Not Applicable | Changed | Updated for unlimited pool segment support. |
B1BK | Real-Time Assembler | Not Applicable | Changed | Updated for unlimited pool segment support. |
BCAI | Real-Time Assembler | Not Applicable | Changed | Updated for unlimited pool segment support. |
BCP0 | Real-Time Assembler | Not Applicable | Changed | Updated for unlimited pool segment support. |
BCP1 | Real-Time Assembler | Not Applicable | Changed | Updated for unlimited pool segment support. |
BCP2 | Real-Time Assembler | Not Applicable | Changed | Updated for unlimited pool segment support. |
BCP6 | Real-Time Assembler | Not Applicable | Changed | Updated for unlimited pool segment support. |
BCPI | Real-Time Assembler | Not Applicable | Changed | Updated for unlimited pool segment support. |
BCPY | Real-Time Assembler | Not Applicable | Changed | Updated for unlimited pool segment support. |
BCPZ | Real-Time Assembler | Not Applicable | Changed | Updated for unlimited pool segment support. |
BOF2 | Real-Time Assembler | Not Applicable | Changed | Updated for unlimited pool segment support. |
BOF3 | Real-Time Assembler | Not Applicable | Changed | Updated for unlimited pool segment support. |
BOF4 | Real-Time Assembler | Not Applicable | Changed | Updated for unlimited pool segment support. |
BOF5 | Real-Time Assembler | Not Applicable | Changed | Updated for unlimited pool segment support. |
BOF6 | Real-Time Assembler | Not Applicable | Changed | Updated for unlimited pool segment support. |
BOF9 | Real-Time Assembler | Not Applicable | Changed | Updated for unlimited pool segment support. |
BOFB | Real-Time Assembler | Not Applicable | Changed | Updated for unlimited pool segment support. |
BOFF | Real-Time Assembler | Not Applicable | Changed | Updated for unlimited pool segment support. |
BPDH | Real-Time Assembler | Not Applicable | Changed | Updated for unlimited pool segment support. |
BRB3 | Real-Time Assembler | Not Applicable | Changed | Updated for unlimited pool segment support. |
BRSH | Real-Time Assembler | Not Applicable | Changed | Updated for unlimited pool segment support. |
BRV1 | Real-Time Assembler | Not Applicable | Changed | Updated for unlimited pool segment support. |
BRV3 | Real-Time Assembler | Not Applicable | Changed | Updated for unlimited pool segment support. |
BRV5 | Real-Time Assembler | Not Applicable | Changed | Updated for unlimited pool segment support. |
BRV6 | Real-Time Assembler | Not Applicable | Changed | Updated for unlimited pool segment support. |
BS0C | Real-Time Assembler | Not Applicable | Changed | Updated for unlimited pool segment support. |
CYAE | Real-Time Assembler | Not Applicable | Changed | Updated for unlimited pool segment support. |
DYD0 | Real-Time Assembler | Not Applicable | Changed | Updated for unlimited pool segment support. |
DYD5 | Real-Time Assembler | Not Applicable | Changed | Updated for unlimited pool segment support. |
DYD7 | Real-Time Assembler | Not Applicable | Changed | Updated for unlimited pool segment support. |
DYD8 | Real-Time Assembler | Not Applicable | Changed | Updated for unlimited pool segment support. |
DYD9 | Real-Time Assembler | Not Applicable | Changed | Updated for unlimited pool segment support. |
DYDA | Real-Time Assembler | Not Applicable | Changed | Updated for unlimited pool segment support. |
DYDU | Real-Time Assembler | Not Applicable | Changed | Updated for unlimited pool segment support. |
DYOM | Real-Time Assembler | Not Applicable | Changed | Updated for unlimited pool segment support. |
FTBD09 | Offline C Language | FCTBG | Changed | Updated for unlimited pool segment support. |
FTBD10 | Offline C Language | FCTBG | No Longer Supported | Deleted by unlimited pool segment support. |
FTGN00 | Offline C Language | FCTBG | Changed | Updated for unlimited pool segment support. |
FTPS03 | Offline C Language | FCTBG | Changed | Updated for unlimited pool segment support. |
FTRG06 | Offline C Language | FCTBG | Changed | Updated for unlimited pool segment support. |
The following section summarizes system equate changes.
Table 1055 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 1055. Changes to SYSEQ Tags for Unlimited Pool Segment Support
SYSEQ Tag | Equate Value | New, Changed, or No Longer Supported? |
---|---|---|
#LTDRT | 122 | No Longer Supported |
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 1056 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 1056. Changes to Commands for Unlimited Pool Segment Support
Command | New, Changed, or No Longer Supported? | Description of Change |
---|---|---|
ZPOOL DISPLAY | Changed | Updated for unlimited pool segment support. |
ZPOOL GENERATION | Changed | Updated for unlimited pool segment support. |
ZPOOL INIT | Changed | Updated for unlimited pool segment support. |
ZRECP DISPLAY | Changed | Updated for unlimited pool segment support. |
ZRPDU CREATE | Changed | Updated for unlimited pool segment support. |
Table 1057 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 1057. Changes to Messages and System Errors for Unlimited Pool Segment Support
Message ID or System Error Number | Message Type | New, Changed, or No Longer Supported? |
---|---|---|
04100C | System Error | No Longer Supported |
BBLD0001I | Online | New |
BBLD0002E | Online | New |
BBLD0003E | Online | New |
BBLD0004E | Online | New |
BBLD0006E | Online | New |
BBLD0007E | Online | New |
BBLD0008E | Online | New |
BCAI0007E | Online | No Longer Supported |
BCPI0001E | Online | No Longer Supported |
BCP00030E | Online | No Longer Supported |
BCP60001E | Online | No Longer Supported |
BOFF0002E | Online | No Longer Supported |
BOF20001I | Online | No Longer Supported |
BOF20002I | Online | No Longer Supported |
BOF20003I | Online | New |
BOF20004I | Online | New |
BOF20005I | Online | New |
BOF20006I | Online | New |
BOF20007I | Online | New |
BOF20008I | Online | New |
BOF20009E | Online | New |
BOF30004E | Online | No Longer Supported |
BOF30005E | Online | No Longer Supported |
BOF30006E | Online | Changed |
BOF40004E | Online | Changed |
BOF40005E | Online | No Longer Supported |
BOF40006E | Online | No Longer Supported |
BRV10000I | Online | No Longer Supported |
BRV10001I | Online | No Longer Supported |
BRV10002E | Online | Changed |
BRV10004E | Online | No Longer Supported |
BRV10005E | Online | No Longer Supported |
BRV10006E | Online | No Longer Supported |
BRV10007E | Online | Changed |
BRV10010I | Online | New |
BRV10011I | Online | New |
BRV10016E | Online | New |
BRV50001I | Online | No Longer Supported |
BRV50002I | Online | No Longer Supported |
BRV50010I | Online | New |
BRV50011I | Online | New |
BRV60001I | Online | Changed |
BRV60008E | Online | No Longer Supported |
B1A80017E | Online | No Longer Supported |
B1A80018E | Online | No Longer Supported |
DYDD0006W | Online | Changed |
DYDU0079E | Online | No Longer Supported |
DYD90002T | Online | No Longer Supported |
DYD90003T | Online | No Longer Supported |
DYD90007T | Online | No Longer Supported |
DYD90008T | Online | No Longer Supported |
DYD90015E | Online | New |
DYD90016E | Online | New |
RECP0032A | Online | No Longer Supported |
RECP0302E | Online | No Longer Supported |
RECP0423E | Online | No Longer Supported |
There are no changes.
There are no changes.
There are no changes.
There are no changes.
There are no changes.
Table 1058 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 1058. Changes to TPF Publications for Unlimited Pool Segment Support
Publication Title | Softcopy File Name | Description of Change |
---|---|---|
TPF Database Reference | GTPDBR0C | Updated with changed reallocation procedural information for unlimited pool segment support. |
TPF General Macros | GTPGEN0E | Updated with information about new and changed system macros for unlimited pool segment support. |
TPF Library Guide | GTPDOC0E | 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 unlimited pool segment support. |
TPF Migration Guide: Program Update Tapes | GTPMG204 | Updated with migration considerations for unlimited pool segment support. |
TPF Operations | GTPOPR0E | Updated with information about the commands that were added and changed for unlimited pool segment support. |
TPF Programming Standards | GTPPSM0A | Deleted OPMTBL and OPMTBLO from the list of data macro (DSECT) names that deviate from the naming standard. |
TPF System Generation | GTPSYC0E | Updated with changed system generation information for unlimited pool segment support. |
TPF System Macros | GTPSYS0E | Deleted the DIR=SON parameter from the SYCON macro for unlimited pool segment support. |
There are no changes.
There are no changes.
There are no changes.
There are no changes.
There are no changes.
To install and use unlimited pool segment support, do the following: