assembler programming complete reference

Download Assembler Programming Complete Reference

Post on 26-Mar-2015

467 views

Category:

Documents

1 download

Embed Size (px)

TRANSCRIPT

High Level Assembler for MVS & VM & VSE IBM Programmers GuideRelease 4 SC26-4941-03 High Level Assembler for MVS & VM & VSE IBMProgrammers GuideRelease 4 SC26-4941-03 Note! Before using this information and the product it supports, be sure to read the general information underNotices on page 379.Fourth Edition (September 2000)This edition applies to IBM High Level Assembler for MVS & VM & VSE, Release 4, Program Number 5696-234 and to anysubsequent releases until otherwise indicated in new editions. Make sure you are using the correct edition for the level of theproduct.Order publications through your IBM representative or the IBM branch office serving your locality. Publications are not stocked at theaddress 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, Department BWE/H3 P.O.Box 49023SAN JOSE, CA 95161-9023United States of AmericaWhen you send information to IBM, you grant IBM a nonexclusive right to use or distribute the information in any way it believesappropriate without incurring any obligation to you. Copyright International Business Machines Corporation 1982, 2000. All rights reserved.US Government Users Restricted Rights Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp. Contents ContentsAbout this Manual . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xiWho Should Use this Manual . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xiProgramming Interface Information . . . . . . . . . . . . . . . . . . . . . . . . . . . xiOrganization of this Manual . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xiIBM High Level Assembler for MVS & VM & VSE Publications . . . . . . . . . . xivHardcopy Publications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xivOnline Publications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xvRelated Publications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xvSyntax Notation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xvSummary of Changes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xviiiPart 1. Understanding and Using the Assembler . . . . . . . . . . . . . . . . . . . . . . . . 1Chapter 1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5System Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5Machine Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5Storage Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6Compatibility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6Assembler Language Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6Migration Considerations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7Chapter 2. Using the Assembler Listing . . . . . . . . . . . . . . . . . . . . . . 8High Level Assembler Option Summary . . . . . . . . . . . . . . . . . . . . . . . . 9External Symbol Dictionary (ESD) . . . . . . . . . . . . . . . . . . . . . . . . . . 12Source and Object . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15Relocation Dictionary (RLD) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22Ordinary Symbol and Literal Cross Reference . . . . . . . . . . . . . . . . . . . 22Unreferenced Symbols Defined in CSECTs . . . . . . . . . . . . . . . . . . . . . 24Macro and Copy Code Source Summary . . . . . . . . . . . . . . . . . . . . . . 25Macro and Copy Code Cross Reference . . . . . . . . . . . . . . . . . . . . . . . 25DSECT Cross Reference . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29USING Map . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30General Purpose Register Cross Reference . . . . . . . . . . . . . . . . . . . . . 31Diagnostic Cross Reference and Assembler Summary . . . . . . . . . . . . . . 32Chapter 3. Controlling Your Assembly with Options . . . . . . . . . . . . . 38The Sources of Assembler Options . . . . . . . . . . . . . . . . . . . . . . . . . . 38Precedence of Assembler Options . . . . . . . . . . . . . . . . . . . . . . . . 38Fixed Installation Default Options . . . . . . . . . . . . . . . . . . . . . . . . . 39| *PROCESS OVERRIDE Statement Options . . . . . . . . . . . . . . . . . . . 39| ASMAOPT Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39Invocation Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39*Process Statement Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40Default Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41Invoking the Assembler Dynamically . . . . . . . . . . . . . . . . . . . . . . . 41Coding Rules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41Assembler Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42 Copyright IBM Corp. 1982, 2000 iii Contents ADATA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42ALIGN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43ASA (MVS and CMS) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43BATCH . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44| CODEPAGE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44COMPAT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45DBCS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46DECK . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47DISK (CMS) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47DXREF . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47ERASE (CMS) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48ESD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48EXIT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49FLAG . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52FOLD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55GOFF (MVS and CMS) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55INFO . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56LANGUAGE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57LIBMAC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58LINECOUNT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58LIST . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59MXREF . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61OBJECT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62OPTABLE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62PCONTROL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64PESTOP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66PRINT (CMS) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66PROFILE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66RA2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67RENT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68RLD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68RXREF . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68SEG (CMS

Recommended

View more >