gtpm2m1s | Migration Guide: Program Update Tapes |
The following section discusses the migration considerations for TPF collection support (TPFCS) enhancements. See TPF Collection Support (APAR PJ25098) for more information about TPFCS.
See the APEDIT for APAR PJ25332 for information about prerequisite APARs.
The enhancements to TPFCS are as follows:
See the TPF C/C++ Language Support User's Guide for more information.
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.
Table 507 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 507. Changes to Build Scripts for TPF Collection Support Enhancements
Build Script | Type | New, Changed, or No Longer Supported? | Description of Change |
---|---|---|---|
CJ00BS | DLM | Changed | Build script for TPFCS central routines. |
CJ10BS | DLM | Changed | Build script for the ZBROW command. |
CJ13BS | DLM | Changed | Build script for TPFCS recoup central routines. |
CJ17BS | DLM | Changed | Build script for TPFCS recoup central routines. |
There are no changes.
Table 508 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$to2.h | Changed | No |
c$globz.h | Changed | No |
Table 509 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$bk0rp.h | New | No |
c$to2m.h | Changed | No |
c$to2r.h | New | No |
Table 510 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 510. Changes to Library Interface Scripts for TPF Collection Support Enhancements
Library Interface Script | New, Changed, or No Longer Supported? | Description of Change |
---|---|---|
CJ00XV | Changed | Changed the library interface script for TPFCS. |
Table 511 summarizes the library member (object file) changes.
This information is presented in alphabetic order by the name of the library
member (object file).
Table 511. Changes to Library Members (Object Files) for TPF Collection Support Enhancements
Library Member (Object File) | Library Module Name | New, Changed, or No Longer Supported? | Type | Description of Change |
---|---|---|---|---|
CJ000 | CJ00 | Changed | Assembler | Updated for TPFCS. |
CJ005 | CJ00 | Changed | Assembler | Updated for TPFCS DS and I/O control. |
CJ006 | CJ00 | New | Assembler | Created for a TPFCS recoup routine. |
There are no changes.
Table 512 summarizes changes to members (object files). This information is presented in alphabetic order by the name of the member (object file).
Notes:
Table 512. 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 |
---|---|---|---|---|
CJ01 | CJ01 | Changed | Assembler | Updated the ZOODB command parser. |
CJ02 | CJ01 | Changed | Assembler | Updated the ZOODB command parser. |
CJ03 | CJ03 | Changed | Assembler | Updated for the TPFCS task services routine. |
CJ04 | CJ04 | Changed | Assembler | Updated for the TPFCS restart scheduler exit. |
CJ106 | CJ10 | Changed | C Language | Updated for the ZBROW COLLECTION routine. |
CJ110 | CJ10 | New | C Language | Created for the ZBROW DISPLAY FA routine. |
CJ13 | CJ13 | Changed | Assembler | Updated for the TPFCS recoup routine. |
CJ14 | CJ13, CJ17 | New | C Language | Created for the TPFCS recoup routines. |
CJ17 | CJ17 | Changed | Assembler | Updated for the TPFCS recoup routine. |
There are no changes.
There are no changes.
There are no changes.
Table 513 summarizes the copy member changes. This information
is presented in alphabetic order by the name of the copy member.
Table 513. Changes to Copy Members for TPF Collection Support Enhancements
Copy Member | Type | CSECT Where Copy Member Is Located | New, Changed, or No Longer Supported? | Description of Change |
---|---|---|---|---|
CJ001 | Real-Time Assembler | CJ003 | Changed | Updated for TPFCS library C function support routines. |
CJ002 | Real-Time Assembler | CJ000, CJ003, CJ004, CJ005, CJ006 | Changed | Updated for TPFCS common macro definitions. |
CJ015 | Real-Time Assembler | CJ005 | Changed | Updated for TPFCS system services class. |
CJ020 | Real-Time Assembler | CJ000 | Changed | Updated for base class definitions. |
CJ021 | Real-Time Assembler | CJ006 | Changed | Updated for TPFCS directory entry support. |
CJ022 | Real-Time Assembler | CJ005 | Changed | Updated for TPFCS database support objects. |
CJ025 | Real-Time Assembler | CJ006 | Changed | Updated for TPFCS collection class definitions. |
CJ026 | Real-Time Assembler | CJ006 | Changed | Updated for TPFCS cursor class definitions. |
CJ030 | Real-Time Assembler | CJ004 | Changed | Updated for TPFCS structure class definitions. |
CJ036 | Real-Time Assembler | CJ004 | Changed | Updated for TPFCS index structure support. |
CJ037 | Real-Time Assembler | CJ004 | Changed | Updated for TPFCS flat structure support. |
CJ038 | Real-Time Assembler | CJ004 | Changed | Updated for TPFCS hash structure support. |
CJ101 | Real-Time Assembler | CJ100 | Changed | Updated for the ZBROW command. |
CJ102 | Real-Time Assembler | CJ100 | Changed | Updated for the ZBROW command. |
CJ103 | Real-Time Assembler | CJ100 | Changed | Updated for the ZBROW command. |
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 514 summarizes the data macro (DSECT) changes. This
information is presented in alphabetic order by the name of the data macro
(DSECT).
Table 514. Changes to Data Macros (DSECTs) for TPF Collection Support Enhancements
Data Macro (DSECT) | New, Changed, or No Longer Supported? | Do You Need to Reassemble Programs Using This Data Macro? |
---|---|---|
BK0RP | Changed | No |
ITO2 | Changed | No |
There are no changes.
Table 515 summarizes the selected equate macro changes. This
information is presented in alphabetic order by the name of the selected
equate macro.
Table 515. Changes to Selected Equate Macros for TPF Collection Support Enhancements
Selected Equate Macro | New, Changed, or No Longer Supported? | Do You Need to Reassemble Programs? |
---|---|---|
BRPEQ | Changed | No |
There are no changes.
Table 516 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 516. Changes to SIP Skeleton and Internal Macros for TPF Collection Support Enhancements
SIP Skeleton and Internal Macro | New, Changed, or No Longer Supported? |
---|---|
SPPGML | Changed |
There are no changes.
Table 517 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 517. Changes to SIP Stage II Macros for TPF Collection Support Enhancements
SIP Stage II Macro | New, Changed, or No Longer Supported? |
---|---|
IBMPAL | Changed |
There are no changes.
Table 518 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 518. Changes to System Macros for TPF Collection Support Enhancements
System Macro | New, Changed, or No Longer Supported? | Do You Need to Reassemble Programs? |
---|---|---|
GROUP | Changed | Yes (BRFM, BPM0, BPM1, and BKDIND (offline)) |
There are no changes.
Table 519 summarizes segment changes. This information is
presented in alphabetic order by the name of the segment.
Table 519. 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 |
---|---|---|---|---|
BKA0 | Real-Time Assembler | Not Applicable | Changed | Updated for TPFCS recoup. |
BKB0 | Real-Time Assembler | Not Applicable | Changed | Updated for TPFCS recoup. |
BRPC | Real-Time Assembler | Not Applicable | Changed | Updated for TPFCS recoup. |
BRPI | Real-Time Assembler | Not Applicable | Changed | Updated for TPFCS recoup. |
BSSC | Real-Time Assembler | Not Applicable | Changed | Updated for TPFCS recoup.
|
CJ12 | Real-Time Assembler | Not Applicable | Changed | Updated for TPFCS recoup. |
CJ15 | Real-Time Assembler | Not Applicable | New | Created for TPFCS. |
CJ16 | Real-Time Assembler | Not Applicable | Changed | Updated for TPFCS recoup. |
CTKS | Real-Time Assembler | Not Applicable | Changed | Updated for TPFCS. |
CTKT | Real-Time Assembler | Not Applicable | Changed | Updated for TPFCS. |
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 520 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 520. Changes to Commands for TPF Collection Support Enhancements
Command | New, Changed, or No Longer Supported? | Description of Change |
---|---|---|
ZBROW DISPLAY | Changed | Updated to add the new FA parameter. |
ZOODB CHANGE | Changed | Updated to add new DS options. |
ZOODB DEFINE | Changed | Updated to add new DS options. |
ZRECP TO2 | Changed | Updated to add the new TIMEOUT parameter. |
Table 521 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 521. 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? |
---|---|---|
020410 | System Error | New |
041006 | System Error | New |
BROW0701I | Online | New |
BROW0702I | Online | New |
BROW0751E | Online | New |
BROW0752E | Online | New |
CJ040003I | Online | New |
CJ040004I | Online | New |
CJ040052E | Online | New |
OODB0014I | Online | New |
OODB0030I | Online | New |
OODB0123E | Online | New |
OODB0130E | Online | New |
RECP0215I | Online | New |
RECP0281E | Online | No Longer Supported |
RECP0285E | Online | New |
RECP0286E | Online | New |
RECP0287E | Online | New |
RECP0288E | Online | New |
RECP0289E | Online | New |
RECP0290E | Online | New |
There are no changes.
There are no changes.
There are no changes.
There are no changes.
There are no changes.
Table 522 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 522. Changes to TPF Publications for TPF Collection Support Enhancements
Publication Title | Softcopy File Name | Description of Change |
---|---|---|
TPF Application Programming | GTPAPP08 | Added information about the new TPFCS collection types. |
TPF C/C++ Language Support User's Guide | GTPCLU09 | Added new C/C++ functions for TPFCS. |
TPF Concepts and Structures | GTPCON06 | Updated with information about the new TPFCS collection types. |
TPF Database Reference | GTPDBR07 | Updated with information about TPFCS and TPFCS recoup. |
TPF Library Guide | GTPDOC09 | 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. |
TPF Migration Guide: Program Update Tapes | GTPMIG09 | Updated with migration considerations for TPFCS. |
TPF Operations | GTPOPR09 | Updated with information about the commands that were added and changed for TPFCS. |
TPF System Macros | GTPSYS09 | Updated the GROUP macro with information 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:
When using TPFCS consider the following fallback and coexistence information: