home *** CD-ROM | disk | FTP | other *** search
/ HomeWare 14 / HOMEWARE14.bin / prog / a86v371.arj / A14.DOC < prev    next >
Text File  |  1994-01-24  |  33KB  |  730 lines

  1. CHAPTER 14   DESCRIPTIONS OF A86 ERROR MESSAGES
  2.  
  3.  
  4. ~01 Unknown Mnemonic~
  5.  
  6.    Most assembly-language lines start with a built-in instruction
  7.    mnemonic such as MOV or ADD.  The only circumstances in which
  8.    a line can start with a non-built-in symbol are if the symbol
  9.    is a macro name or INT equate, or if the symbol is now being
  10.    defined, as indicated by a limited set of following symbols: a
  11.    colon, EQU, DB, DW, etc.  This line started with a
  12.    non-built-in symbol which did not fall into any of the above
  13.    categories.  You might have misspelled an instruction
  14.    mnemonic, or misspelled the following word.
  15.  
  16. ~02 Jump > 128~
  17.  
  18.    The destination operand of a conditional jump must be a label
  19.    within 128 bytes of the end of the instruction.  (Precisely,
  20.    from -128 to +127 from the next instruction, which is from
  21.    -126 to +129 from the start of the conditional jump.)  This
  22.    error can also occur from an unconditional JMP to a
  23.    forward-referenced local label, since A86 assumes the short
  24.    JMP form in that case.  This error is reported in three
  25.    possible places:
  26.  
  27.     1. At the jump.  The operand is more than 126 bytes before
  28.        the jump, or the operand is not a label (e.g. you tried an
  29.        indirect conditional jump through a variable, which isn't
  30.        allowed)
  31.  
  32.     2. At a label definition.  In this case, you use your editor
  33.        to search backwards for references to the label.  One or
  34.        more of the earliest conditional jumps found are too far
  35.        away.
  36.  
  37.     3. At a RET, RETF, or IRET instruction.  You use your editor
  38.        to search backwards for that flavor of RET used as the
  39.        operand to a conditional jump (the A86 conditional return
  40.        feature). The earliest such jumps not satisfied by a
  41.        previous RET are too far away.
  42.  
  43.    You usually correct this error by rearranging your code, or
  44.    (better) by breaking intervening code off into subroutines. If
  45.    desperate, you can replace "Jcond" with "IF cond JMP".
  46.  
  47. ~03 [BX+BP] And [SI+DI] Not Allowed~
  48.  
  49.    The 86 instruction set does not support the combinations of
  50.    indexing registers indicated in the error message.  In
  51.    previous versions of A86, this error was reported in other
  52.    illegal operand combinations; I've attempted to change other
  53.    cases to error 14.  If you ever find otherwise, please let me
  54.    know.
  55.  
  56. ~04 Bad Character In Number~
  57.                                                              14-2
  58.  
  59.    All numbers, and only numbers, start with a decimal digit.
  60.    (It's illegal to have a symbol begin with a digit; e.g.
  61.    01MYVAR .)   You have coded something that starts with a
  62.    decimal digit but does not have the correct format for a
  63.    numeric constant.  See Chapter 8 for detailed descriptions of
  64.    the formats of both integer and floating constants.
  65.  
  66. ~05 Operands Not Allowed~
  67.  
  68.    When this error is reported it usually means that you have
  69.    provided something more than just the mnemonic for an
  70.    instruction that does not have any operands: e.g., PUSHF,
  71.    STOSB, STC, FLDPI, CLTS.  It's also called in other contexts
  72.    when the assembler expects nothing more on the line; e.g.,
  73.    NAME with more than just a single name following, or something
  74.    following the word ENDS.
  75.  
  76. ~06 Symbol Required~
  77.  
  78.    This is reported in numerous situations where A86 requires
  79.    some sort of symbol: either a built-in assembler mnemonic, or
  80.    a symbol you define.  (It's possible that a number or some
  81.    punctuation marks are legal in the context, and that they have
  82.    already been checked for.)  Instead of a symbol, a punctuation
  83.    mark or out-of-context number was seen.  The contexts in which
  84.    this error can occur include:
  85.  
  86.     * the start of a line (characters hex 3C or greater)
  87.  
  88.     * after the following at the start of a line: a symbol you
  89.        define, #, #IF, IF, CODE, or DATA
  90.  
  91.     * where operands to the following directives are expected:
  92.        NAME, PUBLIC, EXTRN, GROUP, SEGMENT
  93.  
  94.     * after ">" denoting a local-label forward reference
  95.  
  96. ~07 Local Symbol Required~
  97.  
  98.    This is reported when something other than a generic local
  99.    label (letter followed by one or more digits) follows a ">"
  100.    mark, which denotes a local-label forward reference.  If you
  101.    meant "greater than" you use the GT operator instead.
  102.  
  103. ~08 Too Many Operands~
  104.  
  105.    This is reported for instructions and directives requiring a
  106.    limited number of operands, for which the limit is exceeded.
  107.    Since operands are separated by commas, you have too many
  108.    commas-- possibly an extra comma between the mnemonic and
  109.    first operand, or at the end of the operands.
  110.  
  111. ~09 Constant Required~
  112.                                                              14-3
  113.  
  114.    This is reported for instructions and directives (ENTER, RET,
  115.    RADIX, etc.) requiring operands that are an immediate constant
  116.    number; and for expression operators (*, /, SHL, OR, NOT, BY,
  117.    etc.) whose operands must be constant.  In some cases a
  118.    limited number of forms other than constants are acceptable,
  119.    but the assembler has already checked for and not found those
  120.    possibilities.
  121.  
  122. ~10 More Operands Required~
  123.  
  124.    This is reported for instructions requiring two operands, for
  125.    which you have provided no operands or only one operand.  You
  126.    might have left out the comma separating the operands.
  127.  
  128. ~11 Constant/Label Not Allowed~
  129.  
  130.    This is reported when you have given a constant number in a
  131.    place where it isn't allowed-- usually as a destination
  132.    operand to an instruction, such as the first operand to a MOV
  133.    or ADD.  If you meant the operand to be the memory location
  134.    with the constant offset, you must convert the type by
  135.    enclosing the operand in brackets [ ] or appending a
  136.    size-specifier (B, W, D, Q, or T) to the number.
  137.  
  138. ~12 Segment Register Not Allowed~
  139.  
  140.    This is reported when you have used a segment register in an
  141.    instruction where it isn't allowed.  The only instructions
  142.    allowing segment registers as operands are MOV, PUSH, and POP.
  143.    You can't, for example, ADD into a segment register.  If you
  144.    want to do anything with a segment register value, you have to
  145.    MOV it into a general register, perform the operation, then
  146.    MOV the result back to the segment register.
  147.  
  148. ~13 Byte/Word Combination Not Allowed~
  149.  
  150.    This is reported in a two-byte instruction in which one
  151.    operand is byte-sized and the other word-sized; or in an
  152.    instruction with a byte-sized destination and an immediate
  153.    source whose value is not byte-sized (high byte not 0 or 0FF).
  154.    If one of the operands is a memory variable of the wrong size,
  155.    you either change the declaration of the variable (DB to DW or
  156.    vice versa) or override the size of the variable in this
  157.    instruction only, by appending a " B" or " W" to the memory
  158.    operand.
  159.  
  160. ~14 Bad Operand Combination~
  161.  
  162.    This is reported when you attempt to add or combine terms in
  163.    an operand expression that do not allow combination.  An
  164.    example of this would be DT 3.7+BX.  Only constants can be
  165.    added to floating point numbers.
  166.  
  167.    This is also reported when you have two operands that are
  168.    mismatched in size, and the mismatch is something other than
  169.    Byte vs. Word. Example: MOV AL,D[0100].
  170.                                                              14-4
  171.  
  172. ~15 Bad Subtraction Operands~
  173.  
  174.    This is reported when you attempt to subtract terms in an
  175.    operand expression that do not allow subtraction, or if the
  176.    right-hand side to a subtraction is missing.  If the
  177.    right-hand side to a subtraction is a non-forward-referenced
  178.    constant, then the left side can be almost anything.
  179.    Otherwise, the operands must match; e.g., labels from
  180.    relocatable segments must be in the same segment (in which
  181.    case the answer is an absolute constant; namely, the size of
  182.    the block of memory between the two labels).
  183.  
  184. ~16 Definition Conflicts With Forward Reference~
  185.  
  186.    This error occurs when the assembler has previously guessed
  187.    the type of a forward-referenced symbol in order to determine
  188.    what kind of instruction to generate, and the guess turned out
  189.    to be wrong.  The error is reported at the time the symbol is
  190.    defined.  For example, when A86 sees MOV AX,FOO, it will
  191.    assume FOO is an immediate value.  This error is reported if
  192.    FOO turns out to be a word variable: FOO DW 0.  You need to
  193.    search backwards from the error message, to references of FOO,
  194.    and specify the type you intend to be used: MOV AX,FOO W.  If
  195.    you really did intend to load the offset of FOO and not the
  196.    memory contents, you can code MOV AX,OFFSET FOO to make the
  197.    error message go away.
  198.  
  199. ~17 Divide Overflow~
  200.  
  201.    This is reported when the right-hand side to a division or MOD
  202.    operation is zero, or when the result of a division by a large
  203.    (>64K) number is still large.
  204.  
  205. ~18 Same Type Required~
  206.  
  207.    This is reported when the two operands to a relational
  208.    operator (EQ, NE, GT, GE, LT, or LE) are of different types.
  209.    The operands to a relational operator ought to be both
  210.    absolute integer constants, or labels in the same segment.
  211.  
  212. ~19 CS Destination Not Allowed~
  213.  
  214.    This is reported if you attempt to specify CS as the
  215.    destination (first) operand to MOV, or as an operand to POP.
  216.    The only acceptable way to load CS on the 8086 is via a far
  217.    JMP, CALL, RETF, or IRET instruction.  The MOV and POP forms
  218.    don't make much sense, so they were outlawed by Intel.
  219.  
  220. ~20 Left Operand Not Allowed~
  221.  
  222.    This is reported if you have a left-hand side to an expression
  223.    operator that expects only a single operand to its right.
  224.    Those operators are BIT, NOT, OFFSET, TYPE, LOW, HIGH, SHORT,
  225.    LONG, and INT.  (The mnemonic INT is considered an operator
  226.    e.g., in MSDOS EQU INT 33.)  For example, you would get this
  227.    error for the expression 1 NOT 2.
  228.                                                              14-5
  229.  
  230. ~21 Bad Single Operand~
  231.  
  232.    This is reported if the operand is inappropriate for an
  233.    instruction INC, DEC, PUSH, POP, NOT, NEG, MUL, IMUL, DIV, or
  234.    IDIV, that takes a single operand.  You should look up the
  235.    instruction in the chart in Chapter 6, to determine the proper
  236.    operand forms allowed.
  237.  
  238. ~22 Bad DUP Usage~
  239.  
  240.    This is reported when a DUP construct occurs out of context
  241.    (e.g. in an instruction operand instead of a data
  242.    initialization); when the total number of bytes generated
  243.    would push the output pointer beyond 64K; or when there is
  244.    improper syntax for a DUP.  See Chapter 9 for the description
  245.    of correct DUP usage.
  246.  
  247. ~23 Number Too Large~
  248.  
  249.    This is reported when a numeric constant is too large for the
  250.    assembler to store in its operand buffers-- the limit for
  251.    integers is 2**80-1 = 1208925819614629174706175 decimal. The
  252.    error is also given when the exponent part of a floating point
  253.    constant is greater than 65535 in magnitude.
  254.  
  255. ~24 SEGMENT or ENDS Required~
  256.  
  257.    This is reported if a line beginning with one of the two A86
  258.    reserved symbols CODE or DATA does not continue with one of
  259.    the reserved symbols SEGMENT or ENDS.  If you meant CODE or
  260.    DATA to be a symbol you define, you have to change the name to
  261.    something else, like _CODE or _DATA.
  262.  
  263. ~25 Bad CALL/JMP Operand~
  264.  
  265.    This is reported if the operand to a call or jump instruction
  266.    cannot be taken as a jump destination.  This occurs if the
  267.    operand is missing, or if it has a size inappropriate for
  268.    address pointers: byte, quadword, or ten-byte.  The error also
  269.    occurs if the operand is a constant number, and you are
  270.    assembling to an OBJ format.  In OBJ format anything jumped to
  271.    within a segment must be specified as a label within some
  272.    segment.
  273.  
  274. ~26 Memory Doubleword Required~
  275.  
  276.    This is reported if the second operand to an LDS, LES, or
  277.    BOUND instruction is of the wrong type.  The operand should be
  278.    a doubleword memory quantity; but A86 will accept a word
  279.    memory variable or a memory variable of unspecified size.
  280.  
  281. ~27 Bad IN/OUT Operand~
  282.  
  283.    This is reported when the operands to IN or OUT do not have
  284.    the correct form.  See Chapter 6 for the limited set of forms
  285.    for these instructions.  One of the operands must be AL or AX;
  286.    the other must be DX or a constant between 0 and 255.
  287.                                                              14-6
  288.  
  289. ~28 type Required~
  290.  
  291.    This is reported when a symbol given in an EXTRN list is not
  292.    followed one of the type names B, W, D, Q, T, F, NEAR, or ABS.
  293.    The more verbose synonyms BYTE, WORD, DWORD, QWORD, and TBYTE
  294.    are also acceptable.
  295.  
  296. ~29 Bad Rotate/Shift Operand~
  297.  
  298.    This is reported when the count (second) operand to a rotate
  299.    or shift instruction is not appropriate: it should be either
  300.    the name CL or a constant less than 32.  The instructions
  301.    requiring this are ROL, ROR, RCL, RCR, SHL, SHR, SAL, SAR, and
  302.    the NEC-specific instructions SETBIT, TESTBIT, CLRBIT, and
  303.    NOTBIT.
  304.  
  305. ~30 Byte-Sized Constant Required~
  306.  
  307.    This is reported in contexts where only a byte-sized absolute
  308.    constant is acceptable.  Those contexts are: the operand to a
  309.    BIT or INT operator in an expression; the required operand to
  310.    an INT or CALL80 instruction; the optional operand to an AAM
  311.    or AAD instruction.
  312.  
  313. ~31 Instruction In Data Segment Not Allowed~
  314.  
  315.    There are only a limited number of directives allowed with a
  316.    STRUC or a DATA segment.  This error is reported when any
  317.    instructions or disallowed directives are seen in one of these
  318.    restricted environments.  You have possibly neglected to
  319.    provide an ENDS directive, returning you to normal assembly.
  320.    In a STRUC, the only directives allowed are DB, DW, DD, DQ,
  321.    DT, another STRUC, ENDS, EQU, SEGMENT, GROUP, MACRO, LABEL,
  322.    EVEN, and ORG.  The DATA segment allows the same directives,
  323.    plus PROC, ENDP, DATA, and CODE.
  324.  
  325. ~32 Bad String~
  326.  
  327.    This is reported when you start a quoted string, and do not
  328.    provide the closing quote in the same line.  You might have
  329.    left it out; or you might not have intended to code a string
  330.    at all, and accidentally inserted a single- or double-quote
  331.    mark in your line.  Or you might have intended a string
  332.    containing an end-of-line, which isn't allowed.  You must
  333.    instead close the string and code hex bytes 0D,0A to represent
  334.    an end-of-line.
  335.  
  336. ~33 Bad Data Operand~
  337.  
  338.    This is reported if an inappropriate operand is seen in a data
  339.    initialization (DB, DW, DD, DQ, or DT) directive.  Examples of
  340.    this are indexed quantities such as [BX], non-byte quantities
  341.    in a DB, or floating point constants in a DB or DW.
  342.  
  343. ~34 Index Brackets Required~
  344.                                                              14-7
  345.  
  346.    This is reported if the name of a register is given in an
  347.    addition/combination operation, but the register is not
  348.    enclosed in square brackets.  The only registers that may be
  349.    added are those presented as indexing registers.  For example,
  350.    don't code BX+2, code [BX+2].
  351.  
  352. ~35 Bad Character~
  353.  
  354.    This is reported when a punctuation mark or other non-standard
  355.    character is seen where it is not expected.  The characters
  356.    causing this error at the beginning of a line are digits, and
  357.    the marks  / - , + * ( ) & " !   --  other illegal marks at
  358.    the start of a line cause error 6, Symbol Required.  The
  359.    characters causing this error elsewhere (i.e. within operands)
  360.    are all characters except letters, digits, and the marks [ ] +
  361.    - ' " > ( ) * . / :
  362.  
  363. ~36 String > 2 Not Allowed~
  364.  
  365.    This is reported when a string with 3 or more characters is
  366.    seen outside of the places where such a string is allowed (in
  367.    a DB directive, macro operand, or relocatable SEGMENT
  368.    directive).  One- and two-character strings are treated as
  369.    simple numeric constants; but longer strings require special
  370.    handling and are allowed only in the places mentioned.
  371.  
  372. ~37 Misplaced Built-In Symbol~
  373.  
  374.    The symbol just before this error message is an A86 built-in
  375.    symbol, that is in a place where it doesn't belong.  Examples
  376.    of this are: mnemonics such as MOV occurring in operands; and
  377.    symbols that aren't mnemonics such as LT occurring at the
  378.    start of the line.  If you thought you could define the symbol
  379.    to the left of this message for your own use, you were wrong.
  380.    You need to change the symbol to something else: TEST to
  381.    _TEST, for example.  If you'd like to know the built-in
  382.    meaning of the symbol, you can look it up in Chapter 16.
  383.  
  384. ~38 Segment Combination Not Allowed~
  385.  
  386.    This is reported when you attempt to add or combine a segment
  387.    or group name with another quantity.  A86 currently doesn't
  388.    allow this.
  389.  
  390. ~39 Bad Index Register~
  391.  
  392.    This is reported when you attempt to use a register other than
  393.    SI, DI, BX, or BP for indexing.  Those are the only registers
  394.    that the 86 architecture allows you to place inside brackets,
  395.    to address memory.
  396.  
  397. ~40 Conflicting Multiple Definition Not Allowed~
  398.                                                              14-8
  399.  
  400.    This is reported when you define a symbol in two places in
  401.    your program, and the definitions aren't the same.  Most often
  402.    you have simply forgotten you already had a symbol somewhere
  403.    of the same name, and you need to change the name of one of
  404.    the two symbols you've defined.  A86 allows the re-use of a
  405.    symbol if it is a generic local label (a letter followed by
  406.    one or more digits), or if is defined with = instead of EQU.
  407.    A86 also allows the redefinition of a symbol if it has exactly
  408.    the same value (e.g. ESC EQU 01B in two places in your
  409.    program).  See the section "Duplicate Definitions" in Chapter
  410.    9 for a detailed discussion of this feature.
  411.  
  412. ~41 ENDS Has No Segment~
  413.  
  414.    This error occurs when A86 is assembling to an OBJ file, and
  415.    it sees an ENDS at the outermost level of segments-- the ENDS
  416.    has not been preceded by a matching SEGMENT directive.  You
  417.    need to look over your SEGMENT and ENDS directives, to get
  418.    them to match up properly.
  419.  
  420. ~42 Bad IF Operand~
  421.  
  422.    This is reported when an IF is not followed by one of the
  423.    flag-mnemonics (e.g., E, Z, NC, AE, etc.) that follow "J" in a
  424.    conditional jump instruction.  Most likely the line is a
  425.    conditional assembly line intended for another assembler.  In
  426.    A86, conditional assembly lines begin with a hash sign #.  So
  427.    you change IF, ELSE, ENDIF to #IF, #ELSE, #ENDIF.  You may
  428.    also need to change the condition following IF: IF FOO EQU 0
  429.    becomes #IF !FOO; IFDEF FOO becomes simply #IF FOO. IF
  430.    (expression) must be replaced by the two lines C1 EQU
  431.    (expression) followed by #IF C1 .  See Chapter 11 for the
  432.    details of A86's syntax for conditional assembly.  See Chapter
  433.    5 for the way A86 uses IF when it doesn't have a hash sign #.
  434.  
  435. ~43 Parenthesis/Bracket Mismatch~
  436.  
  437.    This is reported when there is a lack of balance of
  438.    parentheses ( ) or brackets [ ] in an operand expression--
  439.    there are too many left-sides, too many right-sides, or the
  440.    brackets are interleaved illegally: ( [ ) ].  Most likely you
  441.    have left out an opening or closing parenthesis/bracket in a
  442.    complicated expression; or a spurious extra ( ) [ or ] has
  443.    crept into your code.
  444.  
  445. ~44 Bad Forward Reference Combination~
  446.  
  447.    This is reported when you try to use forward references in
  448.    expressions that are too complicated for A86 to handle.  You
  449.    can add or subtract constants from forward-referenced symbols;
  450.    but you can't subtract a forward-referenced symbol from
  451.    anything, and you can't add two forward references together.
  452.    You can typically get around restrictions in forward reference
  453.    expressions by moving the expression down to an EQU directive
  454.    after the point that the symbols are defined, and making a
  455.    forward reference to the EQUated symbol that represents the
  456.    evaluated expression.
  457.                                                              14-9
  458.  
  459.    You will often get this error if you forget to put a
  460.    semi-colon before a comment: A86 will interpret your prose as
  461.    the addition of undefined (i.e., forward-referenced) terms.
  462.  
  463.    This error is also reported in some situations involving
  464.    relocatable symbols in OBJ mode -- these symbols are forward
  465.    references in the sense that they are resolved only at link
  466.    time.
  467.  
  468. ~45 Is It Byte Or Word?~
  469.  
  470.    This is reported when you have a memory operand of unspecified
  471.    size, and A86 needs to know whether the operand is byte-sized
  472.    or word-sized, in order to generate the correct instruction
  473.    form.  All you need to do is to append a B or a W to the
  474.    operand, to specify the size you want.  For example, if you've
  475.    coded INC [BX], you need to decide between INC B[BX] and INC
  476.    W[BX].  If you've coded ADD FOO,4 where FOO is a forward
  477.    reference, you need to specify ADD FOO B,4 or ADD FOO W,4 .
  478.  
  479. ~46 Bad #-Construct~
  480.  
  481.    This is reported if, within a macro definition, a # is seen
  482.    that is not followed by one of the allowed macro parameter
  483.    constructs described in Chapter 11.  Even in quoted strings,
  484.    the hash sign # must be literalized via ## if it is to be
  485.    taken as-is.
  486.  
  487.    If you mistakenly provide a macro-loop variable (#W, #X, #Y,
  488.    or #Z) outside of any loop defining that variable, this error
  489.    is detected when the macro is expanded, even though the error
  490.    is in the macro definition.
  491.  
  492.    The error is also reported if # occurs at the beginning of a
  493.    line, and is not followed by IF, ELSEIF, ELSE, or ENDIF; or if
  494.    a conditional assembly parameter is a built-in mnemonic e.g.
  495.    #IF MOV .  See Chapter 11 for the correct usage of the hash
  496.    sign in both macros and conditional assembly.
  497.  
  498. ~47 #ENDIF Required~
  499.  
  500.    This is reported if you have an #IF without a corresponding
  501.    #ENDIF before the end of the file (or the end of the macro
  502.    expansion if the #IF was assembled during a macro expansion).
  503.    When this message appears at the end of a file, you need to
  504.    search backwards for #IFs, to find the unclosed block.
  505.  
  506. ~48 #EM Required To End Macro~
  507.  
  508.    This is reported if you have a MACRO without an end.  In A86,
  509.    the end of a macro is given by #EM.  Most likely your file was
  510.    written for another assembler, and you need to convert macro
  511.    definitions.  You need to change all ENDM directives to #EM.
  512.    You also need to eliminate the named parameters from the MACRO
  513.    line, and replace occurrences of the named parameters with #1,
  514.    #2, #3, etc.  The & concatenation operator can be dropped. See
  515.    Chapter 11 for a full description of A86's macro syntax.
  516.                                                             14-10
  517.  
  518. ~49 End Delimiter to COMMENT Required~
  519.  
  520.    This is reported when the portion of code skipped in a COMMENT
  521.    directive has run to the end of the file, without the closing
  522.    delimiter being found.  You need to search backwards from the
  523.    end of the file to find the COMMENT directive, figure out
  524.    where you intend the directive to end, and duplicate the
  525.    delimiter (the first non-blank following COMMENT) at that
  526.    end-point.  See Chapter 4 for a full description of the
  527.    COMMENT directive.
  528.  
  529. ~50 Reg,Mem Required~
  530.  
  531.    This is reported when you have an improper combination of
  532.    operands for a MOV, XCHG, or general arithmetic instruction
  533.    such as ADD, SUB, CMP, XOR, etc.  Most often you have
  534.    attempted to provide two memory operands: MOV VAR1,VAR2 or ADD
  535.    VAR1,VAR2.  One of the operands must be a register.  You can
  536.    effect the memory-to-memory operation by using a register in a
  537.    two-instruction sequence; for example, MOV AX,VAR2 followed by
  538.    ADD VAR1,AX .  For convenience, A86 lets you code the sequence
  539.    with the single line ADD VAR1,AX,VAR2.
  540.  
  541.    If you don't wish to clobber the contents of any registers,
  542.    and the operands are word-sized, you may PUSH the source
  543.    operand and then POP to the destination operand: PUSH VAR2
  544.    followed by POP VAR1.
  545.  
  546. ~51 Segment Override Not Allowed Here~
  547.  
  548.    For compatibility with other assemblers, A86 allows segment
  549.    override operators CS:, DS:, ES:, or SS: within expressions in
  550.    instruction operands.  The override informs the assembler that
  551.    the named segment register is to be used for the memory
  552.    reference, so that the assembler might generate a segment
  553.    override opcode byte.  This error is reported when a segment
  554.    override operator occurs out of context: in A86's special
  555.    three-operand form for MOV or arithmetic instructions; within
  556.    a DATA segment or STRUC, or in an EQU directive.  You might
  557.    encounter the last case if you're porting a program written
  558.    for another assembler.  If so, you might have to provide
  559.    explicit overrides wherever the EQUated symbol is used.  It's
  560.    possible, though, that the override is provided only to
  561.    satisfy the other assembler's segment checking mechanism, and
  562.    no overrides are generated at all.  In that case, you can just
  563.    eliminate the override operator.
  564.  
  565. ~52 Byte Operand Required~
  566.  
  567.    This is reported when an operand to one of the NEC-specific
  568.    instructions STOBITS, LODBITS, ROL4, ROR4 is of the wrong
  569.    type.  STOBITS and LODBITS require the first operand to be a
  570.    byte-sized register and the second operand to be either a
  571.    byte-sized register or an immediate constant.  ROL4 and ROR4
  572.    require the only operand to be a byte-sized register.
  573.  
  574. ~53 Word Register Required~
  575.                                                             14-11
  576.  
  577.    This is reported when the first operand to any of the
  578.    instructions LDS, LES, LEA, BOUND, IMUL, LAR, or LSL is not a
  579.    word-sized general register (AX,BX,CX,DX,SI,DI,BP, or SP).
  580.  
  581. ~54 Floating-Point Chip Required~
  582.  
  583.    This is reported when you attempt to assemble a program with
  584.    floating point constants or floating point expressions, and
  585.    you do not have a floating point chip (8087 or 287) in your
  586.    computer system.  A86 uses the 87 to assemble constants and do
  587.    arithmetic.  It's time for you to buy a chip and install it in
  588.    that empty socket!
  589.  
  590. ~55 Bad Floating-Point Operand~
  591.  
  592.    This is reported when an operand to a floating point
  593.    instruction is not of the correct type.  See Chapter 7 for the
  594.    correct forms for the instruction you're coding.  Some
  595.    possibilities for the error are:
  596.  
  597.    * a memory operand has unspecified size, or a size not
  598.      compatible with the instruction.  Integer instructions
  599.      (FIxxx) require a W or D operand; floating arithmetic
  600.      instructions require a D or Q operand.
  601.  
  602.    * you've tried to specify an 86 register instead of a memory
  603.      operand.
  604.  
  605.    * you've tried A86's special FLD (constant) form in OBJ mode.
  606.      Sorry, I support this only for COM mode (mainly for D86).
  607.  
  608.    * you've specified two register numbers (0 through 7), but
  609.      neither is 0.
  610.  
  611.    * you've tried one of the disallowed forms FCOM i,0 or FCOMP
  612.      i,0
  613.  
  614. ~56 Constant 0--7 Required~
  615.  
  616.    This is reported if a constant number operand to an 87
  617.    instruction, which is supposed to represent an 87 stack number
  618.    (0 through 7), does not have the right value; i.e., it's not
  619.    an integer, or it's not in the range 0 through 7.
  620.  
  621. ~57 Memory Operand Required~
  622.  
  623.    This is reported when an operand to a floating-point or a 286
  624.    protected-mode instruction must be a memory operand, and the
  625.    operand you've provided isn't one.  See Chapters 7 (for
  626.    floating) or 6 (for protected) for the correct syntax of the
  627.    instruction you're coding.
  628.  
  629. ~58 Segment Or Struc Name Not Allowed~
  630.                                                             14-12
  631.  
  632.    This error occurs most often when you are attempting to
  633.    assemble as a COM program a file intended to be an EXE
  634.    program.  The COM format does not allow you to refer to the
  635.    value of a named segment, or to make a FAR pointer out of a
  636.    label within the program.  You should either use the +O option
  637.    to produce an OBJ file, or simply eliminate the statements
  638.    intended to set the segment registers-- COM programs are
  639.    started with all segment registers already pointing to the
  640.    same value.
  641.  
  642.    This error is also reported when you provide the name of a
  643.    structure, or the name of an INT equate, in a place where a
  644.    register or memory operand is expected.
  645.  
  646. ~59 Word Operand Required~
  647.  
  648.    This is reported when something other than a word-sized
  649.    operand is provided for one of the 286 instructions ARPL,
  650.    SLDT, LLDT, STR, LTR, VERR, VERW, SMSW, or LMSW.
  651.  
  652. ~60 Circular Definition Not Allowed~
  653.  
  654.    This is reported when a chain of macro calls or references to
  655.    undefined symbols reaches a depth of 1024.  A86 assumes that
  656.    it is in an infinite loop: for example, FOO EQU FOO; or BAZ
  657.    MACRO containing an uncontrolled call to BAZ within itself.
  658.  
  659.  
  660. ~61 Overlapping Local Not Allowed~
  661.  
  662.    Recall from Chapter 5 that when you use a local label symbol
  663.    twice, you must distinguish a reference to that symbol by
  664.    prepending a > before the symbol's name if the reference is a
  665.    forward reference.  You get this error if you have followed
  666.    such a forward reference with another reference, without the
  667.    >, before the next incaration of the symbol is defined.
  668.    There's a danger that you intended the reference to be to the
  669.    previous incarnation, which A86 doesn't allow. Example:
  670.  
  671.        L1:            ; first incarnation of L1
  672.             JNZ >L1   ; reference to second incarnation
  673.             JMP L1    ; ERROR-- which incarnation are we referring to?
  674.        L1:            ; second incarnation of L1
  675.  
  676.    If you intended the JMP to be to the second L1, you should
  677.    prepend a > to the L1, just like the JNZ.  If you intended the
  678.    JMP to be to the first L1, you must change one of the two
  679.    label names so that their ranges don't overlap.
  680.  
  681. ~62 Instruction Not Allowed On Your CPU~
  682.                                                             14-13
  683.  
  684.    This is reported when you attempt to assemble an instruction
  685.    not supported for the processor (8086/8088, 186, 286 or later,
  686.    or NEC) for which you are assembling.  The instructions not
  687.    common to all 86 processors are marked with a # or a * in
  688.    Chapter 6.  See Chapter 3 for the discussion of the P switch,
  689.    that allows you to specify the processor for which you are
  690.    assembling.
  691.  
  692. ~97 Object Overflow~
  693.  
  694.    This is reported when the assembler runs out of room in its
  695.    output object-code segment (which also holds records used to
  696.    resolve forward references).  This will happen only if your
  697.    object output nears the object capacity, which is 64K if a
  698.    full amount of memory (about 300K) is available to the
  699.    assembler.  If you have a limited amount of memory, you should
  700.    increase the memory available to A86, by buying another board,
  701.    or by having fewer memory-resident programs installed when you
  702.    run A86.  If you are assembling OBJ files, you can break the
  703.    program into smaller assembled modules.
  704.  
  705.    It's conceivable that this error could result in a D86
  706.    session, when you are using patch-memory mode to type in an
  707.    extremely complicated program.  In that case, you should type
  708.    the program into a text file instead, and use A86 to assemble
  709.    the text file.
  710.  
  711. ~98 Undefined Symbol Not Allowed~
  712.  
  713.    This error should occur only during a D86 debugging session,
  714.    when you type an immediate-execution assembly language line
  715.    containing a symbol not in the table (typically a mistyping on
  716.    your part).  D86 allows you to add symbols to the table only
  717.    when you are in patch-memory mode (reached by pressing the F7
  718.    key).
  719.  
  720. ~99 Symbol Table Overflow~
  721.  
  722.    This is reported when the symbol table runs out of space. It's
  723.    unlikely that you'll ever run into this error, since A86's
  724.    capacity is thousands of symbols.  If you do, you'll need to
  725.    reduce the number of symbols in your program.  One way to do
  726.    so is to replace all place-marker symbols with local labels in
  727.    a limited range (like L0--L9).  See Chapter 5 for a
  728.    description of A86's local label facility.
  729.  
  730.