gtpm1m02TPF V4R1 Migration Guide: 3.1 to 4.1

TPF V4R1 Migration Guide: 3.1 to 4.1


Contents

Figures

Tables

Notices

  • Trademarks
  • About This Book

  • Before You Begin
  • Who Should Read This Book
  • How This Book is Organized
  • Conventions Used in the TPF Library
  • Related Information
  • How to Send Your Comments
  • Guidelines for Using This Publication

  • Who Should Use This Publication
  • How This Publication Is Organized
  • Planning for TPF System Migration

  • Checklist for Planning Your System Migration
  • Learning about What Is in the TPF 4.1 System

  • Features of the TPF 4.1 System
  • Areas with Changes or New Functions in the TPF 4.1 System
  • Summarizing the New, Changed, and Obsolete Interfaces

  • How to Read the Tables
  • SIP Macros and Statements
  • SIP Skeletons and Internal Macros (Inner Macros)
  • SIP Stage II Macros
  • System Communication Keypoint (SCK) Generation Macros
  • General and System Macros
  • General Macros
  • System Macros
  • Information-Only Macros
  • Structured Programming Macros (SPMs)
  • Structured Programming Macros (SPMs) (IBM Use Only)
  • Selected Equate Macros
  • Advanced Program-to-Program Communications (APPC) Macros
  • Systems Network Architecture (SNA) Communication Macros and Statements
  • Program Test Vehicle (PTV) Macros
  • New, Changed, and Obsolete Data Macros
  • New, Changed, and Obsolete General Use C Language Support Functions
  • New, Changed, and Obsolete General Use C Language Header Files
  • New, Changed, and Obsolete User Exits
  • Control Program (CP) User Exits
  • ECB User Exits
  • New, Changed, and Obsolete Control Program Interface (CINFC) Tags
  • New, Changed, and Obsolete Configuration Constant (CONKC) Tags
  • New, Changed, and Obsolete System Equates (SYSEQ)
  • SYSEQ Tags
  • New, Changed, and Obsolete Commands
  • New, Changed, and Obsolete System Errors and Messages
  • New, Changed, and Obsolete Areas of the TPF 4.1 System
  • Fixed File Records
  • Segments
  • Control Programs (CPs)
  • Control Program (CP) Copy Members
  • Operating Environment Requirements and Planning Information

  • Hardware
  • Servers
  • Storage Devices
  • Unit Record Devices
  • Interconnection Devices
  • Control Units
  • Terminals and Display Devices
  • Consoles
  • Central Processing Complexes (CPCs)
  • Single Central Processing Complex (CPC) Environment
  • Loosely Coupled Complex
  • High Performance Option (HPO) Feature
  • Software (Programming Requirements)
  • OS/390 or MVS Requirements
  • C and C++ Compiler Requirements
  • SNA-Based Communication Requirements
  • TCP/IP-Based Communication Requirements
  • Non-SNA-Based Communication Requirements
  • Miscellaneous Requirements
  • TPF 4.1 Product Information Requirements
  • PDF and HTML Format
  • Requests for Price Quotations (RPQs) and Programming Requests for Price Quotations (PRPQs) by Protocol
  • IBM Extended Operations Console Facility/2 (EOCF/2) and IBM Transaction Processing Facility Database Facility (TPFDF)
  • Interprocessor Communications for the High Performance Option User
  • Migrating from DASD IPC to MPIF IPC
  • Generating the TPF 4.1 System

  • File Address Compute Program (FACE) Table Generation and System Initialization Program
  • System Installation Program (SIP) Changes
  • Defining the Database
  • Defining Record Types for Capture and Restore
  • Defining Record Types for Multiple TPF Images
  • Defining Record Types for the E-Type Loader
  • Defining Record Types for Program Version Information
  • Defining the New Record ID for the TPF Application Requester (TPFAR) Feature
  • Generating the File Address Compute Program (FACE) Table
  • Allocating Globals
  • ACF/SNA Table Generation Support
  • Setting Bit Strings for System Generation Option Bytes
  • Formatting the General File Loader (ALDR)
  • Reformatting Online Modules
  • Working Storage and 16-MB Constraint Relief
  • Transaction Protection and Data Integrity
  • Increased Main Storage for Application Use
  • Allocating Working Storage
  • Modifying Pilot Tapes for Globals
  • Setting Central Processing Unit (CPU) Loop Shutdown Levels
  • Setting Communications Shutdown Levels
  • Program Allocation Process
  • Allocating Programs, Transfer Vectors, and Pools
  • Adding Your Own Authorization Bits
  • Adding Your Own Function Switches
  • System Allocator (SALO) Program
  • Running the System Allocator (SALO)
  • Locking Programs into Main Storage
  • Excluding a List of Literals (LTORGs) to Save Space
  • E-Type Loader
  • Systems Network Architecture (SNA) Communication
  • Defining the Control Program (CP)
  • Linkage Editing (LEDT)
  • Patching
  • Modifying Low Core
  • Receiving Messages from the Online General File Loader (ACPL)
  • Customizing the Code

  • The TPF 4.1 Control Program Environment
  • Control Program User Exits
  • Changes to Input/Output (I/O) Coding
  • Changing the System State
  • Macro Decoder and SVCs
  • Defining SVCs
  • To Add New (Or Existing) SVCs to the TPF 4.1 System
  • Defining User CINFC Labels
  • The Monitor Call (MC) Facility
  • Modifying Low Storage
  • Changed Macros
  • Getting and Releasing System Workblocks (SWBs)
  • Internal Event Facility
  • Data Collection Changes
  • Critical Record Filing
  • Macro Trace
  • Changes to the Real-Time Trace (RTT) Facility
  • Changes to the Selective File Dump and Trace (SFDT) Facility
  • Subtracting the X'18' Displacement
  • Changes to Inter-I-Stream Communication
  • Activating E-Type Programs
  • Testing System Generation (SYSTC) Bits
  • Requesting MPIF Service
  • Changing the Fault-Rate Threshold
  • Moving Data Between Address Spaces
  • Modifying the TPF System Error Package
  • Controlling Dump Content
  • To Control the Content of Your SERRC Dump
  • Defining Keywords
  • Coding Dump Overrides
  • Coding Prefixes
  • Understanding Database Administration

  • Expanded File Addressing Capacity and File Address Reference Format
  • Migrating File Addresses
  • Migrating from FARF3 to FARF4
  • Migrating from FARF4 to FARF5
  • Making Sure All FARFx Records Are Removed
  • Accessing the File Adddress Compute Program (FACE) Table
  • Accessing Processor, SSU, and I-Stream Unique Records
  • Migration Considerations for Pools
  • Migrating Pool File Addresses
  • Program Size and Segmentation
  • Virtual File Access (VFA)
  • Tuning Virtual File Access (VFA)
  • Allocating Working Storage and Virtual File Access (VFA) Storage
  • Understanding Systems Network Architecture (SNA) Communication

  • Systems Network Architecture (SNA) Communication
  • Defining Systems Network Architecture (SNA) Resources
  • Generating the Systems Network Architecture (SNA) Table
  • Consolidating TPF/APPC Application Program Names Across CTC
  • Modifying Systems Network Architecture (SNA) Network Definitions
  • Converting Network Node Names
  • TPF Advanced Program-to-Program Communications (TPF/APPC)
  • Changes for 3-Byte Resource Identifiers (RIDs)
  • Changes for the SNA Communication Trace Facilities
  • Understanding Non-SNA Communication

  • Non-SNA Communication
  • Setting Non-SNA Communication Shutdown Levels
  • Using Synchronous Link Control (SLC)
  • Using Binary Synchronous Communication (BSC)
  • Using 3270 Local Support
  • Referencing the CCWP and BVT Tables
  • Changes to Channel Control Word (CCW) Areas
  • Understanding Operations

  • Multiple-Volume Tape Dumps and Post Processing
  • Example 1
  • Example 2
  • Modifying System Generation Option Values
  • Modifying Storage Allocation Values Online
  • Specifying and Overriding System Error Options
  • Options that Changed for the ZASER Command
  • System Error Support
  • Modifying Dump Tags
  • Multiple TPF Images
  • Modifying and Displaying Multiple TPF Images
  • Modifying and Displaying the Program Allocation Table
  • Assigning Data Definition Names to Input Devices
  • Loading E-Type Programs
  • Loading and Activating New Versions of Programs
  • Falling Back to Previous Versions of Programs
  • Accepting New Versions of Programs
  • Reissuing ZOLDR Commands Should the TPF System Malfunction
  • Modifying and Displaying Records, Data, Main Storage, and Programs
  • Maintaining Memory Patch Decks
  • Modifying and Displaying CPU Loop and Create Macro Control Levels
  • Adding, Modifying, and Displaying Commands
  • Turning System Trace Options On and Off
  • Activating and Deactivating the PIU Trace Facility
  • Using the Program Event Recording (PER) Trace Facility
  • Handling Channel and Machine Checks
  • Thresholds
  • Service Processor (SVP) Damage, Warning, and Degradation
  • System Recovery Messages
  • Recovering from Disabled Wait State Codes
  • Operational Changes to IPLB
  • Duplicate Volume Serial Numbers (VSNs)
  • Destructive Initial Program Load (IPL)
  • Modifications to Database Reorganization (DBR) Commands
  • Learning About the Changes in System Support Services

  • System Support
  • Real-Time Tape Post Processing
  • Load Balancing for Capture and Restore
  • Running Capture
  • Tape Support
  • Automatic Tape Mounting and Capture and Restore
  • Restoring Components of TPF Images
  • Online File Recoup
  • Enhancements to Online File Recoup (APAR PJ21224)
  • Returning from Recoup GROUP Macro Exit Code
  • Database Reorganization (DBR)
  • Running Database Reorganization (DBR)
  • Capturing Fixed Record Types
  • Eligibility for Database Reorganization (DBR) Input
  • Data Collection and Reduction, and Performance Monitoring
  • Data Collection
  • Data Reduction
  • Diagnosing Problems and Debugging

  • Diagnostic Tools
  • Virtual-Equals-Real (VEQR) Operating Mode
  • Testing the Migration (Virtual-Equals-Real (VEQR) Mode)
  • How Virtual-Equals-Real (VEQR) Mode Works
  • Starting and Stopping Virtual-Equals-Real (VEQR) Mode
  • System Log Trace Facility
  • Block Checking Mode
  • To Turn On Block Checking Mode
  • To Turn Off Block Checking Mode
  • Program Test Vehicle (PTV) Changes
  • Using the Program Event Recording (PER) Trace Facility
  • Running Virtual Machine (VM) Program Event Recording
  • Running Program Event Recording (PER) in a Native TPF 4.1 System
  • Path Information Unit (PIU) Trace Facility
  • PIUPRT Utility
  • Systems Network Architecture (SNA) I/O Trace Facility
  • Changing Application Programs for Migration

  • Changes to E-Type Programs
  • Getting and Releasing Working Storage
  • Getting and Releasing Heap Storage
  • Sharing Data between ECBs
  • Moving Data Between Address Spaces
  • Storage Manipulation Macros No Longer Supported
  • Validating Block Addresses (VALBC)
  • Issuing Macros that Require Authorization
  • Changes to Application Utilities
  • Changes to I-Stream Unique Globals
  • Testing Global Attribute Indicators
  • Block Scanning or ECB Checking
  • Using Input/Output Blocks (IOBs)
  • Monitoring System Activity
  • Shutdown Levels
  • Querying the Number of Storage Blocks
  • Modifying Your Application Programs
  • Migration Considerations for Application Programs
  • Macro Considerations
  • Reentrancy Considerations
  • Program Nesting Levels
  • Data Sharing Considerations
  • 31-Bit Addressing Considerations
  • File Address Reference Formats (FARF) Considerations
  • Miscellaneous Considerations
  • Learning about the TPF 4.1 Library

    Appendix A. Migrating System Error Calls (SERRC)

  • System Error Calls (SERRC) Migration Considerations
  • List of Areas
  • Index