HLASM Language Reference
HLASM Language Reference HLASM Language Reference
Contents Ordinary USING Instruction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 220 Labeled USING Instruction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 223 Dependent USING Instruction . . . . . . . . . . . . . . . . . . . . . . . . . . . 226 WXTRN Instruction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 229 XATTR Instruction (MVS and CMS) . . . . . . . . . . . . . . . . . . . . . . . . . 230 | Association of Code and Data Areas (MVS and CMS) . . . . . . . . . . . . . 232 Part 3. Macro Language . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 235 Chapter 6. Introduction to Macro Language . . . . . . . . . . . . . . . . . . . 238 Using Macros . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 238 Macro Definition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 238 Model Statements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 239 Processing Statements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 240 Comment Statements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 240 Macro Instruction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 241 Source and Library Macro Definitions . . . . . . . . . . . . . . . . . . . . . . . . 241 Macro Library . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 242 System Macro Instructions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 242 Conditional Assembly Language . . . . . . . . . . . . . . . . . . . . . . . . . . . 242 Chapter 7. How to Specify Macro Definitions . . . . . . . . . . . . . . . . . . 243 Where to Define a Macro in a Source Module . . . . . . . . . . . . . . . . . . . 243 Format of a Macro Definition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 244 Macro Definition Header and Trailer . . . . . . . . . . . . . . . . . . . . . . . . . 244 MACRO Statement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 244 MEND Statement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 245 Macro Instruction Prototype . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 245 Body of a Macro Definition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 247 Model Statements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 247 Variable Symbols as Points of Substitution . . . . . . . . . . . . . . . . . . . . 248 Listing of Generated Fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 248 Rules for Concatenation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 249 Rules for Model Statement Fields . . . . . . . . . . . . . . . . . . . . . . . . . 251 Symbolic Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 253 Positional Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 254 Keyword Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 255 Combining Positional and Keyword Parameters . . . . . . . . . . . . . . . . . 255 Subscripted Symbolic Parameters . . . . . . . . . . . . . . . . . . . . . . . . . 255 Processing Statements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 256 Conditional Assembly Instructions . . . . . . . . . . . . . . . . . . . . . . . . . 256 Inner Macro Instructions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 256 Other Conditional Assembly Instructions . . . . . . . . . . . . . . . . . . . . . 256 AEJECT Instruction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 257 AINSERT Instruction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 257 AREAD Instruction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 257 ASPACE Instruction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 259 COPY Instruction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 260 MEXIT Instruction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 260 Comment Statements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 261 Ordinary Comment Statements . . . . . . . . . . . . . . . . . . . . . . . . . . . 261 Internal Macro Comment Statements . . . . . . . . . . . . . . . . . . . . . . . 261 System Variable Symbols . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 262 vi HLASM V1R5 Language Reference
Contents Scope and Variability of System Variable Symbols . . . . . . . . . . . . . . . 262 &SYSADATA_DSN System Variable Symbol . . . . . . . . . . . . . . . . . . 263 &SYSADATA_MEMBER System Variable Symbol . . . . . . . . . . . . . . . 264 &SYSADATA_VOLUME System Variable Symbol . . . . . . . . . . . . . . . . 265 &SYSASM System Variable Symbol . . . . . . . . . . . . . . . . . . . . . . . . 265 &SYSCLOCK System Variable Symbol . . . . . . . . . . . . . . . . . . . . . . 266 &SYSDATC System Variable Symbol . . . . . . . . . . . . . . . . . . . . . . . 266 &SYSDATE System Variable Symbol . . . . . . . . . . . . . . . . . . . . . . . 267 &SYSECT System Variable Symbol . . . . . . . . . . . . . . . . . . . . . . . . 267 &SYSIN_DSN System Variable Symbol . . . . . . . . . . . . . . . . . . . . . . 269 &SYSIN_MEMBER System Variable Symbol . . . . . . . . . . . . . . . . . . . 270 &SYSIN_VOLUME System Variable Symbol . . . . . . . . . . . . . . . . . . . 271 &SYSJOB System Variable Symbol . . . . . . . . . . . . . . . . . . . . . . . . 272 &SYSLIB_DSN System Variable Symbol . . . . . . . . . . . . . . . . . . . . . 272 &SYSLIB_MEMBER System Variable Symbol . . . . . . . . . . . . . . . . . . 273 &SYSLIB_VOLUME System Variable Symbol . . . . . . . . . . . . . . . . . . 273 &SYSLIN_DSN System Variable Symbol . . . . . . . . . . . . . . . . . . . . . 274 &SYSLIN_MEMBER System Variable Symbol . . . . . . . . . . . . . . . . . . 275 &SYSLIN_VOLUME System Variable Symbol . . . . . . . . . . . . . . . . . . 275 &SYSLIST System Variable Symbol . . . . . . . . . . . . . . . . . . . . . . . . 276 &SYSLOC System Variable Symbol . . . . . . . . . . . . . . . . . . . . . . . . 278 &SYSMAC System Variable Symbol . . . . . . . . . . . . . . . . . . . . . . . 279 &SYSM_HSEV System Variable Symbol . . . . . . . . . . . . . . . . . . . . . 279 &SYSM_SEV System Variable Symbol . . . . . . . . . . . . . . . . . . . . . . 280 &SYSNDX System Variable Symbol . . . . . . . . . . . . . . . . . . . . . . . . 281 &SYSNEST System Variable Symbol . . . . . . . . . . . . . . . . . . . . . . . 283 &SYSOPT_DBCS System Variable Symbol . . . . . . . . . . . . . . . . . . . 284 &SYSOPT_OPTABLE System Variable Symbol . . . . . . . . . . . . . . . . . 285 &SYSOPT_RENT System Variable Symbol . . . . . . . . . . . . . . . . . . . 285 &SYSOPT_XOBJECT System Variable Symbol . . . . . . . . . . . . . . . . . 285 &SYSPARM System Variable Symbol . . . . . . . . . . . . . . . . . . . . . . . 286 &SYSPRINT_DSN System Variable Symbol . . . . . . . . . . . . . . . . . . . 286 &SYSPRINT_MEMBER System Variable Symbol . . . . . . . . . . . . . . . . 288 &SYSPRINT_VOLUME System Variable Symbol . . . . . . . . . . . . . . . . 288 &SYSPUNCH_DSN System Variable Symbol . . . . . . . . . . . . . . . . . . 289 &SYSPUNCH_MEMBER System Variable Symbol . . . . . . . . . . . . . . . 290 &SYSPUNCH_VOLUME System Variable Symbol . . . . . . . . . . . . . . . 290 &SYSSEQF System Variable Symbol . . . . . . . . . . . . . . . . . . . . . . . 291 &SYSSTEP System Variable Symbol . . . . . . . . . . . . . . . . . . . . . . . 292 &SYSSTMT System Variable Symbol . . . . . . . . . . . . . . . . . . . . . . . 292 &SYSSTYP System Variable Symbol . . . . . . . . . . . . . . . . . . . . . . . 292 &SYSTEM_ID System Variable Symbol . . . . . . . . . . . . . . . . . . . . . . 293 &SYSTERM_DSN System Variable Symbol . . . . . . . . . . . . . . . . . . . 294 &SYSTERM_MEMBER System Variable Symbol . . . . . . . . . . . . . . . . 295 &SYSTERM_VOLUME System Variable Symbol . . . . . . . . . . . . . . . . 295 &SYSTIME System Variable Symbol . . . . . . . . . . . . . . . . . . . . . . . 296 &SYSVER System Variable Symbol . . . . . . . . . . . . . . . . . . . . . . . . 296 Chapter 8. How to Write Macro Instructions . . . . . . . . . . . . . . . . . . 297 Macro Instruction Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 297 Alternative Formats for a Macro Instruction . . . . . . . . . . . . . . . . . . . . 298 Name Entry . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 299 Operation Entry . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 299 Operand Entry . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 300 Contents vii
- Page 1: High Level Assembler for MVS & VM &
- Page 4 and 5: Note! Before using this information
- Page 6 and 7: Contents Source Module . . . . . .
- Page 10 and 11: Contents Sublists in Operands . . .
- Page 12 and 13: About this Manual This manual descr
- Page 14 and 15: IBM High Level Assembler for MVS &
- Page 16 and 17: | The Internet. You can access IBM
- Page 18 and 19: ▌C▐ The item referred to by ▌
- Page 20 and 21: Miscellany The ASCII translation t
- Page 22 and 23: Part 1. Assembler Language—Struct
- Page 24 and 25: Language Compatibility Language Com
- Page 26 and 27: Assembler Program Assembler Program
- Page 28 and 29: Relationship of Assembler to Operat
- Page 30 and 31: Coding Made Easier Linkage between
- Page 32 and 33: Character Set Compatibility with Ea
- Page 34 and 35: Assembler Language Coding Conventio
- Page 36 and 37: Assembler Language Coding Conventio
- Page 38 and 39: Assembler Language Coding Conventio
- Page 40 and 41: Assembler Language Coding Conventio
- Page 42 and 43: Assembler Language Structure Condit
- Page 44 and 45: Assembler Language Structure Machin
- Page 46 and 47: Assembler Language Structure Condit
- Page 48 and 49: Terms, Literals, and Expressions Te
- Page 50 and 51: Terms, Literals, and Expressions -
- Page 52 and 53: Terms, Literals, and Expressions As
- Page 54 and 55: Terms, Literals, and Expressions Se
- Page 56 and 57: Terms, Literals, and Expressions Fo
Contents<br />
Ordinary USING Instruction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 220<br />
Labeled USING Instruction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 223<br />
Dependent USING Instruction . . . . . . . . . . . . . . . . . . . . . . . . . . . 226<br />
WXTRN Instruction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 229<br />
XATTR Instruction (MVS and CMS) . . . . . . . . . . . . . . . . . . . . . . . . . 230<br />
| Association of Code and Data Areas (MVS and CMS) . . . . . . . . . . . . . 232<br />
Part 3. Macro <strong>Language</strong> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 235<br />
Chapter 6. Introduction to Macro <strong>Language</strong> . . . . . . . . . . . . . . . . . . . 238<br />
Using Macros . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 238<br />
Macro Definition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 238<br />
Model Statements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 239<br />
Processing Statements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 240<br />
Comment Statements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 240<br />
Macro Instruction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 241<br />
Source and Library Macro Definitions . . . . . . . . . . . . . . . . . . . . . . . . 241<br />
Macro Library . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 242<br />
System Macro Instructions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 242<br />
Conditional Assembly <strong>Language</strong> . . . . . . . . . . . . . . . . . . . . . . . . . . . 242<br />
Chapter 7. How to Specify Macro Definitions . . . . . . . . . . . . . . . . . . 243<br />
Where to Define a Macro in a Source Module . . . . . . . . . . . . . . . . . . . 243<br />
Format of a Macro Definition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 244<br />
Macro Definition Header and Trailer . . . . . . . . . . . . . . . . . . . . . . . . . 244<br />
MACRO Statement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 244<br />
MEND Statement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 245<br />
Macro Instruction Prototype . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 245<br />
Body of a Macro Definition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 247<br />
Model Statements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 247<br />
Variable Symbols as Points of Substitution . . . . . . . . . . . . . . . . . . . . 248<br />
Listing of Generated Fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 248<br />
Rules for Concatenation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 249<br />
Rules for Model Statement Fields . . . . . . . . . . . . . . . . . . . . . . . . . 251<br />
Symbolic Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 253<br />
Positional Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 254<br />
Keyword Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 255<br />
Combining Positional and Keyword Parameters . . . . . . . . . . . . . . . . . 255<br />
Subscripted Symbolic Parameters . . . . . . . . . . . . . . . . . . . . . . . . . 255<br />
Processing Statements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 256<br />
Conditional Assembly Instructions . . . . . . . . . . . . . . . . . . . . . . . . . 256<br />
Inner Macro Instructions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 256<br />
Other Conditional Assembly Instructions . . . . . . . . . . . . . . . . . . . . . 256<br />
AEJECT Instruction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 257<br />
AINSERT Instruction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 257<br />
AREAD Instruction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 257<br />
ASPACE Instruction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 259<br />
COPY Instruction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 260<br />
MEXIT Instruction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 260<br />
Comment Statements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 261<br />
Ordinary Comment Statements . . . . . . . . . . . . . . . . . . . . . . . . . . . 261<br />
Internal Macro Comment Statements . . . . . . . . . . . . . . . . . . . . . . . 261<br />
System Variable Symbols . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 262<br />
vi<br />
<strong>HLASM</strong> V1R5 <strong>Language</strong> <strong>Reference</strong>