Rational IBM Informix IBM Informix IBM Informix 4GL to EGL Conversion Utility User’s Guide Version 7.1 G229-6339-01

  • View
    214

  • Download
    1

Embed Size (px)

Transcript

  • Rational IBM Informix

    IBM Informix 4GL to EGL Conversion Utility Users Guide

    Version 7.1

    G229-6339-01

  • Rational IBM Informix

    IBM Informix 4GL to EGL Conversion Utility Users Guide

    Version 7.1

    G229-6339-01

  • Note: Before using this information and the product it supports, read the information in Notices on page L-1.

    This document contains proprietary information of IBM. It is provided under a license agreement and is protected by copyright law. The information contained in this publication does not include any product warranties, and any statements provided in this manual should not be interpreted as such.

    When you send information to IBM, you grant IBM a nonexclusive right to use or distribute the information in any way it believes appropriate without incurring any obligation to you.

    Copyright International Business Machines Corporation 2005, 2008. All rights reserved. US Government Users Restricted Rights Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.

  • Contents

    Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vii In This Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vii About This Manual . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vii Types of Users . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vii Features of This Product . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vii Platforms Supported . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . viii Typographical Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . viii Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . viii IBM Welcomes Your Comments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . x

    Chapter 1. Overview of the Conversion Process . . . . . . . . . . . . . . . . . 1-1 In This Chapter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-1 Introduction to the I4GL to EGL Conversion . . . . . . . . . . . . . . . . . . . . . . . . 1-1 Conversion Benefits . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-1 I4GL to EGL Conversion Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-2

    Pre-Conversion Stage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-2 Conversion Stage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-2 Post-Conversion Stage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-3 Reconversion Stage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-3

    Conversion Limitations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-3 C Interface Support and Limitations . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-4 Report Support and Limitations . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-4 Screen Forms Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-5

    Chapter 2. Preparing for Conversion . . . . . . . . . . . . . . . . . . . . . . 2-1 In This Chapter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-1 Overview of Pre-Conversion Tasks . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-1 Conversion Limitations and Workarounds . . . . . . . . . . . . . . . . . . . . . . . . . 2-2

    4GL Source Conversion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-2 C Code Functionality . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-2 Reports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-3

    Identify Existing I4GL Components Project . . . . . . . . . . . . . . . . . . . . . . . . 2-4 Generate I4GL Source Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-4 Compile your I4GL Application . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-4 Identify the Client Locale . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-5 Identify and Separate the Shared Libraries . . . . . . . . . . . . . . . . . . . . . . . . . 2-5

    Modifying C Code Used with Rapid Development System (RDS) . . . . . . . . . . . . . . . . 2-5 Identify User-Defined Message Files . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-6 Identify Informix Database Schema Information . . . . . . . . . . . . . . . . . . . . . . . 2-6 Identify an EGL Destination Directory . . . . . . . . . . . . . . . . . . . . . . . . . . 2-6 Prepare the I4GL Source File Directory . . . . . . . . . . . . . . . . . . . . . . . . . . 2-7

    Chapter 3. Conversion Tasks . . . . . . . . . . . . . . . . . . . . . . . . . . 3-1 In This Chapter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-1 Conversion Utility Stages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-1 Informix Database Schema Extraction . . . . . . . . . . . . . . . . . . . . . . . . . . 3-1

    Conversion Utility Processing for Informix Database Schema Extraction . . . . . . . . . . . . . . 3-3 I4GL Shared Libraries Conversion . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-3

    Conversion Utility Processing for I4GL Shared Libraries . . . . . . . . . . . . . . . . . . . 3-5 I4GL Application Conversion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-6

    Conversion Utility Processing for I4GL Application Conversion . . . . . . . . . . . . . . . . . 3-8 Conversion Utility Command Line Mode . . . . . . . . . . . . . . . . . . . . . . . . . 3-8 The Conversion Log . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-9

    Chapter 4. Post-Conversion Tasks . . . . . . . . . . . . . . . . . . . . . . . 4-1

    Copyright IBM Corp. 2005, 2008 iii

  • In This Chapter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-1 Post-Conversion Tasks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-2 Changes Made During the Conversion . . . . . . . . . . . . . . . . . . . . . . . . . . 4-2 Artifacts Generated During the Conversion . . . . . . . . . . . . . . . . . . . . . . . . 4-3

    Configuration File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-4 Manifest File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-5

    Source File Conversion Mapping . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-5 Command Line Conversion: Importing Projects into the Workspace . . . . . . . . . . . . . . . . 4-6 Correcting Conversion Errors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-6

    Conversion Log Contents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-7 Using C Shared Libraries with the EGL Program . . . . . . . . . . . . . . . . . . . . . . . 4-9

    EGL Native Library . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-9 Function Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-9 Creating the Application Level Shared Library . . . . . . . . . . . . . . . . . . . . . . 4-10

    Properties Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-12 Validating and Compiling Converted EGL Files . . . . . . . . . . . . . . . . . . . . . . . 4-13 Generating EGL to Java . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-13 Understanding Error Message Conversion . . . . . . . . . . . . . . . . . . . . . . . . 4-14 Understanding Report Conversion . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-14

    EGL Report Driver Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-15 I4GL Report Sections . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-17

    Understanding your EGL Projects, Packages and Files . . . . . . . . . . . . . . . . . . . . 4-28 EGL Project . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-28 Package . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-29 EGL Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-30 Recommendations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-30

    The Information Center Help System and EGL Tutorial . . . . . . . . . . . . . . . . . . . . 4-32

    Chapter 5. Reconversion Process and Tasks . . . . . . . . . . . . . . . . . . . 5-1 In This Chapter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-1 When to Reconvert Your I4GL Shared Libraries . . . . . . . . . . . . . . . . . . . . . . . 5-1 How to Reconvert Your I4GL Shared Libraries . . . . . . . . . . . . . . . . . . . . . . . 5-1 Conversion Wizard Reconversion . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-2 Command Line Reconversion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-2 Reasons and Workarounds for Unsuccessful Reconversions . . . . . . . . . . . . . . . . . . . 5-2

    Appendix A. I4GL to EGL Syntax Mapping . . . . . . . . . . . . . . . . . . . . A-1

    Appendix B. I4GL Report Conversion Code Example . . . . . . . . . . . . . . . B-1

    Appendix C. I4GL Form Code to EGL Form Code Example . . . . . . . . . . . . . C-1

    Appendix D. Configuration File Templates . . . . . . . . . . . . . . . . . . . . D-1

    Appendix E. Manifest File Examples . . . . . . . . . . . . . . . . . . . . . . . E-1

    Appendix F. DTD Examples . . . . . . . . . . . . . . . . . . . . . . . . . .