Tatara

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:\TATARA appears as A:¥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: