gtpm2m1w | Migration Guide: Program Update Tapes |
The following section discusses the migration considerations for TPF collection support (TPFCS) enhancements.
See the APEDIT for APAR PJ26143 for information about prerequisite APARs.
TPFCS has been enhanced in the following ways:
See the TPF C/C++ Language Support User's Guide for more information about these APIs.
See the TPF C/C++ Language Support User's Guide for more information about these APIs.
There are no changes.
There are none.
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.
There are no changes.
There are no changes.
Table 560 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.
C/C++ Language Header File | New, Changed, or No Longer Supported? | Do You Need to Recompile Segments? |
---|---|---|
c$cinfc.h | Changed | No |
c$to2.h | Changed | No |
Table 561 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) | New, Changed, or No Longer Supported? | Do You Need to Recompile Segments? |
---|---|---|
c$to2m.h | Changed | No |
Table 562 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 562. Changes to Library Interface Scripts for TPF Collection Support Enhancements
Library Interface Script | New, Changed, or No Longer Supported? | Description of Change |
---|---|---|
CJ00XV | Changed | Added new library functions for TPFCS. |
There are no changes.
There are no changes.
Table 563 summarizes changes to members (object files). This information is presented in alphabetic order by the name of the member (object file).
Notes:
Table 563. Changes to Members (Object Files) for TPF Collection Support Enhancements
Member (Object File) | DLM/DLL | New, Changed, or No Longer Supported? | Type | Description of Change |
---|---|---|---|---|
CJ04 | CJ04 | Changed | Assembler | Updated for the TPFCS restart scheduler exit. |
CJ109 | CJ10 | Changed | C Language | Updated the ZBROW report table handler. |
CJ110 | CJ10 | Changed | C Language | Updated to add the RRN parameter to the ZBROW DISPLAY command. |
There are no changes.
There are no changes.
Table 564 summarizes the control program interface (CINFC) tag
changes. The information in this table is ordered numerically by the
equate value.
Table 564. Changes to CINFC Tags for TPF Collection Support Enhancements
CINFC Tag | Equate Value | New, Changed, or No Longer Supported? |
---|---|---|
CMMTO2P | 06 | New |
Table 565 summarizes the copy member changes. This information
is presented in alphabetic order by the name of the copy member.
Table 565. Changes to Copy Members for TPF Collection Support Enhancements
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 for TPFCS library C function support routines. |
CJ002 | Real-Time Assembler | CJ000, CJ003, CJ004, CJ005, CJ006 | CJ00 | Changed | Updated for TPFCS common macro definitions. |
CJ015 | Real-Time Assembler | CJ005 | CJ00 | Changed | Updated for TPFCS system services class. |
CJ020 | Real-Time Assembler | CJ000 | CJ00 | Changed | Updated for base class definitions. |
CJ021 | Real-Time Assembler | CJ006 | CJ00 | Changed | Updated for TPFCS directory entry support. |
CJ022 | Real-Time Assembler | CJ005 | CJ00 | Changed | Updated for TPFCS database support objects. |
CJ025 | Real-Time Assembler | CJ006 | CJ00 | Changed | Updated for TPFCS collection class definitions. |
CJ026 | Real-Time Assembler | CJ006 | CJ00 | Changed | Updated for TPFCS cursor class definitions. |
CJ030 | Real-Time Assembler | CJ004 | CJ00 | Changed | Updated for TPFCS structure class definitions. |
CJ036 | Real-Time Assembler | CJ004 | CJ00 | Changed | Updated for TPFCS index structure support. |
CJ037 | Real-Time Assembler | CJ004 | CJ00 | Changed | Updated for TPFCS flat structure support. |
CJ038 | Real-Time Assembler | CJ004 | CJ00 | Changed | Updated for TPFCS hash structure support. |
CJ039 | Real-Time Assembler | CJ004 | CJ00 | Changed | Updated for TPFCS list structure support. |
CJ101 | Real-Time Assembler | CJ100 | CJ10 | Changed | Updated for the ZBROW commands. |
CJ102 | Real-Time Assembler | CJ100 | CJ10 | Changed | Updated for the ZBROW commands. |
CJ103 | Real-Time Assembler | CJ100 | CJ10 | Changed | Updated for the ZBROW commands. |
CJ104 | Real-Time Assembler | CJ100 | CJ10 | Changed | Updated for the ZBROW commands. |
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 566 summarizes the data macro changes. This information
is presented in alphabetic order by the name of the data macro.
Table 566. Changes to Data Macros for TPF Collection Support Enhancements
Data Macro | New, Changed, or No Longer Supported? | Do You Need to Reassemble Programs Using This Data Macro? |
---|---|---|
ITO2 | Changed | No |
Table 567 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 567. Changes to General Macros for for TPF Collection Support Enhancements
General Macro | New, Changed, or No Longer Supported? | Do You Need to Reassemble Programs? |
---|---|---|
CINFC | Changed | No |
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.
Table 568 summarizes segment changes. This information is
presented in alphabetic order by the name of the segment.
Table 568. Changes to Segments for TPF Collection Support Enhancements
Segment | Type | Link-Edit Module (Where Offline Segment Is Linked) | New, Changed, or No Longer Supported? | Description of Change |
---|---|---|---|---|
CTKR | Real-Time Assembler | Not Applicable | Changed | Updated for TPFCS cycle down. |
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 569 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 569. Changes to Commands for TPF Collection Support Enhancements
Command | New, Changed, or No Longer Supported? | Description of Change |
---|---|---|
ZBROW COLLECTION | Changed | Updated to add the new KEYPATH parameter. |
ZBROW DISPLAY | Changed | Updated to add the new RRN parameter. |
ZBROW KEYPATH | New | Added for adding, displaying, or removing key paths. |
ZBROW PATH | New | Added for displaying path information for a collection structure. |
Table 570 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 570. Changes to Messages and System Errors for TPF Collection Support Enhancements
Message ID or System Error Number | Message Type | New, Changed, or No Longer Supported? |
---|---|---|
02040B | System Error | New |
BROW0098E | Online | New |
BROW0475E | Online | New |
BROW0703I | Online | New |
BROW0710I | Online | New |
BROW0753E | Online | New |
BROW0754E | Online | New |
BROW0801I | Online | New |
BROW0802I | Online | New |
BROW0803I | Online | New |
BROW0804I | Online | New |
BROW0810I | Online | New |
BROW0850E | Online | New |
BROW0851E | Online | New |
BROW0852E | Online | New |
BROW0853E | Online | New |
BROW0901I | Online | New |
BROW0902I | Online | New |
BROW0903I | Online | New |
BROW0904I | Online | New |
BROW0910I | Online | New |
BROW0951E | Online | New |
BROW0952E | Online | New |
CJ040005I | Online | New |
There are no changes.
There are no changes.
There are no changes.
There are no changes.
There are no changes.
Table 571 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 571. Changes to TPF Publications for TPF Collection Support Enhancements
Publication Title | Softcopy File Name | Description of Change |
---|---|---|
TPF Application Programming | GTPAPP09 | Added information about key path support. |
TPF C/C++ Language Support User's Guide | GTPCLU0A | Added new C/C++ functions for TPFCS. |
TPF Concepts and Structures | GTPCON07 | Updated with information about the new TPFCS enhancements. |
TPF Database Reference | GTPDBR08 | Updated with information about the new TPFCS key path support. |
TPF Library Guide | GTPDOC0A | Added definitions for new terminology to 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. |
TPF Migration Guide: Program Update Tapes | GTPMG200 | Updated with migration considerations for TPFCS. |
TPF Operations | GTPOPR0A | Updated with information about the commands that were added and changed for TPFCS. |
There are no changes.
There are no changes.
There are no changes.
There are no changes.
There are no changes.
To add TPFCS enhancements to your existing TPF 4.1 system, do the following:
TPFCS enhancements can coexist with previous versions of TPFCS as long as the alternate key paths are not used until you have migrated all processors to the current level of TPFCS because previous versions cannot maintain the new key path support.
After installing the current level of TPFCS on all processors, applications can add and use alternate key paths on both existing and new collections. If you need to fall back to the prior level of TPFCS, those collections are still usable. However, once you migrate to the current level of TPFCS again, any key paths that were previously created must be removed and added again in order for key paths to be usuable.