High Level Assembler for z/OS & z/VM & z/VSE 1.6 General Information IBM GC26-4943-06 Note Before using this information and the product it supports, be sure to read the general information under “Notices” on page 75. 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 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 xv. 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 1992, 2021. US Government Users Restricted Rights – Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp. Contents Figures................................................................................................................ vii Tables.................................................................................................................. ix About this manual................................................................................................ xi Who should use this manual....................................................................................................................... xi Organization of this manual........................................................................................................................ xi High Level Assembler documents..............................................................................................................xii Publications...........................................................................................................................................xii Related publications............................................................................................................................ xiii How to send your comments to IBM......................................................................xv If you have a technical problem.................................................................................................................xv Chapter 1. What's new in High Level Assembler release 6....................................... 1 Chapter 2. Introduction to High Level Assembler.................................................... 3 Language compatibility................................................................................................................................3 Highlights of High Level Assembler............................................................................................................. 3 The Toolkit Feature...................................................................................................................................... 4 Planning for High Level Assembler..............................................................................................................4 Chapter 3. Assembler language extensions............................................................ 5 Additional assembler instructions...............................................................................................................5 Revised assembler instructions...................................................................................................................5 2-Byte relocatable address constants........................................................................................................ 7 Character set support extensions............................................................................................................... 7 Standard character set...........................................................................................................................7 Double-byte character set..................................................................................................................... 8 Translation table.....................................................................................................................................8 Unicode support..................................................................................................................................... 8 Assembler language syntax extensions...................................................................................................... 8 Blank lines.............................................................................................................................................. 8 Comment statements.............................................................................................................................8 Mixed-case input.................................................................................................................................... 9 Continuation lines...................................................................................................................................9 Continuation lines and double-byte data.............................................................................................. 9 Continuation error warning messages................................................................................................... 9 Symbol length.........................................................................................................................................9 Underscore........................................................................................................................................... 10 Literals.................................................................................................................................................. 10 Levels within expressions..........................................................................................................................10 Generalized object format modules (z/OS and CMS)............................................................................... 10 Extended addressing support................................................................................................................... 10 Addressing mode (AMODE) and residence mode (RMODE)............................................................... 10 Channel Command Words (CCW0 and CCW1).................................................................................... 11 Programming sectioning and linking controls...........................................................................................11 Read-only control sections.................................................................................................................. 12 Association of code and data areas..................................................................................................... 12 iii Multiple location counters................................................................................................................... 12 External dummy sections.....................................................................................................................12 Number of external symbols................................................................................................................12 Addressing extensions...............................................................................................................................13 Labeled USINGs and qualified symbols.............................................................................................. 13 Dependent USINGs.............................................................................................................................. 14 Specifying assembler options in external file or library member.............................................................14 Specifying assembler options in the source program......................................................................... 14 IBM-supplied default assembler options................................................................................................. 15 Chapter 4. Macro and conditional assembly language extensions......................... 17 The macro language...................................................................................................................................17 General advantages in using macros...................................................................................................17 Assembler editing of the macro definition.......................................................................................... 18 Macro language extensions....................................................................................................................... 18 Redefining macros................................................................................................................................18 Inner macro definitions........................................................................................................................18 Generated macro instruction operation codes....................................................................................19 Multilevel sublists in macro instruction operands...............................................................................19 Macro instruction name entries..........................................................................................................