gtpm2m2wMigration Guide: Program Update Tapes

Unlimited Pool Segment Support (APAR PJ27484)

The following section discusses the migration considerations for unlimited pool segment support.

Prerequisite APARs

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

Functional Overview

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:

Eliminating Pool Segment Restrictions

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).

Increasing Performance

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.

Simplifying Pool Generation and Reallocation Procedures

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.

Architecture

There are no changes.

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 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.

Object Code Only (OCO) Stubs

There are no changes.

Dynamic Load Module (DLM) Stubs

There are no changes.

General Use C/C++ Language Header Files

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

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

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.

Table 1043. Changes to Implementation-Specific C/C++ Language Header Files (IBM Use Only) for Unlimited Pool Segment Support

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

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)

Table 1044 summarizes changes to members (object files). This information is presented in alphabetic order by the name of the member (object file).

Notes:

  1. You must recompile or reassemble a member (object file) if it has changed.

  2. You must prelink and link a dynamic load module (DLM) if it has changed.

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.

Object Code Only (OCO) Stubs

There are no changes.

Configuration Constant (CONKC) Tags

There are no changes.

Control Program Interface (CINFC) Tags

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

Copy Members

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.

Fixed File Records

There are no changes.

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 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

General Macros

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

Selected Equate Macros

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

Structured Programming Macros (SPMs)

There are no changes.

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

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

System Initialization Program (SIP) Stage I Macros and Statements

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

System Initialization Program (SIP) Stage II Macros

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

System Communication Keypoint (SCK) Generation Macros

There are no changes.

System Macros

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

System Macros (IBM Use Only)

There are no changes.

Segments

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.

System Equates

The following section summarizes system equate changes.

SYSEQ Tags

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

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 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.

Messages and System Errors

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

Performance or Tuning Changes

There are no changes.

Storage Considerations and Changes

There are no changes.

System Initialization Program (SIP) and System Generation Changes

There are no changes.

Loading Process Changes

There are no changes.

Online System Load Changes

There are no changes.

Publication 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.

Host System Changes

There are no changes.

Application Programming Interface (API) Changes

There are no changes.

Database Changes

There are no changes.

Feature Changes

There are no changes.

Installation Validation

There are no changes.

Migration Scenarios

To install and use unlimited pool segment support, do the following:

  1. Ensure that no pool reallocation processing is running on the TPF 4.1 system to which you are installing program update tape (PUT) 14.
  2. For any pool segments that are being deactivated, specify DEACTIVATE=YES on the RAMFIL macro statements in the system initialization program (SIP) stage 1 deck.
  3. Install PUT 14 on all processors that will be running recoup.
  4. Reassemble or recompile the following:
  5. Link-edit the dynamic load modules (DLMs) listed in Table 1044.
  6. Do the following on all subsystems:
    1. Run the FACE table generator (FCTBG) to create the new FACE table.
    2. Run the system allocator program (SALO) using IBMPAL additions for newly created segments to create an updated IBM program allocation table (IPAT) and system allocator (SAL) table.
  7. Link-edit the control program (CP).
  8. To prevent a loss of pool space or data if there are any problems migrating to unlimited pool segment support, run recoup, run pool directory update (PDU), and capture all critical data before loading and IPLing the TPF 4.1 system with unlimited pool segment support changes.
  9. Load the CP to the basic subsystem (BSS).
  10. Load the FACE table, IPAT, the dynamic load modules (DLMs) listed in Table 1044, and the programs listed in Table 1054 to each subsystem.
  11. Make sure that recoup or PDU is not running on the TPF 4.1 system.
  12. IPL the TPF 4.1 system.
  13. Cycle the TPF 4.1 system to 1052 state.
  14. Cycle the TPF 4.1 system to NORM state.