Meta-Assembler (MASM) Programming Reference Manual

More documents

Recommendations

Info

MASM Usage 2-8 Example 1. @MASM,LEFV source input,source output 2. MASM xxRyy 3. I FLAG GENERATED AT LINE 1 4. I 0 000000 74 06 00 00 0 000000 1. 1 DDDK 5. -1 6 U FLAG GENERATED AT LINE 2 7. U 000000000000 2. 1+ LAB1 $EQU XREF 8. ** BITS 72-0 + XR XREF 9. -2,2 10. 000001 000000000024 3. 3 + 20 11. 4. 4 $END . Comments 12. 13. LOCATION COUNTERS: $(0) 000002 $(1) 000000 14. -------------------------------------------------------------- 15. PROCEDURE LIBRARY SEARCH TABLE 16. -------------------------------------------------------------- . . . 28. CROSS REFERENCE LISTING 29. ASSEMBLY SYMBOL USAGE X-ETERNAL, L-LABEL, S-SAMPLE/CONDITIONAL LABEL 30. D-DUPLICATED VALUE, N-NODE REFERENCE, P-PROCEDURE, F-FUNCTION, U-UNDEFINED 31. DDDK 1D 32. LAB1 2* 33. XREF 2 34. ASSEMBLY CONTAINS ERRORS: - FLAGS: IU 35. END MASM - LINES: 8 TIME: 2.111 STORAGE: 8028 ERRORS: I(1) /U(1) Explanation Line 1 MASM call line. Line 2 MASM sign-on line showing the product level, date, and time. Line 3 Error walkback information generated using the E option. Line 4 Shows the breakdown of the listing fields (see 2.2.1). Line 5 Line number generated in field 4 due to the V option on the MASM call line. Line 6 Warning walkback information generated using the F option. 7830 8269-001
Line 7 Line 8 Line 11 Line 13 Line 15 Line 28 Line 35 7830 8269-001 MASM Usage The U flag is generated in field 1, and field 3 (controlled by the O option) contains a zero. The four instruction fields are also shown. Relocation information generated, using the R option. A space-period-space construct begins the comment field (see 2.3.1). Location counter information. A table (in search order) of the library files that MASM searched to resolve references (see 2.4.1). The L or Y option produces the cross-reference listing at the end of the assembly. The END MASM line showing diagnostic flags and processor information. 2.2.4. Cross-Reference Listing When the L or Y option is on the MASM call line, a cross-reference listing is produced. It is derived from the MASM dictionary on the second pass of the assembly and includes label definitions, symbol references, and register usage. The following rules determine if a reference is placed in the cross-reference listing: Only references looked for or found at level 0 (external) or level 1 of the main assembly are entered. This includes references in procedures and functions. All labels in the source input are included in the cross-reference listing. Labels that are defined at level 0 or 1 of the main assembly are defined with X or L. All other labels (that is, labels defined below level 1 and in unprocessed conditional code) are listed with S. Cross-reference is called on the second assembly pass, so tags defined or referenced only on the first pass are not entered. Label definitions from $INCLUDE elements or procedure definition processor (PDP) procedures are not listed. All labels defined or referenced inside procedures follow the first two rules in this list. Symbols encountered while skipping for $IF or $GO are not entered. Labels inside skipped conditional code are entered with S. Symbols within quoted strings and comment lines (with or without the space-period-space construct) are not listed. MASM directives and instruction mnemonics are not listed. 2-9
Page 1 and 2: OS 1100 Meta-Assembler (MASM) Progr
Page 3 and 4: Contents About This Manual . . . .
Page 5 and 6: Section 6. Assembly-Time Controls C
Page 7 and 8: Contents 10.4.5. $IMPORT Directive
Page 9: Contents C.9. Global Relational Ope
Page 13: Tables 1-1. MASM Directives . . . .
Page 16 and 17: About This Manual Prerequisites xvi
Page 18 and 19: About This Manual xviii Section 13.
Page 20 and 21: About This Manual Notation Conventi
Page 22 and 23: Introduction 1.1. Two-Pass Assemble
Page 24 and 25: Introduction 1.4. Summary of MASM D
Page 26 and 27: Introduction 1-6 Table 1-1. MASM Di
Page 28 and 29: Introduction 1-8 Table 1-2. MASM Fu
Page 31 and 32: Section 2 MASM Usage 7830 8269-001
Page 33 and 34: 7830 8269-001 Table 2-1. MASM Optio
Page 35 and 36: 2.1.2. Reusability 7830 8269-001 MA
Page 37: 2.2.2. Preamble Output 7830 8269-00
Page 41 and 42: 7830 8269-001 MASM Usage Note: The
Page 43 and 44: 7830 8269-001 Explanation The follo
Page 45 and 46: 7830 8269-001 Example 2 . A COMMENT
Page 47 and 48: 7830 8269-001 4. MASM symbols MASM
Page 49 and 50: 7830 8269-001 MASM Usage In the obj
Page 51 and 52: 7830 8269-001 MASM Usage It is not
Page 53 and 54: 2.3.4. Line Continuation 7830 8269-
Page 55 and 56: 2.4.1. Procedure Library Search Cha
Page 57 and 58: 2.5. Procedure Library Search Table
Page 59 and 60: Section 3 Listing Control 7830 8269
Page 61 and 62: 3.4. Page Ejection 7830 8269-001 Li
Page 63 and 64: 3.8. $HDG — Specify Print Heading
Page 65: 3.9. Listing Control Example 7830 8
Page 68 and 69: Values and Expressions 4.2. Values
Page 70 and 71: Values and Expressions 4.2.1.2. Rel
Page 72 and 73: Values and Expressions 4-6 Example
Page 78 and 79: Values and Expressions 4-12 The tra
Page 84 and 85: Values and Expressions 4.2.4. Nodes
Page 88 and 89:
Values and Expressions 4-22 Example
Page 90 and 91:
Page 92 and 93:
Values and Expressions 4-26 Line 14
Page 94 and 95:
Page 96 and 97:
Page 98 and 99:
Values and Expressions 4-32 Line 9
Page 100 and 101:
Values and Expressions 4-34 The rel
Page 102 and 103:
Values and Expressions 4-36 These o
Page 104 and 105:
Values and Expressions 4-38 Table 4
Page 106 and 107:
Values and Expressions 4.4. Data Ty
Page 108 and 109:
Values and Expressions 4-42 Table 4
Page 110 and 111:
Data Generation 5.1. Signed Charact
Page 112 and 113:
Data Generation 5.3. $GEN — Data
Page 114 and 115:
Data Generation 5-6 Example 2 1. FA
Page 116 and 117:
Data Generation 5.5.4. $ILCN — In
Page 118 and 119:
Data Generation 5.6. $LIT — Liter
Page 120 and 121:
Data Generation 5-12 Line 7 Line 8
Page 123 and 124:
Section 6 Assembly-Time Controls 78
Page 125 and 126:
7830 8269-001 Example 1 $IF A . . a
Page 127 and 128:
7830 8269-001 Example 3 1. $IF A>0
Page 129 and 130:
6.2.3. $REPEAT — Repeat a Stateme
Page 131 and 132:
6.3. $NIL — No Action 7830 8269-0
Page 133 and 134:
6.7. Procedures and Functions 7830
Page 135 and 136:
6.7.1.2. $END — End of a Subassem
Page 137 and 138:
7830 8269-001 Assembly-Time Control
Page 139 and 140:
7830 8269-001 Assembly-Time Control
Page 141 and 142:
7830 8269-001 This function can the
Page 143 and 144:
6.7.8. Types of Procedures 7830 826
Page 145 and 146:
7830 8269-001 Figure 6-1. Two-Pass
Page 147 and 148:
7830 8269-001 Figure 6-2. One-Pass
Page 149 and 150:
7830 8269-001 Figure 6-3. Words-Giv
Page 151 and 152:
6.7.9.1. $FP — Final Pass 7830 82
Page 153 and 154:
6.8. Microstrings 7830 8269-001 Ass
Page 155 and 156:
6.9. Levelers 7830 8269-001 Assembl
Page 157 and 158:
7830 8269-001 Then the procedure P
Page 159 and 160:
Section 7 Dictionary Control 7830 8
Page 161 and 162:
7.2. $DELETE — Delete a Definitio
Page 163 and 164:
7.4. $IC(e) — Identifier Class 78
Page 165 and 166:
7.6. $LEV — Principal Dictionary
Page 167 and 168:
Line 5 Line 6 Line 14 7830 8269-001
Page 169 and 170:
Line 12 Line 6 Line 7 Line 8 Line 9
Page 171 and 172:
Section 8 Processor Information Fun
Page 173 and 174:
7830 8269-001 Processor Information
Page 175 and 176:
Section 9 MASM Output 7830 8269-001
Page 177 and 178:
9.3.2. Common Block (Group 2) 7830
Page 179 and 180:
7830 8269-001 MASM Output identifie
Page 181:
9.3.12. Library Search File (Group
Page 184 and 185:
Object Modules 10.1. $OBJ — Selec
Page 186 and 187:
Object Modules 10.3.1.1. Bank Type
Page 188 and 189:
Object Modules 10.3.1.4. Locality A
Page 190 and 191:
Object Modules 10-8 Equivalent to a
Page 192 and 193:
Object Modules 10.3.1.9. Merge Orde
Page 194 and 195:
Object Modules 10.3.1.13. Additiona
Page 196 and 197:
Object Modules 10-14 Attribute Fiel
Page 198 and 199:
Object Modules 10-16 A $(0) occurs
Page 200 and 201:
Object Modules 10.4.1.2. Strength A
Page 202 and 203:
Object Modules 10.4.1.4. Storage At
Page 204 and 205:
Object Modules 10.4.3. Library Sear
Page 206 and 207:
Object Modules 10.5. Definitions 10
Page 208 and 209:
Object Modules 10.5.1.4. Address Ty
Page 210 and 211:
Object Modules 10.5.3. Default Valu
Page 212 and 213:
Object Modules 10.6.2. Extended Mod
Page 214 and 215:
Object Modules 10.6.4. Standard Pro
Page 216 and 217:
Object Modules 10.6.4.4. Extended M
Page 218 and 219:
Object Modules 10.8. Library Defini
Page 220 and 221:
Object Modules 10-38 The available
Page 222 and 223:
Object Modules 10.9.2. Collector-De
Page 224 and 225:
Symbolic Output 11.2. $OUTPUT — O
Page 226 and 227:
Symbolic Output 11-4 Line 4 Line 5
Page 228 and 229:
Saving Definitions 12-2 In this cas
Page 230 and 231:
Saving Definitions 12-4 Example 1 $
Page 232 and 233:
Error and Warning Diagnostics 13-2
Page 234 and 235:
OS 1100 Features A-2 f j a Mnemonic
Page 236 and 237:
OS 1100 Features A-4 Note: MASM doe
Page 238 and 239:
OS 1100 Features A.2.4.2. $EXTEND D
Page 240 and 241:
OS 1100 Features A.2.5. $EXTEND Mod
Page 242 and 243:
OS 1100 Features A.2.7. $BASE Direc
Page 244 and 245:
OS 1100 Features A-12 Example 2 The
Page 246 and 247:
OS 1100 Features A-14 Example 1 The
Page 248 and 249:
OS 1100 Features A-16 Line 8 Line 9
Page 250 and 251:
OS 1100 Features A-18 For the $EXTE
Page 252 and 253:
OS 1100 Features A.2.13. $PROC Dire
Page 254 and 255:
OS 1100 Features A.2.15. $MACH Dire
Page 256 and 257:
OS 1100 Features A-24 Example 4 $MA
Page 258 and 259:
Object Module Evolution B.1. OM$DEF
Page 260 and 261:
Object Module Evolution B-4 OMDEF$
Page 262 and 263:
Object Module Evolution B-6 Standar
Page 264 and 265:
Object Module Evolution B-8 Dropped
Page 266 and 267:
Object Module Evolution B.3. MASM 5
Page 268 and 269:
Object Module Evolution B.4. MASM 6
Page 270 and 271:
Incompatibilities with ASM C.4. INF
Page 272 and 273:
Incompatibilities with ASM C.13.Pro
Page 274 and 275:
Restrictions, Operational Considera
Page 276 and 277:
Glossary base register One of sixte
Page 278 and 279:
Glossary M MAP MASM MSU O Glossary-
Page 280 and 281:
Glossary X X register See index reg
Page 283 and 284:
Index Symbols $(e) function, 5-6 $A
Page 285 and 286:
$FP function description of, 6-20 u
Page 287 and 288:
$RES directive, 5-6 $SL function, 4
Page 289 and 290:
B of reference, 10-13 OM$DEF in UCS
Page 291 and 292:
C character conversion functions, 4
Page 293 and 294:
conversion issues (See compatibilit
Page 295 and 296:
$CROSSREF, 3-3 $DEF, 12-1, 12-2 $DE
Page 297 and 298:
with integer values, 4-2 eject page
Page 299 and 300:
form bank attributes, 10-11, 10-12
Page 301 and 302:
global relational operators, C-3 gr
Page 303 and 304:
field, 2-11, 2-14 integer item, 4-2
Page 305 and 306:
number function, 5-7 odd, 10-12 pro
Page 307 and 308:
mode basic (See basic mode) mode ex
Page 309 and 310:
operation mnemonics dictionary leve
Page 311 and 312:
precedence of operators (See operat
Page 313 and 314:
elational operator description of,
Page 315 and 316:
semicolon, as continuation characte
Page 317 and 318:
interaction, A-17 with $ILCN, subfi
Page 319 and 320:
Universal Compiling System (UCS), B
show all

Meta-Assembler (MASM) Programming Reference Manual

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

Delete template?

Save as template?