Tatara

第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

表 3.1: アーカイブの中身

アーカイブは、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:のルート・ディレクトリに置いています。

  1. アーカイブを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で終わっていれば正常です。上の表示は途中を省略しています。

  2. 確認します。dir a:\tatara\binで TATARA.COMとTANREN.COMが、dir a:\tatara\includeで表3.2の 10個のファイルが、dir a:\tatara\examplesでサンプルごとの 8つのディレクトリが表示されれば、正しく展開されています。
  3. 片付けます。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.2: A:\TATARA\INCLUDEの中のファイル

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はサンプルも置き換えます。サンプルを変更する前に、そのディレクトリをほかの場所にコピーし、コピーのほうで作業してください。そうしないと、次のアップデートで変更が上書きされます。