gtpm2m2tMigration Guide: Program Update Tapes

Recoup Follow-On Support (APAR PJ27804)

The following section discusses the migration considerations for recoup follow-on support.

Prerequisite APARs

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

Functional Overview

Recoup follow-on support includes the following:

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

There are no changes.

Dynamic Load Module (DLM) Stubs

There are no changes.

General Use C/C++ Language Header Files

There are no changes.

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

Table 992 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 992. Changes to Implementation-Specific C/C++ Language Header Files (IBM Use Only) for Recoup Follow-On Support

C/C++ Language Header File (IBM Use Only) New, Changed, or No Longer Supported? Do You Need to Recompile Segments? Segments to Recompile
c$bk0lc.h New No Not Applicable
c$bk0rp.h Changed No Not Applicable
c$bl0rp.h Changed No Not Applicable
i$recp.h Changed No Not Applicable
i$rsct.h Changed No Not Applicable

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 993 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 993. Changes to Members (Object Files) for Recoup Follow-On Support

Member (Object File) DLM/DLL New, Changed, or No Longer Supported? Type Description of Change
BAM6 BAM6 Changed C++ Language Updated for recoup follow-on support.
BEWA BEWA Changed C Language Updated for recoup follow-on support.
BJ00 BJ00 Changed C++ Language Updated for recoup follow-on support.
BJ02 BJ02 Changed C++ Language Updated for recoup follow-on support.
BJ12 BJ12 Changed C++ Language Updated for recoup follow-on support.
BRR1 BRR1 Changed C++ Language Updated for recoup follow-on support.
BRR2 BRR1 Changed C++ Language Updated for recoup follow-on support.
BRR3 BRR1 Changed C++ Language Updated for recoup follow-on support.
BRR4 BRR1 Changed C++ Language Updated for recoup follow-on support.
BRR5 BRR1 Changed C++ Language Updated for recoup follow-on support.
BRR6 BRR1 Changed C++ Language Updated for recoup follow-on support.

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

There are no changes.

Fixed File Records

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

Table 994. Changes to Fixed File Records for Recoup Follow-On Support

Fixed File Record New, Changed, or No Longer Supported? Description of Change
#BKDSV No Longer Supported Deleted by recoup follow-on support.
#BKD4K No Longer Supported Deleted by recoup follow-on support.

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 995 summarizes the data macro changes. This information is presented in alphabetic order by the name of the data macro.

Table 995. Changes to Data Macros for Recoup Follow-On Support

Data Macro New, Changed, or No Longer Supported? Do You Need to Reassemble Programs Using This Data Macro? Programs to Reassemble
BK0LC Changed No Not Applicable
BK0RP Changed No Not Applicable
BK9MC New No Not Applicable
BL0RP Changed No Not Applicable
IFMSG Changed Yes CVAI
MPRECP Changed No Not Applicable

General Macros

There are no changes.

Selected Equate Macros

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

Table 996. Changes to Selected Equate Macros for Recoup Follow-On Support

Selected Equate Macro New, Changed, or No Longer Supported? Do You Need to Reassemble Programs? Programs to Reassemble
BRPEQ Changed No Not Applicable

Structured Programming Macros (SPMs)

There are no changes.

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

Table 997 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 997. Changes to SIP Skeleton and Internal Macros for Recoup Follow-On Support

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 998 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 998. Changes to SIP Stage II Macros for Recoup Follow-On 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 999 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 999. Changes to System Macros for Recoup Follow-On Support

System Macro New, Changed, or No Longer Supported? Do You Need to Reassemble Programs? Programs to Reassemble
BRPRO Changed No Not Applicable

System Macros (IBM Use Only)

There are no changes.

Segments

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

Table 1000. Changes to Segments for Recoup Follow-On Support

Segment Type Link-Edit Module (Where Offline Segment Is Linked) New, Changed, or No Longer Supported? Description of Change
BAM0 Real-Time Assembler Not Applicable Changed Changed for recoup follow-on support.
BAM1 Real-Time Assembler Not Applicable Changed Changed for recoup follow-on support.
BAM5 Real-Time Assembler Not Applicable Changed Changed for recoup follow-on support.
BCC0 Real-Time Assembler Not Applicable Changed Changed for recoup follow-on support.
BCC1 Real-Time Assembler Not Applicable Changed Changed for recoup follow-on support.
BCC3 Real-Time Assembler Not Applicable Changed Changed for recoup follow-on support.
BCP5 Real-Time Assembler Not Applicable Changed Changed for recoup follow-on support.
BEWP Real-Time Assembler Not Applicable Changed Changed for recoup follow-on support.
BJ11 Real-Time Assembler Not Applicable Changed Changed for recoup follow-on support.
BKA0 Real-Time Assembler Not Applicable Changed Changed for recoup follow-on support.
BKB0 Real-Time Assembler Not Applicable Changed Changed for recoup follow-on support.
BKC1 Real-Time Assembler Not Applicable Changed Changed for recoup follow-on support.
BKPA Real-Time Assembler Not Applicable Changed Changed for recoup follow-on support.
BKP0 Real-Time Assembler Not Applicable Changed Changed for recoup follow-on support.
BKP5 Real-Time Assembler Not Applicable Changed Changed for recoup follow-on support.
BOFK Real-Time Assembler Not Applicable Changed Changed for recoup follow-on support.
BPM0 Real-Time Assembler Not Applicable Changed Changed for recoup follow-on support.
BPM1 Real-Time Assembler Not Applicable Changed Changed for recoup follow-on support.
BRB2 Real-Time Assembler Not Applicable Changed Changed for recoup follow-on support.
BRB4 Real-Time Assembler Not Applicable Changed Changed for recoup follow-on support.
BRCB (TPFDF) Real-Time Assembler Not Applicable Changed Changed for recoup follow-on support.
BRCP Real-Time Assembler Not Applicable Changed Changed for recoup follow-on support.
BRCX (TPFDF) Real-Time Assembler Not Applicable Changed Changed for recoup follow-on support.
BRDP Real-Time Assembler Not Applicable New Created for recoup follow-on support.
BRFM Real-Time Assembler Not Applicable Changed Changed for recoup follow-on support.
BRMK Real-Time Assembler Not Applicable Changed Changed for recoup follow-on support.
BRPA Real-Time Assembler Not Applicable Changed Changed for recoup follow-on support.
BRPK Real-Time Assembler Not Applicable Changed Changed for recoup follow-on support.
BRPT Real-Time Assembler Not Applicable Changed Changed for recoup follow-on support.
BRPX Real-Time Assembler Not Applicable Changed Changed for recoup follow-on support.
BRSH Real-Time Assembler Not Applicable Changed Changed for recoup follow-on support.
BRS0 Real-Time Assembler Not Applicable Changed Changed for recoup follow-on support.
BRTO Real-Time Assembler Not Applicable Changed Changed for recoup follow-on support.
BRUB Real-Time Assembler Not Applicable Changed Changed for recoup follow-on support.
BRUC Real-Time Assembler Not Applicable Changed Changed for recoup follow-on support.
BRUD Real-Time Assembler Not Applicable Changed Changed for recoup follow-on support.
BRV2 Real-Time Assembler Not Applicable Changed Changed for recoup follow-on support.
BRV5 Real-Time Assembler Not Applicable Changed Changed for recoup follow-on support.
BR0T Real-Time Assembler Not Applicable Changed Changed for recoup follow-on support.
BSSC Real-Time Assembler Not Applicable Changed Changed for recoup follow-on support.
BSSU Real-Time Assembler Not Applicable Changed Changed for recoup follow-on support.
BSSW Real-Time Assembler Not Applicable No Longer Supported Deleted by recoup follow-on support.
BS0C Real-Time Assembler Not Applicable Changed Changed for recoup follow-on support.
BS0D Real-Time Assembler Not Applicable New Created for recoup follow-on support.
BWRA Real-Time Assembler Not Applicable Changed Changed for recoup follow-on support.
BWRT Real-Time Assembler Not Applicable Changed Changed for recoup follow-on support.
B0P0 Real-Time Assembler Not Applicable Changed Changed for recoup follow-on support.
B0P5 Real-Time Assembler Not Applicable Changed Changed for recoup follow-on support.
B0P6 Real-Time Assembler Not Applicable No Longer Supported Deleted by recoup follow-on support.
B0SH Real-Time Assembler Not Applicable Changed Changed for recoup follow-on support.
B1BK Real-Time Assembler Not Applicable Changed Changed for recoup follow-on support.
CVAI Real-Time Assembler Not Applicable Changed Changed for recoup follow-on support.
DYD2 Real-Time Assembler Not Applicable No Longer Supported Deleted by recoup follow-on support.
UBRP Real-Time Assembler Not Applicable Changed Changed for recoup follow-on support.

System Equates

There are no changes.

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 1001 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 1001. Changes to Commands for Recoup Follow-On Support

Command New, Changed, or No Longer Supported? Description of Change
ZACRS Changed Updated for recoup follow-on support.
ZFMSG Changed Updated for recoup follow-on support.
ZPOOL INIT Changed Updated for recoup follow-on support. ZPOOL INIT no longer initializes the #BKDSV and #BKD4K record types, which have been deleted.
ZRBKD Changed Updated for recoup follow-on support.
ZRECP PROFILE Changed Updated for recoup follow-on support.
ZSTIM A Changed Updated for recoup follow-on support.

Messages and System Errors

Table 1002 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 1002. Changes to Messages and System Errors for Recoup Follow-On Support

Message ID or System Error Number Message Type New, Changed, or No Longer Supported?
0412F0 System Error Changed
042001 System Error No Longer Supported
BCP00025A Online Changed
BRUB0012I Online Changed
BRUC0009W Online No Longer Supported
BRUC0010E Online New
BRUC0011W Online New
RECP0098E Online No Longer Supported
RECP009EE Online No Longer Supported
RECP00A0E Online Changed
RECP0504I Online Changed
RECP0658E Online Changed
RECP0659E Online Changed
RECP0661E Online No Longer Supported
RECP0791E Online New
RECP0792E Online New
RECP0793E Online New
RECP0794E Online New
RECP0795E Online New
RECP0796E Online New
RECP0797E Online New
RECP0798E Online New

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 1003 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 1003. Changes to TPF Publications for Recoup Follow-On Support

Publication Title Softcopy File Name Description of Change
TPF Database Reference GTPDBR0C Updated with changed pre-recoup procedural information for recoup follow-on support.
TPF General Macros GTPGEN0E Updated with information about new and changed system macros for recoup follow-on support.
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 recoup follow-on support.
TPF Migration Guide: Program Update Tapes GTPMG204 Updated with migration considerations for recoup follow-on support.
TPF Operations GTPOPR0E Updated with information about the commands that were changed for recoup follow-on support.
TPF System Generation GTPSYC0E Updated with changed system generation information for recoup follow-on support.
TPF System Macros GTPSYS0E Removed a reference to the #BKD4K fixed file record from the GROUP macro. Updated the BRPRO macro.

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 recoup follow-on support, do the following:

  1. Ensure that no deactivation or reallocation processing is running on the TPF 4.1 system to which you are installing program update tape (PUT) 14.
  2. Install PUT 14.
  3. Reassemble or recompile the segments listed in Table 1000.
  4. Link-edit the dynamic load modules (DLMs) listed in Table 993.
  5. Do the following on all subsystems:
    1. Delete the fixed file records listed in Table 994 using the RAMFIL macro statements in the SIP stage 1 deck. See TPF System Generation for more information.
    2. Run the FACE table generator (FCTBG) to create the new FACE table.
    3. Load all descriptors into the program allocation table (PAT) as core resident.
    4. 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.
  6. Link-edit the control program (CP).
  7. To prevent a loss of pool space or data if there are any problems migrating to recoup follow-on support, do the following before loading and IPLing the TPF 4.1 system with recoup follow-on support changes:
    1. Run recoup.
    2. Run pool directory update (PDU).
    3. Capture all critical data.
  8. Load the FACE table, IPAT, CP, the DLMs listed in Table 993, and the programs listed in Table 1000 to each subsystem.
  9. Make sure that recoup or PDU is not running on the TPF 4.1 system.
  10. IPL the TPF 4.1 system.
  11. Cycle the TPF 4.1 system to 1052 state.
  12. Cycle the TPF 4.1 system to NORM state.
  13. Load updated descriptors as follows on all subsystems:
    1. Enter ZRBKD INIT CTL to initialize the BKD load control record (BK0LC).
    2. Enter ZRBKD DUMM ALL to create dummy recoup descriptors.
    3. For each descriptor container used for recoup processing, enter ZRBKD MOVE progname Nordnum, where progname is the name and version of the descriptor container and ordnum is an ordinal number (from 0 to 99) that represents the order in which descriptor containers are processed during chain chase processing.
    4. Enter ZRBKD DISP ALL to verify that the descriptors were loaded correctly.
  14. Enter the ZRECP PROFILE command to display your recoup run-time option settings and record these settings to be used after ZRECP SETUP processing is completed.
  15. Enter ZRECP SETUP once on each subsystem in which you run recoup. The ZRECP SETUP command will create an expanded recoup scheduling control table (IRSCT) that is required by recoup follow-on support, and will also set recoup profile options to their initial settings.
  16. Enter the ZRECP PROFILE command to change any recoup settings that you want to change.
  17. If you want to route recoup status messages to the recoup functional support console (FSC) instead of the primary recoup console, do the following:
    1. Enter the ZACRS command to define a real-time database services (RDBS) FSC if one is not already defined.
      Note:
      In a loosely coupled environment, add RDBS routing for each processor that participates in running recoup processing.
    2. Enter ZRECP PROFILE FSC-YES to route recoup status messages to the RDBS FSC instead of the prime CRAS.
    3. IPL the TPF 4.1 system.