HLASM Language Reference
HLASM Language Reference HLASM Language Reference
Part 3. Macro Language &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 Sublists in Operands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 304 Values in Operands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 307 Omitted Operands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 307 Unquoted Operands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 308 Special Characters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 308 Nesting Macro Instruction Definitions . . . . . . . . . . . . . . . . . . . . . . . . . 311 236 HLASM V1R5 Language Reference
Part 3. Macro Language Inner and Outer Macro Instructions . . . . . . . . . . . . . . . . . . . . . . . . . . 312 Levels of Macro Call Nesting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 312 General Rules and Restrictions . . . . . . . . . . . . . . . . . . . . . . . . . . 313 Passing Values through Nesting Levels . . . . . . . . . . . . . . . . . . . . . . 314 System Variable Symbols in Nested Macros . . . . . . . . . . . . . . . . . . . 316 Chapter 9. How to Write Conditional Assembly Instructions . . . . . . . . 318 SET Symbols . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 319 Subscripted SET Symbols . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 319 Scope of SET Symbols . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 319 Scope of Symbolic Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . 319 SET Symbol Specifications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 320 Subscripted SET Symbol Specification . . . . . . . . . . . . . . . . . . . . . . 322 Created SET Symbols . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 323 Data Attributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 324 | Attributes of Symbols and Expressions . . . . . . . . . . . . . . . . . . . . . . 326 Type Attribute (T') . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 328 Length Attribute (L') . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 332 Scale Attribute (S') . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 333 Integer Attribute (I') . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 334 Count Attribute (K') . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 335 Number Attribute (N') . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 336 Defined Attribute (D') . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 337 Operation Code Attribute (O') . . . . . . . . . . . . . . . . . . . . . . . . . . . 337 Sequence Symbols . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 339 Lookahead . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 340 Open Code . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 342 Conditional Assembly Instructions . . . . . . . . . . . . . . . . . . . . . . . . . . 343 Declaring SET Symbols . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 343 GBLA, GBLB, and GBLC Instructions . . . . . . . . . . . . . . . . . . . . . . . 344 LCLA, LCLB, and LCLC Instructions . . . . . . . . . . . . . . . . . . . . . . . 345 Assigning Values to SET Symbols . . . . . . . . . . . . . . . . . . . . . . . . . . 347 SETA Instruction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 347 SETB Instruction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 362 SETC Instruction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 369 Extended SET Statements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 387 SETAF Instruction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 388 SETCF Instruction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 389 Branching . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 390 AIF Instruction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 390 AGO Instruction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 392 ACTR Instruction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 394 ANOP Instruction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 395 Chapter 10. MHELP Instruction . . . . . . . . . . . . . . . . . . . . . . . . . . 397 Part 3. Macro Language 237
- Page 206 and 207: EQU Instruction 5. The length attri
- Page 208 and 209: EXITCTL Instruction sequence_symbol
- Page 210 and 211: ISEQ Instruction must be greater th
- Page 212 and 213: LOCTR Instruction A CSECT , See not
- Page 214 and 215: LTORG Instruction If symbol is an o
- Page 216 and 217: MNOTE Instruction When two literals
- Page 218 and 219: OPSYN Instruction ,ERROR, SEV 1 An
- Page 220 and 221: ORG Instruction AFTER is defined in
- Page 222 and 223: ORG Instruction If you specify mult
- Page 224 and 225: POP Instruction POP Instruction The
- Page 226 and 227: PRINT Instruction Note: If the next
- Page 228 and 229: Process Statement Process Statement
- Page 230 and 231: REPRO Instruction NOPRINT instructs
- Page 232 and 233: RSECT Instruction 4. AMODE or RMODE
- Page 234 and 235: START Instruction START Instruction
- Page 236 and 237: TITLE Instruction The name value is
- Page 238 and 239: USING Instruction Only the characte
- Page 240 and 241: USING Instruction Base Registers fo
- Page 242 and 243: USING Instruction If register 0 is
- Page 244 and 245: USING Instruction A variable symbo
- Page 246 and 247: USING Instruction In this MVC instr
- Page 248 and 249: USING Instruction Range of a Depend
- Page 250 and 251: XATTR Instruction external_symbol i
- Page 252 and 253: XATTR Instruction SCOPE ►►─
- Page 254 and 255: XATTR Instruction 234 HLASM V1R5 La
- Page 258 and 259: Introduction to Macro Language Chap
- Page 260 and 261: Introduction to Macro Language The
- Page 262 and 263: Introduction to Macro Language Macr
- Page 264 and 265: MACRO and MEND Statements The assem
- Page 266 and 267: Prototype Statement Macros that are
- Page 268 and 269: Model Statements generated from tha
- Page 270 and 271: Model Statements ▌5▐ ▌6▐
- Page 272 and 273: Model Statements Notes: 1. You can
- Page 274 and 275: Positional Parameters Symbolic para
- Page 276 and 277: Processing Statements Processing St
- Page 278 and 279: AREAD Instruction Assign Local Time
- Page 280 and 281: COPY Instruction sequence_symbol is
- Page 282 and 283: System Variable Symbols System Vari
- Page 284 and 285: &SYSADATA_MEMBER System Variable Sy
- Page 286 and 287: &SYSCLOCK System Variable Symbol &S
- Page 288 and 289: &SYSECT System Variable Symbol depe
- Page 290 and 291: &SYSIN_MEMBER System Variable Symbo
- Page 292 and 293: &SYSJOB System Variable Symbol &SYS
- Page 294 and 295: &SYSLIN_DSN System Variable Symbol
- Page 296 and 297: &SYSLIST System Variable Symbol The
- Page 298 and 299: &SYSLOC System Variable Symbol To
- Page 300 and 301: &SYSM_SEV System Variable Symbol &S
- Page 302 and 303: &SYSNDX System Variable Symbol The
- Page 304 and 305: &SYSOPT_DBCS System Variable Symbol
Part 3. Macro <strong>Language</strong><br />
&SYSDATC System Variable Symbol . . . . . . . . . . . . . . . . . . . . . . . 266<br />
&SYSDATE System Variable Symbol . . . . . . . . . . . . . . . . . . . . . . . 267<br />
&SYSECT System Variable Symbol . . . . . . . . . . . . . . . . . . . . . . . . 267<br />
&SYSIN_DSN System Variable Symbol . . . . . . . . . . . . . . . . . . . . . . 269<br />
&SYSIN_MEMBER System Variable Symbol . . . . . . . . . . . . . . . . . . . 270<br />
&SYSIN_VOLUME System Variable Symbol . . . . . . . . . . . . . . . . . . . 271<br />
&SYSJOB System Variable Symbol . . . . . . . . . . . . . . . . . . . . . . . . 272<br />
&SYSLIB_DSN System Variable Symbol . . . . . . . . . . . . . . . . . . . . . 272<br />
&SYSLIB_MEMBER System Variable Symbol . . . . . . . . . . . . . . . . . . 273<br />
&SYSLIB_VOLUME System Variable Symbol . . . . . . . . . . . . . . . . . . 273<br />
&SYSLIN_DSN System Variable Symbol . . . . . . . . . . . . . . . . . . . . . 274<br />
&SYSLIN_MEMBER System Variable Symbol . . . . . . . . . . . . . . . . . . 275<br />
&SYSLIN_VOLUME System Variable Symbol . . . . . . . . . . . . . . . . . . 275<br />
&SYSLIST System Variable Symbol . . . . . . . . . . . . . . . . . . . . . . . . 276<br />
&SYSLOC System Variable Symbol . . . . . . . . . . . . . . . . . . . . . . . . 278<br />
&SYSMAC System Variable Symbol . . . . . . . . . . . . . . . . . . . . . . . 279<br />
&SYSM_HSEV System Variable Symbol . . . . . . . . . . . . . . . . . . . . . 279<br />
&SYSM_SEV System Variable Symbol . . . . . . . . . . . . . . . . . . . . . . 280<br />
&SYSNDX System Variable Symbol . . . . . . . . . . . . . . . . . . . . . . . . 281<br />
&SYSNEST System Variable Symbol . . . . . . . . . . . . . . . . . . . . . . . 283<br />
&SYSOPT_DBCS System Variable Symbol . . . . . . . . . . . . . . . . . . . 284<br />
&SYSOPT_OPTABLE System Variable Symbol . . . . . . . . . . . . . . . . . 285<br />
&SYSOPT_RENT System Variable Symbol . . . . . . . . . . . . . . . . . . . 285<br />
&SYSOPT_XOBJECT System Variable Symbol . . . . . . . . . . . . . . . . . 285<br />
&SYSPARM System Variable Symbol . . . . . . . . . . . . . . . . . . . . . . . 286<br />
&SYSPRINT_DSN System Variable Symbol . . . . . . . . . . . . . . . . . . . 286<br />
&SYSPRINT_MEMBER System Variable Symbol . . . . . . . . . . . . . . . . 288<br />
&SYSPRINT_VOLUME System Variable Symbol . . . . . . . . . . . . . . . . 288<br />
&SYSPUNCH_DSN System Variable Symbol . . . . . . . . . . . . . . . . . . 289<br />
&SYSPUNCH_MEMBER System Variable Symbol . . . . . . . . . . . . . . . 290<br />
&SYSPUNCH_VOLUME System Variable Symbol . . . . . . . . . . . . . . . 290<br />
&SYSSEQF System Variable Symbol . . . . . . . . . . . . . . . . . . . . . . . 291<br />
&SYSSTEP System Variable Symbol . . . . . . . . . . . . . . . . . . . . . . . 292<br />
&SYSSTMT System Variable Symbol . . . . . . . . . . . . . . . . . . . . . . . 292<br />
&SYSSTYP System Variable Symbol . . . . . . . . . . . . . . . . . . . . . . . 292<br />
&SYSTEM_ID System Variable Symbol . . . . . . . . . . . . . . . . . . . . . . 293<br />
&SYSTERM_DSN System Variable Symbol . . . . . . . . . . . . . . . . . . . 294<br />
&SYSTERM_MEMBER System Variable Symbol . . . . . . . . . . . . . . . . 295<br />
&SYSTERM_VOLUME System Variable Symbol . . . . . . . . . . . . . . . . 295<br />
&SYSTIME System Variable Symbol . . . . . . . . . . . . . . . . . . . . . . . 296<br />
&SYSVER System Variable Symbol . . . . . . . . . . . . . . . . . . . . . . . . 296<br />
Chapter 8. How to Write Macro Instructions . . . . . . . . . . . . . . . . . . 297<br />
Macro Instruction Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 297<br />
Alternative Formats for a Macro Instruction . . . . . . . . . . . . . . . . . . . . 298<br />
Name Entry . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 299<br />
Operation Entry . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 299<br />
Operand Entry . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 300<br />
Sublists in Operands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 304<br />
Values in Operands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 307<br />
Omitted Operands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 307<br />
Unquoted Operands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 308<br />
Special Characters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 308<br />
Nesting Macro Instruction Definitions . . . . . . . . . . . . . . . . . . . . . . . . . 311<br />
236 <strong>HLASM</strong> V1R5 <strong>Language</strong> <strong>Reference</strong>