HLASM: V1R6 Language Ref

More documents

Recommendations

Info

eference constant (R) 154reference notation for attribute 307register zeroas base address 220in USING instruction 218registersuse by machine instructions 83relational operatorsfor character strings 362relative addressspecifying 85relative addressing 66relocatability attribute 46relocatable expressioncomplex 47definition 47EQU instruction 183relocatable symboldefined 30relocatable terms 27remarks entries 20RENT assembler option 211&SYSOPT_RENT system variablesymbol 281determining if supplied 281representation conversion functionsA2 369A2B 369A2D 369A2X 370B2A 349B2C 370B2D 370B2X 370BYTE 371C2A 350C2B 371C2D 371C2X 372D2A 350D2B 372D2C 372D2X 372SIGNED 374X2A 354X2B 375X2C 375X2D 376REPRO instruction 209RI format 88RMODEestablishing values 66indicators in ESD 66instruction 210RMODE instruction24 21031 21064 210ANY 210RR format 89RS format 90RSECT instruction 211&SYSECT 265&SYSSTYP 289RSI format 91rules for model statement fields 249RX format 91434 HLASM: V1R6 Language RefSS-type address constant 155S' scale attribute 330scale attribute (S') 330scale modifier 135, 137SCOPEXATTR operands 229scope of SET symbols 316SECTALGN assembler optioninteraction with ALIGN 111interaction with LTORGinstruction 193interaction with ORG instruction 200sectioning, programaddressing mode of a controlsection 109CSECT instruction 122ESD entries 70external symbols 188LOCTR instruction 190multiple location counters in a controlsection 190read-only control section 211residence mode of a controlsection 210sectioning, programcontrol sections 51defining 179first control section 53identifying a blank commoncontrol section 55identifying a dummy section 55location counter 60maximum length of controlsection 60source module 51total length of external dummysections 123unnamed control section 54weak external symbols 227sectionsGOFF option considerations 67segments of control sections 66self-defining termsbinary 34character 34comparison with literals andconstants 40decimal 33graphic 35hexadecimal 33overview 32using 33semiprivileged instructions 76sequence symbols 335defined 30defined within COPY member 121SET statementextended 381SET symbolsarrays 316assigning values to 346created 320declaring 339global 340local 341description of 316SET symbols (continued)dimensioned 316external function calls 381, 382scope of 316SETA (set arithmetic) 346SETB (set binary) 359SETC (set character) 364specifications 317specifications for subscripted 319subscripted 316SETAarithmetic expression 346built-in functions 349statement format 346symbol in operand field of SETCin arithmetic expressions 349leading zeros 380sign of substituted value 380symbolssubscripted 346using 357SETAF instruction 381SETBcharacter relations in logicalexpressions 362, 363logical expression 359statement format 359symbolssubscripted 359using 363SETCbuilt-in functions 369character expression 364character expressions 366SETA symbol in operand field 380statement format 364substring notation 364symbolssubscripted 364SETCF instruction 382shift codesshift-in (SI) DBCS characterdelimiter 12shift-out (SO) DBCS characterdelimiter 12shift functionsSLA 353SLL 353SRA 354SRL 354shift left arithmetic (SETA built-infunction) 353shift left logical (SETA built-infunction) 353shift right arithmetic (SETA built-infunction) 354shift right logical (SETA built-infunction) 354SI (shift-in) charactercontinuation of double-byte data 16continuation-indicator field 15double-byte character set 12SI format 92SIGNED (SETC built-in function) 374simply relocatable addressdefined 85SLA (SETA built-in function) 353
SLL (SETA built-in function) 353SO (shift-out) charactercontinuation of double-byte data 16continuation-indicator field 15double-byte character set 12softcopy publications xsource macro definitions 238source module 10SPACE instruction 212blank lines 212special characters 306SRA (SETA built-in function) 354SRL (SETA built-in function) 354SS format 93stacked items xiSTART instruction 212&SYSECT 265&SYSSTYP 289beginning a source module 51control section 53syntax 212statement coding rules 18statement field 14string manipulation functionsDCLEN 350DCVAL 373DEQUOTE 373DOUBLE 373LOWER 374UPPER 375string scanning functionsFIND 351INDEX 351stringscharacter 307quoted 307structure of assembler language 20subfield 1 of constant (duplicationfactor) 131subfield 2 of constant (type) 132subfield 3 of constant (typeextension) 133subfield 4 of constant (modifier) 135subfield 5 of constant (nominalvalue) 138sublistscompatibility with Assembler H 275effect of COMPAT(SYSLIST) assembleroption 302, 305in operands 302multilevel 304passingto inner macro instructions 305subscripted local SET symbol 343subscripted SET symbols 316, 319subscripted symbolic parameters 252SUBSTRsuboption of FLAG 103substring notationarithmetic expressions in 348assigning SETC symbols 364, 383concatenating double-byte data 378concatenation 380definition 366duplicating double-byte data 365duplication factor 364evaluation of 367substring notation (continued)level of parentheses 356using count (K') attribute 322symbol definition (EQU) instruction 183symbol length attribute reference 37symbol qualifierlabel unavailable as result of DROPinstruction 172symbol qualifiers 222symbol table 29symbolic linkages 67symbolic operation codes 81defining 197deleting 197OPSYN 197symbolic parameters 250symbolsabsolute 183attributes in combination with 323complexly relocatableEQU instruction 184defining 30explanation of 28extended SET 381external 156, 227EXTRN instruction 188labeled USING 222length attribute reference 37previously defined 32qualifiers 222relocatable 30restrictions on 31sequence 335SET 343declaring global 339declaring local 341USING instruction labels 222variableas points of substitution in modelstatements 245SET symbols 316subscripted 316symbolic parameters 250weak 227syntax notation, description xSYSADATA fileADATA instruction 106SYSATTRA (SETC built-in function) 185,374SYSATTRP (SETC built-in function) 185,374SYSPARM assembler option&SYSPARM system variablesymbol 282system macro instructions 238system variable symbols&SYS naming convention 259&SYSADATA_DSN 260&SYSADATA_MEMBER 261&SYSADATA_VOLUME 262&SYSASM 263&SYSCLOCK 263&SYSDATC 263&SYSDATE 264&SYSECT 264&SYSIN_DSN 266&SYSIN_MEMBER 267system variable symbols (continued)&SYSIN_VOLUME 268&SYSJOB 269&SYSLIB_DSN 269&SYSLIB_MEMBER 270&SYSLIB_VOLUME 270&SYSLIN_DSN 271&SYSLIN_MEMBER 272&SYSLIN_VOLUME 273&SYSLIST 273&SYSLOC 275&SYSM_HSEV 195, 276&SYSM_SEV 195, 277&SYSMAC 276&SYSNDX 278&SYSNEST 280&SYSOPT_DBCS 281&SYSOPT_OPTABLE 281&SYSOPT_RENT 281&SYSOPT_XOBJECT 282&SYSPARM 282&SYSPRINT_DSN 283&SYSPRINT_MEMBER 284&SYSPRINT_VOLUME 284&SYSPUNCH_DSN 285&SYSPUNCH_MEMBER 286&SYSPUNCH_VOLUME 287&SYSSEQF 287&SYSSTEP 288&SYSSTMT 288&SYSSTYP 289&SYSTEM_ID 289&SYSTERM_DSN 290&SYSTERM_MEMBER 291&SYSTERM_VOLUME 291&SYSTIME 292&SYSVER 292defined 259in nested macros 312in open code 259, 312, 339summary of 412variability 259Tterms 27enclosed in parentheses 27TITLE instruction 213Toolkit Customization book xToolkit installation and customizationbook information xtrailermacro definition 242TRANSLATE optionconverting default EBCDICcharacters 141not modifying ASCII 143translation table 13type attribute (T') 325literals 326, 328name field of macro instruction 326undefined type attribute 326unknown type attribute 326type extension of constants 133TYPECHECK assembler option 100types of constants 132Index 435
Page 1:
High Level Assembler for z/OS & z/V
Page 4 and 5:
Note!Before using this information
Page 8 and 9:
|Open code . . . . . . . . . . . .
Page 10 and 11:
Programming interface informationOr
Page 12 and 13:
IBM High Level Assembler for z/OS &
Page 14 and 15:
Syntax notationFormat▌A▐ ▌B
Page 16 and 17:
Double-byte character set notationx
Page 18:
Summary of changesxvi HLASM: V1R6 L
Page 21 and 22:
Chapter 1. IntroductionA computer c
Page 23 and 24:
Assembler languagev Macro instructi
Page 25 and 26:
Assembler programProcessingConditio
Page 27 and 28:
Coding made easierCoding made easie
Page 29 and 30:
Chapter 2. Coding and structureThis
Page 31 and 32:
Character setTable 4. Examples usin
Page 33 and 34:
Assembler language coding conventio
Page 35 and 36:
Page 37 and 38:
Page 39 and 40:
Assembler language structureThe mac
Page 41 and 42:
Assembler language structureMachine
Page 43 and 44:
Assembler language structureConditi
Page 45 and 46:
Mnemonic tags|||||||||For example,
Page 47 and 48:
Terms, literals, and expressions- T
Page 49 and 50:
Terms, literals, and expressionsAss
Page 51 and 52:
Terms, literals, and expressionsUsi
Page 53 and 54:
Terms, literals, and expressions|||
Page 55 and 56:
Terms, literals, and expressionsz/V
Page 57 and 58:
Terms, literals, and expressionsTab
Page 59 and 60:
Terms, literals, and expressions1.
Page 61 and 62:
Terms, literals, and expressions1.
Page 63 and 64:
Terms, literals, and expressions┌
Page 65 and 66:
Terms, literals, and expressionsA-Y
Page 67 and 68:
Chapter 3. Program structures and a
Page 69 and 70:
SourcemoduleA source module is comp
Page 71 and 72:
Beginning of a source modulev The S
Page 73 and 74:
Beginning of a source moduleReferen
Page 75 and 76:
Beginning of a source moduleNote: T
Page 77 and 78:
Beginning of a source moduleClass l
Page 79 and 80:
Beginning of a source modulez/VM an
Page 81 and 82:
AddressingBase Address Definition:
Page 83 and 84:
QualifiedDependentaddressingQualifi
Page 85 and 86:
Addressingz/VM and z/OSWhen you spe
Page 87 and 88:
Addressing..EX_SYM DC V(EXMOD1) Add
Page 89 and 90:
AddressingSee the appendix “Objec
Page 91 and 92:
Part 2. Machine and assembler instr
Page 93 and 94:
Chapter 4. Machine instruction stat
Page 95 and 96:
Input/output operationsThe input or
Page 97 and 98:
Branching with extended mnemonic co
Page 99 and 100:
Statement formatsSymbolic operation
Page 101 and 102:
Operand entriesRegistersYou can spe
Page 103 and 104:
Operand entriesv Explicitly—in a
Page 105 and 106:
Operand entriesImmediateused by the
Page 107 and 108:
Examples of coded machine instructi
Page 109 and 110:
Page 111 and 112:
Page 113 and 114:
Page 115 and 116:
Chapter 5. Assembler instruction st
Page 117 and 118:
*PROCESS statementstatement, follow
Page 119 and 120:
ACONTROL instruction►►NOCOMPAT,
Page 121 and 122:
ACONTROL instructionFLAG(PAGE0)inst
Page 123 and 124:
ACONTROL instruction|||may be fetch
Page 125 and 126:
AINSERT instruction►►sequence_s
Page 127 and 128:
ALIAS instruction||||||The alias_st
Page 129 and 130:
AMODE instructionCATTR instruction
Page 131 and 132:
CATTR instructionRMODE(ANY)The text
Page 133 and 134:
CCW and CCW0 instructionssupport 31
Page 135 and 136:
CEJECT instructionIf number of line
Page 137 and 138:
CNOP instructionAfter the BALR inst
Page 139 and 140:
COPY instructioncopied from either
Page 141 and 142:
CSECT instructionsame section name
Page 143 and 144:
CXD instructionZETA: the resulting
Page 145 and 146:
DC instruction10EBP(7)L2’12’the
Page 147 and 148:
DC instructionTable 17. Length attr
Page 149 and 150:
DC instruction4. Double-byte data i
Page 151 and 152:
DC instructionTable 19. Type codes
Page 153 and 154:
DC instructionYou may omit the modi
Page 155 and 156:
DC instructionfirst constant to be
Page 157 and 158:
DC instructionTable 21. Specifying
Page 159 and 160:
DC instruction—Character constant
Page 161 and 162:
DC instruction—Character constant
Page 163 and 164:
DC instruction—Graphic constantTa
Page 165 and 166:
DC instruction—Fixed-point consta
Page 167 and 168:
DC instruction—Fixed-point consta
Page 169 and 170:
DC instruction—Decimal constantsD
Page 171 and 172:
DC instruction—Address constants|
Page 173:
DC instruction—Address constantsT
Page 176 and 177:
DC instruction—Offset constantIn
Page 178 and 179:
DC instruction—Hexadecimal floati
Page 180 and 181:
Page 182 and 183:
Page 184 and 185:
DC instruction—Decimal floating-p
Page 186 and 187:
Syntax of binary, decimal, and hexa
Page 188 and 189:
DC instruction—Binary floating-po
Page 190 and 191:
DROP instructionLabeledDependentIf
Page 192 and 193:
DS instructionv An ordinary symbolv
Page 194 and 195:
DS instructionthe data that follows
Page 196 and 197:
DSECT instructionTo effect referenc
Page 198 and 199:
DXD instructionnominal_valueis the
Page 200 and 201:
END instructionNotes:1. If the END
Page 202 and 203:
EQU instruction||||to the symbol in
Page 204 and 205:
EQU instruction|FPR Register - Floa
Page 206 and 207:
EXITCTL instructionSee the section
Page 208 and 209:
ISEQ instruction►►sequence_symb
Page 210 and 211:
LOCTR instructionA LOCTR name may b
Page 212 and 213:
LTORG instructionAddressingDuplicat
Page 214 and 215:
MNOTE instructionNote: The maximum
Page 216 and 217:
OPSYN instruction||||||v An operati
Page 218 and 219:
ORG instruction||||||||If symbol de
Page 220 and 221:
ORG instructionThat is, the ORG ins
Page 222 and 223:
PRINT instructionPRINT instructionT
Page 224 and 225:
PRINT instructionexceeded the macro
Page 226 and 227:
PUNCH instructionv A pair of single
Page 228 and 229:
REPRO instruction||Notes:1. The ide
Page 230 and 231:
RSECT instructionThe beginning of a
Page 232 and 233:
TITLE instructionv Provides heading
Page 234 and 235:
TITLE instructionIf the TITLE state
Page 236 and 237:
USING instructioninstructions suppo
Page 238 and 239:
USING instructionby means of anothe
Page 240 and 241:
USING instructionLabeled USING inst
Page 242 and 243:
USING instructionDomain of a labele
Page 244 and 245:
USING instructionIf the dependent U
Page 246 and 247:
XATTR instructionXATTR instruction
Page 248 and 249:
XATTR instructionSCOPE(MODULE), abb
Page 250 and 251:
232 HLASM: V1R6 Language Ref
Page 252 and 253:
Name entry . . . . . . . . . . . .
Page 254 and 255:
Macro definitionA macro definition
Page 256 and 257:
Macro instructionThe macro instruct
Page 258 and 259:
240 HLASM: V1R6 Language Ref
Page 260 and 261:
Where to define a macro in a source
Page 262 and 263:
Prototype statement|||||specified o
Page 264 and 265:
Model statementsEach field or subfi
Page 266 and 267:
Model statementsTable 37. Rules for
Page 268 and 269:
Model statements||v Variable symbol
Page 270 and 271:
Symbolic parametersPositionalKeywor
Page 272 and 273:
Other conditional assembly instruct
Page 274 and 275:
AREAD instruction||If no operand is
Page 276 and 277:
MEXIT instructionThe MEXIT instruct
Page 278 and 279:
System variable symbols1 macro2 get
Page 280 and 281:
&SYSADATA_MEMBER System Variable Sy
Page 282 and 283:
&SYSDATC System Variable SymbolYYYY
Page 284 and 285:
&SYSECT System Variable Symbolv Sta
Page 286 and 287:
&SYSIN_MEMBER System Variable Symbo
Page 288 and 289:
&SYSLIB_DSN System Variable SymbolS
Page 290 and 291:
&SYSLIN_DSN System Variable SymbolE
Page 292 and 293:
&SYSLIST System Variable Symbolposi
Page 294 and 295:
&SYSLOC System Variable Symbolinstr
Page 296 and 297:
&SYSNDX System Variable Symbol1 MAC
Page 298 and 299:
&SYSNDX System Variable SymbolState
Page 300 and 301:
&SYSOPT_RENT System Variable Symbol
Page 302 and 303:
&SYSPRINT_DSN System Variable Symbo
Page 304 and 305:
&SYSPUNCH_DSN System Variable Symbo
Page 306 and 307:
&SYSSEQF System Variable Symbol1. I
Page 308 and 309:
&SYSTEM_ID System Variable SymbolNo
Page 310 and 311:
&SYSTERM_VOLUME System Variable Sym
Page 312 and 313:
&SYSVER System Variable Symbol294 H
Page 314 and 315:
Macro instruction format|name_entry
Page 316 and 317:
Macro instruction formatOperandYou
Page 318 and 319:
Macro instruction formatAny keyword
Page 320 and 321:
Macro instruction formatparameters
Page 322 and 323:
Sublists in operandsTable 48. Relat
Page 324 and 325:
Values in operandsUnquotedSpecial2.
Page 326 and 327:
Values in operands’SPACES ALLOWED
Page 328 and 329:
Levels of macro call nestingLevels
Page 330 and 331:
Levels of macro call nestingCOMPAT(
Page 332 and 333:
Levels of macro call nesting&SYSSEQ
Page 334 and 335:
SET symbolsSET symbolsSET symbols a
Page 336 and 337:
SET symbolsTable 50. Features of SE
Page 338 and 339:
SET symbolspreceding 999999 element
Page 340 and 341:
Data attributesTable 51. Data attri
Page 342 and 343:
Data attributesThe values of attrib
Page 344 and 345:
Data attributesV R-, V-type address
Page 346 and 347:
Data attributes|||||||||Notes:1. Or
Page 348 and 349:
Data attributesv If the first opera
Page 350 and 351:
Data attributesCount attribute (K')
Page 352 and 353:
Data attributes||||||defined attrib
Page 354 and 355:
Sequence symbolsparameter wherever
Page 356 and 357:
LookaheadSequencelater defined by O
Page 358 and 359:
GBLA, GBLB, and GBLC instructionsGB
Page 360 and 361:
LCLA, LCLB, and LCLC instructions,
Page 362 and 363:
Assigning values to SET symbolsLogi
Page 364 and 365:
Assigning values to SET symbolsTabl
Page 366 and 367:
SETA instructionTable 58. Variable
Page 368 and 369:
SETA instructionB2A(’’) has val
Page 370 and 371:
SETA instruction|||||||||||||||||||
Page 372 and 373:
SETA instructionAfter the following
Page 374 and 375:
SETA instruction10. An arithmetic e
Page 376 and 377:
SETA instructionarithmetic value
Page 378 and 379:
SETB instructionv A logical express
Page 380 and 381:
SETB instructionOR Format: Logical-
Page 382 and 383:
SETC instructionSETCinstructionThe
Page 384 and 385:
SETC instruction|LCLC &C1,&C2LCLC &
Page 386 and 387:
Substring notationv When e2 has a v
Page 388 and 389:
Substring notation||||ExamplesA2D(0
Page 390 and 391:
Substring notationC2X Format: Funct
Page 392 and 393:
Substring notationSuppose the SETC
Page 394 and 395:
Substring notationX2C(’’) has v
Page 396 and 397:
Substring notationFor example, eith
Page 398 and 399:
Substring notationStatement 1 assig
Page 400 and 401:
SETAF instruction►► variable_sy
Page 402 and 403: AIF instructionsequence_symbolis a
Page 404 and 405: AIF instructionAIFB—synonym of th
Page 406 and 407: ACTR instruction►►sequence_symb
Page 408 and 409: 390 HLASM: V1R6 Language Ref
Page 410 and 411: MHELP optionsparameters are dumped
Page 416 and 417: Assembler instructions and statemen
Page 422 and 423: Summary of constantsTable 65. Summa
Page 424 and 425: Macro and conditional assembly lang
Page 436 and 437: Standard character set code tableHe
Page 438 and 439: Standard character set code tableHe
Page 440 and 441: NoticesPURPOSE. Some states do not
Page 442 and 443: z/VM: CP Planning and Administratio
Page 444 and 445: ALIAS instruction 108maximum operan
Page 446 and 447: comment statements (continued)ordin
Page 448 and 449: GG-type graphic constant 144GBLA in
Page 450 and 451: macro instructions (continued)opera
Page 454 and 455: UUHEADPRINT instruction 206unary op
Page 456: Readers’ Comments — We’d Like
show all

HLASM: V1R6 Language Ref

You also want an ePaper? Increase the reach of your titles

Delete template?

Save as template?