This file describes how to get tkisem running on your
CIRT account.

There are 3 programs involved in the transition from
SPARC assembly code (let's call this foo.s) to an executable
(a.out) running on an emulator (tkisem) on CIRT's aix machines:
The 3 programs are isem-as (assembler), isem-ld (linker), and
tkisem (emulator).

  foo.s -> isem-as -> foo.o -> isem-ld -> a.out -> tkisem

Note, tkisem requires X-Windows to run. These executables are
located in ~maccabe/bin. It's suggested that you make symbolic
links to these programs. Make a directory called 'bin', put
links to these programs in the directory, and add the directory
to your path:

         % cd
         % mkdir bin
         % cd bin
         % ln -s ~maccabe/bin/isem-as isem-as 
         % ln -s ~maccabe/bin/isem-ld isem-ld
         % ln -s ~maccabe/bin/tkisem tkisem

then edit your .login file (in your home directory), adding 
$HOME/bin to the path variable.

The following makefile produces a.out from foo.s (a sample foo.s 
and this makefile are in ~brayer/341/Examples):

a.out: foo.o
	isem-ld foo.o

foo.o: foo.s
	isem-as -als -o foo.o foo.s 

The -als option instructs the assembler to produce a listing
of instructions and variables. Executing

     % make >& error

will do the assembly and linking and redirect any errors
along with the listing to a file called 'error'.

To run a.out, invoke tkisem (preferably in the directory
where a.out is)

     % tkisem

from X-Windows and follow the Help instructions, or the
instructions in the file ~brayer/341/tkisem_guide.