IBM High Level Assembler for MVS & VM & VSE Programmer’s Guide Release 5 SC26-4941-04 IBM High Level Assembler for MVS & VM & VSE Programmer’s Guide Release 5 SC26-4941-04 Note! Before using this information and the product it supports, be sure to read the general information under “Notices” on page 422. Fifth Edition (June 2004) This edition applies to IBM High Level Assembler for MVS & VM & VSE, Release 5, Program Number 5696-234 and to any subsequent releases until otherwise indicated in new editions. 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 J87/D325 555 Bailey Avenue SAN JOSE, CA 95141-1003 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 1982, 2004. All rights reserved. US Government Users Restricted Rights – Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp. Contents Contents About this Manual .................................... xi Who Should Use this Manual .............................. xi Programming Interface Information ........................... xi Organization of this Manual ............................... xi IBM High Level Assembler for MVS & VM & VSE Publications .......... xiv Publications . xiv Softcopy Publications . xv The High Level Assembler web site ......................... xv | Using LookAt to look up Message Explanations .................. xv Related Publications . xvi Syntax Notation . xvi Summary of Changes ................................. xix Part 1. Understanding and Using the Assembler ........................1 Chapter 1. Introduction . 5 Requirements . 5 System Requirements . 5 Machine Requirements . 5 Storage Requirements . 6 Compatibility . 7 Assembler Language Support ............................ 7 Migration Considerations . 7 Chapter 2. Using the Assembler Listing ...................... 8 High Level Assembler Option Summary ........................ 9 External Symbol Dictionary (ESD) .......................... 13 Source and Object ................................... 16 Relocation Dictionary (RLD) .............................. 23 Ordinary Symbol and Literal Cross Reference ................... 24 Unreferenced Symbols Defined in CSECTs ..................... 27 Macro and Copy Code Source Summary ...................... 27 Macro and Copy Code Cross Reference ....................... 28 DSECT Cross Reference ................................ 32 USING Map . 33 General Purpose Register Cross Reference ..................... 34 Diagnostic Cross Reference and Assembler Summary .............. 35 Chapter 3. Controlling Your Assembly with Options ............. 41 The Sources of Assembler Options .......................... 41 Precedence of Assembler Options ........................ 41 Fixed Installation Default Options ......................... 42 *PROCESS OVERRIDE Statement Options ................... 42 ASMAOPT Options . 42 Invocation Options . 42 *Process Statement Options ............................ 43 Default Options . 44 Invoking the Assembler Dynamically ....................... 44 Copyright IBM Corp. 1982, 2004 iii Contents Coding Rules . 44 Assembler Options . 45 ADATA . 45 ALIGN . 46 ASA (MVS and CMS) ................................ 46 BATCH . 47 CODEPAGE . 47 COMPAT . 48 DBCS . 49 DECK . 50 DISK (CMS) . 50 DXREF . 50 ERASE (CMS) . 51 ESD . 51 EXIT . 52 FLAG . 55 FOLD . 58 GOFF (MVS and CMS) ............................... 58 INFO . 60 LANGUAGE . 60 LIBMAC . 61 LINECOUNT . 62 LIST . 62 | MACHINE . 63 MXREF . 65 OBJECT . 66 OPTABLE . 66 PCONTROL . 68 PESTOP . 70 PRINT (CMS) . 70 PROFILE . 70 RA2 . 71 RENT . 72 RLD . 72 RXREF . 73 | SECTALGN . 73 SEG (CMS) . 73 SIZE . 74 | SUPRWARN . 76 SYSPARM . 76 TERM . 77 TEST . 78 THREAD . 78 TRANSLATE . 79 | TYPECHECK . 79 USING . 80 XOBJECT (MVS and CMS) ............................. 83 XREF . 83 Chapter 4. Providing User Exits .......................... 85 Exit Types . 85 Specifying User Exits .................................. 86 Loading User Exits ................................... 87 Calling User Exits .................................... 88 iv HLASM V1R5 Programmer’s Guide Contents Exit Parameter List ................................... 88 Request Info Pointer ................................. 90 Buffer Pointer . 97 Error Buffer Pointer ................................. 97 Exit-Specific Information Pointer .......................... 97 DCB Pointer . 97 Static Assembler Information Pointer ......................... 98 HLASM VRM . 98 PTF Level . 98 System ID . 98 | Numeric Version . 98 Error Handling . 99 Exit-Specific Information Block ............................ 99 Member Name . 101 Member Type . 101 Data Set Name .................................... 101 Volume Serial . 101 Relative Record Number .............................. 102 Absolute Record Number .............................. 103 Linecount . 103 Current Page Number ................................ 103 SOURCE Exit Processing ............................... 104 OPEN . 104 CLOSE . 104 READ . 104 PROCESS . ..