High Level Assembler for z/OS & z/VM & z/VSE IBM Toolkit Feature User's Guide Version 1 Release 6 GC26-8710-12 High Level Assembler for z/OS & z/VM & z/VSE IBM Toolkit Feature User's Guide Version 1 Release 6 GC26-8710-12 Note Before using this information and the product it supports, be sure to read the general information under “Notices” on page 331. This edition applies to IBM High Level Assembler for z/OS & z/VM & z/VSE Toolkit Feature, 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 xv. © 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 The CASE macro set ........... 32 The SELECT macro set .......... 35 Tables ............... ix Chapter 3. Using the disassembler... 39 About this document ......... xi Invoking the disassembler ......... 40 Invoking the disassembler on z/OS ..... 40 Who should use this document ........ xi Invoking the disassembler on CMS ..... 42 Syntax notation ............. xi Invoking the disassembler on z/VSE ..... 44 Control statements ............ 45 How to send your comments to IBM .. xv Module-CSECT statement (required) ..... 46 If you have a technical problem ....... xv DATA-only statement (optional) ...... 47 INSTR-only statement (optional) ...... 47 Summary of changes ........ xvii DS-area statement (optional)........ 47 DSECT definitions (optional) ....... 48 Chapter 1. Introducing the Toolkit ULABL statements ........... 48 Feature ............... 1 USING statements ........... 48 COPY statement (optional) ........ 49 Toolkit Feature components ......... 2 Comment statement (optional) ....... 49 Toolkit Feature structured programming macros . 2 Disassembling a module for the first time .... 49 Toolkit Feature Disassembler ........ 2 Output description ............ 50 Toolkit Feature Program Understanding Tool .. 3 SYSPUNCH (SYSPCH for z/VSE) content ... 50 Toolkit Feature Cross-Reference Facility .... 4 SYSPRINT (SYSLST for z/VSE) content .... 51 Toolkit Feature Interactive Debug Facility.... 5 Disassembler CMS messages ........ 52 Enhanced SuperC............ 6 Disassembler messages .......... 54 Potential uses for the Toolkit Feature ...... 6 Recovery and reconstruction ........ 7 Analysis and understanding ........ 8 Chapter 4. Using the Program Modification and testing ......... 8 Understanding Tool ......... 59 Summary .............. 9 Introducing ASMPUT ........... 59 More about nodes ........... 60 Chapter 2. Using structured Getting started ............ 61 programming macros ........ 11 Working with ADATA files ......... 64 Opening an ADATA file ......... 64 Accessing the macros ........... 12 Opening and closing the control flow graph The ASMMREL macro ........... 13 window .............. 65 The IF macro set............. 13 Viewing source code .......... 65 IF macro option A ........... 14 Viewing ADATA file information ...... 70 IF macro option B ........... 15 Viewing Job Id information ........ 72 IF macro option C ........... 16 Viewing HLASM files information...... 72 IF macro option D ........... 17 Viewing options information ....... 72 IF macros with Boolean operators ...... 17 Viewing statistics information ....... 73 The ELSEIF macro ........... 19 Viewing libraries information ....... 73 The DO macro set ............ 20 Removing (closing) a file ......... 73 The DO indexing group ......... 21 Working with the control flow graph ...... 73 DO loop terminator generation ....... 22 Expanding and collapsing layers ...... 74 Simple DO ............. 22 Adding and removing context ....... 80 Infinite loop ............. 22 Refreshing and redoing ......... 81 Branching to the ENDDO......... 23 Hiding and showing return arcs ...... 82 Leaving a nested DO .......... 24 Marking and unmarking nodes ....... 83 Explicit specification .......... 25 Opening and closing the Overview window .. 84 Counting .............. 25 Zooming .............. 85 Backward indexing ........... 26 Scrolling .............. 88 Forward indexing ........... 27 The interaction between source code and the Register initialization .......... 27 control flow graph ........... 89 The UNTIL and WHILE keywords ..... 28 ASMPUT windows and window areas ..... 91 Looping with DOEXIT and EXITIF ..... 29 Main window ............ 91 The SEARCH macro set .......... 30 © Copyright IBM Corp. 1992, 2017 iii Control Flow Graph window ....... 99 Invoking the comparison on CMS using Control Flow Graph window menu options and command line input .......... 198 toolbar icons ............ 101 Invoking the comparison on z/VSE ..... 205 Overview window .......... 106 Invoking the SuperC search ........ 211 Restrictions .............. 106 Invoking the search on z/OS ....... 212 Using online help ............ 107 Invoking the search on CMS using menu input 213 Using topic help ........... 107 Invoking the search on CMS using command Using what's this help ......... 108 line input.............. 220 ASMPUT messages ........... 108 Invoking the search on z/VSE....... 227 Process options ............. 231 Chapter 5. Using the Cross-Reference Process statements............ 243 Facility .............. 115 Change listing value .......... 245 Change text ............. 245 Invoking the Cross-Reference Facility ..... 116 Comment lines ............ 247 Invoking ASMXREF on z/OS ....... 117 Compare byte offsets .......... 247 Invoking ASMXREF on CMS ....... 125 Compare (search) columns ........ 248 Invoking ASMXREF on z/VSE ...... 131 Compare lines ............ 249 ASMXREF Control Statements........ 136 Compare sections ........... 251 *................. 136 DD-MVS alternate DD names ....... 252 Library .............. 136 DD-VSE DLBL/TLBL definitions ...... 253 Include .............. 137 Define column headings......... 256 Exclude .............. 138 Do not process lines .......... 258 Parm ............... 138 Exclude data ............ 259 Report............... 139 Focus on data ............ 260 ASMXREF Token Statement ........ 139 Line count ............. 261 Token ............... 140 List columns ............ 261 Scanning rules for ASMXREF ....... 142 List previous-search-following value..... 262 ASMXREF Options ........... 143 Revision code reference ......... 262 ASMXREF XRFLANG Statements ...... 143 Search strings in the input file....... 263 Default token segment ......... 144 Select files from a list of files (CMS) ..... 264 Language segment .......... 145 Select members or files (CMS) ....... 265 ASMXREP Options ........... 145 Select members (z/VSE) ......... 266 Understanding the reports ......... 146 Select PDS members (z/OS) ....... 268 Languages supported by reports ...... 146 Statements file listing control ....... 269 Control flow (CF) report......... 147 Title alternative listing ......... 269 Lines Of Code (LOC) report ....... 150 Work size ............. 270 The LOOC report ........... 155 Year aging ............. 270 Macro Where Used (MWU) report ..... 157 Date definitions ........... 271 Spreadsheet Oriented Report (SOR) ..... 158 Global date ............. 274 Symbol Where Used (SWU) report ..... 160 CMS command line option directives ..... 274 Token Where Used (TWU) report...... 163 CMS command line statement option directives 275 Tagged Source Program (TSP) ....... 164 Understanding the listings ......... 277 ASMXREF Messages ........... 168 General listing format ......... 277 Message list ............. 169 How to view the listing output ...... 277 ASMXREF User Abends .......... 179 The comparison listing ......... 278 The search listing ........... 290 Chapter 6. Using Enhanced SuperC 181 Update files .............. 298 The SuperC comparison .......... 181 Revision file ............. 299 The SuperC search ........... 182 Revision file (2)............ 300 SuperC features for date comparisons ..... 183 Update CMS sequenced 8 file ....... 301 General applications ........... 183 Update control files .......... 302 How SuperC and search-for filter input file lines 184 Update long control .......... 305 How SuperC corrects false matches ...... 185 Update MVS sequenced 8 file ....... 306 How SuperC partitions and processes large files 186 Update prefixed delta lines ........ 307 Comparing load modules ......... 186 Update sequenced 0 file ......... 307 Comparing CSECTs ........... 187 Update summary only files........ 308 Invoking the SuperC comparison ....... 187 CMS file selection list........... 311 Invoking the comparison on z/OS ..... 187 Getting to the selection list menus ..... 312 Invoking the comparison on CMS using menu How SuperC pairs CMS files and members ... 317 input ............... 190 Pairing Files ............. 317 Pairing members ........... 318 iv HLASM V1R6 Toolkit Feature User's Guide CMS files used by SuperC ......... 318 Bibliography............ 333 Reasons for differing comparison results .... 319 Return codes ............. 320 Glossary ............. 335 SuperC messages ............ 321 Index ............... 343 Notices .............. 331 Trademarks .............. 332 Contents v vi HLASM V1R6 Toolkit Feature User's Guide Figures 1. Typical phases for Toolkit Feature usage ... 6 46. Sample LOC per Class section