[HR]

Migrating an Application from OpenVMS VAX to OpenVMS Alpha

Contents (summary)

Chapter 1 Overview of the Migration Process
Chapter 2 Selecting a Migration Method
Chapter 3 Migrating Your Application
Chapter 4 Recompiling and Relinking Overview
Chapter 5 Adapting Applications to a Larger Page Size
Chapter 6 Preserving the Integrity of Shared Data
Chapter 7 Checking the Portability of Application Data Declarations
Chapter 8 Examining the Condition-Handling Code in Your Application
Chapter 9 Translating Applications
Chapter 10 Ensuring Interoperability Between Native and Translated Images
Chapter 11 OpenVMS Alpha Compilers
Appendix A Application Evaluation Checklist
Glossary
Index
Figures
Examples
Tables

Contents

Chapter 1 Overview of the Migration Process
- 1.1 Compatibility of VAX and Alpha Systems
- 1.2 Differences Between the VAX and Alpha Architectures
  - 1.2.1 User-Written Device Drivers
- 1.3 Migration Process
- 1.4 Migration Paths
- 1.5 Migration Support from Digital
  - 1.5.1 Migration Assessment Service
  - 1.5.2 Application Migration Detailed Analysis and Design Service
  - 1.5.3 System Migration Detailed Analysis and Design Service
  - 1.5.4 Application Migration Service
  - 1.5.5 System Migration Service
Chapter 2 Selecting a Migration Method
- 2.1 Taking Inventory
- 2.2 How to Select a Migration Method
- 2.3 Which Migration Methods are Possible?
- 2.4 Coding Practices That Affect Recompilation
  - 2.4.1 VAX MACRO Assembly Language
  - 2.4.2 Privileged Code
  - 2.4.3 Features Specific to the VAX Architecture
- 2.5 Identifying Dependencies on the VAX Architecture in Your Application
  - 2.5.1 Data Alignment
  - 2.5.2 Data Types
  - 2.5.3 Shared Access to Data
  - 2.5.4 Reading or Writing Data Smaller Than a Quadword
  - 2.5.5 Page Size Considerations
  - 2.5.6 Order of Read/Write Operations on Multiprocessor Systems
  - 2.5.7 Immediacy of Arithmetic Exception Reporting
  - 2.5.8 Explicit Reliance on the VAX Procedure Calling Standard
  - 2.5.9 Explicit Reliance on VAX Exception-Handling Mechanisms
    - 2.5.9.1 Establishing a Dynamic Condition Handler
    - 2.5.9.2 Accessing Data in the Signal and Mechanism Arrays
  - 2.5.10 Modification of the VAX AST Parameter List
  - 2.5.11 Explicit Dependency on the Form and Behavior of VAX Instructions
  - 2.5.12 Generation of VAX Instructions at Run Time
- 2.6 Identifying Incompatibilities Between VAX and Alpha Systems
- 2.7 Deciding Whether to Recompile or Translate
  - 2.7.1 Translating Your Application
  - 2.7.2 Combining Native and Translated Images
Chapter 3 Migrating Your Application
- 3.1 Setting Up the Migration Environment
  - 3.1.1 Hardware
  - 3.1.2 Software
- 3.2 Converting Your Application
  - 3.2.1 Recompiling and Relinking
    - 3.2.1.1 Native Alpha Compilers
    - 3.2.1.2 VAX MACRO--32 Compiler for OpenVMS Alpha
    - 3.2.1.3 Other Development Tools
  - 3.2.2 Translating
    - 3.2.2.1 VAX Environment Software Translator (VEST) and Translated Image Environment (TIE)
- 3.3 Debugging and Testing the Migrated Application
  - 3.3.1 Debugging
    - 3.3.1.1 Debugging with the OpenVMS Debugger
    - 3.3.1.2 Debugging with the Delta Debugger
    - 3.3.1.3 Debugging with the OpenVMS Alpha System-Code Debugger
  - 3.3.2 Analyzing System Crashes
    - 3.3.2.1 System Dump Analyzer
    - 3.3.2.2 Crash Log Utility Extractor
  - 3.3.3 Testing
    - 3.3.3.1 VAX Tests
    - 3.3.3.2 Alpha Tests
  - 3.3.4 Uncovering Latent Bugs
- 3.4 Integrating the Migrated Application into a Software System
Chapter 4 Recompiling and Relinking Overview
Chapter 5 Adapting Applications to a Larger Page Size
Chapter 6 Preserving the Integrity of Shared Data
- 6.1 Overview
  - 6.1.1 VAX Architectural Features That Guarantee Atomicity
  - 6.1.2 Alpha Compatibility Features
- 6.2 Uncovering Atomicity Assumptions in Your Application
  - 6.2.1 Protecting Explicitly Shared Data
  - 6.2.2 Protecting Unintentionally Shared Data
- 6.3 Synchronizing Read/Write Operations
- 6.4 Ensuring Atomicity in Translated Images
Chapter 7 Checking the Portability of Application Data Declarations
Chapter 8 Examining the Condition-Handling Code in Your Application
Chapter 9 Translating Applications
- 9.1 DECmigrate for OpenVMS Alpha
- 9.2 DECmigrate: Translated Image Support
- 9.3 Translated Image Environment (TIE)
  - 9.3.1 Problems and Restrictions
    - 9.3.1.1 Condition Handler Restriction
    - 9.3.1.2 Exception Handler Restrictions
    - 9.3.1.3 Floating-Point Restrictions
    - 9.3.1.4 Interoperability Restrictions
    - 9.3.1.5 VAX C: Translated Program Restrictions
- 9.4 Translated Image Support
- 9.5 Translated Run-Time Libraries
  - 9.5.1 CRF$FREE_VM and CRF$GET_VM: Translated Callers
- 9.6 Translated VAX C Run-Time Library
  - 9.6.1 Problems and Restrictions
    - 9.6.1.1 Functional Restrictions
    - 9.6.1.2 Interoperability Restrictions
- 9.7 Translated VAX COBOL Programs
  - 9.7.1 Problems and Restrictions
Chapter 10 Ensuring Interoperability Between Native and Translated Images
Chapter 11 OpenVMS Alpha Compilers
- 11.1 Compatibility of DEC Ada Between Alpha Systems and VAX Systems
  - 11.1.1 Differences in Data Representation and Alignment
  - 11.1.2 Tasking Differences
  - 11.1.3 Differences in Language Pragmas
  - 11.1.4 Differences in the SYSTEM Package
  - 11.1.5 Differences Between Other Language Packages
  - 11.1.6 Changes to Predefined Instantiations
- 11.2 Compatibility of DEC C for OpenVMS Alpha Systems with VAX C
  - 11.2.1 Language Modes
  - 11.2.2 DEC C for OpenVMS Alpha Systems Data-Type Mappings
    - 11.2.2.1 Specifying Floating-Point Mapping
  - 11.2.3 Built-in Functions That Access Alpha Instructions
    - 11.2.3.1 Accessing Alpha Instructions
    - 11.2.3.2 Accessing Alpha Privileged Architecture Library (PALcode) Instructions
    - 11.2.3.3 Ensuring the Atomicity of Combined Operations
  - 11.2.4 Differences Between the VAX C and DEC C for OpenVMS Alpha Systems Compilers
    - 11.2.4.1 Controlling Data Alignment
    - 11.2.4.2 Accessing Argument Lists
    - 11.2.4.3 Synchronizing Exceptions
    - 11.2.4.4 Dynamic Condition Handlers
  - 11.2.5 STARLET Data Structures and Definitions for C Programmers
  - 11.2.6 VAX C Features Not Supported by /STANDARD=VAXC Mode
- 11.3 VAX COBOL and DEC COBOL Compatibility and Migration
  - 11.3.1 DEC COBOL Extensions and Features Differences
  - 11.3.2 Command Line Qualifiers
    - 11.3.2.1 /NATIONALITY={JAPAN|US}
    - 11.3.2.2 /STANDARD=MIA
    - 11.3.2.3 DEC COBOL-Specific Qualifiers
    - 11.3.2.4 /ALIGNMENT=PADDING
    - 11.3.2.5 VAX COBOL-Specific Qualifiers
    - 11.3.2.6 /STANDARD=V3
    - 11.3.2.7 /STANDARD=OPENVMS_AXP
  - 11.3.3 DEC COBOL and VAX COBOL Behavior Differences
    - 11.3.3.1 Program Structure Messages
    - 11.3.3.2 Program Listing Differences
      - 11.3.3.2.1 Machine Code
      - 11.3.3.2.2 Module Names
      - 11.3.3.2.3 COPY and REPLACE Statements
      - 11.3.3.2.4 Multiple COPY Statements
      - 11.3.3.2.5 COPY Insert Statement
      - 11.3.3.2.6 REPLACE Statement
      - 11.3.3.2.7 DATE COMPILED Statement
      - 11.3.3.2.8 Compiler Listings and Separate Compilations
    - 11.3.3.3 Output Formatting
    - 11.3.3.4 DEC COBOL and VAX COBOL Statement Differences
      - 11.3.3.4.1 ACCEPT and DISPLAY Statements
      - 11.3.3.4.2 EXIT PROGRAM Clause
      - 11.3.3.4.3 LINAGE Clause
      - 11.3.3.4.4 MOVE Statement
      - 11.3.3.4.5 SEARCH Statement
    - 11.3.3.5 System Return Codes
    - 11.3.3.6 Diagnostic Messages
    - 11.3.3.7 Storage for Double-Precision Data Items
    - 11.3.3.8 High-Order Truncation of Data Items
    - 11.3.3.9 File Status Values
    - 11.3.3.10 Key of Reference
    - 11.3.3.11 RMS Special Registers
    - 11.3.3.12 Calling Shareable Images
    - 11.3.3.13 Sharing Common Blocks
    - 11.3.3.14 Arithmetic Operations
  - 11.3.4 File Compatibility Across Languages and Platforms
  - 11.3.5 Reserved Words
  - 11.3.6 Debugger Support Differences
  - 11.3.7 DECset/LSE Support Differences
  - 11.3.8 DBMS Support
- 11.4 Compatibility of Digital Fortran on OpenVMS Alpha and OpenVMS VAX Systems
  - 11.4.1 Language Features
    - 11.4.1.1 Language Features Specific to Digital Fortran for OpenVMS Alpha
    - 11.4.1.2 Language Features Specific to Digital Fortran 77 for OpenVMS VAX Systems
    - 11.4.1.3 Interpretation Differences
  - 11.4.2 Command Line Qualifiers
    - 11.4.2.1 Qualifiers Specific to Digital Fortran for OpenVMS Alpha
    - 11.4.2.2 Qualifiers Specific to Digital Fortran 77 for OpenVMS VAX Systems
  - 11.4.3 Interoperability with Translated Shared Images
  - 11.4.4 Porting Digital Fortran 77 for OpenVMS VAX Systems Data
- 11.5 Compatibility of DEC Pascal for OpenVMS Alpha Systems with VAX Pascal
  - 11.5.1 New Features of DEC Pascal
  - 11.5.2 Establishing Dynamic Condition Handlers
  - 11.5.3 Modifying Default Alignment Rules for Record Fields
  - 11.5.4 Recommended Use of Predeclared Identifiers
  - 11.5.5 Platform-Dependent Features
  - 11.5.6 Obsolete Features
    - 11.5.6.1 /OLD_VERSION Qualifier
    - 11.5.6.2 /G_FLOATING Qualifier
    - 11.5.6.3 OVERLAID Attribute
Appendix A Application Evaluation Checklist
Glossary
Index
Examples
Figures
Tables

Next | [Home] | [Comments] | [Ordering info] | [Help]

[HR]

  6459PTOC.HTM
  OSSG Documentation
  22-NOV-1996 13:07:36.07

Copyright © Digital Equipment Corporation 1996. All Rights Reserved.