Application System/400 System/38 Environment Programming Version 3 Publication No
Total Page:16
File Type:pdf, Size:1020Kb
Application System/400 SC41-3735-00 System/38 Environment Programming Version 3 IBM Application System/400 SC41-3735-00 System/38 Environment Programming Version 3 Take Note! Before using this information and the product it supports, be sure to read the general information under “Notices” on page v. | First Edition (September 1994) | This edition applies to the licensed program IBM Operating System/400, (Program 5763-SS1), Version 3 Release 1 Modification 0, and to all subsequent releases and modifications until otherwise indicated in new editions. Make sure you are using the proper edition for the level of the product. | Order publications through your IBM representative or the IBM branch serving your locality. If you live in the United States, Puerto | Rico, or Guam, you can order publications through the IBM Software Manufacturing Company at 800+879-2755. Publications are not stocked at the address given below. A form for readers' comments is provided at the back of this publication. If the form has been removed, you may address your comments to: Attn Department 245 IBM Corporation 3605 Highway 52 N | Rochester, MN 55901-9986 USA | or you can fax your comments to: | United States and Canada: 800+937-3430 | Other countries: (+1)+507+253-5192 | If you have access to Internet, you can sent your comments electronically to [email protected]; IBMMAIL, to | ibmmail(usib56rz). 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 or restricting your use of it. Copyright International Business Machines Corporation 1994. 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. Contents Notices . v Chapter 5. Coexistence with an AS/400 Programming Interface . v System . 5-1 | Trademarks and Service Marks ........ v Interchanging Media . 5-1 Interchanging Save File Data ......... 5-1 About System/38 Environment Exchange ID . 5-1 Programming (SC41-3735) . vii APPC . 5-2 What the Book Contains ............. vii Pass-Through . 5-2 What the Book Does Not Contain ....... vii Object Distribution . 5-2 Who Should Use This Book ........... vii SNADS . 5-2 Interchanging Using Communication or Mixed Chapter 1. Migration to the System/38 Files . 5-2 Environment . 1-1 Interchanging Using DDM ........... 5-2 Operational Differences . 1-1 Alerts . 5-5 The Migration Aid ................ 1-2 Interchanging PC Data ............. 5-5 Moving Objects without the Migration Aid .. 1-2 Interchanging Journal Objects ........ 5-6 Restoring the System/38 Objects on the AS/400 System . 1-3 Chapter 6. Maintaining System/38 Significant Changes . 1-3 Applications on an AS/400 System ... 6-1 How the System/38 Environment Is Defined 1-5 Automating Most of the Process ....... 6-3 What Is the System/38 Environment? .... 1-6 List by Function ................. 6-4 How Should You Operate the System? .. 1-10 APF . 6-4 Object Attributes and Source Types .... 1-10 CL . 6-4 Example . 1-14 CL Programs . 6-4 Migrating Multiple System/38s to a Single Command Definition . 6-4 AS/400 System . 1-15 Commitment Control . 6-4 Data Description Specifications (DDS) .. 6-4 Chapter 2. Changes Needed after Database . 6-4 Migration . 2-1 Message Handling . 6-4 Operating System/400 Program ....... 2-1 Programs . 6-5 Utilities and Other Licensed Programs .. 2-62 Return Codes . 6-5 Languages . 2-66 Languages . 6-5 COBOL . 6-5 Chapter 3. Converting from the System/38 Report Program Generator (RPG) .... 6-5 Environment to the OS/400 Program .. 3-1 Overview . 3-1 Chapter 7. Summary of Migration Details 7-1 CL Programs and Job Streams ........ 3-1 What You Should Do on System/38 before Files and Data Management Changes ... 3-3 You Migrate . 7-1 Languages . 3-4 Before Restoring the System/38 Objects .. 7-3 Data File Utility (DFU) ............. 3-5 Migration of System/38 Objects ....... 7-5 Query . 3-5 Handling QGPL . 7-5 Mass Changes of Source Types ....... 3-5 What Should You Do after Migration ..... 7-5 Chapter 4. Changes Needed to Convert to Appendix A. System/38 Commands and the OS/400 Program ............ 4-1 Command Definitions . A-1 General . 4-1 Command Definition Statements ....... A-1 Operating System/400 Program ....... 4-1 Utilities and Other Program Products ... 4-16 Appendix B. DDS Keyword Changes ... B-1 Languages . 4-17 Appendix C. Display and Print File Return Codes . C-1 Copyright IBM Corp. 1994 iii Major and Minor Return Codes Summary Appendix E. Converting RPG from (Display and Printer) ............. C-1 System/38 to the AS/400 System ..... E-1 Converting to AS/400 System ........ E-2 Appendix D. Sample Programs . D-1 1. Print Device Configuration Program ... D-1 Glossary . G-1 2. Moving User Objects from One Library to Another . D-3 Bibliography . H-1 3. Check for a Library Owner ......... D-7 Index . X-1 iv AS/400 System/38 Environment Programming Notices References in this publication to IBM products, programs, or services do not imply that IBM intends to | make these available in all countries in which IBM operates. Any reference to an IBM product, program, | or service is not intended to state or imply that only that IBM product, program, or service may be used. | Any functionally equivalent product, program, or service that does not infringe any of the intellectual prop- | erty rights of IBM may be used instead of the IBM product, program, or service. The evaluation and | verification of operation in conjunction with other products, except those expressly designated by IBM, are | the responsibility of the user. IBM may have patents or pending patent applications covering subject matter in this document. The fur- nishing of this document does not give you any license to these patents. You can send license inquiries, | in writing, to the IBM Director of Commercial Relations, IBM Corporation, 208 Harbor Drive, Stamford, CT | 06904, U.S.A. | This publication could contain technical inaccuracies or typographical errors. | This publication may refer to products that are announced but not currently available in your country. This | publication may also refer to products that have not been announced in your country. IBM makes no | commitment to make available any unannounced products referred to herein. The final decision to | announce any product is based on IBM's business and technical judgment. | Changes or additions to the text are indicated by a vertical line (|) to the left of the change or addition. This publication contains examples of data and reports used in daily business operations. To illustrate them as completely as possible, the examples include the names of individuals, companies, brands, and products. All of these names are fictitious and any similarity to the names and addresses used by an actual business enterprise is entirely coincidental. This publication contains small programs that are furnished by IBM as simple examples to provide an illustration. These examples have not been thoroughly tested under all conditions. IBM, therefore, cannot guarantee or imply reliability, serviceability, or function of these programs. All programs contained herein are provided to you "AS IS". THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE EXPRESSLY DISCLAIMED. Programming Interface The System/38 Environment Programming book discusses migration from the System/38 to the OS/400 System/38 environment, conversion to the OS/400 program, and coexistence with the AS/400 system. This book contains no programming interfaces for customers. | Trademarks and Service Marks | The following terms, denoted by an asterisk (*) in this publication, are trademarks of the IBM Corporation | in the United States or other countries or both: Copyright IBM Corp. 1994 v | Advanced Peer-to-Peer Networking Operating System/400 | Application System/400 OS/400 | APPN Personal System/2 | AS/400 PROFS | Common User Access PS/2 | CUA RPG/400 | GDDM SAA | IBM SQL/400 | IBMLink System/370 | NetView System Application Architecture | OfficeVision/400 400 vi AS/400 System/38 Environment Programming About System/38 Environment Programming (SC41-3735) Coexistence means an AS/400 system and What the Book Contains another system can operate together either by interchanging media or by a communications This book discusses the implications inherent to line. Two forms of coexistence should be migration from a System/38 to the OS/400 considered: System/38 environment, conversion from the System/38 environment to the OS/400 program, – Communications and interchange with an and coexistence with the AS/400 system. AS/400 system Migration to the System/38 environment For example, you might need to send data from a System/38 to an AS/400 system or Once you have migrated to the System/38 vice versa. You might want to exchange environment, these items need to be media or be tied together through a com- addressed: munications line. If you replace a – Documentation of changes from System/38 with an AS/400 system, the System/38 systems you are communicating with might need to make some changes. The Changes exist between the AS/400 considerations for interchange are dis- system and System/38. Some of the cussed in Chapter 5. changes are due to hardware differences and some provide an easier to use and – Maintaining source code for System/38 more consistent system. An overview is For example, assume you have both a provided in Chapter 1 and further details System/38 and an AS/400 system and are described in Chapter 2. want to maintain applications for both. – Migration Aid The OS/400 program allows you to write and develop the System/38 applications The Migration Aid assists in the migration on the AS/400 system.