DOCUMENTATION CHANGES FOR: RDOS/DOS ASSEMBLY LANGUAGE AND PROGRAM UTILITIES PART NUMBER 069-400019-01 THIS FILE (FILENAME 069400019.01) CONTAINS INFORMATION THAT AFFECTS THE FOLLOWING PAGES OF YOUR MANUAL: *43 71 72 *79 *94 *121 138 145 THIS SECOND REVISION OF 069400019.01 WAS UPDATED ON JANUARY 12, 1989. ITEMS APPEARING HERE SINCE THE LAST REVISION ARE EASY TO IDENTIFY: IN THE LIST ABOVE, ASTERISKS (*) MARK PAGES WITH CHANGES PRINTED IN THIS FILE FOR THE FIRST TIME. AND, IN THE MARGIN OF PAGES THAT FOLLOW, CHANGE BARS (|) MARK THE NEW MATERIAL. FOR EXAMPLE, THIS REVISION OF 069400019.01 CONTAINS A CHANGE TO PAGE 43 OF ITS PARENT MANUAL. YOU ARE SEEING THIS CHANGE FOR THE FIRST TIME, AND BARS APPEAR NEXT TO IT. TO KEEP YOUR MANUAL CURRENT, YOU SHOULD DO EITHER OF THE FOLLOWING: O MARK THE AFFECTED PAGES OF YOUR MANUAL SO THAT YOU WILL KNOW TO REFER TO THIS FILE FOR ADDITIONAL INFORMATION. O PRINT THIS FILE, PUNCH HOLES TO FIT YOUR BINDER, AND INSERT THE PAGES INTO YOUR MANUAL. COPYRIGHT (C) DATA GENERAL CORPORATION, 1983-1989 ALL RIGHTS RESERVED LICENSED MATERIAL - PROPERTY OF DATA GENERAL CORPORATION RDOS/DOS ASSEMBLY LANGUAGE AND PROGRAM UTILITIES, 069-400019-01 DOCUMENTATION CHANGES, REVISION 02 12/JAN/89 PAGE 43 | CHANGE THE EXAMPLE IMMEDIATELY ABOVE THE HEADING "ECLIPSE | INSTRUCTIONS" SO THAT IT READS THIS WAY: | | ;INDEXED MR EXAMPLE: | | 035003 LDA 3,3,2 | 031002 LDA 2,2,2 | 021425 LDA 0,TEMP,3 RDOS/DOS ASSEMBLY LANGUAGE AND PROGRAM UTILITIES, 069-400019-01 DOCUMENTATION CHANGES, REVISION 02 12/JAN/89 PAGE 71 INSERT THE FOLLOWING MATERIAL AFTER THE DESCRIPTION OF THE .LOC PSEUDO-OP. .LPOOL (MAC ONLY) DUMP LITERALS ACCUMULATED SO FAR IN NREL SPACE .LPOOL IF YOU USE THE PSEUDO-OP .NLIT AT THE BEGINNING OF YOUR PROGRAM, YOU MUST PERIODICALLY USE .LPOOL TO DUMP THE LITERALS THAT HAVE ACCUMULATED SINCE THE START OF THE PROGRAM OR THE LAST USE OF .LPOOL. THIS PSEUDO-OP DUMPS THE LITERALS INTO NREL SPACE AT THE LOCATION WHERE THE ASSEMBLER SEES THE .LPOOL. A MAXIMUM OF 4096 .LPOOLS ARE ALLOWED IN A SINGLE PROGRAM. WHEN POSSIBLE THE ASSEMBLER WILL OPTIMIZE THE USE OF NREL SPACE FOR EACH SET OF LITERALS DUMPED WITH .LPOOL. HOWEVER, A LITERAL CAN BE OPTIMIZED ONLY IF THE ASSEMBLER KNOWS ITS VALUE WHEN THE LITERAL IS FIRST REFERENCED (ON PASS 1). THIS MEANS THAT NEITHER FORWARD-REFERENCE LITERALS NOR EXTERNAL NORMAL LITERALS ARE OPTIMIZED. YOU WILL RECEIVE AN "L" ERROR MESSAGE IF YOU USE .LPOOL WITHOUT FIRST USING .NLIT. EXAMPLE .TITLE LXMPL .ENT START .NREL .NLIT 00000'020404 START: LDA 0,=4 00001'024404 LDA 1,=4*400+3 00002'030404 LDA 2,=START 00003'002403 JMP @=START 00004'000004 .LPOOL 002003 000000' .END RDOS/DOS ASSEMBLY LANGUAGE AND PROGRAM UTILITIES, 069-400019-01 DOCUMENTATION CHANGES, REVISION 02 12/JAN/89 PAGE 72 INSERT THE FOLLOWING MATERIAL AFTER THE DESCRIPTION OF THE .MCALL PSEUDO-OP. .NLIT (MAC ONLY) PLACE ALL LITERALS IN NREL SPACE .NLIT INVOKING THE .NLIT PSEUDO-OP AT THE BEGINNING OF A PROGRAM CAUSES THE ASSEMBLER TO PLACE ALL LITERALS IN NREL SPACE. YOU MUST REQUEST THE DUMPING OF LITERALS PERIODICALLY WITH THE .LPOOL PSEUDO-OP. YOU WILL RECEIVE AN "L" ERROR MESSAGE IF YOU USE .NLIT AFTER A LITERAL HAS BEEN SEEN. EXAMPLE .TITLE LXMPL .ENT START .NREL .NLIT 00000'020404 START: LDA 0,=4 00001'024404 LDA 1,=4*400+3 00002'030404 LDA 2,=START 00003'002403 JMP @=START 00004'000004 .LPOOL 002003 000000' .END RDOS/DOS ASSEMBLY LANGUAGE AND PROGRAM UTILITIES, 069-400019-01 DOCUMENTATION CHANGES, REVISION 02 12/JAN/89 PAGE 79 | ABOUT TWO-THIRDS OF THE WAY DOWN THE LEFT COLUMN, THE MANUAL STATES | THAT BY DEFAULT BYTES ARE PACKED FROM LEFT TO RIGHT. ACTUALLY, | JUST THE OPPOSITE IS TRUE--BY DEFAULT BYTES ARE PACKED FROM RIGHT | TO LEFT. TO CHANGE THE WAY IN WHICH TEXT BYTES ARE PACKED, YOU CAN | USE THE .TXTM PSEUDO-OP. RDOS/DOS ASSEMBLY LANGUAGE AND PROGRAM UTILITIES, 069-400019-01 DOCUMENTATION CHANGES, REVISION 02 12/JAN/89 PAGE 94 | ABOUT A THIRD OF THE WAY DOWN THE RIGHT COLUMN, THE MANUAL SHOWS | HOW YOU COULD LOAD THE VALUE OF A INTO ACCUMULATOR 2: | | .NREL | . | A: . | . | LDA 2,=A | | THIS EXAMPLE IS CORRECT; HOWEVER, IF A IS DEFINED EXTERNALLY, | CERTAIN TYPES OF LITERAL REFERENCES DO NOT WORK. FOR EXAMPLE, YOU | CANNOT WRITE | | .EXTN A (OR .EXTD A) | . | . | . | LDA 2,=A*2 | ALSO, ADD THE FOLLOWING NOTES TO THE DISCUSSION OF LITERALS. 1) BOTH THE ZREL AND NREL LITERALS NOW ACCEPT EXTERNAL DISPLA- CEMENT AND EXTERNAL NORMAL VALUES AS LEGAL LITERAL VALUES. | 2) BOTH ZREL LITERALS AND NREL LITERALS THAT ARE WITHIN | PC-RELATIVE-ADDRESSING RANGE ARE NOW OPTIMIZED. THE | EXCEPTIONS TO THIS RULE ARE (1) EXTERNAL NORMAL LITERALS | AND (2) EXPRESSIONS THAT USE SYMBOLS THAT ARE NOT IN THE | PERMANENT SYMBOL TABLE AND ARE NOT NUMERIC. RDOS/DOS ASSEMBLY LANGUAGE AND PROGRAM UTILITIES, 069-400019-01 DOCUMENTATION CHANGES, REVISION 02 12/JAN/89 PAGE 121 | UNDER THE HEADING "LIBRARY FILES," THE MANUAL STATES THAT RLDR WILL | NOT LOAD ANY MODULES FROM THE LIBRARY UNLESS ONE OF TWO CONDITIONS | EXISTS. THE FIRST OF THESE CONDITIONS IS THAT THE LIBRARY MODULE | MUST SATISFY AN UNRESOLVED SYMBOL FROM ANOTHER MODULE. ACTUALLY, | THE LIBRARY MODULE MUST SATISFY AN UNRESOLVED SYMBOL FROM ANOTHER | MODULE, AND THE MODULE CONTAINING THE UNRESOLVED SYMBOL MUST | PRECEDE THE LIBRARY MODULE ON THE RLDR COMMAND LINE. RDOS/DOS ASSEMBLY LANGUAGE AND PROGRAM UTILITIES, 069-400019-01 DOCUMENTATION CHANGES, REVISION 02 12/JAN/89 PAGE 138 ADD THE FOLLOWING ENTRY TO THE LIST OF ERROR MESSAGES. LITERAL ERROR (L) OCCURS WHEN THE ASSEMBLER DETECTS AN .NLIT AFTER SEEING A LITERAL OR FINDS AN .LPOOL WITHOUT A PRECEDING .NLIT. RDOS/DOS ASSEMBLY LANGUAGE AND PROGRAM UTILITIES, 069-400019-01 DOCUMENTATION CHANGES, REVISION 02 12/JAN/89 PAGE 145 | AS YOU READ ABOUT THE RADIX 50 REPRESENTATION OF SYMBOLS, KEEP IN | MIND THAT 50 IS AN OCTAL NUMBER (40 DECIMAL). | | ALSO, IN THE FORMULA AT THE BOTTOM OF THE FIRST COLUMN, THE OCTAL | NUMBER 50 IS FOLLOWED BY THE SUBSCRIPT 3. THAT 3 SHOULD BE AN | EXPONENT INSTEAD (50**3 - 1 = 174777). --END OF UPDATE FILE--