Getting started
This page takes you from the download to a first program running on your MSX: five steps, each described in full in the manual. You need an MSX2 or later running MSX-DOS2 or Nextor, or an emulator that runs them.
1. Download
From the Download page, download Tatara, TATAR120.ZIP. It holds the programs, the include files and the example programs.
It is unpacked on the MSX with UNKAGO, the unpacker of Kago. Download
Kago from its download page; you need
only UNKAGO.COM from it.
These steps assume that you download on another computer, such as a PC
or a Mac, and copy the files to the MSX, for instance on a memory card.
Copy TATAR120.ZIP and UNKAGO.COM to the root directory of drive A:.
2. Install
Tatara goes into A:\TATARA, with three directories inside it:
A:\TATARA\
BIN\ TATARA.COM and TANREN.COM
INCLUDE\ the include files
EXAMPLES\ the example programs, one directory each
The archive holds exactly this tree. Unpack it with UNKAGO, giving the
directory to unpack into after /D:; UNKAGO creates A:\TATARA and
the directories inside it:
A:\>unkago /d:a:\tatara tatar120.zip
UNKAGO LZH/PMA/ZIP Decompressor v1.0.1
Copyright (C) 2026 Javier Lavandeira
https://kago.tools
Extracting BIN\ OK
Extracting BIN\TATARA.COM OK
Extracting BIN\TANREN.COM OK
Extracting INCLUDE\ OK
Extracting INCLUDE\WORKAREA.INC OK
...
Extracting EXAMPLES\TWOMOD\TWOMOD.LNK OK
Extracting README.TXT OK
Extracting LICENSE OK
UNKAGO prints one line for each directory and file in the archive,
fifty in all, each ending in OK; the list above is shortened in the
middle. TATAR120.ZIP is not needed any more and can be deleted. Keep
UNKAGO.COM: an update is unpacked with it too.
Note. A Japanese MSX shows the backslash as a yen sign, so
A:\TATARAappears asA:¥TATARA. It is the same character.
The manual’s chapter 3 has every step, how to check the installation and update it, and the list of the include files.
3. Set PATH and TATARA
Two environment variables tell MSX-DOS2 and TATARA where the files are.
PATH lets you run TATARA and TANREN from any directory; the TATARA
environment variable tells TATARA where the include files are.
A:\>set path=%path%;a:\tatara\bin
A:\>set tatara="a:\tatara\include"
At the prompt, the value of TATARA must be between quotation marks;
without them MSX-DOS2 answers *** Invalid environment string.
Set this way, they last until the MSX is reset. To set them every time
it starts, add these two lines at the end of AUTOEXEC.BAT, in the root
directory of the boot drive, where the quotation marks are not needed:
set path=%path%;a:\tatara\bin
set tatara=a:\tatara\include
4. Check
Run each program with the option /V, which prints its name and
version and does nothing else:
A:\>tatara /v
Tatara MSX Macro-Assembler v1.2.0
Copyright (C) 2026 Javier Lavandeira
https://tatara.tools
A:\>tanren /v
Tatara MSX Linker v1.2.0
Copyright (C) 2026 Javier Lavandeira
https://tatara.tools
If MSX-DOS2 answers *** Unrecognized command instead, PATH does not
include A:\TATARA\BIN: type set to see it, and set it again.
5. Build and run HELLO
HELLO.AS is the smallest complete program: it prints a line and
returns to MSX-DOS2. Assemble it with TATARA, link it with TANREN, and
run it:
A:\>cd \tatara\examples\hello
A:\TATARA\EXAMPLES\HELLO>tatara hello.as hello.tro
Tatara MSX Macro-Assembler v1.2.0
Copyright (C) 2026 Javier Lavandeira
https://tatara.tools
ended at HELLO.AS(22)
A:\TATARA\EXAMPLES\HELLO>tanren /o:hello.com hello.tro
Tatara MSX Linker v1.2.0
Copyright (C) 2026 Javier Lavandeira
https://tatara.tools
1 module, 7 records, ends at EOF.
Wrote HELLO.COM, 0100-0121 (34 bytes), entry 0100.
A:\TATARA\EXAMPLES\HELLO>hello
Hello from Tatara.
TATARA turned the source file HELLO.AS into the object file
HELLO.TRO, and TANREN turned the object file into the program
HELLO.COM. If TATARA stops with cannot open MSXDOS.INC, the
TATARA environment variable is not set: go back to step 3.
Where to go next
The manual starts from here: