High Level Assembler for z/OS & z/VM & z/VSE 1.6 Programmer's Guide IBM SC26-4941-08 Note Before using this information and the product it supports, be sure to read the general information under “Notices” on page 441. 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 xxv. © Copyright International Business Machines Corporation 1992, 2021. US Government Users Restricted Rights – Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp. Contents Figures................................................................................................................. xi Tables................................................................................................................xvii About this document...........................................................................................xix Who should use this document.................................................................................................................xix Programming interface information..........................................................................................................xix Organization of this document.................................................................................................................. xix High Level Assembler documents.............................................................................................................xxi Publications..........................................................................................................................................xxi Related publications........................................................................................................................... xxii Syntax notation.........................................................................................................................................xxii Format................................................................................................................................................ xxiii How to send your comments to IBM.................................................................... xxv If you have a technical problem............................................................................................................... xxv Summary of changes........................................................................................ xxvii Chapter 1. Introduction......................................................................................... 1 Requirements...............................................................................................................................................1 System requirements............................................................................................................................. 1 Machine requirements............................................................................................................................1 Storage requirements.............................................................................................................................2 Compatibility................................................................................................................................................ 2 Assembler language support................................................................................................................. 2 Migration considerations........................................................................................................................3 Chapter 2. Using the assembler listing................................................................... 5 High Level Assembler option summary.......................................................................................................6 External Symbol Dictionary (ESD)............................................................................................................... 9 Source and object...................................................................................................................................... 13 Relocation dictionary (RLD)....................................................................................................................... 18 Ordinary symbol and literal cross-reference............................................................................................ 19 Unreferenced symbols defined in CSECTs................................................................................................ 21 Macro and copy code source summary.....................................................................................................22 Macro and copy code cross-reference...................................................................................................... 22 Effects of LIBMAC and PCONTROL(MCALL) options........................................................................... 23 DSECT cross-reference..............................................................................................................................25 USING map................................................................................................................................................ 26 General Purpose Register cross-reference...............................................................................................27 Diagnostic cross-reference and assembler summary.............................................................................. 28 Terminal output..........................................................................................................................................31 Chapter 3. Controlling your assembly with options............................................... 33 The sources of assembler options............................................................................................................ 33 Precedence of assembler options....................................................................................................... 33 Fixed installation default options........................................................................................................ 34 *PROCESS OVERRIDE Statement Options.......................................................................................... 34 iii ASMAOPT options................................................................................................................................ 34 Invocation options................................................................................................................................34 *PROCESS statement options..............................................................................................................35 Default options..................................................................................................................................... 35 Invoking the assembler dynamically................................................................................................... 35 Coding rules..........................................................................................................................................35 Assembler options..................................................................................................................................... 36 ADATA................................................................................................................................................... 37 ALIGN................................................................................................................................................... 37 ASA (z/OS and CMS)............................................................................................................................. 38 BATCH...................................................................................................................................................38 CODEPAGE............................................................................................................................................38 COMPAT................................................................................................................................................ 39 DBCS..................................................................................................................................................... 41 DECK..................................................................................................................................................... 41 DISK (CMS)........................................................................................................................................... 41 DXREF................................................................................................................................................... 42 ERASE (CMS)........................................................................................................................................ 42 ESD........................................................................................................................................................43