Contents

Figures
About this manual
Who should use this manual
Programming interface information
Organization of this manual
IBM High Level Assembler for z/OS & z/VM & z/VSE Publications
Hardcopy Publications
Online publications
Related publications
Syntax notation
Double-byte character set notation
Summary of changes
Introduction
Language compatibility
Assembler language
Machine instructions
Assembler instructions
Macro instructions
Assembler program
Basic functions
Associated data
Controlling the assembly
Processing sequence
Relationship of assembler to operating system
Coding made easier
Symbolic representation of program elements
Variety in data representation
Controlling address assignment
Relocatability
Sectioning a program
Linkage between source modules
Program listings
Multiple source modules
Coding and structure
Character set
Standard character set
Double-byte character set
Translation table
Assembler language coding conventions
Field boundaries
Continuation lines
Blank lines
Comment statement format
Instruction statement format
Assembler language structure
Overview of assembler language structure
Machine instructions
Assembler instructions
Conditional assembly instructions
Macro instructions
Mnemonic tags
Terms, literals, and expressions
Terms
Literals
Expressions
Program structures and addressing
Object program structures
Source program structures
Source module
Sections, elements, and parts
Sections
Reference control sections
Classes (z/OS and CMS)
Parts (z/OS and CMS)
Location counter setting
Addressing
Addressing within source modules: establishing addressability
Base register instructions
Qualified addressing
Dependent addressing
Relative addressing
Literal pools
Establishing residence and addressing mode
Symbolic linkages
External symbol dictionary entries
Summary of source and object program structures
Machine instruction statements
General instructions
Decimal instructions
Floating-point instructions
Control instructions
Input/output operations
Branching with extended mnemonic codes
Alternative mnemonics for some branch relative instructions
Statement formats
Symbolic operation codes
Operand entries
Registers
Addresses
Lengths
Immediate data
Examples of coded machine instructions
RI format
RR format
RS format
RSI format
RX format
SI format
SS format
Assembler instruction statements
64-bit Addressing Mode
*PROCESS statement
ACONTROL instruction
ADATA instruction
AINSERT instruction
ALIAS instruction
AMODE instruction
CATTR instruction (z/OS and CMS)
CCW and CCW0 instructions
CCW1 instruction
CEJECT instruction
CNOP instruction
COM instruction
COPY instruction
CSECT instruction
CXD instruction
DC instruction
Rules for DC operands
General information about constants
Padding and truncation of values
Subfield 1: Duplication Factor
Subfield 2: Type
Subfield 3: Type Extension
Subfield 4: Program type
Subfield 5: Modifier
Subfield 6: Nominal Value
DROP instruction
Labeled USING
Dependent USING
DS instruction
Bytes skipped for alignment
How to use the DS instruction
DSECT instruction
DXD instruction
EJECT instruction
END instruction
ENTRY instruction
EQU instruction
Using conditional assembly values
EXITCTL instruction
EXTRN instruction
ICTL instruction
ISEQ instruction
LOCTR instruction
LTORG instruction
Literal pool
Addressing considerations
Duplicate literals
MNOTE instruction
Remarks
OPSYN instruction
Redefining conditional assembly instructions
ORG instruction
POP instruction
PRINT instruction
Process statement
PUNCH instruction
PUSH instruction
REPRO instruction
RMODE instruction
RSECT instruction
SPACE instruction
START instruction
TITLE instruction
Deck ID in object records
Printing the heading
Printing the TITLE statement
Sample program using the TITLE instruction
Page ejects
Valid characters
USING instruction
Base address
How to use the USING instruction
Base registers for absolute addresses
Ordinary USING instruction
Labeled USING instruction
Dependent USING instruction
WXTRN instruction
XATTR instruction (z/OS and CMS)
Association of code and data areas (z/OS and CMS)
Introduction to macro language
Using macros
Macro definition
Model statements
Processing statements
Comment statements
Macro instruction
Source and library macro definitions
Macro library
System macro instructions
Conditional assembly language
How to specify macro definitions
Where to define a macro in a source module
Format of a macro definition
Macro definition header and trailer
MACRO statement
MEND statement
Macro instruction prototype
Alternative formats for the prototype statement
Body of a macro definition
Model statements
Variable symbols as points of substitution
Listing of generated fields
Rules for concatenation
Rules for model statement fields
Symbolic parameters
Positional parameters
Keyword parameters
Combining positional and keyword parameters
Subscripted symbolic parameters
Processing statements
Conditional assembly instructions
Inner macro instructions
Other conditional assembly instructions
AEJECT instruction
AINSERT instruction
AREAD instruction
ASPACE instruction
COPY instruction
MEXIT instruction
Comment statements
Ordinary comment statements
Internal macro comment statements
System variable symbols
Scope and variability of system variable symbols
&SYSADATA_DSN System Variable Symbol
&SYSADATA_MEMBER System Variable Symbol
&SYSADATA_VOLUME System Variable Symbol
&SYSASM System Variable Symbol
&SYSCLOCK System Variable Symbol
&SYSDATC System Variable Symbol
&SYSDATE System Variable Symbol
&SYSECT System Variable Symbol
&SYSIN_DSN System Variable Symbol
&SYSIN_MEMBER System Variable Symbol
&SYSIN_VOLUME System Variable Symbol
&SYSJOB System Variable Symbol
&SYSLIB_DSN System Variable Symbol
&SYSLIB_MEMBER System Variable Symbol
&SYSLIB_VOLUME System Variable Symbol
&SYSLIN_DSN System Variable Symbol
&SYSLIN_MEMBER System Variable Symbol
&SYSLIN_VOLUME System Variable Symbol
&SYSLIST System Variable Symbol
&SYSLOC System Variable Symbol
&SYSMAC System Variable Symbol
&SYSM_HSEV System Variable Symbol
&SYSM_SEV System Variable Symbol
&SYSNDX System Variable Symbol
&SYSNEST System Variable Symbol
&SYSOPT_DBCS System Variable Symbol
&SYSOPT_OPTABLE System Variable Symbol
&SYSOPT_RENT System Variable Symbol
&SYSOPT_XOBJECT System Variable Symbol
&SYSPARM System Variable Symbol
&SYSPRINT_DSN System Variable Symbol
&SYSPRINT_MEMBER System Variable Symbol
&SYSPRINT_VOLUME System Variable Symbol
&SYSPUNCH_DSN System Variable Symbol
&SYSPUNCH_MEMBER System Variable Symbol
&SYSPUNCH_VOLUME System Variable Symbol
&SYSSEQF System Variable Symbol
&SYSSTEP System Variable Symbol
&SYSSTMT System Variable Symbol
&SYSSTYP System Variable Symbol
&SYSTEM_ID System Variable Symbol
&SYSTERM_DSN System Variable Symbol
&SYSTERM_MEMBER System Variable Symbol
&SYSTERM_VOLUME System Variable Symbol
&SYSTIME System Variable Symbol
&SYSVER System Variable Symbol
How to write macro instructions
Macro instruction format
Alternative formats for a macro instruction
Name entry
Operation entry
Operand entry
Sublists in operands
Multilevel sublists
Passing sublists to inner macro instructions
Values in operands
Omitted operands
Unquoted operands
Special characters
Nesting macro instruction definitions
Inner and outer macro instructions
Levels of macro call nesting
Recursion
General rules and restrictions
Passing values through nesting levels
System variable symbols in nested macros
How to write conditional assembly instructions
Elements and functions
SET symbols
Subscripted SET symbols
Scope of SET symbols
Scope of symbolic parameters
SET symbol specifications
Subscripted SET symbol specification
Created SET symbols
Data attributes
Attributes of symbols and expressions
Type attribute (T')
Length attribute (L')
Scale attribute (S')
Integer attribute (I')
Count attribute (K')
Number attribute (N')
Defined attribute (D')
Operation code attribute (O')
Sequence symbols
Lookahead
Generating END statements
Lookahead restrictions
Sequence symbols
Open code
Conditional assembly instructions
Declaring SET symbols
GBLA, GBLB, and GBLC instructions
LCLA, LCLB, and LCLC instructions
Assigning values to SET symbols
Introducing Built-In Functions
SETA instruction
SETB instruction
SETC instruction
Extended SET statements
SETAF instruction
SETCF instruction
Branching
AIF instruction
AGO instruction
ACTR instruction
ANOP instruction
MHELP instruction
MHELP options
MHELP operand mapping
Combining options
Appendix A. Assembler instructions
Appendix B. Summary of constants
Appendix C. Macro and conditional assembly language summary
Appendix D. Standard character set code table
Notices
Trademarks
Bibliography
High Level Assembler Publications
Toolkit Feature Publications
Related Publications (Architecture)
Related Publications for z/OS
Related Publications for z/VM
Related Publications for z/VSE
Index

[ Top of Page | Previous Page | Next Page | Contents | Index ]