gtpm2m2b | Migration Guide: Program Update Tapes |
The following section discusses the migration considerations for TPF collection support (TPFCS) recoup index command support.
See the APEDIT for APAR PJ26887 for information about prerequisite APARs.
TPFCS has been enhanced in the following ways:
See TPF Operations for more information about the ZBROW RECOUP command.
See the TPF C/C++ Language Support User's Guide for more information about this API.
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 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. |
There are no changes.
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 |
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 |
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. |
There are no changes.
There are no changes.
Table 750 summarizes changes to members (object files). This information is presented in alphabetic order by the name of the member (object file).
Notes:
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. |
There are no changes.
There are no changes.
There are no changes.
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. |
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 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 |
There are no changes.
There are no changes.
There are no changes.
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 |
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.
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 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. |
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 |
There are no changes.
There are no changes.
There are no changes.
There are no changes.
There are no 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. |
There are no changes.
There are no changes.
There are no changes.
There are no changes.
There are no changes.
To add TPFCS recoup index command support to your existing TPF 4.1 system, do the following:
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.