Mainframe Manual

Download Mainframe Manual

Post on 10-Apr-2015

747 views

Category:

Documents

8 download

Embed Size (px)

TRANSCRIPT

<p>Migrating Applications from Vendor Libraries to SCLMDocument Number GG24-4021-00 June 1993</p> <p>International Technical Support Center San Jose</p> <p>Take Note! Before using this information and the product it supports, be sure to read the general information under Special Notices on page xiii.</p> <p>First Edition (June 1993) This edition applies to Version 3 Release 5 of ISPF/PDF Software Configuration and Library Manager, Program Number 5665-402 for use with MVS Version 2 Release 2 or later and TSO/E Version 2 Release 1. Order publications through your IBM representative or the IBM branch office serving your locality. Publications are not stocked at the address given below. An ITSC Technical Bulletin Evaluation Form for readers' feedback appears facing Chapter 1. If the form has been removed, comments may be addressed to: IBM Corporation, International Technical Support Center Dept. 471, Building 098 5600 Cottle Road San Jose, California 95193-0001 When you send information to IBM, you grant IBM a non-exclusive right to use or distribute the information in any way it believes appropriate without incurring any obligation to you. Copyright International Business Machines Corporation 1993. All rights reserved. Note to U.S. Government Users Documentation related to restricted rights Use, duplication or disclosure is subject to restrictions set forth in GSA ADP Schedule Contract with IBM Corp.</p> <p>AbstractThis book describes and documents the process used to migrate two customer applications from CA-LIBRARIAN and ENDEVOR to ISPF/PDF Software Configuration and Library Manager (SCLM). The tools developed to support the migration are included. Readers can apply the techniques used and the experience gained during our project to migrations from any vendor library system to SCLM. The book is intended for project leaders, library administrators, system programmers, and application developers involved in migrating applications from vendor libraries to SCLM. It assumes that users are familiar with the basic concepts of SCLM. AD LS (171 pages)</p> <p> Copyright IBM Corp. 1993</p> <p>iii</p> <p>iv</p> <p>Library Migration</p> <p>ContentsExecutive Summary. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .</p> <p>1 3 3 4 4 5 5 5 6 6</p> <p>Chapter 1. Introduction</p> <p>Why Migrate to SCLM? . . . . . . . Objectives and Scope of the Project Project Environment . . . . . . . Sample Applications . . . . . . . Migration Steps . . . . . . . . . . Vendor Library Systems . . . . . . . . . . . . . . . . CA-LIBRARIAN ENDEVOR . . . . . . . . . . . . . .</p> <p>Chapter 2. Preparing for Migration</p> <p>Develop Migration Strategy . . . . . . . . . . . . . . Define Organizational and Administrative Structure Select Pilot Application . . . . . . . . . . . . . . . . . Sample Application 1 . . . . . . . . . . . . . . . . . . Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Release Process Sample Application 2 . . . . . . . . . . . . . . . . . . Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Release Process Extract Data for the Sample Applications . . . . . . Application 1 . . . . . . . . . . . . . . . . . . . . . . Application 2 . . . . . . . . . . . . . . . . . . . . . .</p> <p>. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .</p> <p>. . 9 . . 9 . 10 . 12 . 12 . 13 . 13 . 16 . 16 . 16 . 17 . 17 . 21 . . . . . . . . . . . . . . . . . . . .</p> <p>Chapter 3. Defining SCLM Project SetupPartitioned Data Set High-Level Qualifier Groups . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Types Version and Audit . . . . . . . . . . . . . Languages . . . . . . . . . . . . . . . . . Accounting Data Set . . . . . . . . . . . . Technical Setup Steps . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . .</p> <p>23 23 24 26 27 28 28 28 29 33 33 35 36 37 37 40 40 41 44 47</p> <p>Chapter 4. Migrating the Control Information</p> <p>Languages and Translators . . . . . . . . . . . . . . . . . . . . SCLM Languages Used in the Migration Project . . . . . . Compilers Used in the Old Environment . . . . . . . . . . . Compiler Options . . . . . . . . . . . . . . . . . . . . . . . . . . Compiler Options in SCLM . . . . . . . . . . . . . . . . . . . Finding VS COBOL II Compiler Options for Application 1 . Other Information about Compiler Options for Application 1 Information about Compiler Options for Application 2 . . . Control Information for the Linkage Editor . . . . . . . . . . . Creating LEC and CC Architecture Definitions . . . . . . . . . DB2CLIST Considerations . . . . . . . . . . . . . . . . . . . . . Copyright IBM Corp. 1993</p> <p>. . . . . . . . . . . . . . . . .</p> <p>v</p> <p>Chapter 5. Migrating the Bulk Data</p> <p>Standard Source Code . . . . . . . . . . . . . . . . . . . . Nonstandard Source Code . . . . . . . . . . . . . . . . . . COBOL Copy Statements with Leading Data Names . COBOL Copy Statements with Prefix Replacement . . INC CA-LIBRARIAN Statements . . . . . . . . . . . . Completeness and Correctness Checks . . . . . . . . . . SCLM Architecture Reports for Completeness Checks Check Correctness Using SCLM BUILDs . . . . . . . .</p> <p>. . . . . . . . . . . . . . . . . . .</p> <p>. . . . . . . . .</p> <p>. . . . . . . . .</p> <p>. . . . . . . . .</p> <p>. . . . . . . . .</p> <p>. . . . . . . . .</p> <p>. . . . . . . . .</p> <p>. . . . . . . . . . . . . . . . .</p> <p>. . . . . . . . . . . . . . . . .</p> <p>. . . . . . . . . . . . . . . . .</p> <p>. . . . . . . . . . . . . . . . .</p> <p>. . . . . . . . . . . . . . . . .</p> <p>. . . . . . . . . . . . . . . . .</p> <p>. . . . . . . . . . . . . . . . .</p> <p>. . . . . . . . . . . . . . . . .</p> <p>. . . . . . . . . . . . . . . . .</p> <p>. . . . . . . . . . . . . . . . .</p> <p>. . . . . . . . . . . . . . . . .</p> <p>. . . . . . . . . . . . . . . . .</p> <p>. . . . . . . . . . . . . . . . .</p> <p>49 51 52 52 54 57 58 58 59 61 61 62 63 63 63 63 69 71 71 71 73 73 74 75 77 77 77 82 88 96 96 97 101 104 104 106 108 110 112 114 116 119 120 121 122 123 123 129 139 139 141 156</p> <p>Chapter 6. Creating High-Level Application Structure</p> <p>Sources of Information . . . . . . . . . . . . . . . . . . . . . . . . Application Structure Information in Your Old Library System Structure Information from Dictionary Reports . . . . . . . . . Information from Application Documentation . . . . . . . . . . Scan of Source Modules . . . . . . . . . . . . . . . . . . . . . . Creating the Architecture Definitions . . . . . . . . . . . . . . . . BUILD and PROMOTE Using the Architecture Definitions . . .</p> <p>. . . . . . . . . . . . . . . . . . . . . . . . .</p> <p>Chapter 7. Post-Migration Steps</p> <p>Promote Migrated Application to Production Handle Nonmigrated Information . . . . . .</p> <p>. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .</p> <p>Appendix A. Data Extraction from CA-LIBRARIANCopy Selected Members between CA-LIBRARIANs Extract Programs and Remove Included Members Unload from CA-LIBRARIAN to Partitioned Data Set</p> <p>Appendix B. Methods and Tools for Analyzing Existing ApplicationsApplication 1 . . . . . . . . . . . . . . . . . . . . . . . . . . . Compiler Information . . . . . . . . . . . . . . . . . . . . . VS COBOL II Compiler Options . . . . . . . . . . . . . . . Extracting Compile and Link Edit Information . . . . . . Application 2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Find Information for Languages Extract Control Information from ENDEVOR Archive File. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .</p> <p>Appendix C. SCLM Project DefinitionLanguage Definitions . . . . . . . . . . . . . . . . . . . F@ASMH for Assembler H F@L370 for the Linkage Editor . . . . . F@COBL for OS/VS COBOL . . . . . . . F@COB2 for VS COBOL II . . . . . . . . F@COB22 for VS COBOL II with CMPR2 F@PLIO for OS PL/I V2 . . . . . . . . . . F@AD2 for Assembler H with DB2 . . . F@SCMD for DB2 DDL Subcommands F@PANELS for ISPF Panels . . . . . . . F@@SKEL for ISPF Skeletons . . . . . F@MSGS for ISPF Messages . . . . . .</p> <p>. . . . . . . . . . . .</p> <p>. . . . . . . . . . . . .</p> <p>. . . . . . . . . . . . .</p> <p>. . . . . . . . . . . . .</p> <p>. . . . . . . . . . . . .</p> <p>. . . . . . . . . . . . .</p> <p>. . . . . . . . . . . . .</p> <p>. . . . . . . . . . . . .</p> <p>. . . . . . . . . . . . .</p> <p>. . . . . . . . . . . . .</p> <p>Appendix D. Generation of Architecture DefinitionsLEC and CC Architecture Definitions . . . . HL Architecture Definitions and DB2CLISTs</p> <p>. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .</p> <p>Appendix E. Tools for Bulk Data Migration</p> <p>Changing Old COBOL COPY Syntax . . . . . . . . . . . . Handling COPY Prefix Replacement in COBOL Programs Changing CA-LIBRARIAN INC Statements . . . . . . .</p> <p>vi</p> <p>Library Migration</p> <p>Using SCLM Command Interface for Mass BUILDs</p> <p>. . . . . . . . . . . . . . . . . . . . . .</p> <p>158 163 165 167</p> <p>Glossary</p> <p>. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .</p> <p>List of Abbreviations Index</p> <p>. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .</p> <p>Contents</p> <p>vii</p> <p>viii</p> <p>Library Migration</p> <p>Figures1. 2. 3. 4. 5. 6. 7. 8. 9. 10. 11. 12. 13. 14. 15. 16. 17. 18. 19. 20. 21. 22. 23. 24. 25. 26. 27. 28. 29. 30. 31. 32. 33. 34. 35. 36. 37. 38. 39. 40. 41. 42. 43. 44. 45. 46. Release Procedure for Sample Application 1: General Flow . . . . . . . . . . . . . . Release Procedure for Sample Application 1: Data Flow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Release Procedure Using ENDEVOR Extraction of Program Sources for Application 1 . . . . . . . . . . . . . . . . . . . . . Project Hierarchy for Our Migration Project . . . . . . . . . . . . . . . . . . . . . . . . Extraction and Use of Control Information . . . . . . . . . . . . . . . . . . . . . . . . . Extraction of Information from Load Modules . . . . . . . . . . . . . . . . . . . . . . . Formatted File before Editing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Formatted File after Editing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Sample Job to Run the IBM AMBLIST Utility . . . . . . . . . . . . . . . . . . . . . . . . AMBLIST Output for Assembler Load Module P92N041 . . . . . . . . . . . . . . . . . Input Records to Create LEC and CC Architecture Definitions for COBOL Programs LEC and CC Architecture Definitions for OS/VS COBOL Program P92N002 . . . . . LEC Architecture Definition for VS COBOL II Program P92N046 . . . . . . . . . . . . Input Records to Create LEC and CC Architecture Definitions for PL/I Programs . . LEC and CC Architecture Definitions for PL/I Program P94N353 . . . . . . . . . . . . Input Records to Create LEC and CC Architecture Definitions for Assembler Programs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . LEC Architecture Definition for Assembler Program P92N041 . . . . . . . . . . . . . . HL Architecture Definition Created by the MIGR0050 Program . . . . . . . . . . . . . Overview of Bulk Data Migration Steps . . . . . . . . . . . . . . . . . . . . . . . . . . . SCLM Migration Utility Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . COBOL Copy Book without 01 Level Data Name . . . . . . . . . . . . . . . . . . . . . COBOL Copy Book with 01 Level Data Name . . . . . . . . . . . . . . . . . . . . . . . COBOL Error Messages for Duplicate 01 Level Data Names . . . . . . . . . . . . . . COPY REPLACING: Example 1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . COPY REPLACING: Example 2a (COBOL Standard) . . . . . . . . . . . . . . . . . . . COPY REPLACING: Example 2b (CA-LIBRARIAN Standard) . . . . . . . . . . . . . . . COPY REPLACING: Example 2c (COBOL AN...</p>