1-30
You have now finished the Demonstration Run. It emphasized how to:
• create a source file, using the editor;
• create an object file from a source file, using the assembler;
• create a load file from object files, using the linker;
• copy the load file into memory, using the LOAD command;
• interpret listings generated by the assembler and linker.
The Demonstration Run in the Learning Guide of the 8550 System Users Manual (DOS/50 Ver-sion 2) shows you how to execute and monitor the program you have loaded into memory.
> DEL -N ASM. DEMOI * ASM.DEMO <CR>
Using This Manual With DOS/50 Version 1
To convert this manual for use with DOS/50 Version 1, you must perform the following steps:
1. Throughout this manual, change all instances of the "CON" command to "COPY", so that the manual will reflect DOS/50 Version 1 syntax.
2. In the "Summary of Demonstration Run", earlier in this section, change the first operating system command line to:
> LDIR IVOL/sysvol/ASM.DEMO <CR>
~
name of your system volume
3. At the end of the "Summary of Demonstration Run", change the operating system com-mand line to:
> DELETE:N iVOLisysVOliASM.V.I!.:M.OI "',/VUL/sysvol/ASM.DEMO <CR>
~ ~
name of your system volume
4. Throughout this manual, change all references of "Version 2" to "Version 1".
8550 System Users Manual (DOS/50 Version 2). Describes how to use the 8550 Microcomputer Development Lab and its operating system, DOS/50 Version 2.
FOR CONTINUED LEARNING
This Learning Guide explained the basic concepts needed to use the assembler and linker.
These same concepts will help you learn to use the library generator. For a more detailed explanation of how to use these system programs, refer to the following sections:
Section 2, Procedures. Gives you step-by-step instructions for accomplishing common tasks in assembling, linking, and library maintenance.
REV FEB 1983
Learning Guide-8500 MOL A Series Assembler Users For Continued Learning
Section 3, Assembler Introduction. Shows the use of the operating system command ASM.
Reviews the notational conventions used throughout this manual. Explains the assembler listing in more detail.
Section
4,
Assembly Language Elements. Describes the fundamental elements of an assembly language statement. Gives rules for creating symbols, constants, and expressions.Describes special characters and assembler functions.
Section 5, Assembler Directives. Describes the function and use of each assembler directive. Each description is accompanied by one or more examples. Directives are arranged in alphabetical order.
Section
6,
Macros. Shows how to create and use assembler macros. Demonstrates the macro features of the TEKTRONIX Assembler.Section
7,
The Linker. Describes the function and use of the operating system command LINK, and of each command in the linker subsystem. Explains the linker listing in more detail.Section
8,
The Library Generator. Describes the function and use of the operating system command LlBGEN, and of each command in the library generator subsystem. Explains the library generator listing.Section
9,
Programming Examples. Demonstrates and explains useful applications of the assembler, linker, and library generator.Section
10,
Tables. Summarizes reference information in tabular form.Section
11,
Technical Notes. Provides information on special applications of the assembler, linker. and library generator.Section 12, Assembler Specifics. Provides information that varies with each microprocessor: registers, instruction sets, special error messages, etc. Section
12
also contains Demonstration Runs for microprocessors other than the 8080A. An Irregularities paragraph for each microprocessor lists exceptions to the standard reference material in this manual.Section 13, Error Messages. Lists the error messages for the assembler, linker, and library generator. Each error message is accompanied by a description of the problem and possible solutions.
Section
14.
Glossary. Defines special terms used in this manual.8550 System. Users Manual (DOS/50 Version 2). Describes how to use the 8550 Miciocom-puter Development Lab and its operating system, DOS/50 Version 2.
8550 Editor Users Manual. Describes how to use the 8550 Microcomputer Development Lab Editor.
8500 MOL A Series Assembler Users
Section 2
PROCEDURES
Page Introduction . ... 2-1 Assembling Your Program ... 2-2 Invoking the Assembler ... 2-2 Combining Source Files During Assembly ... 2-2 Dispiaying iniernai Symbois in ihe Linker Listing ... 2-3 linking Your Program ... 2-4 Invoking the Linker (Simple Invocation) ... 2-4 Invoking the Linker (Interactive Invocation) ... 2-5 Assigning Object Code to an Address Range ... 2-7 Reserving an Area of Memory ... 2-8 Building and Maintaining a library ... 2-10 Invoking LibGen ... 2-10 Creating a User-Defined Library ... 2-11 Adding a New Library Module ... 2-12 Extracting a Library Module ... 2-13 Replacing a Library Module ... 2-13 Combining Libraries ... 2-14
REV A FEB 1981
2-i
8500 MOL A Series Assembler Users
Section 2
PROCEDURES
INTRODUCTION
In the previous section, the Learning Guide, you were presented with the basic concepts of the Tektronix Assembler and Linker. In this section. Procedures. you are shown procedures for using the assembler, the linker, and the library generator.
Each procedure in this section is simply a series of one or more command entries or actions for you to perform. Most of the procedures contain parameters (places for values) that you will supply when you perform the procedure.
Each procedure is presented in the following format:
Description:
Procedure:
Parameters:
Comments:
Examples:
See Also:
A summary of the operation(s) performed by the procedure.
The information entered or displayed at the system terminal. The following conventions are used in the procedure description:
Underlined: The character sequence that you will enter. The sequence may consist of the exact characters to be entered, or parameters for which you must substitute your values.
No underline: A character sequence that is displayed by the operating system.
UPPERCASE: An exact character sequence; if these characters are underlined, enter them exactly as shown. (If they are not underlined, you will see these characters displayed by the operating system.) lowercase: A parameter for which you will supply a value when you perform the procedure.
(Parentheses): A comment, or an action for you to perform at the indicated time.
The filespecs or options that you provide.
The operating limits and options fOi this procedure.
One or more demonstrations of the correct entry format.
Cross-references to related procedures.
For a full description of any given command, refer to Assembler Directives, Linker, or Library Generator section in this manual, as appropriate.