第3章
インストール
この章では、ダウンロードしたファイルから始めて、TATARAとTANRENがどのディレクトリからでも実行でき、インクルード・ファイルを見つけられる状態の MSXを用意します。ここで説明するインストールは、このマニュアルの以降の章が前提とするものです。これから先のセッションは、すべてこのディレクトリ構成で示します。
3.1 配布されるもの
Tataraは、1つのアーカイブ(archive)として配布されます。アーカイブとは、複数のファイルを1つにまとめたファイルです。名前はTATARxyz.ZIPで、xyzはバージョンを表します。たとえば TATAR120.ZIPはバージョン1.2.0です。https://tatara.tools/downloadからダウンロードできます。中には、表3.1のように、すでにディレクトリに分けられたインストール一式が入っています。
| ファイルまたはディレクトリ | 内容 |
| BIN | アセンブラーのTATARA.COMと、リンカーの TANREN.COM |
| INCLUDE | インクルード・ファイル(14章) |
| EXAMPLES | このマニュアルのサンプル・プログラム(サンプルごとに 1つのディレクトリ) |
| README.TXT | バージョンと、Webサイトのアドレス |
| LICENSE | Tataraの配布条件であるApache License 2.0 |
アーカイブは、MSXではUNKAGOを使って展開します。UNKAGOは、ZIP、LZH、PMAのアーカイブを展開するプログラムです。UNKAGOは必須です。MSXでこのアーカイブを展開するのに使うもので、MSX-DOS2にもNextorにも付属していません。UNKAGO.COMは https://kago.tools/en/download/からダウンロードしてください。TATARAやTANRENと同じく、MSX-DOS2またはNextorで動きます。
注. 以前のリリースは、TATAR117.LZHのような.LZHのアーカイブで配布されていました。これらにはディレクトリがないので、この章で説明する方法ではインストールできません。この章で説明するのは.ZIPのアーカイブです。
このマニュアルでは、2つのファイルをPCやMacなどの別のコンピューターでダウンロードし、メモリ・カードなどを使ってMSXにコピーすることを前提にしています。
3.2 ファイルの置き場所
このマニュアルでは、アーカイブをA:\TATARAに展開し、次のディレクトリができているものとします。
A:\TATARA\ BIN\ TATARA.とCOMTANREN.COM INCLUDE\ インクルード・ファイル EXAMPLES\ サンプル・プログラム(サンプルごとにつのディレクトリ)1 README.TXT LICENSE
次の2つの条件を満たしていれば、ほかの場所にインストールしてもかまいません。2つのプログラムがあるディレクトリがPATHに含まれていること、そして環境変数TATARAがインクルード・ファイルのあるディレクトリを指していることです。どちらも3.4節で説明します。以降の章ではA:\TATARAで示しますので、別の場所にインストールした場合は、自分のディレクトリに読み替えてください。
注. 日本のMSXでは、バックスラッシュが円記号で表示されるため、上のディレクトリはA:¥TATARA¥INCLUDEのように見えます。これは同じ文字なので、このマニュアルのパスはそのまま使えます。
3.3 インストールの手順
TATAR120.ZIPとUNKAGO.COMを、MSXの同じディレクトリにコピーします。ファイルをどこに置くかはUNKAGOに指定するので、ディレクトリはどこでもかまいません。次の例では、ドライブA:のルート・ディレクトリに置いています。
-
アーカイブをA:\TATARAに展開します。 2つのファイルがあるディレクトリで、スイッチ/D:と展開先のディレクトリを付けてUNKAGOを実行します。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で終わっていれば正常です。上の表示は途中を省略しています。
- 確認します。dir a:\tatara\binで TATARA.COMとTANREN.COMが、dir a:\tatara\includeで表3.2の 10個のファイルが、dir a:\tatara\examplesでサンプルごとの 8つのディレクトリが表示されれば、正しく展開されています。
- 片付けます。TATAR120.ZIPはもう必要ないので、削除してかまいません。UNKAGO.COMは残しておきます。アップデートの展開にも使います(3.6節)。
| ファイル | 内容 |
| ASCII.INC | 制御コード |
| BIOS.INC | メインROMのエントリー・ポイント |
| ERRORS.INC | MSX-DOSとMSX-DOS2のエラー・コード |
| EXTBIO.INC | 拡張BIOSと、MSX-MUSICのFM BIOS |
| HOOKS.INC | フック |
| MSXDOS.INC | MSX-DOSのファンクション番号と、systemマクロ |
| PORTS.INC | I/Oポート |
| SUBROM.INC | サブROMのエントリー・ポイント |
| WORKAREA.INC | システム・ワーク・エリア |
| README.TXT | 各ファイルの簡単な説明 |
3.4 PATHとTATARAの設定
環境変数(environment variable)とは、文字列を保持する名前で、MSX-DOS2がメモリに保存し、プログラムから読み出すことができます。このインストールでは、2つの環境変数を使います。
- PATH
-
コマンドを入力すると、MSX-DOS2はその名前のプログラムを、まずカレント・ディレクトリで探し、次にPATHに書かれたすべてのディレクトリで探します。ここにA:\TATARA\BINを加えると、どのディレクトリからでも TATARAとTANRENを実行できるようになります。
- TATARA
-
ソース・ファイルがほかのファイルを取り込むとき、TATARAはそのファイルを、まずソース・ファイルのあるディレクトリで、次にカレント・ディレクトリで、そしてTATARAに書かれたすべてのディレクトリで探します。これをA:\TATARA\INCLUDEに設定すると、どのプログラムでも、コピーを置かずに表3.2のファイルを取り込めるようになります。詳しい規則は13章で説明します。
いまのセッションで設定するには、次のように入力します。
A:\>set path=%path%;a:\tatara\bin A:\>set tatara="a:\tatara\include"
%path%はPATHの現在の値を表します。そのため、1行目は PATHを置き換えるのではなく、その最後に新しいディレクトリを加えます。setだけを入力すると、すべての環境変数とその値が表示されます。PATHには、新しく加えたディレクトリの前に、自分の環境のディレクトリが表示されるはずです。
注. MSX-DOS2のプロンプトでは、上のようにTATARAの値を引用符で囲みます。囲まないと、MSX-DOS2は *** Invalid environment stringと表示し、環境変数を設定しません。後で説明するAUTOEXEC.BATでは、引用符は必要ありません。
この方法で設定した環境変数は、MSXをリセットするか電源を切るまで有効です。MSXを起動するたびに設定するには、次の2行をAUTOEXEC.BATに加えます。AUTOEXEC.BATは起動ドライブのルート・ディレクトリにあるバッチ・ファイルで、MSX-DOS2が起動するときに実行します。まだない場合は、テキスト・エディターで作ります。すでにほかのコマンドが書かれていてもかまいません。その最後に2行を加えます。
set path=%path%;a:\tatara\bin set tatara=a:\tatara\include
注. TATARAには、PATHと同じように、セミコロンで区切って複数のディレクトリを書けます。プロジェクトが独自のインクルード・ファイルを持つときに便利です(13章)。
注. TANRENにも、オブジェクト・ファイルを探すディレクトリを指定する TANRENという環境変数があります。このインストールでは必要ありません(23章)。
3.5 インストールの確認
どのディレクトリからでもかまいませんので、それぞれのプログラムを /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
代わりに次のように表示された場合は、PATHに A:\TATARA\BINが含まれていません。setで確認し、3.4節のとおりに設定し直してください。
A:\>tatara /v *** Unrecognized command
環境変数TATARAは、4章で、最初のプログラムが MSXDOS.INCを取り込むときに確認します。
3.6 アップデート
新しいバージョンも同じ方法で展開しますが、スイッチ/Oを付けます。
A:\>unkago /o /d:a:\tatara tatarxyz.zip
/Oを付けないと、UNKAGOはすでにあるファイルを置き換えません。ファイルごとにSkipping BIN\TATARA.COM: it already existsのように表示し、古いバージョンがそのまま残ります。それぞれのプログラムのバージョンは、/Vで確認できます。
警告. /Oはサンプルも置き換えます。サンプルを変更する前に、そのディレクトリをほかの場所にコピーし、コピーのほうで作業してください。そうしないと、次のアップデートで変更が上書きされます。