入門
このページでは、ダウンロードから、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に戻ってください。
次に読むところ
マニュアルは、ここから先を説明します。