gtpm2m2bMigration Guide: Program Update Tapes

TPFCS Recoup Index Command Support (APAR PJ26887)

The following section discusses the migration considerations for TPF collection support (TPFCS) recoup index command support.

Prerequisite APARs

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

Functional Overview

TPFCS has been enhanced in the following ways:

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 746 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 746. Changes to Build Scripts for TPFCS Recoup Index Command Support

Build Script Type New, Changed, or No Longer Supported? Description of Change
CJ10BS DLM Changed Changed the build script for the ZBROW RECOUP command.

Dynamic Load Module (DLM) Stubs

There are no changes.

General Use C/C++ Language Header Files

Table 747 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 747. Changes to General Use C/C++ Language Header Files for TPFCS Recoup Index Command Support

C/C++ Language Header File New, Changed, or No Longer Supported? Do You Need to Recompile Segments?
c$to2.h Changed No

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

Table 748 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 748. Changes to General Use C/C++ Language Header Files for TPFCS Recoup Index Command Support

C/C++ Language Header File New, Changed, or No Longer Supported? Do You Need to Recompile Segments?
c$to2b.h Changed No
c$to2m.h Changed No
c$to2r.h Changed No

Library Interface Scripts

Table 749 summarizes changes to the library interface scripts used by the library interface tool and the build tool. This information is presented in alphabetic order by the name of the library interface script.

Table 749. Changes to Library Interface Scripts for TPFCS Recoup Index Command Support

Library Interface Script New, Changed, or No Longer Supported? Description of Change
CJ00XV Changed Updated to support the TO2_getCollectionKeys function.

Library Members (Object Files)

There are no changes.

Link-Edited Modules

There are no changes.

Members (Object Files)

Table 750 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 750. Changes to Members (Object Files) for TPFCS Recoup Index Command Support

Member (Object File) DLM/DLL New, Changed, or No Longer Supported? Type Description of Change
CJ106 CJ10 Changed C Language Removed the RCPINDEX parameter from the ZBROW COLLECTION functional message.
CJ114 CJ10 New C Language Created for the ZBROW RECOUP command.

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

Table 751. Changes to Copy Members for TPFCS Recoup Index Command Support

Copy Member Type CSECT Where Copy Member Is Located DLM Where CSECT Is Located New, Changed, or No Longer Supported? Description of Change
CJ001 Real-Time Assembler CJ003 CJ00 Changed Updated to add the TO2_getCollectionKeys function.
CJ101 Real-Time Assembler CJ100 CJ10 Changed Updated for the ZBROW RECOUP command.
CJ104 Real-Time Assembler CJ100 CJ10 Changed Updated for the ZBROW RECOUP command.
CJ303 Real-Time Assembler CJ000 CJ00 Changed Updated to add the TO2_getCollectionKeys function.
CJ365 Real-Time Assembler CJ006 CJ00 Changed Updated to enforce unique recoup index entry tokens.
CJ366 Real-Time Assembler CJ006 CJ00 Changed Updated to enforce unique recoup index entry tokens.

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

Table 752. Changes to Data Macros for TPFCS Recoup Index Command Support

Data Macro New, Changed, or No Longer Supported? Do You Need to Reassemble Programs Using This Data Macro?
ITO2 Changed No

General Macros

There are no changes.

Selected Equate Macros

There are no changes.

Structured Programming Macros (SPMs)

There are no changes.

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

Table 753 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 753. Changes to SIP Skeleton and Internal Macros for TPFCS Recoup Index Command 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

There are no changes.

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

There are no changes.

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 754 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 754. Changes to Commands for TPFCS Recoup Index Command Support

Command New, Changed, or No Longer Supported? Description of Change
ZBROW COLLECTION Changed Removed the RCPINDEX parameter to display recoup indexes. The RCPINDEX parameter has been replaced by the ZBROW RECOUP command.
ZBROW RECOUP New Added for managing recoup indexes.

Messages and System Errors

Table 755 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 755. Changes to Messages and System Errors for TPFCS Recoup Index Command Support

Message ID or System Error Number Message Type New, Changed, or No Longer Supported?
BROW0423I Online No Longer Supported
BROW0424I Online No Longer Supported
BROW0471E Online No Longer Supported
BROW0472E Online No Longer Supported
BROW1001I Online New
BROW1011I Online New
BROW1012I Online New
BROW1013I Online New
BROW1014I Online New
BROW1015I Online New
BROW1016I Online New
BROW1017I Online New
BROW1018I Online New
BROW1051E Online New
BROW1053E Online New
BROW1054E Online New
BROW1055E Online New
BROW1056E Online New
BROW1057E Online New
BROW1058W Online New
BROW1059E Online New
BROW1061E Online New
BROW1062E Online New
BROW1063E Online New
BROW1064E Online New
BROW1065E Online New
BROW1066E Online New
BROW1067E Online New
BROW1070E Online New
BROW1072E Online New
BROW1073E Online New
BROW1074E Online New
BROW1075E 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 756 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 756. Changes to TPF Publications for TPFCS Recoup Index Command Support

Publication Title Softcopy File Name Description of Change
TPF C/C++ Language Support User's Guide GTPCLU0C Added a C/C++ function for TPFCS recoup index command support.
TPF Database Reference GTPDR0A Updated with information about TPFCS recoup index command support.
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 TPFCS recoup index command support.
TPF Migration Guide: Program Update Tapes GTPMG202 Updated with migration considerations for TPFCS recoup index command support.
TPF Operations GTPOPR0C Updated with information about the commands that were added and changed for TPFCS recoup index command 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 add TPFCS recoup index command support to your existing TPF 4.1 system, do the following:

  1. Install program update tape (PUT) 12.
  2. Verify that the following are installed:
  3. Run the LIBI offline program for all changed library interface scripts listed in Table 749.
  4. Reassemble the stage I deck.
  5. Run the CBLD program for the build scripts listed in Table 746.
  6. Reassemble or recompile the following:
  7. Link-edit the DLMs/DLLs that are listed in Table 750 and Table 751.
  8. Load the updated object code to your TPF 4.1 system.

Fallback and Coexistence

As part of APAR PJ26887 and to enforce uniqueness of recoup index entry tokens, recoup indexes were changed so they are created as sorted set collections instead of sorted bag collections. Recoup indexes that were created before APAR PJ26887 as sorted bag collections will still be effective after APAR PJ26887 is applied and do not have to be changed to the new format.

If APAR PJ26887 must be removed from your TPF 4.1 system, you will need to remove all indexes created with it before you remove APAR PJ26887. However, you can re-create these indexes after you remove APAR PJ26887. Once APAR PJ26887 has been removed, any attempt to access or delete a recoup index which was created by APAR PJ26887 will produce results that are not predictable.