### IBM (R) OS/2 WARP (R) DEVELOPER KIT,
JAVA (TM) 2 TECHNOLOGY EDITION, Version 1.3.1
インストールおよび構成ガイド

(c) Copyright IBM Corporation 1999, 2002. All rights reserved.

(c) Copyright IBM Japan 2002

注 : 著作権に関する完全な記述は、本資料の 「特記事項」 に含まれています。

このガイドは、OS/2 Warp Developer Kit, Java (TM) 2 Technology Edition, Version 1.3.1 (Developer Kit) に関するものです。 Developer Kit の各コンポーネントをインストールするための準備作業、Developer Kit の各コンポーネントのインストール作業、およびインストール後の注意事項についての情報が含まれています。

Developer Kit をサポートする OS/2 (R) 製品は下記のとおりです。

- OS/2 Warp Version 4、フィックスパック 5 以上を適用後のもの (1 バイト文字セット (SBCS) の場合)、
  またはフィックスパック FX00505 を適用後のもの (2 バイト文字セット (DBCS) の場合)
- OS/2 Warp Server for e-business
- Convenience Package for OS/2 Warp Version 4
- Convenience Package for OS/2 Warp Server for e-business
- Convenience Package 2 for OS/2 Warp Version 4
- Convenience Package 2 for OS/2 Warp Server for e-business
- 最新のフィックスパック付 WorkSpace On-Demand Version 2.0

注 : フィックスパックの要件について、または IBM の フィックスパック Web サイトについては、フィックスパックの項をご覧ください。

Developer Kit の IBM ビルド番号およびバージョン番号を調べるには、コマンド行で下記のように入力してください。

         java -version

### 目次

- 1.0 インストールの前に
- 1.1 インストール要件
- 1.2 インストール用ファイルの解凍
- 1.3 ファイル・システム・パーティションについての注意事項
- 1.4 フィックスパック
- 1.5 Developer Kit をデフォルト JVM としてインストールする

- 1.5.1 JAVA_HOME 環境変数の情報

- 1.6 Netscape Communicator について
- 1.7 分割ファイルの結合
- 2.0 Developer Kit のインストール
- 2.1 GUI によるインストール

- 2.1.1 デスクトップから
- 2.1.2 コマンド・プロンプトから
- 2.1.3 インストールで選択できないコンポーネント
- 2.1.4 インストール中の障害からの回復
- 2.1.5 フィックスパック・レベルを修正してもインストールできない場合

- 2.2 自動 (CID) インストール
  - 2.2.1 CID 応答ファイルの修正
  - 2.2.1.1 コンポーネントのインストール・ドライブ
  - 2.2.2 自動インストールの開始
  - 2.2.3 CID インストールの「正常な」戻りコードとインストール障害
  - 2.2.4 フィックスパック・レベルを修正してもインストールできない場合
- 2.3 NVDM/2 のインストールについての注意事項

- 2.3.1 NVDM/2 プロファイル中の静的コマンド

- 2.4 WorkSpace On-Demand Version 2.0 における Developer Kit のインストール

- 2.4.1 WorkSpace On-Demand Version 2.0 サーバーにおける Developer Kit のインストール
- 2.4.2 WorkSpace On-Demand Version 2.0 クライアントにおける Developer Kit のインストール

- 2.4.2.1 WorkSpace On-Demand Version 2.0 クライアントでの自動インストール
- 2.4.2.2 WorkSpace On-Demand Version 2.0 クライアントでの CONFIG.SYS ファイルの修正
- 2.4.2.3 FIT ファイルを修正して WorkSpace On-Demand Version 2.0 クライアントにアクセスできるようにする
- 2.4.2.4 WorkSpace On-Demand Version 2.0 クライアントに USER_HOME ディレクトリーを割り当てる
- 2.4.2.5 WorkSpace On-Demand Version 2.0 クライアント用のフォントの設定
- 2.4.2.6 WorkSpace On-Demand Version 2.0 クライアント用の Netscape Communicator プラグインのインストール
- 2.4.2.7 WorkSpace On-Demand Version 2.0 クライアントで Developer Kit のコンポーネントを追加インストールする
- 2.4.2.8 WorkSpace On-Demand Version 2.0 クライアントから Java のサンプルを実行する
- 2.4.2.9 WorkSpace On-Demand Version 2.0 クライアントでのトラストの発行
- 2.4.2.10 JIT コンパイラーと WorkSpace On-Demand Version 2.0 クライアント
- 2.4.2.11 WorkSpace On-Demand Version 2.0 クライアント用の Java プラグインのコントロール・パネルの共通アプリケーションの作成

- 2.5 リモート IPL によるインストール

- 2.5.1 応答ファイルの作成
- 2.5.2 JAVA131.RSP ファイルの修正
- 2.5.3 機能のインストール用のファイルの更新
- 2.5.4 リモート IPL インストールの開始
- 2.5.5 リモート IPL クライアントから Java のサンプルを実行する

- 2.5.5.1 リモート IPL クライアントでのトラストの発行

- 3.0 インストールの後
- 3.1 参考資料
- 3.2 コンポーネントの追加インストール
- 3.3 AWT の TextField および TextArea についての注意事項
- 3.4 フォント・プロパティー・ファイルの変更はサポートしていない
- 3.5 Java アプレットでの時刻の問題
- 3.6 OS/2 高位メモリー・サポート (HMS) を使って Java のヒープ・サイズを大きくする

- 3.6.1 OS/2 HMS を有効にする
- 3.6.2 Java のヒープのために OS/2 HMS を使う
- 3.6.3 OS/2 HMS 使用上の制限事項

- 3.7 拡張された BigDecimal クラス
- 3.8 Java プラグイン
  - 3.8.1 Netscape Communicator インストール後の Java プラグインのインストール
  - 3.8.2 IBM Web-browser for OS/2 インストール後の Java プラグインのインストール
  - 3.8.3 Java プラグインの制御パネル
- 3.9 JIT コンパイラーをオフにする
- 3.10 ファイル名の変更点
- 3.11 アプレット・ビューアーの構成作業
- 3.12 Java のオプションおよびシステム・プロパティーの指定
- 3.13 RMI-IIOP

- 3.13.1 IDL/Java コンパイラー

- 3.13.1.1 IDL/Java コンパイラーの制約事項
- 3.13.1.2 IDL/Java コンパイラーに関する既知の問題

- 3.13.2 追加情報
- 3.13.3 RMI-IIOP で使われる用語

- 3.14 Java Authentication and Authorization Service(JAAS)

- 3.14.1 IBM JAAS と Sun JAAS の違い
- 3.14.2 基本インストール

- 3.15 JNI プログラミング情報
- 3.16 パフォーマンスの考慮
- 4.0 フォント・パッケージの追加
- 4.1 フォントの追加インストール

- 4.1.1 CID によるインストール方法
- 4.1.2 フォント・パレットによるインストール

- 5.0 2 バイト文字セット (DBCS) についての情報
- 5.1 インストール・パネルの DBCS テキストが表示されないか長すぎる
- 5.2 中国語のシステムでは TrueType フォントのインストールが必要
- 5.3 DBCS システム用のプログラム一時修正 (PTF) と フィックスパック
- 5.4 アラビア数字のキャラクター・ディスプレイの制御
- 5.5 OS/2 Warp Version 4 日本語版での日本語環境の設定
- 5.6 OS/2 Warp 日本語版で必要なフォント
- 5.7 OS/2 Warp Server for e-business でのフォント表示の改善
- 6.0 Developer Kit のアンインストール
- 6.1 デスクトップから
- 6.2 OS/2 コマンド・プロンプトから
- 6.3 WorkSpace On-Demand Version 2.0 からの Developer Kit のアンインストール
- 6.4 自動アンインストールの実行方法
- 6.5 デフォルト JVM としての Developer Kit の削除
- 7.0 既知の制限事項
- 8.0 特記事項
- 9.0 商標

## 1.0 インストールの前に

Developer Kit は、ランタイム環境とツールキットの 2 つのパッケージで構成されています。 ランタイム環境には、JAAS、RMI-IIOP ランタイム、およびジャストインタイム (JIT) ・コンパイラーなどのコンポーネントが含まれています。 ツールキットには、ツールキットのほか、対話式コード分析ツール (ICAT) デバッガー、サンプルなどのコンポーネントが含まれています。

注 : ツールキットをインストールするには、ランタイム環境もインストールする必要があります。

分割ファイルの形でダウンロードした場合は、分割ファイルの結合方法の項を参照して、 複数の分割ファイルをインストール可能な 1 個のファイルに結合してください。

Developer Kit をインストールする前に、現在の CONFIG.SYS ファイルのコピーを作成しておいてください。 そのようにしておけば、インストール中に何か問題が発生した場合に元の環境に復元することができます。

このガイドでは、下記の用語を使用しています。

- 「OS/2 Warp Version 4」は、OS/2 Warp Version 4 クライアント・オペレーティング・システムおよび WorkSpace On-Demand クライアント (Version 2.0 または 3.0) のことです。
- 「OS/2 Warp Server」は、OS/2 Warp Server for e-business オペレーティング・システム、および WorkSpace On-Demand サーバー (Version 2.0 または 3.0) のことです。
- 「Java Version 1.1.x」は、Java Version 1.1.1 for OS/2、Java Version 1.1.4 for OS/2 Warp、IBM OS/2 Warp Developer Kit Java (TM) 版 Version 1.1.6 、IBM OS/2 Warp Developer Kit Java 版 Version 1.1.7、および IBM OS/2 Warp Developer Kit Java 版 Version 1.1.8 のことです。
- この製品に関して「オブジェクト」とは、Java Version 1.3.1 のオブジェクトのことです。
- 「Netscape Communicator Version」は、特に指定されていない限り Netscape Communicator Version 4.04 以上のことです。

### 1.1 インストール要件

ディスク・スペース所要量 :

Developer Kit のコンポーネントとそのインストール後のファイル・サイズは、下記のとおりです。 インストールする前に、十分なディスク・スペースがあるかどうかを必ず確認しておいてください。

コンポーネント | サイズ
--- | ---
ランタイム環境 | 25.0MB
ツールキット | 35.0MB
サンプル | 5.0MB
ICAT デバッガー (OS/2 Java 版) | 13.0MB
合計インストール済みサイズ | 65.0MB
Developer Kit のコンポーネントとそのインストール後のファイル・サイズのリスト

ハードウェア要件 :

- 一般に 32MB 以上のランダム・アクセス・メモリー (RAM) があれば、Developer Kit のアプリケーション実行時に最良の結果が得られます。
- Java プラグインを使ってブラウザー内でアプレットを実行する場合の推奨 RAM サイズは 48MB 以上です。
- すべての OS/2 システムについて、Intel (R) Pentium (R) プロセッサーまたはそれ以上 (あるいはそれと互換のもの) を使うことが推奨されています。
- Developer Kit の仕様では、256 色以上のモードが必要です。 Developer Kit では、16 色モードにおいて AWT (Abstract Window Toolkit) を使う Java アプリケーションおよびアプレットはサポートされていません。

ソフトウェア要件 :

- 「機能のインストール」Version 1.2.3 以上。 「機能のインストール」の最新バージョンは、 IBM Software Choice Catalog of Features からダウンロードできます。 「機能のインストール」をダウンロードする前に、「機能のインストール」のインストール要件を確認しておいてください。
- Netscape Communicator Version 4.0.4 またはそれ以上。
- TCP/IP Version 4.3. for OS/2 またはそれ以上。 「機能のインストール」の最新バージョンは IBM Software Choice Catalog of Features からダウンロードできます。

### 1.2 インストール用ファイルの解凍

自己解凍 ZIP ファイルを解凍するには、下記のようにします。

1. ハード・ディスク上に自己解凍 ZIP ファイルを入れるためのサブディレクトリーを作成します (まだ作成していない場合)。
2. コマンド・プロンプトにおいて、ダウンロードしたファイルが入っているディレクトリーに移動し、ファイル名を入力することによりそのファイルを実行します。

   例えば、Developer Kit に以下のように入力してください。

       javaintk.exe -o

   ランタイム環境の場合、以下のように入力してください。

       javainrt.exe -o

分割ファイルの形でダウンロードした場合は、複数の分割ファイルをインストール可能な 1 個のファイルに結合する必要があります。その場合は、分割ファイルの結合方法の項をご覧ください。Developer Kit のインストール方法については、Developer Kit のインストールの項をご覧ください。

### 1.3 ファイル・システム・パーティションについての注意事項

Developer Kit のインストールでは、下記の点に注意してください。

- ツールキットをインストールすると、ランタイム環境も自動的に選択され、ツールキットと同じドライブにインストールされます。
- ツールキットとサンプルは、ハイパフォーマンス・ファイル・システム (HPFS) または Journaled File System (JFS) のドライブにインストールする必要があります。
- ランタイム環境と ICAT デバッガーの各コンポーネントについては、ファイル・アロケーション・テーブル (FAT) パーティションにインストール可能です。
- ツールキットをインストールしない場合、ランタイム環境は FAT、HPFS、または JFS のどのパーティションにでもインストール可能です。 パフォーマンスに配慮し、長いファイル名をサポートする HPFS または JFS のパーティションにインストールしてください。

ハード・ディスクが 1 個だけで、その全体を 1 個の FAT パーティションとして使用している場合は、下記のいずれかのようにしてください。

- 現在のシステムをそのまま使用し、ランタイムだけ (およびオプションとして ICAT デバッガー) をインストールする。
- その FAT パーティションを HPFS または JFS としてフォーマットしてから、ソフトウェアをすべて再インストールする。
- PartitionMagic などのディスク・パーティション・プログラムを購入する。 十分なスペースがあるなら、ディスク・パーティション・プログラムを使って現行のパーティション (ドライブ C) を小さくし、新しいパーティション (論理ドライブ D) を作成して、ドライブ D を HPFS としてフォーマットできます。

注 : このガイドでは「パーティション」の語を、物理ドライブまたは論理ドライブのいずれかを指すものとして使用しています。

### 1.4 フィックスパック

下記の点に注意してください。

OS/2 Warp Version 4 に必要なシステム・フィックスパック・レベル
SBCS | DBCS
フィックスパック 5 以上 | フィックスパック FX00505
フィックスパック・レベルの考慮事項

Java のアプリケーションおよびアプレットでユーロ (euro) を使用する場合
OS/2 Warp Version 4 | フィックスパック 6 以上
ユーロを使用する場合のフィックスパック・レベル

注 : ユーロの表示とコード変換がサポートされるのは、ユーロを含むコード・ページにおいてです。

ユーロを入力する場合は、OS/2 の 1 バイト文字セット (SBCS) 版が必要です。 ユーロの入力は、米国国際キーボード UX103 ではサポートされていますが、標準英語キーボードではサポートされていません。 ユーロの入力がサポートされていないキーボードを使っている場合、入力はできませんが表示は可能です。

特定のフィックスパックをダウンロードする方法については、下記の IBM Web サイトを参照してください。
http://ps.software.ibm.com/pbin-usa-ps/getobj.pl?/pdocs-usa/otherservices.html

### 1.5 Developer Kit をデフォルト JVM としてインストールする

Developer Kit をデフォルトの Java 仮想マシン (JVM) としてインストールすると、 Developer Kit をデフォルトでコマンド・プロンプトから実行できるようになります。 Developer Kit は永続的にデフォルト JVM にすることも、一時的なデフォルト JVM とすることもできます。以下の項でさらに説明します。

#### Developer Kit を永続的にデフォルト JVM にする

Developer Kit を永続的にデフォルト JVM にするには、下記のいずれかのようにします。

- GUI インストール中に Developer Kit を選択する。
- Developer Kit (Version 1.3) がすでにインストールされている場合は、 CONFIG.SYS ファイルの PATH ステートメントを変更することによって手動で変更することもできます。

PATH ステートメントを変更するには、 CONFIG.SYS ファイルの PATH ステートメントに x:\JAVA131\JRE\BIN; を追加してください。

Java の旧バージョンを引き続きデフォルトの JVM として使用する場合は、GUI インストール中にチェック・ボックスをチェックしないようにしてください。または、すでに Developer Kit がすでにインストールされている場合は、CONFIG.SYS ファイルの PATH ステートメントに x:\JAVA131\JRE\BIN; を追加しないでください。 Java の Version 1.1.x がすでにデフォルトの JVM としてインストールされている場合、それは引き続きデフォルト JVM となります。

注 : CONFIG.SYS ファイルの中で以前のリリースの Java への参照を削除すると、パフォーマンスを向上させることができます。 ただし、いくつかのアプリケーションについては、 Developer Kit (Version 1.3.x) をデフォルトの JVM としてインストールすると障害が発生することがわかっています。

#### Java セッションのために Developer Kit を一時的に使用する

Developer Kit をデフォルト JVM としてインストールしていない場合に、 Java セッションで使用したい場合、PATH ステートメントを変更します。 例えば、以下のようにします。

         SET PATH=x :\JAVA131\JRE\BIN;%PATH%

ここで、x は、Developer Kit のインストール先ドライブです。

BEGINLIBPATH および CLASSPATH ステートメントを次のように変更すると、 パフォーマンスを向上させることができます。

         SET BEGINLIBPATH=x :\JAVA131\JRE\BIN;x :\JAVA131\JRE\DLL;%beginlibpath%
         SET CLASSPATH=

注 : 一般的に Developer Kit の JVM では、CLASSPATH については、システム・クラス・ファイルを検索するときには必要とせず、アプリケーション・クラス・ファイルの場合に必要になるものなので、CLASSPATH はヌル値に設定されます。

#### Java セッションのために Java Version 1.1.x JVM を一時的に使用する

Developer Kit Version 1.3.x をデフォルト JVM としてインストールしていても、 Java セッションでは Java Version 1.1.x JVM を使用したい場合、 PATH ステートメントを変更します。 例えば、以下のようにします。

        SET PATH=x :\JAVA11\BIN;%PATH%

ここで、x は、Developer Kit Version 1.1.x のインストール先ドライブです。

CONFIG.SYS ファイルから JAVA11 への参照を削除した場合、 PATH、BEGINLIBPATH、および CLASSPATH ステートメントを次のように変更します。

        SET PATH=x :\JAVA11\BIN;%PATH%
        SET BEGINLIBPATH=x :\JAVA11\BIN;x :\JAVA11\DLL;%beginlibpath%
        SET CLASSPATH=x :\JAVA11\LIB\CLASSES.ZIP;x :\JAVA11\SWING\SWINGALL.JAR;\;

注 : CLASSPATH は Java Version 1.1.x ライブラリー・ファイルに設定されます。 CLASSPATH の設定は、それぞれのシステムによって異なります。

Developer Kit と Java プラグインを実行するには、 PATH を上記のように変更する必要があります。

#### 1.5.1 JAVA_HOME 環境変数の情報

Developer Kit (Version 1.3) をデフォルトの Java 仮想マシン (JVM) としてインストールした環境で、 以下のようになっている場合 :

- 旧レベルの Developer Kit に対応した CONFIG.SYS ファイルに JAVA_HOME 環境変数を手作業で追加した場合
- JAVA_HOME 環境変数を設定したコマンド・ファイルがある場合

下記の操作を行います。

- CONFIG.SYS ファイルの JAVA_HOME 環境変数を削除または更新してください。
- JAVA_HOME 環境変数を設定しているステートメントを削除または変更して、 コマンド・ファイルを修正してください。

### 1.6 Netscape Communicator について

下記のリストは、 Developer Kit と Netscape Communicator Version 4.04 以上の併用に関する情報です。

- #### Developer Kit インストール中の Netscape Communicator の実行

  INSTALL コマンドを実行する場合、 Netscape Communicator が実行中であれば Developer Kit はインストールできません。Netscape Communicator をクローズしてから、INSTALL コマンドを実行してください。

- #### Netscape Communicator Version 4.04 と JIT コンパイラー

  Netscape Communicator Version 4.04 を使ってアプレットを実行する場合は、ジャストインタイム (JIT) ・コンパイラーがオンになっていなければなりません。 JIT がオフのまま Netscape Communicator Version 4.04 を使用したい場合は、 Netscape Communicator Version 4.04 の最新リフレッシュ・レベルが必要です。 最新リフレッシュ・レベルについては、下記の Web サイトをご覧ください。

  http://ps.software.ibm.com

- #### 「ゴースト」インストール・チェック・ボックスと Netscape Communicator Version 4.61

  Netscape Communicator Version 4.61 がインストールされていて最新リフレッシュをダウンロードしていない場合、インストール中にいくつかの「ゴースト」チェック・ボックスが現れる場合があります。 それらの「ゴースト」チェック・ボックスが Developer Kit のインストール作業に影響することはありませんが、下記の Web サイトから最新リフレッシュをダウンロードするとよいでしょう。
  http://ps.software.ibm.com

- Java Version 1.3 Developer Kit をインストールして、 その後 CONFIG.SYS ファイルから JAVA11 の項目を除去するか、 または システムから Developer Kit Version 1.1.x を削除すると、 HTML ページに <APPLET> タグ が含まれるアプレットを Netscape Version 4.x から立ち上げた場合、 アプレットを実行できません。Netscape Version 4.x ブラウザーから これらのアプレットを実行するには、 Developer Kit Version 1.3 の Java プラグインをインストールして、 アプレットの HTML ファイルが Java プラグインを使用するように変換する必要があります。 IBM Web for OS/2 から立ち上げられるアプレット は、 Java Version 1.1.x JVM がシステムにインストールされていなくても正常に動作しますから、 変更の必要はありません。

### 1.7 分割ファイルの結合

分割ファイルを結合するには、マージ・ユーティリティーを使う方法と、コマンド・プロンプトから手動で実行する方法とがあります。 下記の各サブセクションにおいて、分割ファイルを結合して、インストール可能な 1 個のファイルにする方法を説明します。

始める前に、次のことを確認してください :

- 特定のコンポーネントに対応する分割ファイルは、必ずその全部をダウンロードし、正しいファイル名を指定してください。 パッケージの一部をダウンロードしていない場合、またはダウンロード時にその名前を変更した場合、マージ・ユーティリティーからエラー・メッセージが表示され、パッケージは作成されません。
- すべてのファイル名を正しい順序で指定してください。 ダウンロード時にファイル名を変更した場合は、ダウンロード時に使用した名前 (変更後の名前) を指定してください。
- 結合後のファイル名は、元のパッケージの正しいファイル名でなければなりません。 (例えば、ランタイム環境の正しいファイル名は javainrt.exe です。) 正しいファイル名を指定しない場合、インストール・ユーティリティーはそのファイルを識別できません。

#### 分割ファイルの結合 - マージ・ユーティリティーを使う方法

分割ファイルを結合する作業を開始する前に、まず Joiner ユーティリティーを、ダウンロードした分割ファイルと同じディレクトリーにダウンロードする必要があります。 (ファイル名は joiner.exe です。) Joiner ユーティリティーには、マージ・ユーティリティーが含まれています。これは、分割ファイルを結合してインストール可能な 1 個のファイルにするためのものです。 Joiner ユーティリティーは、 Developer Kit のコンポーネントと同じページ Software Choice Catalog of Features からダウンロードできます。

コマンド・プロンプトで、ダウンロードした Joiner ユーティリティーを含むディレクトリーに移り、 `joiner` と入力します。 このコマンドにより、マージ・ユーティリティー (merge.exe) とそれに必要なデータ・ファイルが取り出されます。 分割ファイルを結合するために、マージ・ユーティリティーが使用されます。

コマンド・プロンプトで、ダウンロードした Joiner ユーティリティーを含むディレクトリーに移り、 `merge` と入力します。 これで、複数のファイルに分割されていたパッケージが 1 つのファイルになります。 ファイルをインストールするときには、「Developer Kit のインストール」を参照してください。

#### コマンド・プロンプトから手動で分割ファイルを結合します

1. 同じディレクトリーにインストールすることになるコンポーネントの分割ファイルは、必ずそのすべてをダウンロードするようにしてください。
2. コマンド・プロンプトにおいて、(ダウンロードした分割ファイルを含むディレクトリーに移り) 、各分割ファイルの名前と結合後のファイル名を下記の要領で入力します。 例えば、ランタイム環境の分割ファイルを結合する場合は、下記のようになります。

         copy /b javainrt.ex1 + javainrt.ex2 + javainrt.ex3 + javainrt.ex4 javainrt.exe

これで、複数のファイルに分割されていたパッケージが 1 つのファイルになります。 ファイルをインストールするときには、「Developer Kit のインストール」を参照してください。

## 2.0 Developer Kit のインストール

以下の項で、Developer Kit のインストールの手順について説明します。 Developer Kit またはそれに付随するコンポーネントをインストールする前に、必ずインストールの前にを読んで、ファイルの解凍方法とインストール要件について調べてください。

### 2.1 GUI によるインストール

Developer Kit のインストールは、デスクトップからする方法とコマンド・プロンプトからする方法があります。 以下の項で、それぞれの手順について説明します。

#### 2.1.1 デスクトップから

注 : Netscape Communicator が実行中のまま Developer Kit をインストールしようとすると、インストールは失敗します。Netscape の実行を停止してからインストール作業を開始するようにしてください。

以下の手順に従って、INSTALL.EXE オブジェクトを使ってください。

1. 「OS/2 システム」フォルダーをオープンします。
2. 「ドライブ」 オブジェクトをオープンします。
3. Developer Kit の解凍先ドライブをオープンします。
4. Developer Kit の解凍先フォルダーをオープンします。
5. INSTALL.EXE オブジェクトをダブルクリックすると、インストール・プログラムが開始されます。

INSTALL.EXE コマンドが実行されると、グラフィカル・ユーザー・インターフェース (GUI) が立ち上がり、プログラムのインストールが可能な言語を指定するためのボタンが表示されます。 インストールする言語をクリックすると、インストール・プログラムによりインストール作業が実行されます。

OS/2 Warp Version 4 およびデスクトップ (他のサポートされるプラットフォームすべての場合) の 「プログラム」フォルダーの中に「Developer Kit for OS/2」フォルダーが作成されます。

インストール作業の完了後、 Developer Kit の解凍先ディレクトリー内を消去したい場合は、「Developer Kit」フォルダーから DELINST.CMD オブジェクトを選択してください。 これにより、 解凍先ディレクトリーから Developer Kit 用のファイルとサブディレクトリーが削除されます。 Developer Kit から解凍されたもの以外のファイルおよびサブディレクトリー以外は削除されません。 ダウンロードしたファイルは、手動でも削除できます。

#### 2.1.2 コマンド・プロンプトから

注 : Netscape Communicator が実行中のまま Developer Kit をインストールしようとすると、インストールは失敗します。Netscape の実行を停止してからインストール作業を開始するようにしてください。

インストールを開始する際には、必ず Developer Kit の解凍先ディレクトリーに移動してください。 OS/2 コマンド・プロンプトで、下記のように入力します。

         INSTALL

この install コマンドを実行すると GUI が立ち上がり、プログラムのインストールが可能な言語を指定するためのボタンが表示されます。インストールする言語をクリックすると、インストール・プログラムによりインストール作業が実行されます。

OS/2 Warp Version 4 およびデスクトップ (他のサポートされるプラットフォームすべての場合) の 「プログラム」フォルダーの中に「Developer Kit for OS/2」フォルダーが作成されます。

インストール作業の完了後、 Developer Kit の解凍先ディレクトリー内を消去したい場合は、「Developer Kit」フォルダーから DELINST.CMD オブジェクトを選択してください。 これにより、解凍先ディレクトリーから Developer Kit 用のファイルとサブディレクトリーが削除されます。 Developer Kit から解凍されたもの以外のファイルおよびサブディレクトリー以外は削除されません。 ダウンロードしたファイルは、手動でも削除できます。

#### 2.1.3 インストールで選択できないコンポーネント

GUI を使って Developer Kit をインストールしようとしてコンポーネントが選択可能にならない場合は、そのコンポーネントを含む ZIP ファイルがダウンロードおよび解凍されていない可能性があります。 Software Choice Catalog of Features のページに戻り、必要な自己解凍 ZIP ファイルをダウンロードしてください。

Developer Kit のどのコンポーネントをインストールする場合でも、ランタイム環境コンポーネントをダウンロードおよびインストールし (またはすでにランタイム環境コンポーネントがインストールされており)、システムを再始動する必要があります。

#### 2.1.4 インストール中の障害からの回復

Developer Kit のインストール中にエラーが発生した場合は、インストール・オブジェクトが残っているかどうかを調べてそれを削除する必要があります。 インストール・オブジェクトを削除しないと、それ以降のインストールは、「オブジェクトが読み取り専用になっているかまたは別のプロセスで使用中になっているために 1 つ以上のコンポーネントをインストールできなかった」という内容のメッセージを出力し、エラーになる可能性があります。

構成/インストール/配布 (CID) インストールの場合、インストール・オブジェクトのアイコンは青い箱に赤いリボンのアイコンであり、デスクトップ上にあります。 手動インストールの場合、インストール・オブジェクトは x :\os2\install\ のフォルダーにあります (x はブート・ドライブ)。インストール・オブジェクトを削除するには、マウスの右ボタンでそのオブジェクトをクリックし、メニューから削除をクリックしてください。

あるいは、そのオブジェクトを含むディレクトリーに移動してから、ディレクトリー・ツリー全体を削除する方法もあります。 ディレクトリーの名前は「Install object」または「Java Version 1.3 for OS/2」です (インストール・エラーが発生したタイミングによって異なります)。

インストール・オブジェクトを削除したら、シャットダウンしてシステムを再始動してください。

#### インストール・オブジェクトを削除できない場合

上記の手順を実行してもインストール・オブジェクトが削除されない場合は、下記のようにしてください。

1. 「OS/2 コマンド・プロンプト」をオープンします。
2. ブート・ドライブの os2\install ディレクトリーに移動します。
3. Java Version 1.3.1 for OS/2 ディレクトリーおよびすべてのサブディレクトリーを削除します。
4. システムを再始動します。

#### 2.1.5 フィックスパック・レベルを修正してもインストールできない場合

システムのフィックスパック・レベルは要件を満たしているはずなのに、フィックスパック自動検査の段階でインストールできなくなってしまう場合は、フィックスパック自動検査機能をオフにすることができます。 そのためには、下記のいずれかの方法を使います。

方法 1:

1. CONFIG.SYS ファイルを編集し、JAVANOFPK=YES というステートメントを追加します。
2. システムを再始動してから、 Developer Kit のインストール作業をもう一度実行します。

方法 2:

1. 前に自己解凍ファイルを実行したディレクトリーの中で、インストールする言語に対応するディレクトリーに移動します。
2. CHECK.CMD ファイルを編集します。 下記のステートメントを探してください。

            disablecheck="NO"

   この「NO」を「YES」に変更します。 (このステートメントは 12 行目前後にあります。)
3. 自己解凍ファイルを実行したディレクトリーに戻り、もう一度ファイルを実行します。

### 2.2 自動 (CID) インストール

Developer Kit の自動インストールまたは構成/インストール/配布 (CID) インストールは、機能のインストールのコマンド・ライン・インターフェース (CLIFI) によって処理され、 15 〜 20 分またはそれ以上の時間がかかります。インストール・プログラム終了後、インストールを完了するためには、システムを再始動することが必要です。

CLIFI には 2 個の応答ファイルが必要です。 1 つは Developer Kit の応答ファイル (JAVA131.RSP)、もう 1 つはお客様がデフォルトの選択項目を変更するためのカスタム応答ファイルです。 インストール・パッケージの中には、カスタム応答ファイルのサンプルとして CID.RSP ファイルが含まれています。自動インストールを実行するには、このファイルと CID.CMD ファイルを修正することが必要になります。

注 : 自動 (CID) インストールには、機能のインストール、Version 1.2.3 以上が必要です。 また、Netscape Communicator が実行中のまま Developer Kit をインストールしようとすると、インストールは失敗します。 Netscape の実行を停止してからインストール作業を開始するようにしてください。

#### 2.2.1 CID 応答ファイルの修正

CID.RSP ファイルには、インストールするコンポーネントやターゲット・ドライブおよびターゲット・ディレクトリーを選択するための変数が含まれています。 CID.RSP ファイルは、デフォルトでは Developer Kit のすべてのコンポーネントをインストールするように設定されています。 この応答ファイルを修正することにより、インストールするコンポーネントを選択できます。 インストールを開始する前に、必要となるファイルがすべてダウンロードおよび解凍されていることを確認してください。 また、ツールキットをインストールする場合には、ランタイム環境がすでにインストールされている場合であっても、必ずランタイム環境をインストールするようにしてください。

選択可能なコンポーネントと変数の名前は、下記のとおりです。

コンポーネント | 変数
ランタイム環境 | JV13Runtime
ツールキット | JV13Toolkit
サンプル | JV13Samples
OS/2 ICAT Java 用デバッガー | JV13 Debugger
選択可能なコンポーネントと変数名のリスト

CID.RSP ファイルの中で、インストールする各コンポーネントについて「selection=1」をそれぞれ設定し、インストールしない各コンポーネントについて「selection=0」をそれぞれ設定してください。例えば、

- ランタイム環境コンポーネントと OS/2 ICAT デバッガー・コンポーネントをインストールする
- Netscape Version 4.x 用の Java プラグインを構成する
- IBM Web-browser for OS/2 用の Java プラグインを構成する
- Developer Kit をデフォルト JVM としてインストールする
- しかし、ツールキット・コンポーネントとサンプル・コンポーネントのインストールはしないという場合には、

以下のように変数を設定します。

         Java13.Continue=UNATTENDED
         Java13.LicenseAgree=AGREE
         JV13Runtime.Selection=1
         JV13RuntimeConfig.Selection=1
         JV13RuntimeUrls.Selection=1
         JV13NSFiles.Selection=1
         JV13MZFiles.Selection=1
         Java13.RUNDRV=x:
         JV13DefaultJVM.Selection=1
         JV13Samples.Selection=0
         JV13SamplesConfig.Selection=0
         JV13Samplesurls.Selection=0
         JV13Samples.SMPDRV=x :
         JV13Toolkit.Selection=0
         JV13ToolkitConfig.Selection=0
         JV13Debugger.Selection=1
         JV13Debuggerurls.Selection=1
         JV13Debugger.DBGDRV=x :

これはサンプルです。 特定のコンポーネントとそれに対応する変数値については、CID.RSP ファイルをご覧ください。 x はコンポーネントのインストール先ドライブです。

各 JV13xxConfig.Selection 変数ごとに、それぞれ 1 つの JV13xx.Selection 変数が対応しています。JV13xxConfig.Selection 変数は、JV13xx.Selection 変数と同じ値に設定してください。 例えば、JV13Toolkit.Selection=0 と設定した場合は JV13ToolkitConfig.Selection=0 と設定する必要があります (xx はコンポーネント名)。

上記の例の中のいくつかの変数は、 Developer Kit が正しくインストールされるために必ず設定する必要があります。 それらの変数は下記のとおりです。

JV13.LicenseAgree | プログラムのご使用条件に同意 この変数の値は、DISAGREE および AGREEです。プログラムのご使用条件を読んだ上でそれに同意したことを示すため、この変数は AGREE に設定してください。この変数を AGREE に変更しないと、Developer Kit はインストールされません。
JV13DefaultJVM.Selection | JVM Developer Kit をデフォルト JVM としてインストールする場合は、この変数の値を「1」に設定してください。
JV13MZFiles | IBM Web-browser for OS/2 用のプラグイン IBM Web-browser for OS/2 を構成する場合には、 この変数の値を「1」に設定してください。
JV13NSFiles | Netscape プラグイン Netscape プラグインを構成する場合は、この変数の値を「1」に設定してください。

インストール中に確認ウィンドウが表示されないようにするためには、 下記のように変数を設定してください。

        java13.continue=UNATTENDED

##### 2.2.1.1 コンポーネントのインストール・ドライブ

ツールキットは、 ターゲット・ドライブの \JAVA131 ディレクトリーにインストールされます。 ツールキットをインストールすると、ランタイム環境もツールキットと同じドライブに自動的にインストールされます。 ランタイム環境は、ツールキット、サンプル、およびデバッガーの各コンポーネントの前提条件です。

サンプル・コンポーネントと ICAT コンポーネントのターゲット・ドライブは、そのドライブを希望する値に設定することにより指定します。 そのターゲット・ドライブ上に Developer Kit がすでに存在する場合、インストール・プログラムはそれを置き換えます。

#### 2.2.2 自動インストールの開始

CID.CMD ファイルには、CID インストールのための CLIFI コマンドが含まれています。 インストール処理は複数言語のインストールが可能なものとなっているため、 CID.RSP ファイルの中で言語変数を指定する必要があります。 言語変数は下記のとおりです。

言語 | 言語変数
英語 | en
フランス語 | fr
ドイツ語 | de
イタリア語 | it
日本語 | jp
ポルトガル語 (ブラジル) | br
中国語 (簡体字) | cn
スペイン語 | es
中国語 (繁体字) | tw
言語およびそれに関連する言語変数

CLIFI コマンドは、 OS/2 コマンド・プロンプトで下記のように単一行コマンドとしても入力できます。

         clifi /a:c /r2 :cid.rsp/r :xx \JAVA131.rsp/b :c:/s  :d:\tmp\xx
         /l1 :ciderr.log /l2 :cidhist.log

前述のファイルの変数の設定については、下記を参照してください。

/r2 | ユーザー応答ファイルのドライブ、パス、および名前。
/r | 機能のインストール用応答ファイルの完全修飾名。
xx | 希望する言語変数。
/b | ブート・ドライブ。
/s | Developer Kit のファイルの解凍先の完全修飾名。
/l1 および /l2 | ログ・ファイルの完全修飾名 (オプション)。インストール中に何か問題が発生した場合は、ブート・ドライブの \install\wpinstal.log に加えて、ここに指定するファイルを参照してください。

インストール中に確認ウィンドウが表示されないようにするためには、 下記のように変数を設定してください。

        java13.continue=UNATTENDED

#### 2.2.3 CID インストールの「正常な」戻りコードとインストール障害

Developer Kit のインストール後、CID 戻りコードは「正常」であるにもかかわらず、インストールに失敗した場合、その原因としては下記のことが考えられます。

- 応答ファイルの中で Java13LicenseAgree 変数の後に「AGREE」を指定しなかった。
- システムのフィックスパック・レベルが正しいものではない。

フィックスパック・レベルが正しいものかどうかを確認するため、 CID 管理者にフィックスパック検査をしてもらうことをお勧めします。 (詳しくはフィックスパックの項を参照。) フィックスパック・レベルを調べるためのスクリプトの作成例としては、x :\Java131 ディレクトリーにある check.cmd ファイルを使用できます。 (x:\ は Developer Kit のインストール先ドライブ。)

#### 2.2.4 フィックスパック・レベルを修正してもインストールできない場合

システムのフィックスパック・レベルは要件を満たしているはずなのに、 フィックスパック自動検査の段階でインストールできなくなってしまう場合は、フィックスパック自動検査機能をオフにすることができます。そのためには、下記のいずれかの方法を使います。

方法 1:

1. CONFIG.SYS ファイルを編集し、JAVANOFPK=YES というステートメントを追加します。
2. システムを再始動してから、 Developer Kit のインストール作業をもう一度実行します。

方法 2:

1. 前に自己解凍ファイルを実行したディレクトリーの中で、インストールする言語に対応するディレクトリーに移動します。
2. CHECK.CMD ファイルを編集します。 下記のステートメントを探してください。

            disablecheck="NO"

   この「NO」を「YES」に変更します。 (このステートメントは 12 行目前後にあります。)
3. CID 処理をもう一度実行します。

### 2.3 NVDM/2 のインストールについての注意事項

NetView (R) Distribution Manager /2 (NVDM/2) の CID インストールでは、プロファイルを作成してから、変更ファイルを構築およびカタログすることが必要です。 NVDM/2 プロファイルで指定する応答ファイルは 1 個だけです。しかし、Developer Kit の自動インストールでは 2 個の応答ファイルを指定する必要があります。 さらに、NVDM/2 での変数と引き数の処理は、 Developer Kit のインストールで使用される機能のインストールの場合と異なっています。

注 : Netscape Communicator が実行中のまま Developer Kit をインストールしようとすると、インストールは失敗します。Netscape の実行を停止してからインストール作業を開始するようにしてください。

以下の項で、 NVDM/2 を使用して Developer Kit をインストールする 2 種類の方法について説明します。

#### 2.3.1 NVDM/2 プロファイル中の静的コマンド

NVDM/2 プロファイルの中で、PARMS 変数の CLIFI オプションをすべて指定します。 パラメーターは 1 行の中で指定し、二重引用符で囲む必要があります。

         Program=c:\os2\install\clifi.exe
         Parms="/a:c /r2:cid.rsp /r :\xx \JAVA131.rsp /b :c:/s :d:\tmp\xx
         /l1 :ciderr.log/l2 :cidhist.log"

この方法では、 ソース・ディレクトリーまたはログ・ファイル名を変更するごとにプロファイルを修正する必要があります。 一方、下記のようにして、 それらの値をワークステーション固有の変数値で置換する方法もあります。

         Program=c:\os2\install\clifi.exe
         Parms="/a:c /r2:$(ResponseFile) /r :$(SourceDir)\xx \JAVA131.rsp
         /b:c: /s :$(SourceDir\xx ) /l1 :$(LogFile1) /l2 :$(LogFile2)"
         ResponseFile=$(WorkstatName).rsp
         SourceDir=d: \tmp
         LogFile1=$(WorkstatName).log
         LogFile2=$(WorkstatName).lg2

この第 2 の方法では、各ワークステーションごとに別個の応答ファイルを用意し、 それぞれ WorkstatName を該当する値に設定する必要があります。

前述のファイルの変数の設定については、下記を参照してください。

d: | 一時ディレクトリー。
/r | 機能のインストール用応答ファイルの完全修飾名。
xx | 希望する言語変数。
/b | ブート・ドライブ。
/s | Developer Kit のファイルの解凍先の完全修飾名。
/l1 および /l2 | ログ・ファイルの完全修飾名 (オプション)。インストール中に何か問題が発生した場合は、ブート・ドライブの \install\wpinstal.log に加えて、ここに指定するファイルを参照してください。

### 2.4 WorkSpace On-Demand Version 2.0 における Developer Kit のインストール

注 : Netscape Communicator が実行中のまま Developer Kit をインストールしようとすると、インストールは失敗します。Netscape の実行を停止してからインストール作業を開始するようにしてください。

WorkSpace On-Demand Version 2.0 製品には、Java Version 1.1.6 for OS/2 Warp が含まれています。 Developer Kit (Version 1.3) は、 WorkSpace On-Demand のサーバーにもクライアントにもインストールできます。Developer Kit は、Java Version 1.1.x OS/2 Warp と共存します。 以下の項では、 WorkSpace On-Demand のサーバーおよびクライアントに Developer Kit をインストールする方法と、 Developer Kit をデフォルト JVM としてインストールする方法を説明します。

#### 2.4.1 WorkSpace On-Demand Version 2.0 サーバーにおける Developer Kit のインストール

WorkSpace On-Demand サーバーに Developer Kit をインストールするには、 GUI を使います。 その手順については、このガイドの GUI によるインストールの項を参照してください。

#### 2.4.2 WorkSpace On-Demand Version 2.0 クライアントにおける Developer Kit のインストール

WorkSpace On-Demand クライアントに Developer Kit をインストールするには、 自動 (CID) インストールを使います。自動 (CID) インストールの項で示されている手順を使い、Developer Kit のパッケージに含まれている CID.CMD ファイルと WSOD2.RSP ファイルを使用できます。 インストール作業は、WorkSpace On-Demand Version 2.0 サーバー上で実行されます。

注 : WorkSpace On-Demand クライアントにおいて、Developer Kit をデフォルト JVM としてインストールしたい場合には、CONFIG.SYS ファイルの中で `z:\JAVA11` の前に `z:\JAVA131` ディレクトリーとその中のファイルへの参照を含める必要があります。

##### 2.4.2.1 WorkSpace On-Demand Version 2.0 クライアントでの自動インストール

下記の手順を実行します。

1. CID.CMD ファイルにおいて、`/r2 :cid.rsp` を `/r2 :wsod2.rsp` に変更します (`/r2` はユーザー応答ファイルのドライブ、パス、および名前)。
2. 自動インストールの開始の項で説明されているように、
   - CID.CMD ファイルの中の `/s:d:\tmp\xx` を、インストール・パッケージの解凍先のドライブおよびディレクトリーで置き換えます (`xx` は希望する言語変数)。
   - CID.CMD の中の `/b:z` がクライアントのブート・ドライブを指すようにします。
3. WSOD2.RSP ファイルの中の選択項目を、 実際のインストールに合ったものにします。 デフォルトでは、ランタイム環境が選択されており、 その他のすべてのコンポーネントは選択されていません。 必要となるファイルがすべてダウンロードおよび解凍されていることを確認してください。 また、プログラムのご使用条件を読み、同意する場合には、 WSOD2.RSP ファイルの中で Java13.LicenseAgree 選択変数を AGREE に設定してください。 この変数を AGREE に変更しないと、ランタイム環境はインストールされません。
4. コマンド・プロンプトでファイル名を入力し、 更新済みの CID.CMD ファイルを実行します。

自動インストールを完了するには、この後の項も参照してください。

##### 2.4.2.2 WorkSpace On-Demand Version 2.0 クライアントでの CONFIG.SYS ファイルの修正

Developer Kit のランタイム環境コンポーネントを有効にするためには、 WorkSpace On-Demand の管理者が WorkSpace On-Demand の各クライアントの CONFIG.SYS ファイルに下記の事項を追加する必要があります。

下記のように追加します。

`z:\JAVA131\jre\dll` | LIBPATH ステートメントに追加
`z:\JAVA131\jre\bin;` | SET PATH ステートメントに追加

WorkSpace On-Demand クライアントの CONFIG.SYS ファイルは、 下記の 2 つのオプションに基づいて検索および編集できます。

- サーバーから特定のユーザーを対象とする場合、 CONFIG.SYS ファイルは下記のドライブおよびディレクトリーにあります。

         [rpldrive] :\ibmlan\rpl\machines\[client name] \config.sys

- 個々のマシン・クラスを使用して作成された各マシンのデフォルトの CONFIG.SYS を変更する場合、 CONFIG.SYS ファイルは下記のドライブおよびディレクトリーにあります。

         [rpldrive] :\ibmlan\rpl\machines\BB20.xx \ [machine class] \config.sys

変数の詳細は、以下の通りです。

[rpldrive] | RPL ディレクトリーが存在するドライブ。
[client_name] | WorkSpace On-Demand クライアントの名前。
xx | 国および領域コード
[machine_class] | WorkSpace On-Demand クライアントで使用されているマシン・クラスの名前。

##### 2.4.2.3 FIT ファイルを修正して WorkSpace On-Demand Version 2.0 クライアントにアクセスできるようにする

ランタイム環境を有効にするためには、 WorkSpace On-Demand の管理者が WorkSpace On-Demand の各クライアントのファイル索引テーブル (FIT) ファイルに下記の事項を追加する必要があります。

下記のように追加します。

         z:\JAVA131      BB20.xx \JAVA131

WorkSpace On-Demand クライアントの FIT ファイルは、 下記の 2 つのオプションに基づいて検索および編集できます。

- サーバーから特定のユーザーを対象とする場合、[client_name] .FIT ファイルは下記のドライブおよびディレクトリーにあります。

         [rpldrive] :\ibmlan\rpl\fits\[client_name] .FIT

- デフォルトの FIT を変更する場合、DFBB20xx .FIT ファイルは下記のドライブおよびディレクトリーにあります。

         [rpldrive] :\ibmlan\rpl\fits\DFBB20xx .FIT

WorkSpace On-Demand 管理者は、 WorkSpace On-Demand クライアントに対して JAVA131 ディレクトリーに対する読み取り実行アクセス権を付与することも必要です。

下記の LAN サーバー・コマンドを実行してください。

      NET ACCESS [rpldrive] \ibmlan\rpl\bb20.xx \JAVA131 /ADD RPLGROUP:RX
      NET ACCESS [rpldrive] \ibmlan\rpl\bb20.xx \JAVA131 /APPLY

変数の詳細は、以下の通りです。

[rpldrive] | RPL ディレクトリーが存在するドライブ。
[client_name] | WorkSpace On-Demand クライアントの名前。
xx | 国および領域コード

##### 2.4.2.4 WorkSpace On-Demand Version 2.0 クライアントに USER_HOME ディレクトリーを割り当てる

Developer Kit の USER_HOME ディレクトリーについては、読み取りと書き込みアクセスが必要になります。 セキュリティー証明書やプラグインのプロパティー・ファイルがこのディレクトリーに作成されるため、 このディレクトリーに対するアクセスが必要になるからです。 例えば、`z:\JAVA13_RW` を USER_HOME ディレクトリーとして指定し、そのディレクトリーに読み取りと書き込みアクセスを与えるには、 FIT ファイルに次の記述を (必ず 1 つの連続した行として) 追加してください。

         z:\JAVA13_RW      \\server_name \WRKFILES\client_name \JAVA_RW

server_name および client_name は、それぞれ WorkSpace On-Demand サーバーおよび WorkSpace On-Demand クライアントの名前で置き換えてください。z は、ランタイム環境のインストール先ドライブです。これは、デフォルトの FIT ファイルの中に入力することもできます。

WorkSpace On-Demand の管理者は、 さらに WorkSpace On-Demand の各クライアントの OS2.INI ファイルに下記の事項を追加する必要があります。 追加事項は、ヌルで終了しなければなりません。

下記のように追加します。

         Application = Java131
         Key = USER_HOME
         Value = z :\JAVA13_RW

INI エディターまたは NET APPPARM コマンドを使って WorkSpace On-Demand クライアント用に INI ファイルの項目を追加する方法については、「WorkSpace On-Demand 2.0 Handbook」を参照してください。 WorkSpace On-Demand クライアントの OS2.INI ファイルは、下記の 2 つのうちのいずれかの方法で検索できます。

- 特定ユーザーのサーバーにある場合 :

           [rpldrive] :\ibmlan\rpluser\[client name] \os2\os2.ini

- 個々のマシン・クラスを使用して作成された各マシンのデフォルトの OS2.INI を変更する場合、 OS2.INI ファイルは下記のドライブおよびディレクトリーにあります。

           [rpldrive] :\ibmlan\rpl\machines\BB20.xx \[machine class] \os2\os2.ini

各変数の詳細は、以下の通りです。

z | クライアント用のランタイム環境インストール先ドライブです。
[rpldrive] | RPL ディレクトリーが存在するドライブ。
[client_name] | WorkSpace On-Demand クライアントの名前。
xx | 国および領域コード
[machine class] | WorkSpace On-Demand クライアントで使用されているマシン・クラスの名前。

##### 2.4.2.5 WorkSpace On-Demand Version 2.0 クライアント用のフォントの設定

ランタイム環境のためのフォントを有効にするためには、WorkSpace On-Demand の管理者が WorkSpace On-Demand の各クライアントの OS2.INI ファイルに下記の事項を追加する必要があります。各追加事項は、ヌルで終了しなければなりません。 z は、クライアント用のランタイム環境インストール先ドライブです。

下記のように追加します。

      Application = PM_Fonts
      Key = courtbi_.ttf
      Value = z:\JAVA131\jre\lib\fonts\COURTBI_.TTF
      Application = PM_Fonts
      Key = courtb_.ttf
      Value = z:\JAVA131\jre\lib\fonts\COURTB_.TTF
      Application = PM_Fonts
      Key = courti_.ttf
      Value = z:\JAVA131\jre\lib\fonts\COURTI_.TTF
      Application = PM_Fonts
      Key = court_.ttf
      Value = z:\JAVA131\jre\lib\fonts\COURT_.TTF
      Application = PM_Fonts
      Key = lucb.ttf
      Value = z:\JAVA131\jre\lib\fonts\LUCB.TTF
      Application = PM_Fonts
      Key = lucbb.ttf
      Value = z:\JAVA131\jre\lib\fonts\LUCBB.TTF
      Application = PM_Fonts
      Key = lucbbi.ttf
      Value = z:\JAVA131\jre\lib\fonts\LUCBBI.TTF
      Application = PM_Fonts
      Key = lucbi.ttf
      Value = z:\JAVA131\jre\lib\fonts\LUCBI.TTF
      Application = PM_Fonts
      Key = lucs.ttf
      Value = z:\JAVA131\jre\lib\fonts\LUCS.TTF
      Application = PM_Fonts
      Key = lucsb.ttf
      Value = z:\JAVA131\jre\lib\fonts\LUCSB.TTF
      Application = PM_Fonts
      Key = lucsbi.ttf
      Value = z:\JAVA131\jre\lib\fonts\LUCSBI.TTF
      Application = PM_Fonts
      Key = lucsi.ttf
      Value = z:\JAVA131\jre\lib\fonts\LUCSI.TTF
      Application = PM_Fonts
      Key = luct.ttf
      Value = z:\JAVA131\jre\lib\fonts\LUCT.TTF
      Application = PM_Fonts
      Key = luctb.ttf
      Value = z:\JAVA131\jre\lib\fonts\LUCTB.TTF
      Application = PM_Fonts
      Key = luctbi.ttf
      Value = z:\JAVA131\jre\lib\fonts\LUCTBI.TTF
      Application = PM_Fonts
      Key = lucti.ttf
      Value = z:\JAVA131\jre\lib\fonts\LUCTI.TTF
      Application = PM_Fonts
      Key = thonbi_.ttf
      Value = z:\JAVA131\jre\lib\fonts\THONBI_.TTF
      Application = PM_Fonts
      Key = thonburi.ttf
      Value = z:\JAVA131\jre\lib\fonts\THONBURI.TTF
      Application = PM_Fonts
      Key = thonb_.ttf
      Value = z:\JAVA131\jre\lib\fonts\THONB_.TTF
      Application = PM_Fonts
      Key = thoni_.ttf
      Value = z:\JAVA131\jre\lib\fonts\Thoni_.TTF

INI エディターまたは NET APPPARM コマンドを使って WorkSpace On-Demand クライアント用に INI ファイルの項目を追加する方法については、「WorkSpace On-Demand Handbook 2.0」を参照してください。 WorkSpace On-Demand クライアントの OS2.INI ファイルは、 下記の 2 つのオプションに基づいて検索できます。

- サーバーから特定のユーザーを対象とする場合、 OS2.INI ファイルは下記のドライブおよびディレクトリーにあります。

         [rpldrive] :\ibmlan\rpluser\[client name]\os2\os2.ini

- 個々のマシン・クラスを使用して作成された各マシンのデフォルトの OS2.INI を変更する場合、 OS2.INI ファイルは下記のドライブおよびディレクトリーにあります。

         [rpldrive] :\ibmlan\rpl\machines\BB20.xx \ [machine class] \os2\os2.ini

各変数の詳細は、以下の通りです。

[rpldrive] | RPL ディレクトリーが存在するドライブ。
[client name] | WorkSpace On-Demand クライアントの名前。
xx | 国および領域コード
[machine class] | WorkSpace On-Demand クライアントで使用されているマシン・クラスの名前。

##### 2.4.2.6 WorkSpace On-Demand Version 2.0 クライアント用の Netscape プラグインのインストール

Netscape Version 4.x 用の Java プラグインをインストールするためには、 WorkSpace On-Demand の管理者が npjava.dll ファイルを WorkSpace On-Demand クライアントの Netscape Version 4.x プラグインのディレクトリーにコピーする必要があります。 次のように入力します。

         copy d:\JavaTemp \package\npjava.dll [rpldrive] :\ibmlan\rpl\bb20.xx \NETSCAPE\PROGRAM\PLUGINS\*.*

IBM web-browser for OS/2 の Java プラグインをインストールするためには、 npoji6.dll ファイルを WorkSpace On-Demand クライアントの Web-browser プラグインのディレクトリーにコピーする必要があります。ファイルをコピーするために以下のコマンドを入力します。

         copyd:\JavaTemp \package\npoji6.dll [rpldrive] :\ibmlan\rpl\bb20.xx \os2\os2web\PLUGINS\*.*

各変数の詳細は、以下の通りです。

d:\JavaTemp | ランタイム環境のファイルの解凍先の完全修飾名。
[rpldrive] | RPL ディレクトリーが存在するドライブ。
xx | 国および領域コード

WorkSpace On-Demand の管理者は、 さらに WorkSpace On-Demand の各クライアントの OS2.INI ファイルに下記の事項を追加する必要があります。 各追加事項は、ヌルで終了しなければなりません。

下記のように追加します。

         Application = Java Plug-in
         Key = JAVA_HOME
         Value = z: \JAVA131\jre

z は、クライアント用のランタイム環境インストール先ドライブです。

INI エディターまたは NET APPPARM コマンドを使って WorkSpace On-Demand クライアント用に INI ファイルの項目を追加する方法については、「WorkSpace On-Demand Handbook 2.0」を参照してください。WorkSpace On-Demand クライアントの OS2.INI ファイルは、下記の 2 つのうちのいずれかの方法で検索できます。

- サーバーから特定のユーザーを対象とする場合、OS2.INI ファイルは下記のドライブおよびディレクトリーにあります。

         [rpldrive] :\ibmlan\rpluser\[client name]\os2\os2.ini

- 個々のマシン・クラスを使用して作成された各マシンのデフォルトの OS2.INI を変更する場合、 OS2.INI ファイルは下記のドライブおよびディレクトリーにあります。

         [rpldrive] :\ibmlan\rpl\machines\BB20.xx \[machine class]\os2\os2.ini

各変数の詳細は、以下の通りです。

[rpldrive] | RPL ディレクトリーが存在するドライブ。
[client name] | WorkSpace On-Demand クライアントの名前。
xx | 国および領域コード
[machine class] | WorkSpace On-Demand クライアントで使用されているマシン・クラスの名前。

##### 2.4.2.7 WorkSpace On-Demand Version 2.0 クライアントで Developer Kit のコンポーネントを追加インストールする

WorkSpace On-Demand クライアントに対してランタイム環境以外のコンポーネントをインストールする場合は、 WSOD2.RSP ファイルの中でそのコンポーネントを選択することができます。

ツールキットをインストールする場合、WorkSpace On-Demand の管理者は、 各クライアントの CONFIG.SYS ファイルの中に下記の事項を追加する必要があります。
下記のように追加します。

`x:\java131\bin;` | SET PATH ステートメントに追加
`z:\JAVA131\lib;` | SET LIB ステートメントに追加
`z:\JAVA131\include;` | SET INCLUDE ステートメントに追加

z:\JAVA131 は、クライアント用ツールキットのインストール先のドライブおよびディレクトリーです。

##### 2.4.2.8 WorkSpace On-Demand Version 2.0 クライアントから Java のサンプルを実行する

サンプル・コンポーネントに含まれるサンプルを WorkSpace On-Demand のクライアントから実行できるようにするためには、 WorkSpace On-Demand サーバーの管理者が RPL\FITS\client_name.FIT ファイルの中に下記の行を追加する必要があります。

         z :\JAVA131\WEBLOGS \\server_name \WRKFILES\client_name \JAVA131\WEBLOGS
         z :\JAVA131\HOTJAVA \\server_name \WRKFILES\client_name \JAVA131\HOTJAVA

server_name および client_name は、それぞれリモート IPL サーバーおよびリモート IPL クライアントの名前で置き換えてください。z は、Developer kit のインストール先ドライブです。これは、デフォルトの FIT ファイルの中に入力することもできます。

リモート IPL クライアントに書き込みアクセス権が付与されているディレクトリーにサンプルが入っている場合、 そのリモート IPL クライアントからそのサンプル・コードをコンパイルできます。

##### 2.4.2.9 WorkSpace On-Demand Version 2.0 クライアントでのトラストの発行

Web サーバーに接続するためのトラスト (アクセス付与) を発行している場合、IDENTITYDB.OBJ ファイルは読み取りと書き込み可能になっていなければなりません。 接続するためには、FIT ファイルに下記の事項を追加してください。

         z :\JAVA131\WEBLOGS        \\ server_name \WRKFILES\ client_name \JAVA131\WEBLOGS
         z :\JAVA131\HOTJAVA        \\ server_name \WRKFILES\client_name \JAVA131\HOTJAVA
         z :\JAVA131\IDENTITYDB.OBJ \\server_name \WRKFILES\ client_name \JAVA131\IDENTITYDB.OBJ

##### 2.4.2.10 JIT コンパイラーと WorkSpace On-Demand Version 2.0 クライアント

WorkSpace On-Demand サーバーのインストール中に Developer Kit の Version 1.1.6 がインストールされた場合は、 WorkSpace On-Demand のクライアント・システムの CONFIG.SYS に下記の行が追加されています。

        set java_compiler=xxx

このコマンドにより、ジャストインタイム (JIT) ・コンパイラーはオフになります。

JIT コンパイラーをオンにするには、CONFIG.SYS ファイルから上記のコマンドを削除してください。 このファイルは、下記の 2 つのオプションに基づいて検索および編集できます。

- サーバーから特定のユーザーを対象とする場合、CONFIG.SYS ファイルは下記のドライブおよびディレクトリーにあります。

         [rpldrive] :\ibmlan\rpl\machines\[machine class]\config.sys

- 個々のマシン・クラスを使用して作成された各マシンのデフォルトの CONFIG.SYS を変更する場合、CONFIG.SYS ファイルは下記のドライブおよびディレクトリーにあります。

         [rpldrive] :\ibmlan\rpl\machines\BB20 .xx \[machine class]\config.sys

前述のファイルの変数の設定については、下記を参照してください。

[rpldrive] | 要求パラメーター・リストが存在するドライブ。
xx | 国および領域コード
[machine class] | WorkSpace On-Demand クライアントで使用されているマシン・クラスの名前。

##### 2.4.2.11 WorkSpace On-Demand Version 2.0 クライアント用の Java プラグインのコントロール・パネルの共通アプリケーションの作成

WorkSpace On-Demand Version 2.0 クライアント上で稼動する Java プラグイン・コントロール・パネル用の共通アプリケーションを作成するには、Netscape ファイルにアクセスできるようにする必要があります。アクセス制御は、Netscape APPPOST.FIT ファイルに指定します。

以下の例は、Java プラグインのコントロール・パネルを実行するための共通アプリケーションの作成方法を示しています。

         net app jctrlpnl /remark:"Java Plug-in Control Panel"
           /appdir:z:\java131 \jre\bin
           /command:"jctrlpnl.cmd"
           /type:wsod /interface:pm /add
        net appparm jctrlpnl NCC_POSTFITS=z:\netscape \program\apppost.fit
           /add /placement:b

z:\java131 は Java Developer Kit イメージのインストール先で、z:\netscape は Netscape イメージのインストール先です。

### 2.5 リモート IPL によるインストール

リモート IPL インストールでは、2 個の応答ファイルを作成し、リモート IPL サーバー上のディレクトリーやファイルを適切に設定することが必要になります。

インストールするクライアントごとに、下記のステップを実行してください。

1. Developer Kit の解凍済みインストール・ファイルをリモート IPL サーバー上に置きます。
2. GENFIRPL コマンドを実行します。 (詳しくは応答ファイルの作成の項を参照。)
3. 1 つのリモート IPL クライアントに対して CLIFI コマンドを実行します。 (詳しくはリモート IPL インストールの開始の項を参照。)
4. クライアントの FIT ファイルを修正します (機能のインストール用のファイルの更新およびリモート IPL クライアントから Java のサンプルを実行するの項を参照。)

#### 2.5.1 応答ファイルの作成

Developer Kit の解凍済みインストール・ファイルをリモート IPL サーバーに置くと、GENFIRPL コマンドを使用して 2 個の応答ファイルを作成します。 すなわち、リモート IPL サーバー用の FILES.RSP とリモート IPL クライアント用の JAVA131.RSP です。下記に GENFIRPL コマンドの例を示します。 コマンドは、1 行で入力してください。

         genfirpl /m :c:\javacode\xx   /r :c:\ibmlan\rpl
         /u :c:\ibmlan\rpluser  /f :c:\javacode\xx \JAVA131.rsp
         /c:client_name  /b :x:

GENFIRPL コマンドを発行する時点で、リモート IPL クライアントが実行中であってはなりません。 各リモート IPL クライアントごとに、該当するクライアント名とブート・ドライブを指定した GENFIRPL コマンドを 1 回ずつ実行する必要があります。

前述のファイルの変数の設定については、下記を参照してください。

/m | リモート IPL サーバーにおいて、Developer Kit のインストール・ファイルが含まれているディレクトリー。
xx | 希望する言語変数。
/r | RPL ディレクトリー。
/u | RPLUSER ディレクトリー。
/f | このリモート IPL クライアント用の応答ファイルの完全修飾名。
/c | このリモート IPL クライアントの名前。
/b | このリモート IPL クライアントのブート・ドライブ。
/nf | Java ファイル転送を抑止します。 このフラグを使うと、最初のリモート IPL クライアントのインストールの後、リモート IPL クライアントの追加インストールにおいて、 新しいクライアントごとに Developer Kit が再インストールされてしまうことを防ぐことができます。

#### 2.5.2 JAVA131.RSP ファイルの修正

JAVA131.RSP ファイルには、インストールするコンポーネントやドライブおよびディレクトリーを選択するための変数が含まれています。 JAVA131.RSP ファイルは、デフォルトでは Developer Kit のすべてのコンポーネントをインストールするように設定されています。この応答ファイルを修正することにより、インストールするコンポーネントを選択できます。 インストールを開始する前に、必要となるファイルがすべてダウンロードおよび解凍されていることを確認してください。

このファイルに含まれている長い行が切り捨てられないようにするため、TEDIT など 255 バイトを超える行を処理できるテキスト・エディターを使う必要があります。 このファイルはサイズが非常に大きいため、その修正には時間がかかるだけでなく、普通以上に入力ミスの発生する可能性があります。 JAVA131.RSP を修正する前にそのバックアップ・コピーを作成しておき、データが失われないようにしてください。

#### 2.5.3 機能のインストール用のファイルの更新

各リモート IPL クライアントのclient_name .FIT ファイルは、下記の行を含めるように修正する必要があります。 これは 1 行で入力する必要があります。

         z :\os2\install\install.inv \\server_name \WRKFILES\client_name
         \os2\install\install.inv

server_name および client_name は、それぞれリモート IPL サーバーおよびリモート IPL クライアントの名前で置き換えてください。z は、Developer Kit のインストール先ドライブです。

#### 2.5.4 リモート IPL インストールの開始

リモート初期プログラム・ロード (RIPL) インストールは CLIFI (機能のインストール) によって処理され、 15 〜 20 分またはそれ以上の時間がかかります。 リモート IPL サーバーに管理者としてログオンした後、リモート IPL サーバーのために作成した応答ファイル FILES.RSP を指定した CLIFI コマンドを、 下記のようにして実行します。

         clifi /a:i  /r:c:\javacode\files.rsp

ファイル転送を抑止していない場合は、CLIFI 実行後にリモート IPL サーバーを再始動する必要があります。

各リモート IPL クライアントごとに、それに対応する GENFIRPL コマンドの実行後に CLIFI コマンドを実行してください。

         clifi /a:i  /r :z:\xx \JAVA131.rsp

前述のファイルの変数の設定については、下記を参照してください。

/r | このリモート IPL クライアント用の応答ファイルの完全修飾名。 GENFICMD コマンドで指定したもの。
xx | 希望する言語変数。

#### 2.5.5 リモート IPL クライアントから Java のサンプルを実行する

サンプル・コンポーネントに含まれるサンプルをリモート IPL クライアントから実行できるようにするためには、リモート IPL サーバーの管理者が RPL\FITS\client_name .FIT ファイルの中に下記の行を追加する必要があります。

         z :\JAVA131\WEBLOGS \\server_name \WRKFILES\client_name \JAVA131\WEBLOGS
         z :\JAVA131\HOTJAVA \\server_name \WRKFILES\client_name \JAVA131\HOTJAVA

server_name および client_name は、それぞれリモート IPL サーバーおよびリモート IPL クライアントの名前で置き換えてください。 z は、Developer kit のインストール先ドライブです。

リモート IPL クライアントに書き込みアクセス権が付与されているディレクトリーにサンプルが入っている場合、 そのリモート IPL クライアントからそのサンプル・コードをコンパイルできます。

##### 2.5.5.1 リモート IPL クライアントでのトラストの発行

Web サーバーに接続するためのトラストを発行している場合、IDENTITYDB.OBJ ファイルは読み取りと書き込み可能になっていなければなりません。 接続するためには、FIT ファイルに下記の事項を追加してください。

         z :\JAVA131\WEBLOGS \\server_name \WRKFILES\client_name \JAVA131\WEBLOGS
         z :\JAVA131\HOTJAVA \\server_name \WRKFILES\client_name \JAVA131\HOTJAVA
         z :\JAVA131\IDENTITYDB.OBJ  \\server\WRKF\client\JAVA131\IDENTITYDB.OBJ

server_name および client_name は、それぞれリモート IPL サーバーおよびリモート IPL クライアントの名前で置き換えてください。z は、Developer kit のインストール先ドライブです。

これは、WorkSpace On-Demand のための Developer Kit のインストールの一部として、 WSOD.CMD コマンド実行時にデフォルト FIT ファイルの中に入力することもできます。

## 3.0 インストールの後

以下の項では、Developer Kit のインストール後に必要になることについて説明します。

### 3.1 参考資料

下記のリストに示されているオブジェクトが OS/2 の Developer Kit フォルダーに表示されるのは、 OS/2 Warp Server Version 4 が実行されている場合だけです。 OS/2 Warp Server for e-business を実行している場合は、 ここに示されている場所にある対応するドキュメンテーションを参照することができます。

- IBM の Java テクノロジー・センター :
  http://www.ibm.com/java/jdk/index.html
- Java ドキュメンテーション :
  http://www.javasoft.com/doc.html
- ICAT デバッガー (OS/2 Java 版)
  `x :\JAVA131\ICATJAVA\help\icatjvo.htm`
- Developer Kit README
  `x :\JAVA131\`

x は、Developer Kit のインストール先ドライブです。

ツールキット・コンポーネントまたは ICAT デバッガー (OS/2 Java 版) コンポーネントを、 ランタイム環境コンポーネントとは異なるディレクトリーにインストールした場合は、 これらの 2 つのオブジェクトに対応するディレクトリーをそれぞれ指定してください。 ランタイム環境のドキュメンテーションおよび ICAT デバッガー (OS/2 Java 版) が異なるディレクトリーにある場合、 またはインストールしていない場合、それらへのリンクは無効になります。

### 3.2 コンポーネントの追加インストール

Developer Kit の最初のインストールの後、 インストール手順を再実行することによりコンポーネントを追加インストールできます。 そのためには、Software Choice の Web サイトから再びファイルをダウンロードするか、 解凍したファイルすべてをシステム上に残しておくか、 または元の ZIP ファイルを取っておいて必要になった時点でもう一度ファイルを解凍する必要があります。

### 3.3 AWT の TextField および TextArea についての注意事項

AWT (Abstract Window Toolkit) の TextField および TextArea コントロールでは、現在のコード・ページに含まれない文字はサポートされません。米国英語システムを使用しているユーザーの場合、コード・ページ 850 (西ヨーロッパの諸言語をサポートする複数言語のコード・ページ) に切り替えることによって、さらに多くの言語の文字がそれらのコントロールに表示されるようにすることができます。

### 3.4 フォント・プロパティー・ファイルの変更はサポートしていない

Developer Kit に含まれているフォント・プロパティー・ファイルの変更はサポートされていません。

### 3.5 Java アプレットでの時刻の問題

Java アプレットにおいて時刻に関連した問題が発生する場合には、時間帯 (TZ) 変数の設定や変更が必要な場合があります。TZ 変数を設定するには、下記のいずれかを実行します。

- 「TCP/IP 構成」ノートブックの中の「一般」ページを表示します。 オンライン・ヘルプを使用して時間帯フィールドを設定します。
- CONFIG.SYS ファイルを編集して、SET TZ= ステートメントを追加または変更します。

### 3.6 OS/2 高位メモリー・サポート (HMS) を使って Java のヒープ・サイズを大きくする

標準的な OS/2 環境の場合、 1 つのアプリケーションで使用可能な仮想アドレス・スペースの最大値は 512MB であり、 Java ヒープ・サイズのために使用可能なメモリーは約 256MB に制限されています。 この制限は、OS/2 の高位メモリー・サポート (OS/2 HMS) を使うことによって変更できます。 OS/2 HMS を使うと、 1 つのアプリケーションで使用可能な仮想アドレス・スペースの最大値が 3GB になります。

OS/2 HMS がサポートされているプラットフォームは、下記のとおりです。

- WorkSpace On-Demand Servers
- OS/2 Warp Server for e-business

#### 3.6.1 OS/2 HMS を有効にする

使用可能な高位メモリーは、CONFIG.SYS ファイル内の VIRTUALADDRESSLIMIT の設定によって制御できます。 CONFIG.SYS ファイルにおいて、その値は MB 単位で指定します。 例えば :

            VIRTUALADDRESSLIMIT=2048

最小値は 512MB です。最小値を設定した場合は、アクセス可能サイズが 512MB である OS/2 の旧バージョンと互換になります。 512MB を超える値を指定した場合は、システムで同時に実行できるプロセスの数が少なくなります。

#### 3.6.2 Java のヒープのために OS/2 HMS を使う

Java 仮想マシン (JVM) に対してヒープを OS/2 HMS 中に取るよう指示するには、 下記の環境変数を設定します。

        SET JAVA_HIGH_MEMORY=1

OS/2 HMS を使用できない場合、このオプションは無視され、 ヒープは標準のアドレス・スペースから割り振られます。

#### 3.6.3 OS/2 HMS 使用上の制限事項

Java ヒープを OS/2 HMS 中に取った場合、そこから割り振られるオブジェクトは 16 ビット・コードからアクセスできなくなります。 これが問題になるのは、 Java アプリケーションがネイティブ・メソッド DLL を使用しており、 その DLL が 16 ビット・コンパイラーでコンパイルされたものであるか、 または 16 ビット・コードを含む他の DLL を呼び出すものである場合だけです。

### 3.7 拡張された BigDecimal クラス

このリリースには、BigDecimal クラス (com.ibm.math.BigDecimal) が含まれています。 これは、java.math.BigDecimal クラスに代わるものとして、 そのサポート・クラスである MathContext と共に用意されているものです。 現在 Java プログラムの中で java.math.BigDecimal クラスを使用していて、 この新しいクラスを使用したい場合には、 ソース・コードの中の import 文を下記のように変更する必要があります。

変更前 :

         import java.math.*;

変更後 :

         import com.ibm.math*;

これ以外の変更は不要です。

### 3.8 Java プラグイン

ここでは、Netscape Version 4.x 用および IBM Web-browser for OS/2 用の Java プラグインのインストール方法と使用方法を説明します。

#### 3.8.1 Netscape Communicator インストール後の Java プラグインのインストール

Developer Kit のインストール後に Netscape Communicator をインストールした場合、 Java プラグインをオンにするには、下記のステップを実行してください。

1. ランタイム環境の \JAVA131\ns\ ディレクトリーの中の plugin.exe ファイルを探してください。その plugin.exe ファイルを一時ディレクトリーにコピーします。
2. plugin.exe ファイルのコピー先ディレクトリーに移動して、 コマンド・プロンプトでファイル名を入力して plugin.exe ファイルを実行します。 このファイルを実行すると、下記のファイルが取り出されます。
   - instplug.cmd: Java プラグインのインストールのために使用される CLIFI コマンド。
   - npjava.dll: Java プラグイン dll。
   - nscheck2.exe: Netscape を検索するためのユーザー出口。
   - nsfiles.rsp: 機能のインストール (FI) の応答ファイル。 このファイルを編集しないでください。
   - nsuser.rsp: 部分ユーザー応答ファイルのサンプル。
   - package.ctl: FI で必要なパッケージ・ファイル。
3. \JAVA131\ns\ ディレクトリーに戻ります。
4. 正しいパスおよびブート・ドライブを指定するため、instplug.cmd ファイルを編集します。
5. Java プラグインを使用可能にするため、nsuser.rsp ファイルを編集します。Netscape Communicator の最新バージョンが使用可能となります。 (Netscape の特定のバージョンを使用したい場合は、nsuser.rsp ファイル中の JAVANSFILES.NSDRV 値を、完全修飾のドライブとディレクトリーに設定します。)
6. instplug.cmd ファイルを実行します。
7. システムを再始動します。

前述のファイルの変数の設定については、下記の変数リストを参照してください。

xx | 希望する言語変数。
/r | 機能のインストール用応答ファイルの完全修飾名。
/r2 | ユーザー応答ファイルのドライブ、パス、および名前。
/b | ブート・ドライブ。
/s | Developer Kit のファイルの解凍先の完全修飾名。
/l1 および /l2 | ログ・ファイルの完全修飾名 (オプション)。インストール中に何か問題が発生した場合は、ブート・ドライブの \os2\install\wpinstal.log ファイルに加えて、ここに指定するファイルを参照してください。

#### 3.8.2 IBM Web-browser for OS/2 インストール後の Java プラグインのインストール

Developer Kit のインストール後に IBM Web-browser for OS/2 をインストールした場合、 このブラウザー用の Java プラグインをオンにするために、 下記のステップを実行してください。

1. ランタイム環境の \JAVA131\ns\ ディレクトリー内の mzplugin.exe ファイルを探してください。その mzplugin.exe ファイルを一時ディレクトリーにコピーします。
2. mzplugin.exe ファイルのコピー先ディレクトリーに移動して、 コマンド・プロンプトでファイル名を入力して mzplugin.exe ファイルを実行します。 このファイルを実行すると、下記のファイルが取り出されます。

- insmzplg.cmd: Java プラグインのインストールのために使用される CLIFI コマンド。
- npoji6.dll: Java プラグイン dll。
- mzcheck2.exe: Netscape を検索するためのユーザー出口。
- mzfiles.rsp: 機能のインストール (FI) の応答ファイル。このファイルを編集しないでください。
- mzuser.rsp: 部分ユーザー応答ファイルのサンプル。
- package.ctl: FI で必要なパッケージ・ファイル。

3. \JAVA131\ns\ ディレクトリーに戻ります。
4. 正しいパスおよびブート・ドライブを指示するため、insmzplg.cmd ファイルを編集します。
5. Java プラグインを使用可能にするため、mzuser.rsp ファイルを編集します。IBM Web-browser for OS/2 の最新バージョンが使用可能となります。(IBM Web-browser for OS/2 の特定バージョンを使用したい場合は、mzuser.rsp ファイル中の JAVAMZFILES.NSDRV 値を、完全修飾のドライブとディレクトリーに設定します。)
6. insmzplg.cmd ファイルを実行します。
7. システムを再始動します。

前述のファイルの変数の設定については、下記の変数リストを参照してください。

xx | 希望する言語変数。
/r | 機能のインストール用応答ファイルの完全修飾名。
/r2 | ユーザー応答ファイルのドライブ、パス、および名前。
/b | ブート・ドライブ。
/s | Developer Kit のファイルの解凍先の完全修飾名。
/l1 および /l2 | ログ・ファイルの完全修飾名 (オプション)。 インストール中に何か問題が発生した場合は、ブート・ドライブの \os2\install\wpinstal.log ファイルに加えて、ここに指定するファイルを参照してください。

#### 3.8.3 Java プラグインの制御パネル

Java プラグインをインストール後、ランタイム時に Java プラグインの動作を制御することができます。 例えば、Java プラグイン始動時に Java コンソールを立ち上げるかどうかを、 Java プラグイン実行中に設定することができます。

制御パネルは Java アプリケーションの 1 つであり、 [x:\JAVA131 ]\jre\bin\jctrlpnl.cmd ファイルのコマンド・ファイルによって起動されます。 このコマンド・ファイルのアイコンは、Developer Kit のインストール先である x ドライブの [x:\JAVA131 ] ディレクトリーの中にあります。 デフォルトのディレクトリー名は JAVA131 です。

### 3.9 JIT コンパイラーをオフにする

Developer Kit には、ジャストインタイム (JIT) ・コンパイラーが含まれています。 JIT コンパイラーは、 Java アプリケーションやアプレットの実行中に頻繁に使用されるバイトコード・シーケンス用のマシン・コードを生成します。 デフォルトで、JIT は使用可能です。 JIT を使用不可にすると、Java アプリケーション、アプレット、 またはコンパイラー自身の問題を分離するために役立ちます。 その場合は、Java ランタイム・インタープリターに次のコマンドを渡します。

    SET JAVA_COMPILER=none

### 3.10 ファイル名の変更点

Microsoft (R) Windows (R) または Linux などのプラットフォームにおける長いファイル名とは違い、 OS/2 では 8.3 ファイル名規則に基づく短いファイル名のものがいくつかあります。 違いのあることがわかっているファイル名は、下記のとおりです。

長いファイル名 | OS/2 の短いファイル名
cmm.dll | orb.dll
fontmanager.dll | font.dll
ioser12.dll | iosr12.dll
java-rmi.exe | jrmi.exe
| policytool.exe | policy.exe

keytool.exe | keytol.exe
appletviewer.exe | applet.exe
tnameserv.exe | tnames.exe
rmiregistry.exe | rmireg.exe
.keystore | keystore.prp
8.3 ファイル名規則に基づいて、違いがあることがわかっている短いファイル名と長いファイル名

### 3.11 アプレット・ビューアーの構成作業

プロキシー・ゲートウェイを通じてインターネットに接続するため、アプレット・ビューアーを下記のよう設定します。

1. 「アプレット・プロパティー」をクリックします。
2. 「プロパティー」をクリックします。
3. プロキシー・サーバーとポートを、それぞれ対応するフィールドに入力します。
例えば、以下のように入力します。

         Http proxy server: myproxy.mycompany.com
         Http proxy port:   80

使用している Web ブラウザーが、すでにインターネットに接続するよう構成されている場合は、 その構成で設定されている値を使ってください。 例えば、WebExplorer (R) の場合は、 「サーバーの構成」ページの中の「プロキシー・ゲートウェイ」の値から、 先頭の「http://」と末尾の「/」を省略した値を使ってください。
プロキシー・ゲートウェイがわからない場合は、 プロキシー・サービスを使うことが許可されているかどうかをシステム管理者にお尋ねください。
4. 「適用」をクリックして、変更内容を保管します。
5. アプレット・ビューアーをクローズします。

### 3.12 Java のオプションおよびシステム・プロパティーの指定

Java のオプションとシステム・プロパティーは、IBM_JAVA_OPTIONS という環境変数を作成して、 必要な値をそれに設定することによって指定できます。 指定するすべての Java オプションまたはシステム・プロパティーの前には、 それぞれスペースがなければなりません (最初のオプションを除く)。 例えば、IBM_JAVA_OPTIONS は下記のように設定します。

    IBM_JAVA_OPTIONS=-Dmysysprop1=tcpip -Dmysysprop2=wait

同じオプションまたはプロパティーをコマンド行から (または JNI プログラムから) 指定する場合、 それらは IBM_JAVA_OPTIONS 環境変数に指定したオプションまたはプロパティーよりも優先されます。 この規則の唯一の例外は、-Xt、-Xtm、または -Xdebug を指定する場合です。 それらすべては、JITを使用すべきでないということを暗黙指定します。

下記の点に注意してください。

- JNI_VERSION_1_1 での実行時に IBM_JAVA_OPTIONS は無効です。
- Java オプションは、現行の形式で指定してください。例えば、-verbosegc ではなく -verbose:gc と指定します。

システム・プロパティー ibm.jvm.bootclasspath では、追加の検索パスを定義できます。このプロパティーの値は、-Xbootclasspath/p: で定義されている値と bootclass パスの間に挿入されます。 bootclass パスは、デフォルトのパスか、-Xbootclasspath: オプションで定義されているパスのいずれかになります。 これらのオプションの詳細については、 「3.1 参考資料」を参照してください。

### 3.13 RMI-IIOP

リモート・メソッド呼び出し (RMI) は、 Java 分散プログラミングのためのシンプルなメカニズムです。 RMI-IIOP は、Java の基本 RMI を拡張して、 CORBA (Common Object Request Broker Architecture) 標準の Internet Inter-ORB Protocol (IIOP プロトコル) を使って通信を実行するためのものです。これにより、 Java で実装されたものだけでなく別のプログラム言語で実装されたものも含め、 その他の CORBA オブジェクト・リクエスト・ブローカー (ORB) と直接対話できるようになります。

Developer Kit には、 RMI-IIOP を使ったアプリケーション開発のサポート機能が含まれています。 このサポートは、標準のランタイム環境インストールの一部であり、特別な設定や構成作業は不要です。

#### 3.13.1 IDL/Java コンパイラー

このリリースには IDL/Java コンパイラーが含まれています。 これは、CORBA Interface Definition Language (IDL) を Java に変換するツールです。 詳しくは、「IDL/Java コンパイラーユーザーズ・ガイド」を参照してください。 この資料は、下記のディレクトリーにあります。

         [x :\JAVA131]\DOCS\RMI-IIOP\toJavaPortableUG.htm

[x :\JAVA131] は、Developer Kit のインストール先ドライブおよびディレクトリーです。 デフォルトのディレクトリー名は JAVA131 です。

IDL/Java コンパイラーは CORBA 2.3 仕様をサポートしています。 これには、「valuetype」構成とそのマッピングを IDL から Java に変換する機能が組み込まれています。 詳細は、下記の FTP サイトにあります。

- ftp://ftp.omg.org/
  このメイン・ページから pub --> docs --> formal --> 99-07-53.pdf
  (IDL/Java マッピング)
- ftp://ftp.omg.org/
  このメイン・ページから pub --> docs --> formal --> 98-12-01.pdf
  (CORBA 2.3 コア) をクリックします。

IDL/Java コンパイラーが用意されているので、「rmic -idl」コマンドで生成される IDL を試してみることができます。 Java と Java の間で RMI-IIOP を使う場合には、 その生成された IDL と IDL/Java コンパイラーは必要ありません。 生成された IDL は、RMI-IIOP と C++ などの他の言語との相互操作のために使用されます。 C++ との相互協調処理がうまくいくようにするには、 生成 IDL をコンパイルする場合に CORBA 2.3 仕様をサポートする IDL/C++ コンパイラーを使う必要があります。

##### 3.13.1.1 IDL/Java コンパイラーの制約事項

IDL/Java コンパイラー使用時には、下記の点に注意してください。

- グローバル・スコープでエスケープ ID のスペルは、 IDL のプリミティブ型、オブジェクト、 または ValueBase と同じでないことがあります。 これは、シンボル・テーブルがそれらの ID と共にプリロードされるためです。 それらの再定義を可能にすると、元の定義が上書きされてしまう可能性があります。
- ローカルに値を渡す場合に、 ローカル・スタブやコピー・セマンティクスはありません。
- IDL の固定型はサポートされていません。
- 生成されるスタブでは、シリアライゼーションはサポートされません。 IDL と Java マッピング仕様 1998-08-22 のセクション 25.3.1.3 で要件が指定されていないためです。
- オクテット型の定数を宣言することはできません。

##### 3.13.1.2 IDL/Java コンパイラーに関する既知の問題

IDL/Java コンパイラーには、下記の問題のあることがわかっています。

- このコンパイラーでは、 コンパイル処理がエラーなしで完了するにもかかわらず出力が生成されない場合があります。 そのような場合には、-emitAll オプションを指定し、すべてのクラスが生成されるようにしてください。 -emitAll オプションを使う場合は、-pkgPrefix オプションも使用するようにしてください。このオプションの指定により、名前が「java」で始まるクラスに接頭部が追加され、JVM のクラスとの名前の競合が発生しないようになります。
- このコンパイラーは、CORBA::プリンシパル型を認識しません。 この型を使用しないでください。
- 同じスコープ内で同じ名前の定数とメソッドまたは属性を宣言しても、 エラーになりません。 下記の IDL がエラーを発生する可能性があります。

               interface t {
                 const long foo = 1;
                 attribute long foo;
               };

- 下記の IDL は、インターフェース B において「S は非宣言型です」というエラーになりますが、本来これはエラーではありません。

               interface A { struct S { short s; }; };
               interface B:A { typedef S new_S;
                           exception ex {S f1;}; // Error for "S" here
               };

- ある共用体のデフォルト文節で別の共用体が定義されている場合、 結果として作成される Java クラスがコンパイル・エラーになります。 これを避けるには、ネスト共用体を、 それを含む共用体の外側で定義するようにしてください。

#### 3.13.2 追加情報

IBM および RMI-IIOP については、下記の IBM Web サイトを参照してください。
http://www.ibm.com/java/jdk/rmi-iiop/index.html

その他の資料 :

- Developer Kit の README。これは、Developer Kit のインストール先ディレクトリーにあります。
- 「RMI-IIOP プログラマーズ・ガイド」。これは RMI-IIOP プログラム作成に関する入門書です。 下記の Web サイトまたはディレクトリーおよびファイルにあります。

- http://www.ibm.com/java/jdk/rmi-iiop/docs/win130/rmi_iiop_pg.html
- [x :\JAVA131]\DOCS\RMI-IIOP\rmi_iiop_pg.html

- 「IDL/Java コンパイラー・ユーザーズ・ガイド」。これには、IDL から Java コードを生成するためのツールの使用方法が載せられています。 下記の Web サイトまたはディレクトリーおよびファイルにあります。
  - http://www.ibm.com/java/jdk/rmi-iiop/docs/win130/toJavaPortableUG.htm
  - [x: \JAVA131]\DOCS\RMI-IIOP\toJavaPortableUG.htm
- サンプルのディレクトリーには、下記のものが含まれています。
  - JRMP プロトコルと IIOP プロトコルの間で交換可能な Hello World サンプル。 ([x :/JAVA131]/rmi-iiop/samples/Hello)
  - 標準 IDL プログラムとの相互操作を含む Hello World サンプル。 ([x :/JAVA131]/rmi-iiop/samples/idl)

  [x :\JAVA131] は、Developer Kit のインストール先ドライブです。 デフォルトのディレクトリー名は JAVA131 です。

- 「IDL マッピングへの Java言語」 の資料。RMI-IIOP の詳細な技術仕様が載せられており、下記のFTP サイトにあります。
  ftp://ftp.omg.org/
  このメイン・ページから、pub --> docs --> formal --> 99-07-59.pdf
- Sun Microsystems の Java アプリケーション・プログラミング・インターフェース (API) 情報は下記の Web サイト にあります。 http://java.sun.com/products/?frontpage-main

#### 3.13.3 RMI-IIOP で使われる用語

API | アプリケーション・プログラミング・インターフェース
CORBA | Common Object Request Broker Architecture
IDL | Interface Definition Language (IDL)
IIOP | Internet Inter-ORB Protocol
| ORB | オブジェクト・リクエスト・ブローカー (ORB)

RMI | リモート・メソッド呼び出し

### 3.14 Java Authentication and Authorization Service(JAAS)

Java 2 プラットフォームには、コードがどこから来たものか、 まただれが署名しているかに基づいてアクセスを制御するための仕組みが用意されています。 そのようなアクセス制御が必要なのは、 例えば、リモート・アプレットが公衆ネットワークからダウンロードされてローカルに実行されるというように、 Java プラットフォームが本質的に分散型であることによります。

Java 2 プラットフォームでは、 だれがそのコードを実行するかに基づいてアクセスを制御するための手段は用意されていません。 そのようなアクセス制御を提供するため、Java 2 のセキュリティー・アーキテクチャーでは下記のことが必要になります。

- 認証のための付加的なサポート (実際にだれがそのコードを実行しているかの特定)
- だれが認証されたかに基づく新しいアクセス制御を強化する既存の認証コンポーネントの拡張

これらの拡張機能は、Java Authentication and Authorization Service(JAAS) フレームワークによって提供されます。

JAAS については、下記の Web サイトを参照してください。

http://java.sun.com

このメイン・ページから、「Products & APIs」をクリックしてから、「Optional Packages」セクションが表示されるまでスクロールします。 この Web サイトの文書には、 Web 上のその他のたくさんの情報源へのリンクが含まれています。

#### 3.14.1 IBM JAAS と Sun JAAS の違い

IBM 版の JAAS for OS/2 は、Sun 版の JAAS for Windows とは異なり、com.sun.* パッケージは com.ibm.* パッケージになります。

#### 3.14.2 基本インストール

下記に示すのは、JAAS ファイルの位置に関する情報です。

- jaas.jar ファイルと jaas_lm.jar ファイルは、 ランタイム環境のインストール先ディレクトリーの jre\lib\ext サブディレクトリーに入っています。
.
- JAAS には、 現行のオペレーティング・システムのログイン情報を Java プログラムに反映させるためのシンプルな LoginModule が含まれています。 この機能のため、 下記のディレクトリー (ランタイム環境のインストール先ディレクトリー) に下記のファイルが用意されています。

             JAVA131\jre\bin:
                       jaas.dll
                       jaas_g.dll

- JAVA131\docs\jaas のドキュメンテーション用ディレクトリーには、 JAAS API のドキュメンテーションと module.html ファイルが入っています。 JAAS のドキュメンテーション・ディレクトリーの中で JaasDocs.jar ファイル (JAAS API のドキュメンテーション) を探し、 HPFS または JFS のパーティション上でそれを unjar (jar -xvf JaasDocs.jar) してください。 index.html ファイルを探してください。 ブラウザーで index.html ファイルをオープンすると、 API ドキュメンテーションの残りの部分を見ることができます。

注 : ランタイム環境は x :\JAVA131 ディレクトリーにインストールされます。(x は、Developer Kit のインストール先ドライブです。デフォルトのディレクトリー名は JAVA131です。)

### 3.15 JNI プログラミング情報

Java Version 1.1.1 から、Java Native Interface (JNI) を使うことにより、C プログラムから Java オブジェクトにアクセスできるようになりました。JNI では、以前の Native Method Interface (NMI) に比べて、より安定したインターフェースが提供されています。

多くの場合 JNI アプリケーションでは、Java の long、float、 および double 型を処理することが必要になります。 それは下記の理由によります。

- ネイティブ・メソッドのパラメーターとして変数を受け取るため。
- インスタンスまたはクラス変数を直接検査または変更するため。
- ネイティブ・メソッドの戻り値として変数を戻すため。
- ネイティブ・メソッドから他の Java メソッドを呼び出す場合に、 パラメーター・データとして変数を渡すため。

### JNI のネイティブ型

JNI には、JNI アプリケーションで使用できる型として、 Java の各型に対応するネイティブ型が用意されています。 それらの型は、下記のテーブルのとおりです。

JNI ネイティブ型
Java 型 | JNI ネイティブ型 | サイズ (バイト)
--- | --- | ---
long | jlong | 8
double | jdouble | 8
float | jfloat | 4
JNI ネイティブ型

注 : Java の long、double、 および float 型を処理しないアプリケーションの場合、 使用する必要はありません。

ネイティブ・メソッド・インプリメンテーションを定義する際に、 コンパイラーがネイティブ・メソッド・のシグニチャーを、 javah ユーティリティーによって生成されるヘッダー・ファイルのものと 対応付けることができるようにするため、JNI のネイティブ型を使用してください。

### ヘルパー関数およびマクロ

JNI ネイティブの jlong、jdouble、および jfloat 型は、 対応する C および C++ の long、double、および float 型との互換性がありません。 その間でキャストしようとすると、コンパイル・エラーになるか、 または実行時に予期しない動作になることがあります。 JNI ネイティブ型は Developer Kit 専用のものなので、 C および C++ の型との間の変換はしないでください。

JNI ヘッダー・ファイル (jni.h) には、int64_md.h という Developer Kit 付属のヘッダー・ファイルが組み込まれています。ネイティブ型の作業のために使用できるヘルパー関数およびマクロが定義されています。

int64_md.h (jlong の関係) に含まれる関数とマクロのほとんどは、 名前の先頭または末尾が ll になっています。 jdouble または jfloat に関係する関数のほとんどについては、 名前の一部として dbl、double、flt、 または float が含まれています。 jlong、jdouble、および jfloat に関係する定数もいくつかあります。

マクロには、下記のものが含まれています。

- ll_add() マクロ : 2 つの jlongs を加算して jlong を戻します。
- int2ll() マクロ : int を jlong に変換します。
- ll2str() 関数 : jlong を、64 ビット値を表す ASCII ストリング表記に変換します。
- flt2dbl() 関数 : jfloat を jdouble に変換し、 変換後の jdouble を戻します。
- dbl2nat() マクロ : jdouble を OS/2 ネイティブの double に変換します。
.
- dbl_sqrt() マクロ : jdouble の平方根を計算し、 jdouble として戻します。
- dbl2str() 関数と flt2str() 関数 : 引き数を ASCII ストリング表記に変換します。

### 3.16 パフォーマンスの考慮

OS/2 Warp Development Kit, Java 2 Technology Edition, Version 1.3.1 の幾つかのアプリケーションは、Version 1.3.0 と比較すると、ロードしたり、始動したりするのに時間がかかるように思うかもしれません。 このような場合、JAVA.EXE コマンド行パラメーターの -Xquickstart を使用してください。

デフォルトで OS/2 Java Version 1.3.1 ジャストインタイム・コンパイラーはアプリケーションをロードするためにかかる時間を増加するような付加的な最適化を行います。 これらの付加的な最適化の意図した利点は、アプリケーションのランタイム・パフォーマンスを向上するためです。 ランタイム・パフォーマンス利点の量およびロード時間低下の量は、アプリケーションにより異なります。 幾つかのアプリケーションは、Java Version 1.3.0 と比較するとほとんど変更されていません。-Xquickstart パラメーターは、起動時間を向上するであろう最適化の簡素化設定の使用を指定します。 -Xquickstart を使用する場合と、それを使用しない場合でのパフォーマンス差はアプリケーションにより異なります。

## 4.0 フォント・パッケージの追加

1 つ以上のフォント・パッケージを 1 つのファイルとしてダウンロードした場合のインストール手順については、 フォントの追加インストールの項をご覧ください。 分割ファイルをダウンロードした場合は、下記の手順を実行することにより、それらの分割ファイルを 1 つのインストール可能ファイルに結合してください。 その後、インストールに関する部分に進んでください。

1. インストールするフォントのすべての分割ファイルが同じディレクトリー内にあることを確認してください。
2. コマンド・プロンプトにおいて、ダウンロードした分割ファイルが入っているディレクトリーに移動し、コピー・コマンドを使ってファイルを結合します。 分割ファイルの名前と、結合後のフォント・ファイル名を組み込んでください。例えば、3 個の分割ファイルをダウンロードした場合、下記のように入力します。

         Copy /b ExamFont.txx  + ExamFont.txx  + ExamFont.txx ExamFont.ttf

各変数の詳細は、以下の通りです。

ExamFont.txx | ダウンロードした分割ファイルの名前。 (xx はダウンロードした分割ファイルの番号。) 必ず正しい順序で分割ファイルを指定してください。
ExamFont.ttf | 結合後のフォントのファイル名。

### 4.1 フォントの追加インストール

CID インストール方式またはフォント・パレット方式を使用するインストール情報について以下の項を参照してください。

#### 4.1.1 CID によるインストール方法

CID インストールによってフォントを追加インストールするには、下記のようにします。

1. Developer Kit の x: \JAVA131\fonti ディレクトリーの中で、 wtfont.exe ファイルを探してください。 x は、Developer Kit のインストール先ドライブです。
2. コマンド・プロンプトでファイル名を入力して、 wtfont.exe ファイルを実行します。 このファイルを実行すると、下記のファイルが取り出されます。

- wtfnt.cmd: CLIFI を実行するコマンド・ファイル。
- wtfonts.rsp: 機能のインストール (FI) の応答ファイル。 このファイルを編集しないでください。
- wtfntusr.rsp: ユーザー応答ファイル。これを編集して、インストールするフォントを選択してください。
- PACKAGE.CTL: フィーチャー・インストールで必要なパッケージ・ファイル。

3. PACKAGE.CTL ファイルを、 追加のフォント・パッケージをダウンロードしたディレクトリーにコピーします。
4. wtfnt.cmd ファイルを編集して、正しいパスおよびブート・ドライブを指定します。 パラメーターのリストについては、下記を参照してください。
5. wtfntusr.rsp ファイルを編集して、インストールするフォントを選択します。
6. wtfnt.cmd ファイルを実行します。
7. システムを再始動します。

注 : CLIFI から「メディアを挿入してください」と指示された場合には、wtfnt.cmd ファイルの中で /s: パラメーターを正しく設定するか、 またはインストールするフォント・パッケージと同じディレクトリーに PACKAGE.CTL ファイルを置く必要があります。

前述のファイル変数の設定については、下記の変数リストを参照してください。

/s: | フォント・パッケージと PACKAGE.CTL ファイルのソース。
/b: | ブート・ドライブ。
/r2: | ユーザー応答ファイルのドライブ、パス、および名前。
/r: | フィーチャー・インストール・ファイル (wtfntusr.rsp)。
/l1 および /l2 | ログ・ファイルの完全修飾名 (オプション)。 インストール中に何か問題が発生した場合は、ブート・ドライブの \os2\install\wpinstal.log ファイルに加えて、ここに指定するファイルを参照してください。

#### 4.1.2 フォント・パレットによるインストール

フォント・パレットを使ってフォントを追加インストールするには、下記のようにします。

1. 「OS/2 システム」フォルダーを開きます。
2. 「システム設定」フォルダーをクリックします。
3. 「フォント・パレット」をクリックします。
4. 「フォントの編集」ボタンをクリックします。
5. 「追加」ボタンをクリックします。
6. ダウンロードしたフォント・ファイルの入っているドライブおよびディレクトリーを入力します。
7. インストールするフォントを選択してから「追加」をクリックします。

## 5.0 2 バイト文字セット (DBCS) についての情報

既知の 2 バイト文字セット (DBCS) に関する考慮事項は、下記のとおりです。

### 5.1 インストール・パネルの DBCS テキストが表示されないか長すぎる

OS/2 の DBCS 版に Developer Kit をインストールする場合、 インストール・パネルに DBCS 文字が表示されなかったり、 表示ウィンドウを最大化してもテキスト行がウィンドウの右端からはみ出ていたりする可能性があります。

それらの問題を修正するには、まずインストール・プログラムを終了し、 OS/2 版の Netscape Navigator または Netscape Communicator のオブジェクトをオープンし、 「オプション」メニュー項目をクリックします。 「一般設定」ノートブックを開き、「フォント」タブを選択します。国ごとに該当するエンコード方式を選択してから、 プロポーショナルおよび固定フォントを MINCHO に設定します。 「OK」をクリックして、変更内容を保管します。 もう一度 Developer Kit のインストールを開始すると、 今度はテキストが正しく表示されるはずです。

### 5.2 中国語のシステムでは TrueType フォントのインストールが必要

中国語 (簡体字または繁体字) システムでは、 使用可能なすべての OS/2 TrueType フォントがインストールされていることを確認してください。 それらのフォントをインストールするには、下記のようにします。

1. OS/2 コマンド・プロンプトにおいて下記のように入力することにより、 選択インストール・プログラムを開始します (ブート・ドライブが C: の場合)。

            C:\OS2\INSTALL\INSTALL

   「システム構成」というタイトルのパネルが表示されます。
2. 「次ページ」ボタン (OS/2 Warp Version 4.0 の場合) または「OK」ボタン (OS/2 Warp Server for e-business の場合) をクリックして、 「OS/2 のセットアップとインストール」パネルを継続します。
3. 「OS/2 セットアップとインストール」パネルにおいて、「TrueType フォント」チェック・ボックスを選択します。
4. このチェック・ボックスの右にある「続く」ボタンをクリックします。
5. すべてのフォントのチェック・ボックスが選択されていることを確認してください。 「OK」をクリックします。
6. CD ドライブにオペレーティング・システムの CD-ROM (OS/2 Warp Server Version 4.0 または OS/2 Warp Server for e-business) を挿入します。
7. 「ソース・ディレクトリー」パネルの「OK」をクリックします。

適切なフォントがインストールされます。 フォント・インストールが完了したら、システムを再始動してください。

### 5.3 DBCS システム用のプログラム一時修正 (PTF) とフィックスパック

DBCS ユーザーの場合、 アジア式入力方式の操作に関連して下記のような現象が発生することがあります。 それらの項目の大部分は、オペレーティング・システム (OS) の最新リリースがあてられています。 しかし、最新リリースにアップグレードできない場合、日本の IBM サービス技術員に該当するプログラム一時修正 (PTF) またはフィックスパックが使用できるかについてお問い合わせください。

アジア式入力方式の操作に関連したいくつかの現象と、 関係のある DBCS システムについて、下記のテーブルに示します。

説明 | 関係する DBCS システム
--- | ---
フォーカスが別のフレームに移ると、IME でトラップが発生する。 | 中国語 (繁体字)
ルックアップ・ウィンドウ表示中にフォーカスが別のフレームに移ると、 変換操作が正しく動作しない。 | 中国語 (繁体字)
ルックアップ・ウィンドウ表示中にフォーカスが別のフレームに移ると、ルックアップ・ウィンドウが閉じない。 | 日本語
入力モード標識に正しい入力モードが表示されない。 | 日本語、中国語 (簡体字)、中国語 (繁体字)
アクティブ・クライアントにおいて、ESC キーを押しても変換ストリングが消えない。 | 中国語 (繁体字)
Java ネイティブ IME に切り替えると、変換キーが正しく動作しない。 | 日本語、中国語 (簡体字)、中国語 (繁体字)
IM フレームをたくさん開いていると、システムが作動しなくなる。 | 中国語 (繁体字)
ルックアップ・ウィンドウから DBCS 文字を選択せずに、英語入力モードにスイッチバックする場合、入力を継続できない。 | 中国語 (簡体字)、中国語 (繁体字)
アクティブ・クライアントにおいて、Ctrl+ スペース・キーを押しても変換ストリングが消えない。 | 中国語 (簡体字)
ルックアップ・ウィンドウを表示する時 Backspace キーを押すと、IME でトラップが発生する。 | 中国語 (簡体字)
アジア式入力方式の操作に関連したいくつかの現象と、関係のある DBCS システムの説明

### 5.4 アラビア数字のキャラクター・ディスプレイの制御

一部の国または地域において、アラビア数字が予期せず表示されることがあります。 国、地域特有の幾つかの OS/2 のバージョンでは、 x'00B0' 〜 x'00B9' の文字がアラビア数字の 0 〜 9 にマップされます。 本来の文字が表示されるようにするには、CONFIG.SYS の中で両方向属性を変更するか、 またはオブジェクトの「プロパティー」ノートブック (OS/2 Warp Server for e-business の場合は「設定」ノートブック) の言語ページを使って指定します。

### 5.5 OS/2 Warp Version 4 日本語版での日本語環境の設定

OS/2 Warp Version 4 の日本語版では、日本語環境のための下記の設定値を使用してください。

コード・ページ : | 932
シフト JIS (MS 漢字) コード : | 新 JIS

### 5.6 OS/2 Warp 日本語版で必要なフォント

Developer Kit を実行するには、システム上に下記のフォントが必要です。

名前 | スタイル
GOTHIC | Normal
GOTHIC | HeiseiKakuGothic-W5-H-90-TT
MINCHO | HeiseiMincho-W3-H-90-TT
OS/2 Warp 日本語版で必要なフォント

「OS/2 システム」フォルダーの中の 「システム設定」フォルダーの中にある「フォント・パレット」の中で、それらをチェックできます。

- GOTHIC Normal フォントは、GOTHIC システム日本語フォントの中に含まれています。
- GOTHIC HeiseiKakuGothic-W5-H-90-TT は、 新 JIS 順による IBM HeiseiKakuGothic TrueType フォントです。
- MINCHO HeiseiMincho-W3-H-90-TT は、 新 JIS 順による IBM HeiseiMincho TrueType フォントです。

これらのフォントは、選択インストール・プログラム・オブジェクトを使ってインストールできます。 これは「システム設定」フォルダーの「インストール/削除」フォルダー (OS/2 Warp Version 4 システムおよび OS/2 Warp Server for e-business の場合) にあります。

### 5.7 OS/2 Warp Server for e-business でのフォント表示の改善

OS/2 Warp Server for e-business では、 アウトライン・フォントとビットマップ・フォントの間の関連付けを有効にすることにより、 ポイント・サイズの小さいフォントの表示品質を改善することができます。 その関連付けを有効にするには、下記のようにします。

1. 「OS/2 システム」フォルダーを開きます。
2. 「システム設定」フォルダーを開きます。
3. 「システム」オブジェクトを開きます。
4. 「フォントの関連付け」ページを開きます。
5. 「フォントの関連付けを行う。」ボタンをチェックします。
6. システム・メニュー・アイコンをダブルクリックして、「システム」オブジェクトを閉じます。

ビットマップ・フォントの関連付けについてさらに詳しい情報を知りたい場合は、「ビットマップ・フォントとの関連付け」ページにある「ヘルプ」ボタンをクリックしてください。

## 6.0 Developer Kit のアンインストール

以下の項では、Developer Kit のアンインストールについて説明します。

Developer Kit のコンポーネントをアンインストールすることなく何度も Developer Kit の コンポーネントをインストールした場合、CONFIG.SYS ファイルの中に JAVA131 への参照が存在し続けます。 それらの参照を削除したい場合は、CONFIG.SYS ファイルからそれらを削除してください。

注 : Netscape Communicator が実行中のまま Developer Kit をアンインストールしようとすると、 アンインストールは失敗します。Netscape Communicator の実行を停止してからアンインストール処理作を開始してください。

### 6.1 デスクトップから

「Developer Kit の削除」オブジェクトを使ってアンインストールする場合は、下記のようにします。

1. 「OS/2 システム」フォルダーを開きます。
2. 「システム設定」フォルダーを開きます。
3. 「機能のアンインストール」フォルダーを開きます。 OS/2 Warp Version 4 からアンインストールする場合は、 まず「インストール/削除」フォルダーを開いてから「機能のアンインストール」フォルダーを開いてください。
4. 「Developer Kit for OS/2 の削除」オブジェクトをダブルクリックすると、 アンインストール・プログラムが開始されます。

付加的なフォント・ファイル、 または plugin.exe や mzplugin.exe のような Java プラグインを取り出した場合、 それらをシステムから削除するには、 インストール先ドライブおよびディレクトリーに移動してからそれらを削除してください。

### 6.2 OS/2 コマンド・プロンプトから

アンインストールを開始するには、 まずランタイム環境がインストールされているルート・ドライブに移動してください。 OS/2 コマンド・プロンプトで、下記のように入力します。

         JAVA131/UNINSTAL/UNINSTAL

アンインストール・プログラムによってアンインストール処理が実行されます。 削除されるのは、インストール処理で作成されたファイルおよびディレクトリーだけです。 例えば、 アプレット・ビューアーを実行することによって作成された HOTJAVA ディレクトリーなどはアンインストール時に削除されません。

付加的なフォント・ファイル、 または plugin.exe や mzplugin.exe のような Java プラグインを取り出した場合、 それらをシステムから削除するには、 インストール先ドライブおよびディレクトリーに移動してからそれらを削除してください。

### 6.3 WorkSpace On-Demand Version 2.0 からの Developer Kit のアンインストール

Developer Kit のアンインストール機能のサポートでは、 (\os2\install\installed features) というディレクトリーの中のインベントリー・オブジェクト (Java Version 1.3) にアクセスすることが必要になります。 WorkSpace On-Demand Version 2.0 クライアントと WorkSpace On-Demand Version 2.0 サーバーの両方の Developer Kit をインストールした場合、 Java Version 1.3 インベントリー・オブジェクトは壊れているか置き換えられています。この場合、クライアント・スペースから Developer Kit のコンポーネントを削除する際に、 アンインストール・プログラムは使用しないでください。

その代わりに、[rpldrive]\ibmlan\rpl\bb20.xx \JAVA131 のディレクトリー構造を削除し、 さらに WorkSpace On-Demand クライアント・イメージのディレクトリーに追加されたそのディレクトリーへの参照を削除してください。 (CONFIG.SYS、OS2.INI、および FIT ファイルなど。)

サーバーから Developer Kit を削除するには、\JAVA131 ディレクトリー構造を削除します。 このディレクトリー構造は、 「OS/2 システム」フォルダー中の「ドライブ」フォルダーから削除できます。

### 6.4 自動アンインストールの実行方法

Developer Kit をアンインストールするには、 OS/2 コマンド・プロンプトで下記の単一行コマンドを入力します。

         clifi /a:u /f:"<WP_INSTALLED>" /o:INV_JAVA13 /set:Selection=ALL

### 6.5 デフォルト JVM としての Developer Kit の削除

デフォルト Java 仮想マシン (JVM) としての Developer Kit を削除または置換するには、 CONFIG.SYS ファイルの中の PATH ステートメントから x:\JAVA131\JRE\BIN; ステートメントを削除してください。 変更を有効にするには、システムを再始動する必要があります。

## 7.0 既知の制限事項

- Developer Kit をデフォルト JVM としてインストールする場合、 障害が発生することがわかっているアプリケーションがいくつかあります。 それらは下記のとおりです。
  - LVMGUI: 論理ボリューム・マネージャーのためのグラフィカル・ユーザー・インターフェース
  - TCP/IP の一部のコンポーネント

- Developer Kit では、2GB 以上のファイルを読んだり書き込んだりできません。

- Java Cryptography Extensions (JCE) セキュリティー拡張機能をダウンロードしてインストールする場合には、 Java Cryptography Archictecture (JCA) の JAR ファイル (jre/lib/ext/ibmjca.jar) をインストール処理中に削除してください。 JCA 機能は JCE のサブセットであるため、 両方がインストールされていると Developer Kit が正しく機能しない可能性があります。

- JDBC (Java Database Connectivity) と Open Database Connectivity の間のブリッジ (JDBC-ODBC ブリッジ) はサポートされていません。

- Java プラグインは、このリリースの Developer Kit では印刷はサポートしていません。

- アプリケーションによっては、 Developer Kit の実行可能ファイルを JAVA131\bin ディレクトリーから検索するようにハードコーディングされているかもしれません。 実際に実行可能ファイルが存在するのは、x:\JAVA131 \jre\bin\ ディレクトリーの中です。 そのようなアプリケーションを使う場合は、 コマンド・プロンプトで下記のように入力することにより、 実行可能ファイルを JAVA131\bin ディレクトリーにコピーしてください。

           copy x:\JAVA131\jre\bin\*.exe to x:\JAVA131\bin

  x は、Developer Kit のインストール先ドライブです。デフォルトのディレクトリー名は JAVA131 です。

  サービス・レベルを Developer Kit に適用する場合は、 サービス・レベル適用後に上記のステップをもう一度実行してください。

- IBM Java プラグインを使用するとき、 ブラウザーが「ハング」するのを防ぐために、 アプレットがロードを完了できるようにしてください。 例えば、アプレットのロード中に「戻る」ボタンと「進む」ボタンを続けてクリックすると、 HTML ページをロードできない可能性があります。

- IBM Java プラグインは現在の Sun 版の Java プラグイン (1.3.0_01) と同じレベルの LiveConnect 機能をサポートしますが、 どちらのプラグインにも Live Connect の障害があることがわかっています。 LiveConnect に関連する障害を報告するとき、 Sun 版と IBM 版のどちらのプラグインで発生したかを明示してください。

- HPFS の最大ディスク・キャッシュ・サイズは、2MB です。 この最大サイズにより、Developer Kit のパフォーマンスが制限を受ける可能性があります。 ほとんどの環境では、キャッシュを大きくすれば、 システム・パフォーマンスとアプリケーションのロード時間は改善されます。 その他の OS/2 ファイル・システムで、大きなキャッシュ・サイズをサポートしているものは、 次のとおりです。

  - IBM の OS/2 Warp Server for e-business に組み込まれている JFS
  - IBM の OS/2 Warp Server Advanced に組み込まれている HPFS 386
- Pentium (R) MMX マシン以下でこれらの問題をやり直す場合、 環境変数を「JAVA_COMPILER=NONE」と設定することにより、この問題に対処することができます。

## 8.0 特記事項

(c) Copyright International Business Machines Corporation 1999, 2002. All rights reserved.

(c) Copyright IBM Japan 2002

米国政府機関ユーザーの権利の制限 - IBM Corporation との間の GSA ADP Schedule Contract により、 使用、複製、および開示が制限されます。

日本で現在使用可能な製品およびサービスに関する情報については、 日本の IBM 担当者にお問い合わせください。 本書で IBM 製品 、プログラム、またはサービスに言及していても、その IBM 製品、プログラム、 またはサービスのみが使用可能であることを意味するものではありません。 これらに代えて、IBM の知的所有権を侵害することのない、機能的に同等の 製品、プログラム、またはサービスを使用することができます。 ただし、IBM 以外の製品、プログラムまたはサービスの 操作性の評価および検証は、お客様の責任で行っていただきます。

IBM は、本書に記載されている内容に関して特許権 (特許出願中のものを含む) を保有している場合があります。 本書の提供は、お客様にこれらの特許権について 実施権を許諾することを意味するものではありません。 使用許諾については、下記の宛先に書面にてご照会ください。

〒106-0032 東京都港区六本木 3 丁目 2-31
IBM World Trade Asia Corporation
Intellectual Property Law & Licensing

以下の保証は、国または地域の法律に沿わない場合は、適用されません。

IBM およびその直接または間接の子会社は、本書を特定物として現存するままの状態で提供し、 商品性の保証、特定目的適合性の保証および法律上の瑕疵担保責任を含むすべての明示もしくは黙示の保証責任を負わないものとします。

国または地域によっては、法律の強行規定により、保証責任の制限が 禁じられる場合、強行規定の制限を受けるものとします。

本書は定期的に見直され、必要な変更 (例えば、技術的に不適確な表現や誤植など) は、 本書の次版に組み込まれます。 これらに対する変更は、定期的に行われます。これらの変更は、資料の改訂版に含まれます。 IBM は予告なしに、随時、 この文書に記載されている製品またはプログラムに対して、改良または変更を行うことがあります。

本書において IBM 以外の Web サイトに言及している場合がありますが、 便宜のため記載しただけであり、決してそれらの Web サイトを推奨するものでは ありません。それらの Web サイトにある資料は、この IBM 製品の資料の一部では ありません。それらの Web サイトは、お客様の責任でご使用ください。

IBM は、お客様が提供するいかなる情報も、お客様に対してなんら義務も負うことのない、 自ら適切と信ずる方法で、使用もしくは配布することができるものとします。

本プログラムのライセンス保持者で、 (i) 独自に作成したプログラムとその他のプログラム (本プログラムを含む) との間での情報交換、 および (ii) 交換された情報の相互利用を可能にすることを目的として、 本プログラムに関する情報を必要とする方は、下記に連絡してください。

JTCMAIL@uk.ibm.com
[Hursley Java Technology Center (JTC) contact]

本プログラムに関する上記の情報は、適切な使用条件の下で使用すること ができますが、有償の場合もあります。

本書で説明されているライセンス・プログラムまたはその他のライセンス資料は、 IBM 所定のプログラム契約の契約条項、IBM プログラムのご使用条件、 またはそれと同等の条項に基づいて、IBM より提供されます。

この文書に含まれるいかなるパフォーマンス・データも、管理環境下で 決定されたものです。そのため、他の操作環境で得られた結果は、異なる可能性があります。 一部の測定が、開発レベルのシステムで行われた可能性がありますが、 その測定値が、一般に利用可能なシステムのものと同じである保証はありません。 さらに、一部の測定値が、推定値である可能性があります。実際の結果は、異なる可能性があります。 お客様は、お客様の特定の環境に適したデータを確かめる必要があります。

IBM 以外の製品に関する情報は、その製品の供給者、出版物、 もしくはその他の公に利用可能なソースから入手したものです。 IBM は、それらの製品のテストは行っておりません。したがって、 他社製品に関する実行性、互換性、またはその他の要求については確証できません。 IBM 以外の製品の性能に関する質問は、それらの製品の供給者にお願いします。

IBM の将来の方向または意向に関する記述については、 予告なしに変更または撤回される場合があり、単に目標を示しているものです。

著作権使用許諾 :

本書には、様々なオペレーティング・プラットフォームでのプログラミング手法を例示するサンプル・アプリケーション・プログラムがソース言語で掲載されています。 お客様は、サンプル・プログラムが書かれているオペレーティング・ プラットフォームのアプリケーション・プログラミング・インターフェースに 準拠したアプリケーション・プログラムの開発、使用、販売、配布を目的として、 いかなる形式においても、IBM に対価を支払うことなくこれを複製し、改変し、 配布することができます。

これらのサンプルは、すべての条件下で十分にテストを行っていません。 したがいまして、IBM は、これらのプログラムの信頼性、実用性または機能について、 いかなる保証も負いません。 お客様は、IBM のアプリケーション・プログラミング・インターフェースに準拠したアプリケーション・プログラムの開発、 使用、販売、配布を目的として、いかなる形式においても、IBM に対価を支払うことなくこれを複製し、改変し、配布することができます。

このエディションは、OS/2 Warp Developer Kit, Java (TM) 2 Technology Edition の Version 1.3.1 および新しいエディションにおいて特に断りのない限り、 それ以降のすべてのリリースおよびモディフィケーション・レベルに適用されます。

このソフトウェアの一部は、Free Type Project が作成したものに基づいています。 Free Type Project の詳細については、 http://www.freetype.org をご覧ください。

## 9.0 商標

以下は、IBM Corporation の商標です。

IBM
OS/2
OS/2 Warp
NetView
WebExplorer

Java およびすべての Java 関連の商標およびロゴは、Sun Microsystems, Inc. の米国およびその他の国における商標または登録商標です。

Microsoft、Windows、Windows NT および Windows ロゴは、Microsoft Corporation の米国およびその他の国における商標です。

Action Media、LANDesk、MMX、Pentium および ProShare は、Intel Corporation の米国およびその他の国における商標です。

他の会社名、製品名およびサービス名などはそれぞれ各社の商標または登録商標です。

[インストールおよび構成ガイドの冒頭]