HLASM Language Reference
HLASM Language Reference HLASM Language Reference
Contents Source Module . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52 | Sections, Elements, and Parts . . . . . . . . . . . . . . . . . . . . . . . . . . . 52 | Sections . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53 Reference Control Sections . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56 | Classes (MVS and CMS) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59 | Parts (MVS and CMS) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61 Location Counter Setting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61 Addressing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63 Addressing within Source Modules: Establishing Addressability . . . . . . . . 64 Base Register Instructions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66 Qualified Addressing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66 Dependent Addressing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67 Relative Addressing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67 Literal Pools . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68 Establishing Residence and Addressing Mode . . . . . . . . . . . . . . . . . . 68 Symbolic Linkages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68 External Symbol Dictionary Entries . . . . . . . . . . . . . . . . . . . . . . . . 72 | Summary of Source and Object Program Structures . . . . . . . . . . . . . . 73 Part 2. Machine and Assembler Instruction Statements . . . . . . . . . . . . . . . . . . 75 Chapter 4. Machine Instruction Statements . . . . . . . . . . . . . . . . . . . 78 General Instructions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78 Decimal Instructions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79 Floating-Point Instructions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79 Control Instructions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79 Input/Output Operations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80 Branching with Extended Mnemonic Codes . . . . . . . . . . . . . . . . . . . . . 80 | Alternative Mnemonics for some Branch Relative Instructions . . . . . . . . . 83 Statement Formats . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83 Symbolic Operation Codes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84 Operand Entries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85 Registers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86 Addresses . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87 Lengths . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90 Immediate Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91 Examples of Coded Machine Instructions . . . . . . . . . . . . . . . . . . . . . . 91 RI Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91 RR Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93 RS Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94 RSI Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95 RX Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95 SI Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97 SS Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97 Chapter 5. Assembler Instruction Statements . . . . . . . . . . . . . . . . . 100 64-bit Addressing Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101 *PROCESS Statement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102 ACONTROL Instruction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103 ADATA Instruction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107 AINSERT Instruction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108 ALIAS Instruction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109 AMODE Instruction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110 iv HLASM V1R5 Language Reference
Contents CATTR Instruction (MVS and CMS) . . . . . . . . . . . . . . . . . . . . . . . . . 112 CCW and CCW0 Instructions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115 CCW1 Instruction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 116 CEJECT Instruction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118 CNOP Instruction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119 COM Instruction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121 COPY Instruction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122 CSECT Instruction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123 CXD Instruction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125 DC Instruction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126 Rules for DC Operand . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128 General Information About Constants . . . . . . . . . . . . . . . . . . . . . . . 129 Padding and Truncation of Values . . . . . . . . . . . . . . . . . . . . . . . . . 130 Subfield 1: Duplication Factor . . . . . . . . . . . . . . . . . . . . . . . . . . . 132 Subfield 2: Type . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133 Subfield 3: Type Extension . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134 Subfield 4: Program type . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 135 Subfield 5: Modifier . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136 Subfield 6: Nominal Value . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 140 DROP Instruction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 172 DS Instruction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 174 DSECT Instruction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 178 DXD Instruction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 180 EJECT Instruction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 181 END Instruction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 182 ENTRY Instruction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 183 EQU Instruction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 184 Using Conditional Assembly Values . . . . . . . . . . . . . . . . . . . . . . . . 187 EXITCTL Instruction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 187 EXTRN Instruction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 189 ICTL Instruction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 189 ISEQ Instruction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 190 LOCTR Instruction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 191 LTORG Instruction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 193 Literal Pool . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 194 Addressing Considerations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 195 Duplicate Literals . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 195 MNOTE Instruction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 196 OPSYN Instruction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 198 ORG Instruction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 200 POP Instruction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 204 PRINT Instruction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 204 Process Statement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 208 PUNCH Instruction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 208 PUSH Instruction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 209 REPRO Instruction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 210 RMODE Instruction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 211 RSECT Instruction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 212 SPACE Instruction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 213 START Instruction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 214 TITLE Instruction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 215 USING Instruction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 218 How to Use the USING Instruction . . . . . . . . . . . . . . . . . . . . . . . . 219 Base Registers for Absolute Addresses . . . . . . . . . . . . . . . . . . . . . . 220 Contents v
- Page 1: High Level Assembler for MVS & VM &
- Page 4 and 5: Note! Before using this information
- Page 8 and 9: Contents Ordinary USING Instruction
- 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
Contents<br />
CATTR Instruction (MVS and CMS) . . . . . . . . . . . . . . . . . . . . . . . . . 112<br />
CCW and CCW0 Instructions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115<br />
CCW1 Instruction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 116<br />
CEJECT Instruction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118<br />
CNOP Instruction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119<br />
COM Instruction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121<br />
COPY Instruction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122<br />
CSECT Instruction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123<br />
CXD Instruction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125<br />
DC Instruction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126<br />
Rules for DC Operand . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128<br />
General Information About Constants . . . . . . . . . . . . . . . . . . . . . . . 129<br />
Padding and Truncation of Values . . . . . . . . . . . . . . . . . . . . . . . . . 130<br />
Subfield 1: Duplication Factor . . . . . . . . . . . . . . . . . . . . . . . . . . . 132<br />
Subfield 2: Type . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133<br />
Subfield 3: Type Extension . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134<br />
Subfield 4: Program type . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 135<br />
Subfield 5: Modifier . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136<br />
Subfield 6: Nominal Value . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 140<br />
DROP Instruction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 172<br />
DS Instruction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 174<br />
DSECT Instruction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 178<br />
DXD Instruction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 180<br />
EJECT Instruction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 181<br />
END Instruction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 182<br />
ENTRY Instruction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 183<br />
EQU Instruction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 184<br />
Using Conditional Assembly Values . . . . . . . . . . . . . . . . . . . . . . . . 187<br />
EXITCTL Instruction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 187<br />
EXTRN Instruction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 189<br />
ICTL Instruction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 189<br />
ISEQ Instruction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 190<br />
LOCTR Instruction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 191<br />
LTORG Instruction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 193<br />
Literal Pool . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 194<br />
Addressing Considerations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 195<br />
Duplicate Literals . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 195<br />
MNOTE Instruction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 196<br />
OPSYN Instruction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 198<br />
ORG Instruction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 200<br />
POP Instruction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 204<br />
PRINT Instruction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 204<br />
Process Statement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 208<br />
PUNCH Instruction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 208<br />
PUSH Instruction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 209<br />
REPRO Instruction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 210<br />
RMODE Instruction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 211<br />
RSECT Instruction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 212<br />
SPACE Instruction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 213<br />
START Instruction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 214<br />
TITLE Instruction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 215<br />
USING Instruction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 218<br />
How to Use the USING Instruction . . . . . . . . . . . . . . . . . . . . . . . . 219<br />
Base Registers for Absolute Addresses . . . . . . . . . . . . . . . . . . . . . . 220<br />
Contents<br />
v