IBM APL2 Installation and Customization under CMS Version 2 Release 2 SH21-1062-01 IBM APL2 Installation and Customization under CMS Version 2 Release 2 SH21-1062-01 Note! Before using this information and the product it supports, be sure to read the general information under “Notices” on page vi. Second Edition (March 1994) This edition replaces and makes obsolete the previous edition, SH21-1062-0. The technical changes for this edition are summarized under “Summary of Changes,” and are indicated by a vertical bar to the left of a change. This edition applies to Version 2 Release 2 of APL2, 5688-228, Release 2 of APL2 Version 2 Application Environment, Program Number 5688-229, and to any subsequent releases until otherwise indicated in new editions or technical newsletters. Make sure you are using the correct edition for the level of the product. Order publications through your IBM representative or the IBM branch office serving your locality. Publications are not stocked at the address below. A form for reader's comments is provided at the back of this publication. If the form has been removed, address your comments to: IBM Corporation, Department J58 P.O. Box 49023 San Jose, CA, 95161-9023 United States of America 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 1984, 1994. All rights reserved. US Government Users Restricted Rights – Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp. Contents | Notices . vi | Programming Interface Information ........................... vi | Trademarks . vii | About This Book .................................... viii | Who Should Read This Book ............................. viii | APL2 Publications . viii | Conventions Used in This Library ............................ ix | Summary of Changes .................................. x | Product . x Chapter 1. Overview of APL2 and the Installation Process .......... 1 APL2 . 1 How APL2 Is Packaged in CMS ............................. 1 The Installation Process ................................. 2 Chapter 2. Planning the Installation of APL2 ................... 3 Preplanning Activity . 3 System Requirements . 3 Software . 3 Hardware . 4 Defining the Installation User ID and Minidisk ..................... 4 Determining Where the APL2 Modules and System Files Are to Reside ..... 5 Determining Where the APL2 Libraries Are to Reside ................ 5 Planning for Printer Support ............................... 6 Planning for Installation of the Global SVP ...................... 6 Planning for Installation of the APL2 Port Server ................... 7 Planning for APL2 Saved Segments .......................... 8 Defining the APL2 Shared Code Saved Segment ................. 8 Defining the APL2 Global Shared Storage Saved Segment .......... 10 Modifying System Options in AP2VIOPT or AP2VIOPE .............. 10 Modifying APL2PI Command Options in AP2XAPIC ................ 10 Determining APL2 Storage Requirements ...................... 11 Planning for Migration from VS APL ......................... 11 Planning for Migration from Previous APL2 Releases ............... 12 Determining Post-Installation Customizing Requirements ............. 13 Planning for Data Security ............................... 13 | Planning for GDDM ................................... 13 Chapter 3. Installing APL2 . 14 Installation Summary . 14 Installation Steps . 14 Step 1–Define Saved Segments and IMAGELIBs (Optional) .......... 14 Step 2–Define the Product User IDs (Optional) ................. 15 Step 3–Load Installation EXEC and MEMO (Required) ............. 15 Step 4–Perform Default or Customized Installation (Required) ........ 16 Step 5–Review APL2 Installation (Required) ................... 21 Step 6–Copy Files to Production Disks (Optional) ................ 21 Copyright IBM Corp. 1984, 1994 iii Chapter 4. APL2 Invocation and Termination .................. 25 Starting APL2—The APL2 Command ........................ 25 Continuing with the Invocation Options ........................ 26 Description of Invocation Options ......................... 28 Session Termination . 44 Chapter 5. Customizing APL2 . 46 Customizing IBM-Supplied Sample Files ....................... 46 Customizing Your APL2 Installation Process .................... 46 NAMES Files and the AP2M EXECs ....................... 46 Outline of Customizing Installation Steps ..................... 49 Installing to a Different Disk and/or Retrieving Optional Material ....... 49 Removing GDDM . 51 Removing SQL/DS . 51 Adding 3800 Font Support ............................. 51 | Testing APL2 Without Saving Segments ..................... 52 | Customizing Saved Segment Information for APL2 ............... 52 | Adding Saved Segment Information for GDDM and SQL/DS ......... 52 Including a Modified APLSCOPT TEXT Deck .................. 53 Making User-Written Auxiliary Processors Part of the System ......... 53 Making User-Written External Routines Part of the System .......... 55 Installing Namespaces and Non-APL Routines in VM Saved Segments ... 56 Customizing the Execution of APL2 ......................... 61 Customizing the APL2 Session Manager Profile ................. 61 Changing the APL2 System and Invocation Options .............. 62 Changing the APL2PI Command Options .................... 63 Using Nondefault Saved Segment Names for APL2 .............. 63 Modifying the AP2EXIT EXEC ........................... 64 Defining APL2 Libraries ............................... 64 Installation Exit for the Global SVP ........................ 67 Preparing for Access of SQL/DS by APL2 .................... 68 Extending or Adding National Language Message and Command Files ... 70 Extending or Adding National Language Help Files ............... 71 Providing a Local Greeting Message ......................... 72 Chapter 6. Administering the APL2 Environment ............... 74 Running the Global SVP Service Machine ...................... 74 Running the Port Server ................................ 75 Documenting Problems . 78 Maintaining APL2 . 78 Preventive Service with PUT ............................ 78 Corrective Service . 79 Appendix A. Sample User IDs and Disk Tables ................. 81 Sample Installation User ID ............................. 81 Sample APL2 User User ID ............................. 81 Sample Global SVP User ID ............................ 81 Sample Port Server User ID ............................ 82 Disk Tables for Selected CMS Devices ...................... 82 Appendix B. Sample Files . 83 AP2EXIT EXEC Sample — AP2EXIT AP2MSAMP ................. 83 AP2LOCAL NAMES Sample — AP2LOCAL AP2MSAMP ............. 85 AP2MPSRV EXEC Sample — AP2MPSRV AP2MSAMP ............. 91 iv APL2 Installation and Customization under CMS Sample Exit for Global SVP — AP2SVPEX AP2MSAMP ............. 92 TCP/IP Profile File — AP2TCPIP APL2PROF .................... 101 AP2VIOPE ASSEMBLE Sample — AP2VIOPE AP2MSAMP ........... 104 AP2VIOPT ASSEMBLE Sample — AP2VIOPT AP2MSAMP ........... 107 AP2XAPIC Module Sample — AP2XAPIC AP2MSAMP .............. 110 DEFAULT VSAPLPR Sample — DEFAULT AP2MSAMP ............. 113 LIBTAB APL2 Sample — LIBTAB AP2MSAMP ................... 114 NAMESYS Macro Sample — NAMESYS AP2MSAMP ............... 116 NAME3800 Macro Sample — NAME3800 AP2MSAMP .............. 118 RDEVICE Macro Sample — RDEVICE AP2MSAMP ................ 119 Appendix C. Sample Installation . 120 Sample APL2 Installation ................................ 120 Sample Application Environment Installation .................... 125 Appendix D. APL2 System Options ........................ 129 System Options . 129 Invocation Options . 131 Appendix E. APL2 Files and Data Sets ...................... 133 Files . 133 CMS FILEDEF (DD) Names .............................. 134 Appendix F. AP2M220 NAMES File ........................ 135 Appendix G. SCRIPT/VS Support . 168 Box Character Set .................................. 168 Line Printer Font Information ............................ 168 Bibliography . 169 | APL2 Publications . 169 | Other Books You Might Need ............................. 169 Index . 171 Contents v | 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 IBM’s product, program, or service may be used. Any functionally | equivalent product, program, or service that does not infringe any of IBM’s intellec- | tual property rights may be used instead of the IBM product, program, or service. | Evaluation and verification of operation in conjunction with other products, except | those expressly designated by IBM, are the user’s responsibility. | IBM may have patents or pending patent applications covering subject material in | this document. The furnishing of this document does not give you any license to | these patents. You can send license inquiries, in writing, to the IBM Corporation, | IBM Director of Licensing, 208 Harbor Drive, Stamford, Connecticut, United States | 06904. | Programming Interface Information | This installation guide is intended to help you install APL2 Version 2 on CMS. | This book also documents Product-sensitive Programming Interface and Associated | Guidance Information provided by APL2. | Product-sensitive