HLASM V1R6 Installation and Customization Guide Chapter 12
Total Page:16
File Type:pdf, Size:1020Kb
High Level Assembler for z/OS & z/VM & z/VSE IBM Installation and Customization Guide Version 1 Release 6 SC26-3494-07 High Level Assembler for z/OS & z/VM & z/VSE IBM Installation and Customization Guide Version 1 Release 6 SC26-3494-07 Note Before using this information and the product it supports, be sure to read the general information under “Notices” on page 213. This edition applies to IBM High Level Assembler for z/OS & z/VM & z/VSE, Release 6, Program Number 5696-234 and to any subsequent releases until otherwise indicated in new editions. Make sure that 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. IBM welcomes your comments. For information on how to send comments, see “How to send your comments to IBM” on page xiv. © Copyright IBM Corporation 1992, 2017. US Government Users Restricted Rights – Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp. Contents Figures .............. vii Planning to customize cataloged procedures ... 15 Why do it .............. 15 Tables ............... ix Choices to make now .......... 15 Example .............. 16 Planning to install in the link pack area ..... 16 About this document ......... xi Why do it .............. 16 Brief overview of High Level Assembler ..... xi Choices to make now .......... 16 Who should use this document ........ xi Experienced users installing on z/OS ..... xi Chapter 3. Installing High Level Experienced users installing on z/VM .... xii Experienced users installing on z/VSE .... xii Assembler on z/OS ......... 19 Experienced users installing on zLinux .... xii Overview of installation .......... 19 Terminology in this information ....... xii Modifying High Level Assembler jobs .... 19 List of APARs and PTFs in this book ...... xii If using a CBPDO ........... 19 Other documentation you might need ..... xii Installation checklist .......... 19 Syntax notation ............. xii Step 1: SMP/E considerations for installing High How to send your comments to IBM ..... xiv Level Assembler ............. 22 If you have a technical problem ...... xv SMP/E environment .......... 22 Summary of changes ........... xv SMP/E options subentry values ...... 22 Step 2: Copy the sample JCL from the product tape 23 Chapter 1. Planning for installing High Step 3: Set up ISPF editor macro (optional) .... 23 Step 4: Allocate and initialize the SMP/E data sets Level Assembler on z/OS ....... 1 (optional) ............... 24 What you receive with High Level Assembler ... 1 Step 5: Perform SMP/E receive ........ 24 Distribution media ........... 1 Method 1: Receive using SMP/E dialogs ... 24 Basic material ............. 1 Method 2: Receive using a batch job ..... 25 Optional material ............ 2 Step 6: Allocate target and distribution libraries .. 25 Program publications and softcopy ...... 2 Step 7: Create DDDEF entries ........ 25 What you need to install High Level Assembler .. 2 Step 8: Perform SMP/E apply ........ 25 Required and optional software for the target Method 1: Apply using SMP/E dialogs .... 26 system ............... 3 Method 2: Apply using a batch job ..... 26 DASD storage required for the target system .. 3 Step 9: Run the installation verification program .. 26 FMIDs deleted.............. 5 Step 10: Perform SMP/E accept........ 26 Installing with CBPDO ........... 6 Method 1: Accept using SMP/E dialogs .... 27 Planning to use SMP/E........... 6 Method 2: Accept using a batch job ..... 27 Planning to change installation jobs....... 6 Publications useful during installation ...... 6 Chapter 4. Customizing High Level Program support ............. 6 Program services ............ 7 Assembler on z/OS ......... 29 Preventive Service Planning ........ 7 SMP/E considerations ........... 29 Statement of support procedures....... 7 Customization checklist .......... 30 Program and service level information...... 7 Customization steps ........... 30 Program level information ......... 7 Step 1: Change SMP/E to use High Level Service level information ......... 7 Assembler .............. 30 Cumulative service tape ......... 8 Step 2: Customize user exits ........ 31 Step 3: Change default options and DDNAMES 32 Chapter 2. Planning for customizing Step 4: Customize the High Level Assembler procedures ............. 33 High Level Assembler on z/OS ..... 9 Step 5: Place High Level Assembler into link Deciding whether and what to customize..... 9 pack area .............. 36 SMP/E and High Level Assembler ....... 9 Step 6: Assembler H migration (optional) ... 36 Selecting multicultural support ........ 9 Planning to customize High Level Assembler Chapter 5. Maintaining High Level options ................ 10 Why do it .............. 10 Assembler on z/OS ......... 39 Choices to make now .......... 10 Re-installing High Level Assembler ...... 39 Planning to customize the user exits ...... 14 Applying service updates.......... 39 © Copyright IBM Corp. 1992, 2017 iii What you receive ........... 39 Step 5: Define and build High Level Assembler Checklist for applying service ....... 39 saved segment (optional) .......... 63 Step 1. Prepare to install service ...... 40 Step 6: Put High Level Assembler into production 69 Step 2. Receive the service ........ 40 Putting High Level Assembler onto the Y disk.. 69 Step 3. Accept applied service (optional).... 40 Putting High Level Assembler onto a disk other Step 4. Apply the service ......... 40 than the Y disk ............ 71 Step 5. Test the service.......... 40 Step 6. Accept the service......... 41 Chapter 9. Customizing High Level Removing High Level Assembler ....... 41 Assembler on z/VM ......... 73 Reporting a problem with High Level Assembler .. 41 Changing option and DDNAMES defaults .... 73 Obtaining service information ........ 42 General rules for coding the ASMADOPT ASSEMBLE file ............. 73 Chapter 6. Planning for installing High Example of Modifying Option and DDNAME Level Assembler on z/VM....... 43 Values ............... 73 Worksheet: Planning for installing High Level Changing the saved segment name ...... 74 Assembler on z/VM ........... 43 Customizing the user exits ......... 74 What you receive with High Level Assembler ... 43 Distribution media ........... 44 Chapter 10. Maintaining High Level Basic material ............ 44 Assembler on z/VM ......... 77 Optional material ........... 44 Re-installing High Level Assembler ...... 77 Cumulative service tape ......... 44 Applying service updates.......... 77 Program publications and softcopy ..... 44 What you receive ........... 77 What you need to install High Level Assembler .. 45 Checklist for applying service ....... 77 Operating system requirements....... 45 Step 1. Prepare to install service ...... 79 Other program product requirements..... 45 Step 2. Clear the alternate APPLY disk .... 80 VMSES/E considerations ......... 45 Step 3. Receive the new service ....... 81 DASD storage required ......... 46 Step 4. Apply the new service ....... 81 Planning to install in a saved segment ..... 47 Step 5. Reapply local service........ 82 Program support ............ 47 Step 6. Update build status table ...... 82 Program services ........... 47 Step 7. Rebuild serviced parts (objects) .... 84 Preventive Service Planning ........ 47 Step 8. Verify the service ......... 85 Statement of support procedures ...... 47 Step 9. Place the service into production.... 85 Program and service level information ..... 48 Removing High Level Assembler ....... 89 Program level information ........ 48 Reporting a problem with High Level Assembler .. 89 Service level information ......... 48 Obtaining service information ........ 90 Publications useful during installation ..... 48 Chapter 11. Planning for installing High Chapter 7. Planning for customizing Level Assembler on z/VSE ...... 91 High Level Assembler on z/VM .... 49 Worksheet: Planning for installing High Level Deciding whether and what to customize .... 49 Assembler on z/VSE ........... 91 Selecting multicultural support ........ 49 What you receive with High Level Assembler ... 92 Planning to customize High Level Assembler Distribution media ........... 92 options and DDNAMES .......... 50 Basic material ............ 92 Why do it .............. 50 Optional material ........... 92 Choices to make now .......... 50 Cumulative service tape ......... 92 Planning to customize the user exits ...... 53 Program publications and softcopy ..... 92 Program source materials......... 93 Chapter 8. Installing High Level What you need to install High Level Assembler .. 93 Assembler on z/VM ......... 55 Required and optional software ...... 93 Overview of installation .......... 55 DASD and other storage required ...... 93 Checklist for installing High Level Assembler .. 55 Planning where to install High Level Assembler .. 94 Step 1: Prepare to install High Level Assembler .. 56 Program support ............ 94 Step 2: Allocate resources for installing High Level Program services ........... 94 Assembler ............... 58 Preventive Service Planning ........ 94 Common instructions for allocating storage Statement of support procedures ...... 94 resources .............. 58 Program and service level information ..... 95 If installing on a minidisk ........ 59 Program level information ........ 95 If installing on a shared file system ..... 59 Service level information ......... 95 Step 3: Install High Level Assembler ...... 60 Publications useful during installation ..... 95 Step 4: Verify