gtpm2m0bMigration Guide: Program Update Tapes

How to Use the Migration Considerations Information

Each new function or SPE documented in this publication uses the following format to present the migration considerations to you. As you are using this information keep in mind that some migration considerations may not be applicable for a particular new function or SPE. In those cases a statement indicating that there are no changes is printed.

Note:
Depending on the complexity of the new function or SPE, additional migration considerations may be included with the information for that new function or SPE. In those cases, the appropriate section will be added and repeated across the chapter for each new function or SPE as appropriate.

Table 1. Format of Migration Considerations

Section Type of Information You Will Find In This Section
Name of the New Function or SPE and the APAR Number Provides the name of the new function or SPE and the associated APAR number.
Prerequisite APARs Provides a cross reference to the APEDIT for you to review any APARs that must be installed on your TPF 4.1 system before installing the new function or SPE.
Functional Overview This section provides a high-level description or overview of the new function or SPE, as well as a description of the benefits the new function or SPE will bring to your TPF 4.1 system.
Architecture This section provides a general description about the architecture of the new function or SPE and how it is implemented.
Operating Environment Requirements and Planning Information To ensure that your TPF 4.1 system performs properly, you must establish the required operating environment. This section provides information about changes by the new function or SPE to the minimum hardware and software (programming requirements) system configuration requirements necessary to operate the TPF 4.1 system. See Operating Environment Requirements and Planning Information for more information about these minimum system configuration requirements.
Interface Changes This section provides information about the interfaces that are new, changed, or no longer supported by the new function or SPE. These interfaces include (but are not limited to):
  • Build scripts
  • Configuration constant (CONKC) tags
  • Control program interface (CINFC) tags
  • Copy members
  • C/C++ header files
  • DLM stubs
  • Dynamic load module (DLM) members
  • Fixed file records
  • Macros
  • Segments
  • User exits.
Functional and Operational Changes This section provides information about the functional and operational changes (such as commands, system errors, offline messages, and online messages) that are new, changed, or no longer supported by the new function or SPE.
Performance or Tuning Changes This section provides recommendations about tuning the TPF 4.1 system because of the new function or SPE. For example, here you will find:
  • Information about changes that affect timing considerations
  • Changes about how the TPF load is balanced
  • Estimates of performance enhancements or losses
  • Tuning values, operational procedures, configuration parameters, and other information that may improve performance.
Storage Considerations and Changes This section provides information about considerations for and changes to storage that are necessary for the new function or SPE.
System Initialization Program (SIP) and System Generation Changes This section provides information about the SIP and system generation changes necessary for the new function or SPE. For example, here you will find information about modifications that must be made to SIP parameters such as:
  • Guidelines for recommended parameter values
  • Changes to the size or content of keypoints or non-keypoint data areas
  • Cross references to the appropriate TPF 4.1 publications and code for more information about parameter values.
Loading Process Changes This section provides information about changes to the allocator (ALDR, TLDR, OLDR), the pilot tape, and current loading procedures introduced by the new function or SPE.
Online System Load Changes This section provides information about changes associated with loading the TPF 4.1 system that must be specified before performing an online system load because of the new function or SPE. In addition, information may be provided about new commands or procedures that must be used when IPLing the TPF 4.1 system.
Publication Changes This section provides information about changes to the publications in the TPF 4.1 library to document the new function or SPE.
Host System Changes This section provides information about considerations that would impact the installation of the PUT. For example, here you will find information such as:
  • Changes to the cataloged procedures
  • Special assembly or link-edit requirements
  • Changes to partitioned data sets
  • Changes to an associated operating system like the IBM VM or IBM MVS systems
  • IBM VM or IBM MVS system configuration requirements, changes, and recommendations that may enhance the performance of the new function or SPE.
Application Programming Interface (API) Changes This section provides information about changes to the external interfaces that may affect existing application programs because of the new function or SPE.
Database Changes This section provides information about database organization or support changes because of the new function or SPE.
Feature Changes This section provides information about changes in operations or support of the following TPF 4.1 features:
  • High Performance Option (HPO) Feature
  • Multi-Processor Interconnect Facility (MPIF) Feature
  • TPF Application Requester (TPFAR) Feature.
Installation Validation This section provides information about specific tests or procedures that you can run to verify that the installation of the new function or SPE was done properly.
Migration Scenarios This section provides migration scenarios you can use when installing the new function or SPE.