IBM WebSphere Development Studio Client for iSeries バージョン 5.1.2 マイグレーション・ガイド
この情報では、プロジェクトを IBM WebSphere Development Studio Client for iSeries バージョン 4.0、5.0、または 5.1 から移行する方法について説明します。
一般には、移行はシームレスで、意識されることがありません。既存のワークスペースを使用して、製品の新規バージョンでプロジェクトの処理を続行するだけです。
Java Tools、Web Tools、および WebFacing プロジェクトのカスタマイズと関連する一部の特別の場合には、移行ツールを使用するか、または特別の手動ステップを実行することが必要な場合があります。
重要: 現在、Development Studio Client for iSeries バージョン 4.0 あるいはバージョン 5.0 または 5.1 であり、WebSphere Development Studio Client バージョン 5.1.2 をインストールする場合は、インストール・プロセスにより前のバージョンの製品はアンインストールされます。Development Studio Client for iSeries バージョン 4.0、5.0、または 5.1 をアンインストールする前に、4.0、5.0、または 5.1 ワークスペースの位置をメモすることと、そのワークスペースのバックアップ・コピーを作成することもお勧めします。ワークスペースをバックアップしないと、バージョン 4.0、5.0、または 5.1 プロジェクトを失う場合があります。(デフォルトでは、これらのプロジェクトはアンインストールまたは削除されません。)
バージョン 5.0 または 5.1 ワークスペースの場所を見つけるには、以下のようにします。
- バージョン 5.0 をインストールした時にデフォルト位置を受け入れだ場合は、ワークスペースはディレクトリー X:\Documents & Settings\your userid \My Documents\IBM\wdsc\workspace にあります。ここで、X は、製品をインストール済みのドライブです。
- その他の場合、.metadata というディレクトリーを検索してください。すべのワークスペース・ディレクトリーには、メタデータ・ディレクトリーが入っています。.metadata が現れるディレクトリーがワークスペースであるのが普通です。
- プロジェクトなどの個々のリソースの位置を検索するには、以下のようにします (異なるタイプのプロジェクトのマイグレーションについて詳しくは、このガイドの後ろで説明します)。
- バージョン 5.0 または 5.1 IDE で「ナビゲーター」ビューに切り替えます。「ウィンドウ」>「ビューの表示」>「その他」をクリックします。「基本」を展開して、「ナビゲーター」を選択します。「OK」をクリックします。
- リソースの名前を右マウス・ボタンでクリックし、「プロパティー」を選択します。
- 左側で、「Info」をクリックします。
リソースの位置が右ペインに表示されます。
バージョン 4.0 ワークスペースの場所を検索するには、以下のようにします。
- バージョン 4.0 をインストールする時に、デフォルト位置を受け入れた場合は、ワークスペースはディレクトリー X:\WDSC\WSSD\workspace にあります。ここで、X は製品をインストールしたドライブです。
- その他の場合は、.metadata というディレクトリーを (「スタート」メニューから) 検索してください。すべてのワークスペース・ディレクトリーには metadata ディレクトリーが含まれています。.metadata ディレクトリーが見つかったら、そのディレクトリーを含むディレクトリーを確認します。そのディレクトリーがワークスペースの候補です。
- プロジェクトなどの個々のリソースの位置を検索するには、以下のようにします (異なるタイプのプロジェクトのマイグレーションについて詳しくは、このガイドの後ろで説明します)。
- バージョン 4.0 IDE で「ナビゲーター」ビューに切り替えます。「パースペクティブ」>「ビューの表示」>「その他」 をクリックします。「基本」を展開して、「ナビゲーター」を選択します。「OK」をクリックします。
- リソースの名前を右マウス・ボタンでクリックし、「プロパティー」を選択します。
- 左側で、「Info」をクリックします。
リソースの位置が右ペインに表示されます。
クイック・ポストインストール・ステップ:
- バージョン 5.1.2 製品を開始すると (「スタート」>「プログラム」>「IBM WebSphere Studio」>「Development Studio Client for iSeries」)、「WebSphere Studio」ウィンドウが開くので、ここでセッションに使用するディレクトリーを指定します。このウィンドウでバージョン 5.0 または 5.1 ワークスペースのディレクトリー位置を指定します。
- 新規ワークスペース・フォーマットに変換するかどうかを確認するプロンプトが出されたら、「OK」をクリックします。
本書には、バージョン 5.1.2 をインストールする前に お読みになる必要があるその他の情報が記載されています。しかし、すでにインストール済みの場合は、本書は、たとえば、X:\WDSC\install\help\migrate.htm にあります。
バージョン 5.1.2 への移行がワークスペースまたはプロジェクトに及ぼす影響に関して特定の情報が必要な場合は、基本 WebSphere Studio 製品と同梱で提供されているマイグレーション・ガイドの該当するセクションをお読みいただくことができます。このガイドの位置は、システム上の Development Studio Client の版によって異なります。
- WebSphere Development Studio Client Advanced Edition for iSeries バージョン 5.1.2 を手持ちの場合、マイグレーション・ガイド は CD 1 の wsad ディレクトリーにある migrate.html または migrate.pdf です。
- その他の場合、マイグレーション・ガイド は CD 1 の wssd ディレクトリーにある migrate.html または migrate.pdf です。
このガイドは、インストール後に、たとえば、以下から入手することもできます。
- C:\Program Files\IBM\WebSphere Studio\Application
Developer\v5.1\migrate.html
- C:\Program Files\IBM\WebSphere Studio\Site Developer\v5.1\migrate.html
JDK 1.4 における変更が原因で、バージョン 5.1.x で実行するページを生成するために「データベース Web ページ」および「Java Bean Web ページ」ウィザードを使用する場合は、Java(TM) パッケージを指定する必要があります。この問題は、「Java Bean Web ページ」ウィザードまたは IBM(R) Database Access Java Beans-Master Details Pattern にビュー Bean テンプレートを使用すると発生します。また、これは、作成時にパッケージが指定されていなかった、これらのウィザードで前に生成されたページおよび .java ファイルを含むプロジェクトにも適用されます。前に生成されたコードの場合、.java ファイルをパッケージに移動します。それから、.jsp ファイルを更新し、インポート・ステートメントおよびクラス情報を更新します。そのプロジェクトの web.xml ファイル中で、サーブレット・クラス・エントリーを更新します。
このセクションでは、Development Studio Client for iSeries バージョン 5.0 で作成されたプログラム呼び出し Bean を
バージョン 5.1.2 に移行する方法について説明します。
インストール後:
- バージョン 5.1.2 製品を開始すると (「スタート」>「プログラム」>「IBM WebSphere Studio」>「Development Studio Client for iSeries」)、「WebSphere Studio」ウィンドウが開くので、ここでセッションに使用するディレクトリーを指定します。このウィンドウでバージョン 5.0 ワークスペースのディレクトリー位置を指定します。
- 新規ユーザー・インターフェース・フォーマットに変換するかどうかを確認するプロンプトが出されたら、「OK」をクリックします。
- プロジェクトの Java のビルド・パスを変更すると、前のクラスパスは削除されます。
- Java プロジェクトを右マウス・ボタンでクリックして、「プロパティー」を選択します。
- 左側で、「Java のビルド・パス」を選択します。
- 「ライブラリー」タブを選択し、以下の JAR ファイルを選択し、「除去」をクリックしてクラスパスから除去します。
WDSC_HOME/plugins/com.ibm.etools.iseries.toolbox_5.1.0/runtime/jt400.jar
WDSC_HOME/plugins/com.ibm.etools.iseries.webtools_5.1.0/lib/iwdtrt.jar
WDSC_ECLIPSE_HOME/plugins/org.apache.xerces_4.1.3/xercesImpl.jar/
j2ee.jar
4. すべての PCML ファイルに関して「プログラム呼び出し」ウィザードを再実行します。
インストール後:
- バージョン 5.1.2 製品を開始すると (「スタート」>「プログラム」>「IBM WebSphere Studio」>「Development Studio Client for iSeries」)、「WebSphere Studio」ウィンドウが開くので、ここでセッションに使用するディレクトリーを指定します。このウィンドウでバージョン 5.0 ワークスペースのディレクトリー位置を指定します。
- 新規ユーザー・インターフェース・フォーマットに変換するかどうかを確認するプロンプトが出されたら、「OK」をクリックします。
- 「J2EE マイグレーション」ウィザードを使用して、以下を行います。
- プロジェクト構造をバージョン 5.1.2 に変換する。
- オプションで、J2EE レベル 1.2 からレベル 1.3 へ移行する。
- Web パースペクティブ内のプロジェクト名を右マウス・ボタンでクリックし、「移行」>「iSeries Web ツール・プロジェクト」を選択します。
- 「マイグレーションの確認」ウィンドウには、プロジェクトの構造と内容がマイグレーションされることが示されます。このプロセスを続行するには、「OK」をクリックします。
- マイグレーションにより、WEB-INF\lib フォルダー内の iwdtrt.jar と jt400.jar がバージョン 5.1.2 jar ファイルに置き換えられます。
- すべての PCML ファイルに関して「プログラム呼び出し」ウィザードを再実行します。
- すべての Web サービス Bean に関して「Web サービス」ウィザードを再実行します。
- この移行は、Web サービス Bean そのもののみに適用されます。「Web サービス」ウィザードによって生成されたコードには、手動移行およびクリーンアップが必要です。
このセクションでは、Development Studio Client for iSeries バージョン 5.0 で作成されたプログラム呼び出し Bean を
バージョン 5.1.2 に移行する方法について説明します。
インストール後:
- バージョン 5.1.2 製品を開始すると (「スタート」>「プログラム」>「IBM WebSphere Studio」>「Development Studio Client for iSeries」)、「WebSphere Studio」ウィンドウが開くので、ここでセッションに使用するディレクトリーを指定します。このウィンドウでバージョン 5.0 ワークスペースのディレクトリー位置を指定します。
- 新規ユーザー・インターフェース・フォーマットに変換するかどうかを確認するプロンプトが出されたら、「OK」をクリックします。
- プロジェクトの Java のビルド・パスを変更すると、前のクラスパスは削除されます。
- Java プロジェクトを右マウス・ボタンでクリックして、「プロパティー」を選択します。
- 左側で、「Java のビルド・パス」を選択します。
- 「ライブラリー」タブを選択し、以下の JAR ファイルを選択し、「除去」をクリックしてクラスパスから除去します。
WDSC_HOME/plugins/com.ibm.etools.iseries.toolbox_5.0.0/runtime/jt400.jar
WDSC_HOME/plugins/com.ibm.etools.iseries.webtools_5.0.0/lib/iwdtrt.jar
WDSC_ECLIPSE_HOME/plugins/org.apache.xerces_4.0.7/xercesImpl.jar/
j2ee.jar
4. すべての PCML ファイルに関して「プログラム呼び出し」ウィザードを再実行します。
インストール後:
- バージョン 5.1.2 製品を開始すると (「スタート」>「プログラム」>「IBM WebSphere Studio」>「Development Studio Client for iSeries」)、「WebSphere Studio」ウィンドウが開くので、ここでセッションに使用するディレクトリーを指定します。このウィンドウでバージョン 5.0 ワークスペースのディレクトリー位置を指定します。
- 新規ユーザー・インターフェース・フォーマットに変換するかどうかを確認するプロンプトが出されたら、「OK」をクリックします。
- 「J2EE マイグレーション」ウィザードを使用して、以下を行います。
- プロジェクト構造をバージョン 5.1.2 に変換する。
- オプションで、J2EE レベル 1.2 からレベル 1.3 へ移行する。
- Web パースペクティブ内のプロジェクト名を右マウス・ボタンでクリックし、「移行」>「iSeries Web ツール・プロジェクト」を選択します。
- 「マイグレーションの確認」ウィンドウには、プロジェクトの構造と内容がマイグレーションされることが示されます。このプロセスを続行するには、「OK」をクリックします。
- マイグレーションにより、WEB-INF\lib フォルダー内の iwdtrt.jar と jt400.jar がバージョン 5.1.2 jar ファイルに置き換えられます。
- すべての PCML ファイルに関して「プログラム呼び出し」ウィザードを再実行します。
- すべての Web サービス Bean に関して「Web サービス」ウィザードを再実行します。
このセクションでは、Development Studio Client for iSeries
バージョン 4.0 で作成したプログラム呼び出し Bean を
バージョン 5.1.2 にマイグレーションする方法について説明
します。
インストール後:
- バージョン 5.1.2 製品を開始すると (「スタート」>「プログラム」>「IBM WebSphere Studio」>「Development Studio Client for iSeries」)、「WebSphere Studio」ウィンドウが開くので、ここでセッションに使用するディレクトリーを指定します。このウィンドウでバージョン 4.0 ワークスペースのディレクトリー位置を指定します。
- 新規ユーザー・インターフェース・フォーマットに変換するかどうかを確認するプロンプトが出されたら、「OK」をクリックします。
- プロジェクトの Java のビルド・パスを変更すると、前のクラスパスは削除されます。
- Java プロジェクトを右マウス・ボタンでクリックして、「プロパティー」を選択します。
- 左側で、「Java のビルド・パス」を選択します。
- 「ライブラリー」タブを選択し、以下の JAR ファイルを選択し、「除去」をクリックしてクラスパスから除去します。
ECLIPSE_HOME/plugins/com.ibm.etools.iseries.toolbox/runtime/jt400.jar
ECLIPSE_HOME/plugins/com.ibm.etools.iseries.webtools/lib/wdt400rt.jar
ECLIPSE_HOME/plugins/com.ibm.etools.websphere.runtime/lib/j2ee.jar
ECLIPSE_HOME/plugins/com.ibm.etools.websphere.runtime/lib/xerces.jar
- すべての PCML ファイルに関して「プログラム呼び出し」ウィザードを再実行します。
- この移行は、プログラム呼び出し Bean そのもののみに適用されます。「プログラム呼び出し」ウィザードによって生成されたコードには、手動移行およびクリーンアップが必要です。
インストール後:
- バージョン 5.1.2 製品を開始すると (「スタート」>「プログラム」>「IBM WebSphere Studio」>「Development Studio Client for iSeries」)、「WebSphere Studio」ウィンドウが開くので、ここでセッションに使用するディレクトリーを指定します。このウィンドウでバージョン 4.0 ワークスペースのディレクトリー位置を指定します。
- 新規ワークスペース・フォーマットに変換するかどうかを確認するプロンプトが出されたら、「OK」をクリックします。
- 「J2EE マイグレーション」ウィザードを使用して、以下を行います。
- プロジェクト構造をバージョン 5.1.2 に変換する。
- オプションで、J2EE レベル 1.2 からレベル 1.3 へ移行する。
- Web パースペクティブ内のプロジェクト名を右マウス・ボタンでクリックし、「移行」>「iSeries Web ツール・プロジェクト」を選択します。
- 重要: この時点でプロジェクトをクローズして再びオープンし、リソースの削除に関連する例外を回避します。
- 「マイグレーションの確認」ウィンドウには、プロジェクトの構造と内容がマイグレーションされることが示されます。このプロセスを続行するには、「OK」をクリックします。
- 移行により、WEB-INF\lib フォルダーから wdt400rt.jar と wdt400tb.jar は除去され、WEB-INF\lib フォルダーにバージョン 5.1.2 の iwdtrt.jar と jt400.jar がコピーされます。
- すべての PCML ファイルに関して「プログラム呼び出し」ウィザードを再実行します。
- すべての Web サービス Bean に関して「Web サービス」ウィザードを再実行します。
- バージョン 5.0 では、Web サービス Bean をデフォルト・パッケージ内に生成できました。バージョン 5.1 以来、「Web サービス」ウィザードを呼び出す前に、この Bean を指定されたパッケージ内で生成する必要があります。
- この移行は、Web サービス Bean そのもののみに適用されます。「Web サービス」ウィザードによって生成されたコードには、手動移行およびクリーンアップが必要です。
インストール後:
- バージョン 5.1.2 製品を開始すると (「スタート」>「プログラム」>「IBM WebSphere Studio」>「Development Studio Client for iSeries」)、「WebSphere Studio」ウィンドウが開くので、ここでセッションに使用するディレクトリーを指定します。このウィンドウでバージョン 4.0 ワークスペースのディレクトリー位置を指定します。
- 新規ワークスペース・フォーマットに変換するかどうかを確認するプロンプトが出されたら、「OK」をクリックします。
- メインメニューで、「ウィンドウ」>「設定」をクリックします。
- 左側で、「LPEX エディター」を展開して、「パーサー」を選択します。
- 右側のペインで、「ILErpg」を選択します。下の「クラス名」フィールドで、クラス名を com.ibm.etools.iseries.editor.ISeriesEditorRPGILEParserに変更します。「設定」をクリックします。
- 右側のペインで、「rpg」を選択します。下の「クラス名」フィールドで、クラス名を com.ibm.etools.iseries.editor.ISeriesEditorRPGOPMParserに変更します。「設定」をクリックします。
- 「適用」をクリックします。「OK」をクリックします。
バージョン 4.0、5.0.x、または 5.1.x からの既存プロジェクトがある場合は、5.1.2 ワークベンチの開始時に古い方のワークスペースを指定することができ、そのプロジェクトを現状のまま 実行することができます。しかし、プロジェクトの表示は完全ではない場合があります。たとえば、前のリリースからのレコード JSP ファイルおよび一部のスタイル・ファイルは、5.1.2 ツリー・ビューに表示されません。
初めて DDS ファイルを変換すると、プロジェクト構成は新規 5.1.2 レイアウトを反映するように更新されます。たとえば、新規の実行時 Jar ファイルおよびテンプレート・ファイルがインポートされます。これは、「インポート」ウィザードが特に選択された場合と同じ方法で行われます。
WebSphere Development Studio Client バージョン 4.0、5.0、または 5.1 からの WebFacing プロジェクトがある場合は、「インポート」ウィザードを使用して WebFacing プロジェクトを Development Studio Client バージョン 5.1.2 に移行できます。以下のステップに従ってください。
インストール後:
- 「ファイル」>「インポート」を選択します。
- 「WebFacing プロジェクト」を選択します。「次へ」をクリックします。
- バージョン 5.1.2 に移行したい WebFacing プロジェクトが入っているフォルダーをブラウズします。「次へ」をクリックします。
注:
バージョン 5.1.2 にアップグレードしても、WebFacing プロジェクトは元のワークスペース・ディレクトリーで使用可能なままになっています。
- Development Studio Client 5.0 または 5.1 からマイグレーションする場合は、「始める前に」の下にある、ワークスペースの検索に関するセクションを参照します。
- ウィザードで検索した WebFacing プロジェクトは、「検出された WebFacing プロジェクト」ペインにリストされます。インポートしたいプロジェクトを選択してください。ウィザードは、そのプロジェクト用の EAR ファイルを作成します。EAR ファイルは、J2EE エンタープライズ・アプリケーション・アーカイブ・ファイルです。デフォルトで、EAR ファイルは WebFacing プロジェクトの名前を使用して、その名前に _EAR を追加します。別の名前を使用するか、複数のプロジェクトを単一の EAR ファイルに統合したい場合には、「エンタープライズ・アプリケーション・プロジェクト」フィールドで名前を変更できます。
- 「終了」をクリックして、プロジェクトをバージョン 5.1.2 のワークスペースにマイグレーションします。
- 「WebFacing」パースペクティブでプロジェクトを表示するには、「ウィンドウ」>「パースペクティブを開く」> 「WebFacing」を選択します。
元のファイルには、filename +_512_bak という形式の新しい名前が付けられます。
WebFacing プロジェクトをカスタマイズした場合は、元のファイルからのカスタマイズを以下にマージします。
- PageBuilder.jsp
- CmdKeys.jsp
- logon.jsp
- index.html
- 前のプロジェクトが Struts 対応であった場合は、Struts 構成ファイル (struts-config.xml) を更新する必要があります。
- 前のプロジェクトが Web サイト・デザイナーを使用していた場合は、以下のファイルを更新する必要があります。
- \WebContent\index.jsp
- \WebContent\INV1.jsp
- \WebContent\INV2.jsp
- \WebContent\theme\WFB_blue.jtpl
以下のメソッドは、iSeries Web プロジェクトを移行するために使用できます。
以下の情報では、iSeries Web プロジェクトを Development Studio Client for iSeries バージョン 5.0.x および 5.1 から Development Studio Client for iSeries バージョン 5.1.2 に移行する方法について説明します。
マイグレーション活動では以下のステージが実行されます。
- 既存の 5.0.x または 5.1 ワークスペースを使用したプロジェクトの移行
- iSeries Web プロジェクトの内容の移行
- 移行の結果として生成されたエラーおよび警告を処理する
バージョン 5.1.2 では、新規 Web プロジェクト用の Web コンテンツおよび Java ソースのデフォルト・フォルダー名は、
設定ページを介して構成できます。現在、デフォルトの名前は JavaResources と WebContent です。これらのデフォルト名は、新規 Web プロジェクトにのみ使用されます。
バージョン 5.1.2 より前のバージョンで作成された Web プロジェクトは、それまでの名前を使用して機能し続けます。同じことが、静的 Web プロジェクトにも当てはまります。
インストール後:
- バージョン 5.1.2 製品を開始すると (「スタート」>「プログラム」>「IBM WebSphere Studio」>「Development Studio Client for iSeries」)、「WebSphere Studio」ウィンドウが開くので、ここでセッションに使用するディレクトリーを指定します。このウィンドウでバージョン 5.0.x または 5.1 ワークスペースのディレクトリー位置を指定します。
- 新規ユーザー・インターフェース・フォーマットに変換するかどうかを確認するプロンプトが出されたら、「OK」をクリックします。
- オプション: メインメニューで、「ウィンドウ」>「設定」をクリックします。左側で、「Web ツール」を展開して「新規プロジェクト」を選択します。右ペインでデフォルト・フォルダー名の設定を設定します。
「ナビゲーター」ビューでフォルダー名を右マウス・ボタンでクリックして「名前変更」をクリックすることで、バージョン 5.1.2 にある 5.0.x または 5.1 プロジェクトのソース・フォルダー名を手動で変更できます。名前変更アクションにより、フォルダー名が変更され、5.0.x または 5.1 Web プロジェクトの Java のビルド・パスが修正されます。バージョン 5.1.2 で JavaResources と WebContent のフォルダー名を変更する場合、手動で自動ビルド・スクリプトを新規フォルダー名に更新する必要があります。
iSeries Web ツールのプロジェクトの内容をマイグレーションするには、以下のようにします。
- Web パースペクティブの「プロジェクト・ナビゲーター」ビューでプロジェクト名を右マウス・ボタンでクリックし、「プロパティー」を選択します。左パネルで「Web プロジェクト・フィーチャー」を選択します。「使用可能な Web プロジェクト・フィーチャー」のリストから、「Struts サポートの追加」を選択します (まだ選択されていない場合)。「OK」をクリックします。「Web プロジェクト・フィーチャー」ウィンドウで「終了」をクリックして、デフォルトの Struts バージョン (1.1) を受け入れます。
注:
このステップを実行しないと、Struts サポートの追加を要求するウィンドウが表示されます。
- 重要 : リソースの削除に関連した例外を回避するには、この時点で、プロジェクトを閉じて再び開いてしてください。
- Web パースペクティブ内のプロジェクト名を右マウス・ボタンでクリックし、「移行」>「iSeries Web ツール・プロジェクト」を選択します。「マイグレーションの確認」ウィンドウには、プロジェクトの構造と内容がマイグレーションされることが示されます。
- このプロセスを続行するには、「OK」をクリックします。「進行状況情報」ウィンドウに、マイグレーションの進行状況が表示されます。
- マイグレーションが終了すると、結果を示すメッセージが表示されます。
- マイグレーション・プロセスが正常に完了した場合、アクションは不要です。マイグレーション・プロセスがエラーまたは警告で完了した場合には、「ステージ 3: マイグレーションの結果として生成されたエラーおよび警告を処理する 」に進みます。
- マイグレーション・プロセスでは以下のアクションが実行されます。
- iSeries Web コンポーネント、タグ・ライブラリー、および JavaScript ファイルを更新します (それに応じてすべての JSP ファイルが更新されます)。
- struts フレームワークに基づいた Web 対話関連ファイルを .wit ファイルから再生成し、Web 対話実行時ファイルを更新します。
- バージョン 5.1.2 で使用可能な新規 iSeries Web ツール機能のサポートを追加します。
マイグレーション・プロセスで問題が検出された場合、エラーまたは警告が起こり、それらが「Web」パースペクティブのプロジェクト名の下にあるマイグレーション・ログ・ファイル projectName_MigrationDetails.txt に入っていることを示すウィンドウが開きます。
マイグレーション・ログ・ファイルの上部にある「マイグレーション結果」セクションは、マイグレーションの全般状況を示し、エラーと警告、およびその訂正に必要なアクションを説明するファイルをオンライン情報で示します。Web プロジェクト移行に対する警告およびエラー・メッセージを参照してください。
5.0.x 移行の場合に限り、ログ・ファイルにリストされたマイグレーション警告の他に、テキスト項目 (Text Entry) Web コンポーネントについて最大長 (maxLength) 属性がサポートされなくなったことにも注意してください。これにより、Web ページの外観に影響が及ぶ場合があります。
以下では、iSeries Web プロジェクトを Development Studio Client for iSeries バージョン 4.0 から Development Studio Client for iSeries バージョン 5.1.2 にマイグレーションする方法について説明します。
マイグレーション活動では以下のステージが実行されます。
- 既存の V4.0.x ワークスペースを使用したプロジェクトの移行
- Web プロジェクト構成およびオプションでプロジェクトの J2EE のバージョンの移行
注:
J2EE 1.3 への Web プロジェクトの移行はオプションです。ただし、J2EE 1.2 は JCA (Java Connector Architecture) をサポートしません。
- iSeries Web ツールのプロジェクトの内容をマイグレーションする
- 移行の結果として生成されたエラーおよび警告を処理する
この方法は部分的にしかサポートされていないため、マイグレーションが不完全なものになります。ユーザー・インターフェース設定、デバッグ設定、および設定のほとんどはすべて失われます。プロジェクト名、プロジェクト・ソース・ファイル、およびプロジェクト Java のビルド・パス (クラスパス) は保存されますが、その他の保証はありません。この方法は、サポートされるソフトウェア構成管理 (SCM) システムが使用されていない場合、およびプロジェクト・ビルド・パス情報の保存が重要である場合にのみ使用してください。この情報は、バージョン 4,0 からエクスポートされたプロジェクトをバージョン 5.1.2 にインポートすると失われます。以下を行うことにより、既存のバージョン 4.0.x ワークスペースを
使用することができます。
インストール前:
- 保留中のリポジトリーに対する変更をすべてコミット (解放) します。
- すべてのパースペクティブを閉じて、バージョン 4.0 製品をシャットダウンします。
- workspace_directory の内容をバックアップします。この場合、workspace_directory は、バージョン 4.0.x ワークスペースが入っているディレクトリーの完全な修飾名です。デフォルトでは、バージョン 4.0.x ワークスペース・サブディレクトリーは、製品がインストールされているディレクトリーと同じディレクトリーにあります。バージョン 4.0.x 製品でもう一度作業したい場合には、このバックアップが必要になります。バージョン 5.1.2 IDE からバージョン 4.0.x ワークスペースを示しても、もはや元に戻ってバージョン 4.0.x 製品でそのワークスペースを使用することができなくなります。
- Development Studio Client for iSeries バージョン 5.1.2 をインストールします。
インストール後:
- バージョン 5.1.2 製品を開始すると (「スタート」>「プログラム」>「IBM WebSphere Studio」>「Development Studio Client for iSeries」)、「WebSphere Studio」ウィンドウが開くので、ここでセッションに使用するディレクトリーを指定します。このウィンドウでバージョン 4.0.x ワークスペースのディレクトリー位置を指定します。
- 前のバージョンの製品で作成されたワークスペースを更新するかどうかを確認するプロンプトが出されたら、「OK」をクリックします。
- ワークスペースにあるプロジェクトの再ビルドまたは妥当性検査を行う前に、「リソース」パースペクティブ内の「ナビゲーター」ビューのすべてのプロジェクトを選択し、次にポップアップ・メニューから「リフレッシュ」を選択します。これにより、すべてのファイルが適切なメタデータと同期されるようになります。
- クローズされているプロジェクトをオープンします (「既知の問題および制限」を参照)。
- クラスパス変数を確認します (「既知の問題および制限」を参照)。
- このバージョンでは、一部のビルダーおよび妥当性検査プログラムが追加、除去、または変更されています。訂正するエラーおよび警告を表示するには、各 Java プロジェクトに対して、「プロジェクト」> 「すべて再ビルド」を選択してから、「妥当性検査の実行」を選択することによって、すべてのプロジェクトを再ビルドする必要があります。
- 一部のユーザー設定は維持されますが、他の多くは維持されない場合があります。バージョン 5.1.2 の設定を調べて、その設定が所要のものであることを確認してください。
EAR およびサーバー構成の絶対パス参照のマイグレーション後除去
バージョン 4.0 EAR application.xml ファイルおよび
サーバー構成ファイルには絶対パス参照が含まれていました。バージョン 5.1.2 に
マイグレーションした後、それらをそのエディターで開く必要があります (これにより、元の絶対パス参照が自動的に新規相対参照に変更されます)。
- EAR プロジェクトごとに application.xml ファイルを更新します。
- 「ナビゲーター」ビューで META-INF/application.xml を右マウス・ボタンでクリックし、「アプリケーションから開く」「デプロイメント記述子エディター」を選択します。
- このメッセージには「はい」をクリックします。
IBM 拡張ファイルには、使用すべきではない絶対パスが含まれています。これは自動訂正できます...自動訂正しますか。
- 保管してから、エディター・ウィンドウを閉じます。
- サーバー構成ごとに構成ファイルを更新します。
- サーバー・パースペクティブの「サーバー構成」ビューでサーバー名を右マウス・ボタンでクリックし、「オープン」を選択します。
- 同様の自動訂正ウィンドウが開きます。
- 「はい」をクリックします。
- 保管してから、エディター・ウィンドウを閉じます。
既知の問題および制限
バージョン 5.1.2 製品でバージョン 4.0 ワークスペースを開いてマイグレーションしようとすると、以下の問題が起こる場合があります。
不正な JRE_LIB クラスパス変数の値
JRE_LIB クラスパス変数を有効な位置にリセットするには、以下のステップに従ってください。
最初に「設定」ウィンドウを開いた時に、値が正しく見えてもこれを行ってください。
- 「ウィンドウ」>「設定」>「Java」>「インストール済み JRE」を選択します。
- リストから、JRE_LIB を設定したデフォルトの JRE 位置のチェック・ボックスを選択します。
- 「編集」を選択してから、「OK」をクリックして、「JRE の編集」ダイアログ・ボックスを閉じます。
これを行わないと、JRE_LIB の値が正しくなくなる場合があり、Java ファイルで多くのビルド・エラーを起こす原因となります。
一般検査として、他のすべてのクラスパス変数の値を検査します。
前に共用されていた SCM プロジェクトの場合、「チーム」メニューに共用プロジェクトが含まれる
Eclipse 1.0 と 2.0 の間ではチーム・サポートが明確に変更されています。リポジトリーでプロジェクトを共用する方法も変更されています。
- 「チーム」>「共用プロジェクト」オプションを選択すると、ウィザードに従ってマイグレーション・プロセスに進むことができます。終了すると、プロジェクトが共用され、「同期化」ビューが開きます。変更の競合はすべてのファイル上に表示されます。これは、Eclipse 1.0 と 2.0 で同期情報の保管方法が変更されたことが原因です。
- 発信変更がない場合 (上記の推奨通りにアップグレードする前に、すべての発信変更をコミットした場合には、存在しない) には、「同期化」ビューでプロジェクトを選択して、「オーバーライドおよび更新」を選択するだけです。これによりサーバーから現在の内容がロードされます。
- 発信変更がある場合には、「同期化」ビューの三角形のメニューをプルダウンして、「ファイル・コンテンツの比較」を選択します。作業によっては、その後に実際に異なるファイルしか「同期化」ビューに表示されない場合があります。ここで「同期化」ビューを使用してこうした矛盾を解決できます。
ワークスペース・ディレクトリーの外側に作成されるプロジェクト
デフォルトでは、プロジェクトは、ワークスペース・ディレクトリー内に作成されます。プロジェクトをどこか他の場所に作成するようデフォルトをオーバーライドする場合、ここですべてのプロジェクトを開いてから、ワークベンチを閉じます。
これにより、プロジェクトの .project ファイルが指定した場所に書き込まれるようになります。
ディレクトリーがワークスペースの外側にあるクローズ済みプロジェクトを開くのに失敗すると、
プロジェクトは実際のプロジェクトをマスクし、その中には .project
ファイルのみがあるという結果となります。
J2EE マイグレーション・ウィザードでは、以下の 2 つの機能を実行できます。
- Web プロジェクト構造、または J2EE プロジェクト構造をバージョン 4.0 からバージョン 5.1.2 へマイグレーションする。
- オプションで、J2EE レベル 1.2 をレベル 1.3 にマイグレーションする。
J2EE プロジェクト構造をマイグレーションするには、以下のようにします。
- IDE を開いていない場合、「スタート」>「プログラム」メニューから製品を選択してバージョン 5.1.2 IDE を開きます。
- IDE で、「ウィンドウ」>「パースペクティブのオープン」>「Web」を選択して、「Web」パースペクティブを開きます。
- 「Web」パースペクティブの「プロジェクト・ナビゲーター」ビューでプロジェクト名を右マウス・ボタンでクリックして、「移行」>「J2EE マイグレーション・ウィザード」を選択します。
- 「ウィザード」ページの指示に従ってください。JCA (Java Connector Architecture)
サポートを使用する場合、チェック・ボックス「バージョン・レベル J2EE 1.2 から J2EE 1.3 へのプロジェクトの移行」 を必ず選択してください。
- 「終了」をクリックして、選択した Web プロジェクトを移行します。
以下のマイグレーション・プロセスは、先のセクションで説明した Web プロジェクトの J2EE プロジェクト構造へのマイグレーションが成功した場合に、実行できます。
iSeries Web ツールのプロジェクトの内容をマイグレーションするには、以下のようにします。
- Web パースペクティブの「プロジェクト・ナビゲーター」ビューでプロジェクト名を右マウス・ボタンでクリックし、「プロパティー」を選択します。左パネルで「Web プロジェクト・フィーチャー」を選択します。「使用可能な Web プロジェクト・フィーチャー」のリストから、「Struts サポートの追加」を選択します (まだ選択されていない場合)。「OK」を押します。「Web プロジェクト・フィーチャー」ウィンドウで「終了」を押して、デフォルトの Struts バージョン (1.1) を受け入れます。
注:
このステップを実行しないと、Struts サポートの追加を要求するウィンドウが表示されます。
- 重要: この時点でプロジェクトをクローズして再びオープンし、リソースの削除に関連する例外を回避します。
- 「Web」パースペクティブの「プロジェクト・ナビゲーター」ビューでプロジェクト名を右マウス・ボタンでクリックして、「移行」> 「iSeries Web ツール・プロジェクト」を選択します。
- 「マイグレーションの確認」ウィンドウには、プロジェクトの構造と内容がマイグレーションされることが示されます。このプロセスを続行するには、「OK」をクリックします。
- マイグレーション操作が行われていることを示す「進行状況情報」ウィンドウがオープンし、マイグレーションの進行状況が示されます。
- マイグレーション・プロセスが完了すると、「警告」、「エラー」、または「成功」ウィンドウにマイグレーションの結果が示されます。
- マイグレーション・プロセスが正常に完了した場合、アクションは不要です。移行プロセスがエラーまたは警告で完了した場合には、「ステージ 4: マイグレーションの結果として生成されたエラーおよび警告を処理する 」に進みます。
マイグレーション・プロセスでは以下のアクションが実行されます。
- JSP ファイル内のすべての設計時制御を新しい Web コンポーネント・フィールドおよび制御に変換する。
- struts フレームワークに基づいた Web 対話関連ファイルを .wit ファイルから再生成し、Web 対話実行時ファイルを更新します。
マイグレーション・プロセスで問題が検出された場合、エラーまたは警告が起こり、それらが「Web」パースペクティブのプロジェクト名の下にあるマイグレーション・ログ・ファイル projectName_MigrationDetails.txt に入っていることを示すウィンドウが開きます。
マイグレーション・ログ・ファイルの上部にある「マイグレーション結果」セクションは、マイグレーションの全般状況を示し、エラーと警告、およびその訂正に必要なアクションを説明するファイルをオンライン情報で示します。「Development Studio Client for iSeries」>「Web アプリケーション」>「iSeries Web 開発」>「参照」>「マイグレーション・エラーおよび警告の詳細」の下にあるオンライン・ヘルプを参照してください。
マイグレーションに関するその他の考慮事項
上のステージ 4 で説明されているログ・ファイルにリストされるマイグレーション・エラーの他に、以下の項目に該当する場合はそれも処理する必要があります。
- 必ず新しいバージョンの QDTSSFL サブファイル・サービス・プログラムを iSeries ホストに復元してください。
このサービス・プログラムは、サブファイル API を使用してサブファイル・ユーザー・スペースを操作するために必要です。
このサービス・プログラムを復元する方法の説明については、「ヘルプ」>「ヘルプ目次」のセクションと、次に「参照」>「ユーザー・インターフェース参照」>「iSeries Web アプリケーション」>「iSeries Web コンポーネント」>「サブファイル API」のヘルプ・システムで 『サブファイル・サービス・プログラム QDTSSFL』セクションを参照してください。
- コンボ・ボックス Web コンポーネントのホスト・プログラムから戻されたデータ・フォーマット配列は、2 つのフォーマットのいずれかになっています。
そのため、コンボ・ボックスに望ましいデータ・フォーマットの結果を得るためには、プログラムの変更が必要となる場合があります。
データ・フォーマットについて詳しくは、「参照」>「ユーザー・インターフェース参照」>「iSeries Web アプリケーション」>「iSeries Web コンポーネント」>「コンボ・ボックス Web コンポーネント」の項のオンライン・ヘルプの『データ・タブ』セクションを参照してください。
- 選択ボックス Web コンポーネントのホスト・プログラムから戻されたデータ・フォーマット配列は、2 つのフォーマットのいずれかになっています。
そのため、選択ボックスに望ましいデータ・フォーマットの結果を得るためには、プログラムの変更が必要となる場合があります。
データ・フォーマットについては、「参照」>「ユーザー・インターフェース参照」>「iSeries Web アプリケーション」>「iSeries Web コンポーネント」>「選択ボックス Web コンポーネント」の項のオンライン・ヘルプの『データ・タブ』セクションを参照してください。
上のステージ 4 で説明されているログ・ファイルにリストされるマイグレーション警告の他に、Web ページの外観に影響を及ぼす可能性のある以下の変更について認識しておく必要があります。
- 以下のテーブル設計時制御 (DTC) プロパティーは、同等のテーブル Web コンポーネントではサポートされなくなりました。
- セル余白
- セル間隔
- 枠サイズ
- 位置合わせ
- テーブル幅
- テーブル高
- テーブル DTC のセル前景プロパティーおよびセル背景プロパティーは、テーブル Web コンポーネントの列の色に個別には適用されません。すべての列見出しに使用される色は、テーブルの最初の列に定義されている色です。
- テーブル DTC の「入力フィールド」列に関連付けられた表示幅、CapsLock、および読み取り専用プロパティーは、
テーブル Web コンポーネントの同等の「テキスト項目」列ではサポートされません。
- サブファイル DTC の「前ページ」ボタン、「次ページ」ボタン、および「選択列」ボタンは、同等のテーブル Web コンポーネントではサポートされません。
- DTC で指定されたフィールド名の値は、同等の Web コンポーネントの名前値にマイグレーションされます。
ピリオド (.) はすべて、名前値ではアンダースコアー (_) に置換されます。
また、DTC のフィールド名の先頭文字は、同等の Web コンポーネントの名前値で小文字に変換されることがあります。
- 指定された条件が発生したとき、実行時に Web コンポーネント属性を変更することはできなくなりました。
「DTC 実行時属性」タブを使用して、条件が満たされたときに実行時でも DTC 属性を変更する (フォント・サイズの変更など) 条件を定義した場合でも、対応する Web コンポーネント属性は、この条件が発生したときに変更されなくなりました。
| エラー・コード |
説明 |
アクション |
| E100 |
JSP ファイルの移行時に未確認のエラーが発生しました。 |
移行ログ・ファイル中のその他のすべてのエラーまたは警告を解決または処理して、移行ツールを再び実行してください。 |
| E101 |
JSP ファイル中の iSeries Web コンポーネントにエラーがあります。 |
iSeries Web コンポーネント・エラーを解決してください。 |
| E200 |
未確認のエラーで生じた .wit ファイルを処理中。 |
「Web 対話」ウィザードを呼び出すには、エラーになっている .wit ファイルをダブルクリックしてください。このウィザードのページのすべてをくまなく進んで、必要な変更を行ってください。「終了」をクリックします。 |
| E201 |
この対話に使用されたページ内に定義された 1 つ以上の Web コンポーネントが無効です。 |
「Web 対話」ウィザードを呼び出すには、エラーになっている .wit ファイルをダブルクリックしてください。Web コンポーネント名が無効であることが示されているウィンドウが開き、変更するかどうかを尋ねます。「はい」をクリックします。ウィザード・ページ「入力パラメーターを入力フィールドにマップおよびリンク」に進みます (前の方のウィザード・ページで必要な変更を行います)。「セッション中の名前」、「セッションへの保管」、および「リンク」オプションを、名前を変更したすべての Web コンポーネント (入力フィールド) に指定します。ウィザード・ページ「出力パラメーターを出力フィールドにマップおよびリンク」に進みます。「セッション中の名前」、「セッションからの復元」、および「リンク」オプションを、名前を変更したすべての Web コンポーネント (出力フィールド) に指定します。このウィザードのページのすべてをくまなく進んで、必要な変更を行ってください。「終了」をクリックします。 |
| E202 |
この対話で定義された出力パラメーターには、true に設定された「メッセージ標識」がありました。拡張メッセージ処理は、このリリースでかなり変更されました。「メッセージ処理」オプションを再定義する必要があります。 |
「Web 対話」ウィザードを呼び出すには、エラーになっている .wit ファイルをダブルクリックしてください。「出力パラメーターを出力フィールドにマップおよびリンク」というウィザード・ページに進みます。出力パラメーターの特性ウィンドウで、「true」に設定された「メッセージ・コントローラー」値で、値「true」を選択します。これでボタンが表示されます。このボタンをクリックして、メッセージ制御仕様を定義します。 |
| E300 |
DTC および/または得られている iSeries Web コンポーネントを処理中に、未確認エラーが発生しました。 |
移行ログ・ファイル中のその他のすべてのエラーまたは警告を解決または処理します。移行ログ・ファイルを名前変更し、移行ツールを再び実行してください。 |
| E301-E302 |
このプッシュボタン DTC プロパティーの「次へ/前へ」はもうサポートされません。ボタン Web コンポーネントのボタンの種類属性は「実行依頼」と定義されます。 |
「Web 対話」ウィザードを使用して、JSP ページとして「次へ/前へ」ボタンが含まれたページを指定するため、および出力 JSP ページとして「次へ」ボタンの宛先ページを指定するために、対話を作成します。バージョン 4.0 では、「次へ/前へ」ボタンは複数の入力ページで使用されていました。「ヘルプ」>「ヘルプ目次」の項、および次に「参照」>「ユーザー・インターフェース参照」>「iSeries Web アプリケーション」>「複数入出力ページ」 のヘルプ・システムの情報を参照してください。 |
| 警告コード |
説明 |
アクション |
| W100 |
JSP ページの iSeries Web コンポーネントには警告があります。 |
iSeries Web コンポーネントの警告を処理してください。 |
| W300 |
リスト・ボックスまたはコンボ・ボックスには、区切り文字プロパティーに複数の文字が含まれていました。区切り文字プロパティーに見つかった先頭文字が、対応する iSeries Web コンポーネントの区切り文字属性に使用されます。 |
選択ボックスまたはコンボ・ボックス Web コンポーネントのすべてのオプションの Name 属性および Value 属性が正しく定義されていることを確認してください。 |
| W301-W302 |
リスト・ボックスまたはコンボ・ボックスには、データ・プロパティーの「キー」または「値」に事前選択文字 * が入っていました。 |
選択ボックスまたはコンボ・ボックス Web コンポーネントのすべてのオプションの Name 属性および Value 属性が正しく定義されていることを確認してください。 |
| W303 |
現在、JSP ファイル内のグループ名プロパティーが同じであるすべてのラジオ・ボタン DTC は、ラジオ・ボタン・グループ Web コンポーネントのオプションの 1 つとして表示されます。JSP ページで見つかった最初のラジオ・ボタンの「フォント」タブと「カラー」タブで定義されたプロパティーは、ラジオ・ボタン・グループのカラー属性およびフォント属性として使用されます。つまり、同じグループ内で以降のラジオ・ボタンの「カラー」タブと「フォント」タブのプロパティーは失われます。 |
関連の JSP ファイルを選択し、サーバーでそのファイルを実行することによって、ラジオ・ボタン・グループが JSP ファイル内に要求通りに目に見えるように表示されることを確認してください。関連の JSP ファイルを選択し、サーバーでそのファイルを実行することによって、ラジオ・ボタン・グループのフォントおよびカラー属性が要求通りに表示されることを確認してください。 |
| W304 |
プッシュボタン・プロパティーのラベルはもうサポートされません。プッシュボタン・プロパティーの Value は、対応するボタン Web コンポーネントの Label 属性にマップされました。ボタン Web コンポーネントに表示されるテキストはプッシュボタン DTC とは異なります。 |
ボタン Web コンポーネント上に表示されたテキストが適切でない場合は、Label 属性の値を変更してください。 |
| W305 |
現在、サブファイルまたはテーブル DTC は、HTML FORM タグの外側に目に見えるように表示されます。テーブル Web コンポーネントを、HTML FORM タグの内部に表示することはできません。DTC タイプがサブファイルだった場合は、対応する iSeries Web コンポーネントは、テーブル Web コンポーネントです。 |
テーブル Web コンポーネントが JSP ページに要求通りに目に見えるように表示されることを確認してください。 |
| W306-W320 |
DTC イベント・プロパティーはもうサポートされません。 |
必要な場合は、関連アクションを別なイベントで定義してください。 |
| W306 |
OnDblClick |
|
| W307 |
OnMouseDown |
|
| W308 |
OnMouseOut |
|
| W309 |
OnMouseOver |
|
| W310 |
OnSelect |
|
| W312 |
ラジオ・ボタン用 OnChange |
|
| W313 |
チェック・ボックス用 OnChange |
|
| W314 |
OnMouseUp |
|
| W315 |
ラジオ・ボタン用 OnKeyDown |
|
| W316 |
ラジオ・ボタン用 OnKeyPress |
|
| W317 |
ラジオ・ボタン用 OnKeyUp |
|
| W318 |
プッシュボタン用 OnKeyDown |
|
| W319 |
プッシュボタン用 OnKeyPress |
|
| W320 |
プッシュボタン用 OnKeyUp |
|
| W321 |
Web コンポーネントには、次の理由でもうサポートされない属性が定義されていました。1) 関連した CSS 属性がほとんどのブラウザーでサポートされていない。2) 関連した HTML 属性が、HTML 4.0 においてすでに使用すべきではなく、ほとんどのブラウザーでサポートされていない。 |
なし。 |
インストール後:
- バージョン 5.1.2 製品を開始すると (「スタート」>「プログラム」>「IBM WebSphere Studio」>「Development Studio Client for iSeries」)、「WebSphere Studio」ウィンドウが開くので、ここでセッションに使用するディレクトリーを指定します。このウィンドウでバージョン 5.0 ワークスペースのディレクトリー位置を指定します。
- 新規ユーザー・インターフェース・フォーマットに変換するかどうかを確認するプロンプトが出されたら、「OK」をクリックします。
ご使用の 5.0 ワークベンチで 5.0 Build Status ビューを開いたままにしていた場合は、次のエラーが 5.1.2 で発生します。
ワークベンチのレイアウトを復元できませんでした
続行するには「OK」をクリックします。これは、iSeries プロジェクト・パースペクティブにおける「ビルド状況」ビューの、リモート・システム・エクスプローラー・パースペクティブにおける「iSeries ジョブ状況」ビューによる置換と関連しています。元の「ビルド状況」ビューにリストされたすべてのビルドは、新規ビューには表示されません。関連の iSeries プロジェクトを再ビルドすると、新規ビルドが「ジョブ状況」ビューに表示され、実行中の機能には影響しません。
マイグレーションの後、iSeries プロジェクトに赤色のフラグが付いている場合、プロジェクトに関連付けられたリモート・システム・エクスプローラーの接続がそれ以上存在しないことが原因である可能性があります。これを解決するには、以下のようにします。
- iSeries プロジェクトを右マウス・ボタンでクリックして、「プロパティー」>「iSeries プロジェクト」を選択します。
- 欠落している接続を設定して、「OK」をクリックします。
Development Studio Client バージョン 4.0
をアンインストールする前に、プロジェクトの内容をホスト・マシンにエクスポート
してください。その後で、Development Studio Client バージョン 5.1.2
をインストールしてください。インストールの後、リモート・システム・エクスプローラーからアクションを実行して、プロジェクトを再作成することができます。
インストール前:
Development Studio Client for iSeries バージョン 5.1.2 をすでにインストール済みで、プロジェクトをリモート・ホストにアップロードしていないことが分かっている場合は、このセクションをスキップしてください。
- バージョン 4.0 で、「iSeries プロジェクト」を右マウス・ボタンでクリックして、「変更をプッシュ」 を選択します。これにより、プロジェクトの関連ライブラリーに対するコードの変更点をすべてアップロードします。(プロジェクトが対象としているホストおよびライブラリーが分からない場合は、プロジェクトを右マウス・ボタンでクリックして、「プロパティー」>「iSeries プロジェクト」を選択してください。)
- バージョン 4.0 を閉じて、アンインストールします。
- Development Studio Client for iSeries バージョン 5.1.2 のインストールを続行します。
インストール後:
- バージョン 5.1.2 では、「リモート・システム・エクスプローラー」パースペクティブを開き、「ウィンドウ」>「パースペクティブを開く」>「リモート・システム・エクスプローラー」をクリックします。
- iSeries プロジェクトの関連ライブラリーへナビゲートします。このライブラリーには、iSeries プロジェクトからアップロードしたすべてのソースが含まれています。
- iSeries プロジェクトの一部だったこのライブラリーのソース物理ファイルを選択して、そのファイル上で右マウス・ボタンでクリックして、「オフラインを使用可能にする」を選択します。これにより、このライブラリーにマップしている iSeries
プロジェクトを再作成して、すべてのソース・メンバーをローカルのプロジェクトにダウンロードします。これで開発を続行することができます。
注 : リモート・システム・エクスプローラーから「iSeries プロジェクトの作成」を選択して、プロジェクトを再作成するもう 1 つの速い方法もありますが、この方法では、ライブラリーからソース・メンバーはダウンロードされません。ライブラリーとホストにマップしている iSeries
プロジェクトを作成して設定するだけです。
インストール後:
- メインメニューで、「ウィンドウ」>「パースペクティブを開く」>「リソース」をクリックします。「OK」をクリックします。
- 「ファイル」>「新規」>「その他」>「シンプル」>「プロジェクト」をクリックして、簡単なプロジェクトを作成します。作成したプロジェクトを Temp と呼びます。このプロジェクトは、バージョン 4.0 プロジェクトをバージョン 5.1.2 ワークスペースにインポートするためのコンテナーです。
- 「ファイル」>「インポート」>「ファイル・システム」を選択します。「次へ」をクリックします。
- 古いワークスペースまでナビゲートし、再作成するプロジェクトをインポートします。
(「始める前に」の下にある、ワークスペースの検索に関するセクションを参照してください。)
- 4. でインポートしたバージョン 4.0 プロジェクトのライブラリーおよびホストにマップする iSeries プロジェクトを作成します。
- 「ナビゲーター」ビューで右マウス・ボタンでクリックして、「新規」>「プロジェクト」>「iSeries」>「ローカル」>「iSeries プロジェクト」を選択します。
- ライブラリーおよびホストが分からない場合、Temp プロジェクトの下にある .iseries_project_properties という XML ファイルで情報を検索することができます。
- バージョン 4.0 プロジェクトに存在していたソース物理ファイルを再作成します。
- 「ファイル」>「新規」>「その他...」>「iSeries」>「ローカル」>「iSeries ソース物理ファイル」をクリックします。
- ファイルの CCSID およびレコード長が不明な場合、各ソース物理ファイル直下にある .iseries_srcpf_properties と呼ばれる XML ファイル内でこの情報を検索できます。
- ここで、ソース・メンバーを古いプロジェクトから新規のバージョン 5.1.2 プロジェクトにドラッグ・アンド・ドロップします。
- 「Temp」プロジェクトはもう使わないので削除してください。そして、「ウィンドウ」>「パースペクティブを開く」>「iSeries プロジェクト」をクリックして「iSeries プロジェクト・パースペクティブ」を開きます。
本書は米国 IBM が提供する製品およびサービスについて作成したものであり、本書に記載の製品、サービス、または機能が日本においては提供されていない場合があります。日本で利用可能な製品、サービス、および機能については、日本 IBM の営業担当員にお尋ねください。
本書で IBM 製品、プログラム、またはサービスに言及していても、その IBM 製品、プログラム、または
サービスのみが使用可能であることを意味するものではありません。これらに代えて、IBM の知的所有権を侵害することのない、機能的に同等の
製品、プログラム、またはサービスを使用することができます。
ただし、IBM 以外の製品とプログラムの操作またはサービスの評価および検証は、お客様の責任で行っていただきます。
IBM は、本書に記載されている内容に関して特許権 (特許出願中のものを含む) を保有している場合があります。本書による情報の提供は、これらの特許権について実施権を許諾することを意味するものではありません。実施権についてのお問い合わせは、書面にて下記宛先にお送りください。
〒106-0032
東京都港区六本木
3-2-31
IBM World Trade Asia Corporation
Licensing
使用許諾については、下記の宛先に書面にてご照会ください。
〒106-0032
東京都港区六本木 3-2-31
IBM World Trade Asia Corporation
Licensing
以下の保証は、国または地域の法律に沿わない場合は、適用されません。IBM およびその直接または間接の子会社は、本書を特定物として現存するままの状態で提供し、商品性の保証、特定目的適合性の保証および法律上の瑕疵担保責任を含むすべての明示もしくは黙示の保証責任または保証条件は適用されないものとします。国または地域によっては、法律の強行規定により、保証責任の制限が禁じられる場合、強行規定の制限を受けるものとします。
この情報には、技術的に不適切な記述や誤植を含む場合があります。
本書は定期的に見直され、必要な変更は本書の次版に組み込まれます。
IBM は予告なしに、随時、この文書に記載されている製品またはプログラムに対して、改良または変更を行うことがあります。
本書において IBM 以外の Web サイトに言及している場合がありますが、
便宜のため記載しただけであり、決してそれらの Web サイトを推奨するものでは
ありません。それらの Web サイトにある資料は、この IBM 製品の資料の一部ではありません。それらの Web サイトは、お客様の責任でご使用ください。
IBM は、お客様が提供するいかなる情報も、お客様に対してなんら義務も負うことのない、自ら適切と信ずる方法で、使用もしくは配布することができるものとします。
本プログラムのライセンス保持者で、(i) 独自に作成したプログラムと
その他のプログラム（本プログラムを含む）との間での情報交換、
および (ii) 交換された情報の相互利用を可能にすることを目的として、
本プログラムに関する情報を必要とする方は、下記に連絡してください。
Lab Director IBM Canada Ltd. Laboratory
8200 Warden Avenue
Markham, Ontario, Canada L6G 1C7
本プログラムに関する上記の情報は、適切な使用条件の下で使用することができますが、有償の場合もあります。
本書で説明されているライセンス・プログラムまたはその他のライセンス資料は、IBM 所定のプログラム契約の契約条項、IBM プログラムのご使用条件、またはそれと同等の条項に基づいて、IBM より提供されます。
IBM 以外の製品に関する情報は、その製品の供給者、出版物、
もしくはその他の公に利用可能なソースから入手したものです。IBM は、それらの製品のテストは行っておりません。したがって、
他社製品に関する実行性、互換性、またはその他の要求については確証できません。
IBM 以外の製品の性能に関する質問は、それらの製品の供給者にお願いします。
本書には、日常の業務処理で用いられるデータや報告書の例が含まれています。
より具体性を与えるために、それらの例には、個人、企業、ブランド、あるいは製品などの名前が含まれている場合があります。
これらの名称はすべて架空のものであり、名称や住所が類似する企業が実在しているとしても、それは偶然にすぎません。
本書には、様々なオペレーティング・プラットフォームでの
プログラミング手法を例示するサンプル・アプリケーション・プログラムがソース言語で掲載されています。お客様は、サンプル・プログラムが書かれているオペレーティング・
プラットフォームのアプリケーション・プログラミング・インターフェースに
準拠したアプリケーション・プログラムの開発、使用、販売、配布を目的として、
いかなる形式においても、IBM に対価を支払うことなくこれを複製し、改変し、
配布することができます。
このサンプル・プログラムは、あらゆる条件下における完全なテストを経ていません。
従って IBM は、これらのサンプル・プログラムについて信頼性、利便性もしくは機能性が
あることをほのめかしたり、保証することはできません。
お客様は、IBM のアプリケーション・プログラミング・インターフェースに準拠したアプリケーション・プログラムの開発、使用、販売、配布を目的として、いかなる形式においても、IBM に対価を支払うことなくこれを複製し、改変し、配布することができます。
それぞれの複製物、サンプル・プログラムのいかなる部分、またはすべての派生的創作物にも、次のように、著作権表示を入れていただく必要があります。
(C) (お客様の会社名) (年). このコードの一部は、IBM Corp. のサンプル・プログラムから取られています。
(C) Copyright IBM Corp. 1992, 2002. All rights reserved.
プログラミング・インターフェース情報は、プログラムを使用して
アプリケーション・ソフトウェアを作成する際に役立ちます。
一般使用プログラミング・インターフェースにより、お客様はこのプログラム・ツール・サービスを含むアプリケーション・ソフトウェアを書くことができます。
ただし、この情報には、診断、修正、および調整情報が含まれている場合が
あります。診断、修正、調整情報は、お客様のアプリケーション・ソフトウェアの
デバッグ支援のために提供されています。
警告: 診断、修正、調整情報は、変更される場合がありますので、プログラミング・インターフェースとしては使用しないでください。
以下は、IBM Corporation の商標です。
| * AIX |
* DB2 Extenders |
* Operating System/400 |
| * AIX windows |
* DB2 Universal Database |
* OS/2 |
| * Application System/400 |
*
 |
* Open Class |
| * AS/400 |
* IBM |
* OS/390 |
| * AS/400e |
* IBMLink |
* OS/400 |
| * C Set ++ |
* Integrated Language Environment |
* RPG/400 |
| * COBOL/2 |
* iSeries |
* SQL/400 |
| * COBOL/400 |
* Language Environment |
* VisualAge |
| * DB2 |
* MQSeries |
* WebSphere |
InstallShield は InstallShield Corporation の商標です。
Pentium は、Intel Corporation の米国およびその他の国における商標です。
Java およびすべての Java 関連の商標およびロゴは、Sun Microsystems, Inc. の米国およびその他の国における商標または登録商標です。
Rational は、International Business Machines Corporation および Rational Software Corporation の米国およびその他の国における商標または登録商標です。
ActiveX、Microsoft、SourceSafe、Visual C++、Visual SourceSafe、Windows、Windows NT、Win32、Win32s、および Windows ロゴは、Microsoft Corporation の米国およびその他の国における商標です。
UNIX は、The Open Group の登録商標です。
他の会社名、製品名およびサービス名等はそれぞれ各社の商標です。