gtpm2m1wMigration Guide: Program Update Tapes

TPF Collection Support Enhancements (APAR PJ26143)

The following section discusses the migration considerations for TPF collection support (TPFCS) enhancements.

Prerequisite APARs

See the APEDIT for APAR PJ26143 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 none.

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

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.

Table 560. Changes to General Use C/C++ Language Header Files for TPF Collection Support Enhancements

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

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

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.

Table 561. Changes to Implementation-Specific C/C++ Language Header Files (IBM Use Only) for TPF Collection Support Enhancements

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

Library Interface Scripts

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.

Library Members (Object Files)

There are no changes.

Link-Edited Modules

There are no changes.

Members (Object Files)

Table 563 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 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.

Object Code Only (OCO) Stubs

There are no changes.

Configuration Constant (CONKC) Tags

There are no changes.

Control Program Interface (CINFC) Tags

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

Copy Members

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.

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 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

General Macros

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

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)

There are no changes.

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

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.

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 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.

Messages and System Errors

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

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 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.

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 enhancements to your existing TPF 4.1 system, do the following:

  1. Install program update tape (PUT) 10.
  2. Run the LIBI offline program for all changed library interface scripts listed in Table 562.
  3. Run the CBLD program for the build scripts listed in Table 563, Table 565, and Table 566.
  4. Verify the following are installed:
  5. Reassemble or recompile the following:
  6. Link-edit the DLM/DLLs listed in Table 563 and Table 565.
  7. Load the updated object code to your TPF 4.1 system.
  8. Ensure that the TPF 4.1 system is in NORM state before running any application programs.

Fallback and Coexistence

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.