To start and use DOS TOOL KIT on the Apple II emulator

 To start and use DOS TOOL KIT on the Apple II emulator

 

After you start the Apple II emulator, click on the drive #1 icon and set the “DOS TOOL KIT” .dsk file as the file to run.

 

 

Click on the drive #2 icon and set ULTIMA .dsk as the file to run.

 

 

Now that you have to two files ready to go, start the DOS TOOL KIT program by clicking on the apple start button.

 

 

 

The main screen should come up and look like the following:

 

To start the DOS TOOL KIT assembly editor you need to type “RUN EDASM” at the command prompt.

 

The following screen will come up and you just hit “ENTER” to continue.

 

 

After the editor starts you will see a  :  on the screen where the regular  ]  prompt should be, this is the assembly editor prompt and lets you know you are in EDIT MODE!

Since the ULTIMA files are on disk in the second drive you need to switch over to that drive to run the programs in it.  In the display screen at the prompt, type in “DRIVE 2” and hit enter.

 

 To display the names of all the files on the disk type in “CATALOG” and hit enter.

 

The files you see on the disk are as follows:

·         HELLO – The initial disk header file.

·        ULTIMA.BAT – The main BASIC program that runs the ULTIMA1REV.OBJ0 assembly program.

·      ULTIMA1REV  - The main assembly program for the world map of 1 and 2

·      ULTIMA1REV.OBJ0  - The editor compiled object file of the main assembly program

 Since you are in the assembly editor you can load the ULTIMA1REV assembly program to check out the program code.

To load the program type in “LOAD ULTIMA1REV”

 

 

Depending on how big your program is, it may take a few minutes to load.  Once the program is loaded you can list the program to see the code.

To show a listing of the program type in “LIST” and hit enter, the program will start showing a listing and to pause the listing hit the “SPACE” key.  To continue showing the listing just hit the “SPACE” key again.

 

To break out of the listing just hit “CNTR-C” and this will stop the listing immediately and bring you back to the  :  prompt.

To list a specific line # just type in the line # after the LIST command.  So, to list the code line # 500 just type in “LIST 500” and hit enter.

 

 

To start listing the program from a certain starting line # you can use the list command  and the line # and a dash!  So just type in “LIST 400-“ and hit enter. 

 

 To list a section of code type in the list command with the first and last line numbers separated by a dash.   So, to see the code listing from 100 to 110 type in “LIST 100-110” and hit enter.

 

 

To see a listing of two individual lines of code type if the list command and the first line number and the second line number separated by a comma.  So, to see the two lines of code 300 and 400 just type in the command “LIST 300,400” and hit enter.

 

 

To find a specific name or phrase within the program you would use the FIND command.  So, to find all the listing with the word TEMP in it just type in the command “FIND TEXT” and hit enter.

 

 

To either start writing a new program or add a line to existing lines of code you would use the ADD command.  So, let’s say you want to add a comment after line #3, you would type in “ADD 3” and hit enter.  Then the new line number 4 would show up and you would type in the new statement for that line number, such as “**** HAPPY” and hit enter.  The next number in the sequence would show up, which in this case would be a 5 so if this was all you wanted to add you would hit “CTRL-Q” and it would break you out of the add command and bring up the : prompt.

When you list the program again you would see your new line #4 with the comment line included.

 

To delete a line from your program you would use the DELETE command or just DEL “you can abbreviate most if not all the commands in the assembly editor”.  So, if you wanted to delete the line #4 you just added type in “DEL 4” and hit enter.  The new listing will show that the comment you added before is gone and all the lines have moved up in the sequence.  NOTE *** Remember that the line numbers in your assembly program are not the same as they would be in a BASIC program.  The program doesn’t use the line number with the program runs, the editor just uses them to help you write your code and keep it organized and allow you easier editing.

 

 You can also delete a group of code lines by typing the command “DEL 300-400” and hitting enter.  This will delete all the lines of code from line 300 thru 400!  Be very careful when using this command, there is no undo command in the assembly editor, once you type this command it is done and there is no turning back!!!

To edit a line of code in the program you can use the EDIT command.  So, if you want to edit line 500 and change the text in the statement you would type “EDIT 500” and hit enter.  Line # 500 will show up with a flashing cursor and you just hit the right arrow to start editing the line.  Use the right arrow to scroll over to the letters you want to change and either hit the space bar to delete them or type over them with the new letters.  When finished hit enter and the line will be updated and ready to use.

To compile a program type in ASM and the program name then hit enter!  You will be asked to hit any key to continue.

When you are compiling a program and you find that there is an error that needs to be fixed before it will compile, there is no point compiling the program so hit CNTR-C and stop the compiling and then LOAD the program again and fix the error!