プログラム呼び出し Bean のマイグレーション
iSeries Java および Web プロジェクトのプログラム呼び出し Bean のバージョン 5.1 または 5.1.2 から バージョン 6.0.1 へのマイグレーション
このセクションでは、Development Studio Client for iSeries™ バージョン 5.1 または 5.1.2 で作成されたプログラム呼び出し Bean を バージョン 6.0.1 にマイグレーションする方法について説明します。
バージョン 6.0.1 では、プログラム呼び出し Bean の PCML ファイルは、「プログラム呼び出し」ウィザードによって Bean パッケージに入れられます。
これは、旧バージョンからの変更です。
Bean パッケージに入っていない既存の PCML ファイルからプログラム呼び出し Bean を再作成する場合は、ウィザードがそのプログラム呼び出し Bean の再作成を完了した後で、この PCML ファイルを削除できます。
注:
バージョン 6.0.1 では、「Web サービス」ウィザードを直接使用して、ILE RPG または COBOL ソースあるいは PCML ファイルから
iSeries プログラム Web サービスを作成できます。
「プログラム呼び出し」ウィザードや「Web サービス」ウィザードを実行する必要はありません。
Java プロジェクトのプログラム呼び出し Bean のマイグレーション
- バージョン 6.0.1 製品を開始 (「スタート」 > 「プログラム」 > 「IBM® Rational®」 > 「WebSphere Development Studio Client for iSeries」) すると、セッション時に使用するディレクトリーを指定する「Workspace Launcher」ウィンドウが開きます。
バージョン 5.x のワークスペースのディレクトリーの場所を指定してください。
- 新しいユーザー・インターフェース・フォーマットへの変換を確認するプロンプトが表示されたら、「OK」をクリックします。
- プロジェクトの Java™ のビルド・パスを変更して、ランタイム .jar ファイルを除去します。
- 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 ファイルに対して「プログラム呼び出し」ウィザードを再実行します。
デフォルト・パッケージを使用していた場合は、バージョン 6.0.1 のパッケージ名を指定してください。
指定したパッケージで、新しく生成された Java Bean と PCML ファイルが検索されます。デフォルト・パッケージにある古い Java Bean と PCML ファイルは削除できます。
Web プロジェクトのプログラム呼び出し Bean のマイグレーション
プログラム呼び出しサービス Bean のユーザーは、バージョン 6.0.1 では「プログラム呼び出し」ウィザードが常に .config ファイルを生成することを知っておく必要があります。
これは、ユーザーが指定したもの、またはデフォルト (defaultPCW.config) となります。
「実行時構成」ウィザードは、今後使用する必要はありません。
バージョン 6.0.1 より前の Web プロジェクトの場合は、以下に概説する Web ツール・プロジェクト・マイグレーション・ステップで、そのプロジェクトの web.xml ファイルから情報が取得され、defaultPCW.config が存在していなければ自動的に作成されます。
これ以降は、web.xml ファイルではなく .config ファイルのデータに基づいてプログラム呼び出し実行時構成が行われます。
- バージョン 6.0.1 製品を開始 (「スタート」 > 「プログラム」 > 「IBM Rational」 > 「WebSphere Development Studio Client for iSeries」) すると、セッション時に使用するディレクトリーを指定する「Workspace Launcher」ウィンドウが開きます。
このウィンドウで、バージョン 5.1 または 5.1.2 のワークスペースのディレクトリーの場所を指定してください。
- 新しいユーザー・インターフェース・フォーマットへの変換を確認するプロンプトが表示されたら、「OK」をクリックします。
- (オプションのステップ: J2EE マイグレーション・ウィザードを使用して、J2EE レベル 1.2 から、これより高い J2EE レベルにマイグレーションします。)
- iwdtrt.jar および jt400.jar を WEB-INF¥lib フォルダーから削除します。
- すべての PCML ファイルに対して「プログラム呼び出し」ウィザードを再実行します。
指定したパッケージに、新しいサービス Bean および PCML ファイルが作成されます。
古い PCML ファイルを Web プロジェクトから削除してください。
- サービス Bean に対して「Web サービス」ウィザードを再実行します。
「Web サービス」ウィザードで生成したコードは、手動でマイグレーションおよびクリーンアップを行う必要があります。
このマイグレーションは、Web サービス Bean 自体にのみ適用されます。
Web サービスのマイグレーション方法については、Rational Software Developer Platform 基本製品に付属のマイグレーション・ガイドにある Web サービスのセクションを参照してください (このガイドへのリンクについてはその他の重要な情報の検索を参照)。
iSeries Java および Web プロジェクトのプログラム呼び出し Bean のバージョン 5.0 から バージョン 6.0.1 へのマイグレーション
このセクションでは、Development Studio Client for iSeries バージョン 5.0 で作成されたプログラム呼び出し Bean を バージョン 6.0.1 にマイグレーションする方法について説明します。
注:
バージョン 6.0.1 では、「Web サービス」ウィザードを直接使用して、ILE RPG または COBOL ソースあるいは PCML ファイルから
iSeries プログラム Web サービスを作成できます。
「プログラム呼び出し」ウィザードや「Web サービス」ウィザードを実行する必要はありません。
Java プロジェクトのプログラム呼び出し Bean のマイグレーション
- バージョン 6.0.1 製品を開始 (「スタート」 > 「プログラム」 > 「IBM Rational」 > 「WebSphere Development Studio Client for iSeries」) すると、セッション時に使用するディレクトリーを指定する「Workspace Launcher」ウィンドウが開きます。
このウィンドウで、バージョン 5.0 のワークスペースのディレクトリーの場所を指定してください。
- 新しいユーザー・インターフェース・フォーマットへの変換を確認するプロンプトが表示されたら、「OK」をクリックします。
- プロジェクトの Java のビルド・パスを変更して、ランタイム .jar ファイルを除去します。
- 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 ファイルに対して「プログラム呼び出し」ウィザードを再実行します。
ウィザードの「認証の構成」ページで、「構成ファイルの生成」オプションを選択解除します。
Web プロジェクトのプログラム呼び出し Bean のマイグレーション
以下のセクションでは、Web コンテンツ・フォルダー、Java ソース・フォルダー、および Web プロジェクト・フォルダーの内容をマイグレーションする方法について説明します。
Web コンテンツ・フォルダーの内容をマイグレーションするには、次のようにします。
- バージョン 6.0.1 製品を開始 (「スタート」 > 「プログラム」 > 「IBM Rational」 > 「WebSphere Development Studio Client for iSeries」) すると、セッション時に使用するディレクトリーを指定する「Workspace Launcher」ウィンドウが開きます。
デフォルトの場所をワークスペースとして使用します。
- 「リソース」パースペクティブに切り替えます。
- 既存の 5.0 Web プロジェクトと同じ名前および同じサーブレット・バージョンの新しい動的 Web プロジェクトを作成します。
サーブレットのバージョンは、既存の 5.0 プロジェクトの .websettings ファイルで jsp-level タグを検索すれば確認できます。
JSP レベルが 1.2 の場合は、サーブレットのバージョンを 2.3 に設定し、その他の場合はサーブレットのバージョンを 2.2 に設定し、「完了」をクリックしてください。
プロンプトが表示されたら Web パースペクティブに切り替えないでください。
- 新しく作成したプロジェクトの Web コンテンツ・フォルダーを選択して右クリックし、コンテキスト・メニューから「インポート」を選択します。
- インポート・ソースとして「ファイル・システム」を選択し、「次へ」をクリックします。
「参照」ボタンをクリックし、既存の 5.0 Web プロジェクトの Web コンテンツ・フォルダー (デフォルト名は Web Content) を選択します。
「OK」をクリックします。
- Web コンテンツ・フォルダーを選択します。ただし、ボックスにチェック・マークは付けません。
「すべて選択」をクリックします。
右側のパネルで、ファイルの 1 つを選択解除した後、同じファイルを再び選択します。
これで、Web コンテンツ・フォルダー内のすべて (ただし、Web コンテンツ・フォルダー自体は除く) がインポートされます。
- 「選択されたフォルダーのみ作成する」オプションと「警告を出さずに既存のリソースを上書き」オプションを選択し、「完了」をクリックします。
新しく作成したプロジェクトの Web コンテンツ・フォルダーは現在、5.0 Web コンテンツ・フォルダーと同様のリソースおよびフォルダー構造を持っているはずです。
Java ソース・フォルダーの内容をマイグレーションするには、次のようにします。
- 新しく作成したプロジェクトの Java ソース・フォルダーを選択して右クリックし、コンテキスト・メニューから「インポート」を選択します。
- インポート・ソースとして「ファイル・システム」を選択し、「次へ」をクリックします。
「参照」ボタンをクリックし、既存の 5.0 Web プロジェクトの Java ソース・フォルダー (デフォルト名: Java Source) を選択します。
「OK」をクリックします。
- Java ソース・フォルダーを選択します。ただし、ボックスにチェック・マークは付けません。
「すべて選択」をクリックします。
右側のパネルで、ファイルの 1 つを選択解除した後、同じファイルを再び選択します。
これで、Java ソース・フォルダー内のすべて (ただし、Java ソース・フォルダー自体は除く) がインポートされます。
- 「選択されたフォルダーのみ作成する」オプションと「警告を出さずに既存のリソースを上書き」オプションを選択し、「完了」をクリックします。
新しく作成したプロジェクトの Java ソース・フォルダーは現在、5.0 Java ソース・フォルダーと同様のリソースおよびフォルダー構造を持っているはずです。
Web プロジェクト・フォルダーの内容をマイグレーションするには、次のようにします。
- 新しく作成したプロジェクトを選択して右クリックし、コンテキスト・メニューから「インポート」を選択します。
- インポート・ソースとして「ファイル・システム」を選択し、「次へ」をクリックします。
「参照」ボタンをクリックし、既存の 5.0 Web プロジェクトを選択します。
- 左側のパネルでプロジェクト・フォルダーを選択し、「すべて選択」をクリックします。
右側のパネルで、ファイルの 1 つを選択解除した後、同じファイルを再び選択します。
左側のパネルで、Web コンテンツ・フォルダーと Java ソース・フォルダーを選択解除します。
これで、Web プロジェクト・フォルダー内のすべて (ただし、Web プロジェクト・フォルダー自体だけでなく Web コンテンツ・フォルダーおよび Java ソース・フォルダーは除く) がインポートされます。
- 右側のパネルで、以下のファイルがリストにある場合は、選択解除します。
- ¥WebContent¥.classpath
- ¥WebContent¥.project
- ¥WebContent¥.websettings
- ¥WebContent¥.serverPreference
これらのファイルには、設計時に必要な、プロジェクトに関する情報が記載されています。
この情報はバージョン 6.0.1 にマイグレーションできないため、これらのファイルは必要に応じて再作成されます。
- 「選択されたフォルダーのみ作成する」オプションと「警告を出さずに既存のリソースを上書き」オプションを選択し、「完了」をクリックします。
新しく作成した Web プロジェクト・フォルダーは現在、5.0 Web プロジェクト・フォルダーと同様のリソースおよびフォルダー構造を持っているはずです。
- (オプションのステップ: J2EE マイグレーション・ウィザードを使用して、J2EE レベル 1.2 から、これより高い J2EE レベルにマイグレーションします。)
- iwdtrt.jar および jt400.jar を WEB-INF¥lib フォルダーから削除します。
- すべての PCML ファイルに対して「プログラム呼び出し」ウィザードを再実行します。
このマイグレーションは、サービス Bean 自体にのみ適用されます。
Web サービスのマイグレーション方法については、Rational Software Developer Platform 基本製品に付属のマイグレーション・ガイドにある Web サービスのセクションを参照してください (このガイドへのリンクについてはその他の重要な情報の検索を参照)。
iSeries Java および Web プロジェクトのプログラム呼び出し Bean のバージョン 4.0 から バージョン 6.0.1 へのマイグレーション
このセクションでは、Development Studio Client for iSeries バージョン 4.0 で作成されたプログラム呼び出し Bean を バージョン 6.0.1 にマイグレーションする方法について説明します。
注:
バージョン 6.0.1 では、「Web サービス」ウィザードを直接使用して、ILE RPG または COBOL ソースあるいは PCML ファイルから
iSeries プログラム Web サービスを作成できます。
「プログラム呼び出し」ウィザードや「Web サービス」ウィザードを実行する必要はありません。
Java プロジェクトのプログラム呼び出し Bean のマイグレーション
- バージョン 6.0.1 製品を開始 (「スタート」 > 「プログラム」 > 「IBM Rational」 > 「WebSphere Development Studio Client for iSeries」) すると、セッション時に使用するディレクトリーを指定する「Workspace Launcher」ウィンドウが開きます。
このウィンドウで、バージョン 4.0 のワークスペースのディレクトリーの場所を指定してください。
- 新しいユーザー・インターフェース・フォーマットへの変換を確認するプロンプトが表示されたら、「OK」をクリックします。
- プロジェクトの Java のビルド・パスを変更して、ランタイム .jar ファイルを除去します。
- 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 自体にのみ適用されます。
「プログラム呼び出し」ウィザードで生成したコードは、手動でマイグレーションおよびクリーンアップを行う必要があります。
Web プロジェクトのプログラム呼び出し Bean のマイグレーション
Web コンテンツ・フォルダーの内容をマイグレーションするには、次のようにします。
- バージョン 6.0.1 製品を開始 (「スタート」 > 「プログラム」 > 「IBM Rational」 > 「WebSphere Development Studio Client for iSeries」) すると、セッション時に使用するディレクトリーを指定する「Workspace Launcher」ウィンドウが開きます。
デフォルトの場所をワークスペースとして使用します。
- 「リソース」パースペクティブに切り替えます。
- 既存の 4.0 Web プロジェクトと同じ名前および同じサーブレット・バージョンの新しい動的 Web プロジェクトを作成します。
サーブレットのバージョンは、既存の 4.0 プロジェクトの .websettings ファイルで jsp-level タグを検索すれば確認できます。
JSP レベルが 1.2 の場合は、サーブレットのバージョンを 2.3 に設定し、その他の場合はサーブレットのバージョンを 2.2 に設定し、「完了」をクリックしてください。
プロンプトが表示されたら Web パースペクティブに切り替えないでください。
- 新しく作成したプロジェクトの Web コンテンツ・フォルダーを選択して右クリックし、コンテキスト・メニューから「インポート」を選択します。
- インポート・ソースとして「ファイル・システム」を選択し、「次へ」をクリックします。
「参照」ボタンをクリックし、既存の 4.0 Web プロジェクトの Web コンテンツ・フォルダー (デフォルト名は webApplication) を選択します。
「OK」をクリックします。
- Web コンテンツ・フォルダーを選択します。ただし、ボックスにチェック・マークは付けません。
「すべて選択」をクリックします。
右側のパネルで、ファイルの 1 つを選択解除した後、同じファイルを再び選択します。
これで、Web コンテンツ・フォルダー内のすべて (ただし、Web コンテンツ・フォルダー自体は除く) がインポートされます。
- 「選択されたフォルダーのみ作成する」オプションと「警告を出さずに既存のリソースを上書き」オプションを選択し、「完了」をクリックします。
新しく作成したプロジェクトの Web コンテンツ・フォルダーは現在、4.0 Web コンテンツ・フォルダーと同様のリソースおよびフォルダー構造を持っているはずです。
Java ソース・フォルダーの内容をマイグレーションするには、次のようにします。
- 新しく作成したプロジェクトの Java ソース・フォルダーを選択して右クリックし、コンテキスト・メニューから「インポート」を選択します。
- インポート・ソースとして「ファイル・システム」を選択し、「次へ」をクリックします。
「参照」ボタンをクリックし、既存の 4.0 Web プロジェクトの Java ソース・フォルダー (デフォルト名: source) を選択します。
「OK」をクリックします。
- Java ソース・フォルダーを選択します。ただし、ボックスにチェック・マークは付けません。
「すべて選択」をクリックします。
右側のパネルで、ファイルの 1 つを選択解除した後、同じファイルを再び選択します。
これで、Java ソース・フォルダー内のすべて (ただし、Java ソース・フォルダー自体は除く) がインポートされます。
- 「選択されたフォルダーのみ作成する」オプションと「警告を出さずに既存のリソースを上書き」オプションを選択し、「完了」をクリックします。
新しく作成したプロジェクトの Java ソース・フォルダーは現在、4.0 Java ソース・フォルダーと同様のリソースおよびフォルダー構造を持っているはずです。
Web プロジェクト・フォルダーの内容をマイグレーションするには、次のようにします。
- 新しく作成したプロジェクトを選択して右クリックし、コンテキスト・メニューから「インポート」を選択します。
- インポート・ソースとして「ファイル・システム」を選択し、「次へ」をクリックします。
「参照」ボタンをクリックし、既存の 4.0 Web プロジェクトを選択します。
- 左側のパネルでプロジェクト・フォルダーを選択し、「すべて選択」をクリックします。
右側のパネルで、ファイルの 1 つを選択解除した後、同じファイルを再び選択します。
左側のパネルで、Web コンテンツ・フォルダーと Java ソース・フォルダーを選択解除します。
これで、Web プロジェクト・フォルダー内のすべて (ただし、Web プロジェクト・フォルダー自体だけでなく Web コンテンツ・フォルダーおよび Java ソース・フォルダーは除く) がインポートされます。
- 右側のパネルで、以下のファイルがリストにある場合は、選択解除します。
- ¥WebContent¥.classpath
- ¥WebContent¥.project
- ¥WebContent¥.websettings
- ¥WebContent¥.serverPreference
これらのファイルには、設計時に必要な、プロジェクトに関する情報が記載されています。
この情報はバージョン 6.0.1 にマイグレーションできないため、これらのファイルは必要に応じて再作成されます。
- 「選択されたフォルダーのみ作成する」オプションと「警告を出さずに既存のリソースを上書き」オプションを選択し、「完了」をクリックします。
新しく作成した Web プロジェクト・フォルダーは現在、5.0 Web プロジェクト・フォルダーと同様のリソースおよびフォルダー構造を持っているはずです。
- (オプションのステップ: J2EE マイグレーション・ウィザードを使用して、J2EE レベル 1.2 から、これより高い J2EE レベルにマイグレーションします。)
- wdt400rt.jar および wdt400tb.jar を WEB-INF¥lib フォルダーから削除します。
- すべての PCML ファイルに対して「プログラム呼び出し」ウィザードを再実行します。
- このマイグレーションは、サービス Bean 自体にのみ適用されます。
バージョン 5.1 以降では、「Web サービス」ウィザードを呼び出す前に、指定したパッケージに Bean を生成してください。
「Web サービス」ウィザードで生成したコードは、手動でマイグレーションおよびクリーンアップを行う必要があります。
このマイグレーションは、Web サービス Bean 自体にのみ適用されます。
Web サービスのマイグレーション方法については、Rational Software Developer Platform 基本製品に付属のマイグレーション・ガイドにある Web サービスのセクションを参照してください (このガイドへのリンクについてはその他の重要な情報の検索を参照)。
(C) Copyright IBM Corporation 1992, 2006. All Rights Reserved.