COGNOS(R) APPLICATION DEVELOPMENT TOOLS POWERHOUSE(R) 4GL FOR MPE/IX MIGRATION PLANNING GUIDE Migration Planning Guide 15-02-2005 PowerHouse 8.4 Type the text for the HTML TOC entry Type the text for the HTML TOC entry Type the text for the HTML TOC entry Type the Title Bar text for online help PowerHouse(R) 4GL version 8.4 USER GUIDE (DRAFT) THE NEXT LEVEL OF PERFORMANCETM Product Information This document applies to PowerHouse(R) 4GL version 8.4 and may also apply to subsequent releases. To check for newer versions of this document, visit the Cognos support Web site (http://support.cognos.com). Copyright Copyright © 2005, Cognos Incorporated. All Rights Reserved Printed in Canada. This software/documentation contains proprietary information of Cognos Incorporated. All rights are reserved. Reverse engineering of this software is prohibited. No part of this software/documentation may be copied, photocopied, reproduced, stored in a retrieval system, transmitted in any form or by any means, or translated into another language without the prior written consent of Cognos Incorporated. Cognos, the Cognos logo, Axiant, PowerHouse, QUICK, and QUIZ are registered trademarks of Cognos Incorporated. QDESIGN, QTP, PDL, QUTIL, and QSHOW are trademarks of Cognos Incorporated. OpenVMS is a trademark or registered trademark of HP and/or its subsidiaries. UNIX is a registered trademark of The Open Group. Microsoft is a registered trademark, and Windows is a trademark of Microsoft Corporation. FLEXlm is a trademark of Macrovision Corporation. All other names mentioned herein are trademarks or registered trademarks of their respective companies. All Internet URLs included in this publication were current at time of printing. While every attempt has been made to ensure that the information in this document is accurate and complete, some typographical or technical errors may exist. Cognos does not accept responsibility for any kind of loss resulting from the use of the information contained in this document. This page shows the publication date. The information contained in this document is subject to change without notice. Any improvements or changes to either the product or the publication will be documented in subsequent editions. U.S. Government Restricted Rights. The software and accompanying materials are provided with Restricted Rights. Use, duplication, or disclosure by the Government is subject to the restrictions in subparagraph (C)(1)(ii) of the Rights in Technical Data and Computer Software clause at DFARS 252.227-7013, or subparagraphs (C) (1) and (2) of the Commercial Computer Software - Restricted Rights at 48CFR52.227-19, as applicable. The Contractor is Cognos Corporation, 15 Wayside Road, Burlington, MA 01803. Information about Cognos Products and Accessibility can be found at www.Cognos.com. Table of Contents About this Book 5 Cognos PowerHouse 4GL, Axiant 4GL, and PowerHouse Web Documentation Set 6 Chapter 1: Migration Choices 11 Key Migration Decisions 11 Choosing the Target Platform 11 Choosing the Target File Systems 12 Choosing the End-User UI 13 Choosing the Migration Method 13 Choosing the Migration Timing 14 Moving Forward 14 Chapter 2: The Target Platform: UNIX 15 Platform Differences 15 Groups and Accounts vs. Directory Paths 15 File Names 15 Operating System Commands 16 System Management 18 PowerHouse Differences 19 PowerHouse File Extensions 19 Subfiles 20 Designated Files and Environment Variables 20 Case Sensitivity 21 Interrupt Control 21 PDL 21 QDESIGN/QUICK 22 QTP 23 QUIZ 23 After the Migration 24 PDL 24 QDESIGN/QUICK 24 QTP 25 QUIZ 25 Moving Forward 25 Chapter 3: The Target Platform: Windows 27 Platform Differences 27 Groups and Accounts vs. Folders 27 File Names 27 Operating System Commands 28 System Management 30 PowerHouse Differences 30 The Command Prompt Window 30 PowerHouse File Extensions 31 Paths in File Names 31 Subfiles 32 Designated Files and Environment Variables 32 Interrupt Control 33 PDL 33 QDESIGN/QUICK 33 QTP 35 Migration Planning Guide 3 QUIZ 35 After the Migration 36 PDL 36 QDESIGN/QUICK 37 QTP 37 QUIZ 37 Moving Forward 37 Chapter 4: The File Systems 39 Migrating from IMAGE 39 IMAGE to An IMAGE Emulator 39 IMAGE to Relational 40 IMAGE to Indexed 48 Migrating from KSAM (Indexed) 49 KSAM to Indexed 49 KSAM to Relational 51 Migrating from MPE Files (Direct, Relative, Sequential) 57 Direct and Sequential Files 57 Relative Files 58 Migrating from Allbase or Oracle (Relational) 59 Datatype Mappings 60 Moving Forward 61 Chapter 5: The Migration Plan 63 Overview 63 The Twelve Step Plan 63 Step 1: Define the Application 63 Step 2: Learn 63 Step 3: Take Inventory 64 Step 4: Identify What Will Be Migrated 64 Step 5: Develop a Plan 65 Step 6: Migrate The Pilot Application 65 Migrate with the Axiant Migration Tools 65 Migrate without the Axiant Migration Tools 68 Step 7: Assemble the Pilot Application 70 Step 8: Assess Steps 2 through 7 71 Step 9: Have Users Evaluate the Pilot 71 Step 10: Assess Steps 2 through 9 71 Step 11: Plan the Complete Migration 71 Step 12: Do the Complete Migration 71 In Conclusion 71 Index 73 4 PowerHouse(R) 4GL for MPE/iX About this Book Overview This book describes how to plan your migration of PowerHouse applications from MPE/iX to a UNIX or Windows platform. It is intended for system managers and developers who are familiar with the MPE/iX environment and have a basic knowledge of UNIX or Windows. Unless otherwise indicated, where "Windows" appears in the documentation, it applies to the Microsoft Windows operating systems. And unless otherwise indicated, where "relational database" appears in the documentation, it refers to a relational database management system (RDBMS). Chapter 1, "Migration Choices", gives an overview of the types of migration covered in this guide. It also identifies the factors which will influence your choices for each type of migration. Chapter 2, "The Target Platform: UNIX", discusses differences between MPE/iX and UNIX that will have to be addressed during the migration. Chapter 3, "The Target Platform: Windows", discusses differences between MPE/iX and Windows that will have to be addressed during the migration. Chapter 4, "The File Systems", contains a separate section for each of the MPE/iX file systems: IMAGE, KSAM, MPE, and relational. In each section, we identify the target file systems available for the given source file system, and then discuss the work involved in migrating between the two file systems. Chapter 5, "The Migration Plan", describes the 12-step plan to actually perform the migration. This identifies everything from identifying training needs to editing data definitions. We'll show two ways of doing this, with and without the Axiant 4GL migration tools. Migration Planning Guide 5 About this Book Cognos PowerHouse 4GL, Axiant 4GL, and PowerHouse Web Documentation Set PowerHouse 4GL, Axiant 4GL, and PowerHouse Web documentation includes planning and configuration advice, detailed information about statements and procedures, installation instructions, and last minute product information. Objective Document Get detailed Cognos PowerHouse 4GL Reference documents reference on the documentation CD. They provide detailed information for information about PowerHouse rules and each PowerHouse 4GL PowerHouse component. and PowerHouse The documents are: Web • Cognos PowerHouse 4GL PowerHouse Rules (PHRules.pdf) • Cognos PowerHouse 4GL PDL and Utilities Reference (PDL.pdf) • Cognos PowerHouse 4GL QDESIGN Reference (QD.pdf) • Cognos PowerHouse 4GL PowerHouse and Relational Databases (PHRDB.pdf) • Cognos PowerHouse 4GL PHD Reference (PHD.pdf) • Cognos PowerHouse 4GL QUIZ Reference (QZ.pdf) • Cognos PowerHouse 4GL QTP Reference (QTP.pdf) Available from the PowerHouse 4GL documentation CD or from: http://support.cognos.com and http://powerhouse.cognos.com Get an Cognos PowerHouse 4GL Primer. This document introduction to provides an overview of the PowerHouse language PowerHouse 4GL and a hands-on demonstration of how to use PowerHouse. Available from the PowerHouse 4GL documentation CD or from: http://www.cognos.com/products/powerhouse/ download.html Install Cognos PowerHouse 4GL & PowerHouse Web PowerHouse 4GL Getting Started books. These documents provide step-by-step instructions on installing PowerHouse 4GL on each supported platform. 6 PowerHouse(R) 4GL for MPE/iX About this Book Objective Document Get a summary of PowerHouse 4GL New Features. This document what’s new in contains a summary of new features in this release PowerHouse 4GL of PowerHouse. It also contains documentation for features specific to PowerHouse for Windows Available from: http://support.cognos.com and http://powerhouse.cognos.com Attend training Instructor-led classes are available for courses PowerHouse 4GL, Axiant 4GL, and PowerHouse Web. They provide hands-on education about these products. Available courses include: • PowerHouse 4GL - Introduction • PowerHouse 4GL - QUIZ Reporting By Users • PowerHouse 4GL - QUIZ Advanced Reporting • PowerHouse 4GL - Advanced Part I • PowerHouse 4GL - Advanced Part 2 • PowerHouse 4GL - Relational Interface Part I • PowerHouse 4GL - Relational Interface Part II • PowerHouse 4GL - Moving to Relational: Understanding Relational Databases • PowerHouse 4GL - Moving to Relational: Porting PowerHouse Applications • Axiant 4GL - Building Applications • Migrating Applications with Axiant 4GL • PowerHouse Web - Developing Applications Course descriptions and schedules are available from: http://support.cognos.com and http://powerhouse.cognos.com