Tatara

入門

このページでは、ダウンロードから、MSXで最初のプログラムを実行するまでを5つの手順で説明します。それぞれの手順は、マニュアルで詳しく説明しています。MSX-DOS2またはNextorが動くMSX2以降の機種か、これらを動かせるエミュレーターが必要です。

1. ダウンロード

ダウンロードのページから、TataraのTATAR120.ZIPをダウンロードします。プログラム、インクルード・ファイル、サンプル・プログラムがすべて入っています。

MSXでは、KagoのUNKAGOを使って展開します。KagoのダウンロードのページからKagoをダウンロードしてください。使うのはUNKAGO.COMだけです。

ここでは、PCやMacなどの別のコンピューターでダウンロードし、メモリ・カードなどを使ってMSXにコピーすることを前提にしています。TATAR120.ZIPとUNKAGO.COMを、ドライブA:のルート・ディレクトリにコピーしておきます。

2. インストール

TataraはA:\TATARAに置きます。その中には、次の3つのディレクトリがあります。

A:\TATARA\
    BIN\         TATARA.COMとTANREN.COM
    INCLUDE\     インクルード・ファイル
    EXAMPLES\    サンプル・プログラム(サンプルごとに1つのディレクトリ)

アーカイブの中身は、このとおりの構成になっています。UNKAGOで展開します。展開先のディレクトリは/D:のあとに指定します。A:\TATARAとその中のディレクトリは、UNKAGOが作ります。

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は、アーカイブの中のディレクトリとファイルごとに1行、全部で50行を表示します。どの行もOKで終わっていれば正常です。上の表示は途中を省略しています。TATAR120.ZIPはもう必要ないので、削除してかまいません。UNKAGO.COMは残しておきます。アップデートの展開にも使います。

注意 日本のMSXでは、バックスラッシュが円記号で表示されるため、A:\TATARAはA:¥TATARAのように見えます。これは同じ文字です。

すべての手順と、インストールの確認やアップデートのしかた、インクルード・ファイルの一覧は、マニュアルの第3章にあります。

3. PATHとTATARAの設定

2つの環境変数で、ファイルの場所をMSX-DOS2とTATARAに知らせます。PATHを設定すると、どのディレクトリからでもTATARAとTANRENを実行できます。環境変数TATARAは、インクルード・ファイルの場所をTATARAに知らせます。

A:\>set path=%path%;a:\tatara\bin
A:\>set tatara="a:\tatara\include"

プロンプトでは、TATARAの値を引用符で囲みます。囲まないと、MSX-DOS2は*** Invalid environment stringと表示します。

この方法で設定した環境変数は、MSXをリセットするまで有効です。起動するたびに設定するには、起動ドライブのルート・ディレクトリにあるAUTOEXEC.BATの最後に、次の2行を加えます。ここでは引用符は必要ありません。

set path=%path%;a:\tatara\bin
set tatara=a:\tatara\include

4. 確認

それぞれのプログラムを/Vオプションを付けて実行します。プログラムの名前とバージョンを表示するだけで、ほかには何もしません。

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

代わりに*** Unrecognized commandと表示された場合は、PATHにA:\TATARA\BINが含まれていません。setで確認し、設定し直してください。

5. HELLOを作って実行する

HELLO.ASは、完全なプログラムとしてはもっとも小さなものです。1行を表示して、MSX-DOS2に戻ります。TATARAでアセンブルし、TANRENでリンクして、実行します。

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がソース・ファイルHELLO.ASをオブジェクト・ファイルHELLO.TROに変換し、TANRENがオブジェクト・ファイルをプログラムHELLO.COMにしました。TATARAがcannot open MSXDOS.INCと表示して止まった場合は、環境変数TATARAが設定されていません。手順3に戻ってください。

次に読むところ

マニュアルは、ここから先を説明します。