アプリケーションをデバッグするには、Application Server Toolkit または Rational Application Developer などの
開発環境を使用して、Java プロジェクトを作成する必要があります。その後、デバッグするプログラムをプロジェクトにインポートする必要があります。
このタスクについて
以下のステップに従うことにより、
WebSphere Application Server の例を Java プロジェクトにインポートすることができます。
次の 2 つのデバッグのスタイルが使用できます。
- ステップバイステップ・デバッグ・モードでは、サーバーが Web オブジェクトのメソッドを呼び出すたびにプロンプトが表示されます。ダイアログを使用すると、メソッド内に入ったり、メソッドをスキップすることができます。
ダイアログでは、ステップバイステップ・モードの使用が終了すると、このモードをオフにすることができます。
- ブレークポイント・デバッグ・モードでは、プログラムの特定の部分をデバッグできます。
デバッグする必要があるコードの部分にブレークポイントを追加し、追加したブレークポイントのいずれかに達するまでプログラムを実行します。
ブレークポイントは、実際には、どちらのデバッグ・スタイルでも機能します。ステップバイステップ・モードでは、あらかじめブレークポイントを設定しなくても、どの Web オブジェクトが呼び出されているかがわかります。
プロジェクトにプログラム全体をインポートする必要はありません。ただし、プロジェクトにプログラムをすべてインポートしないと、ソースの一部がコンパイルされない可能性があります。この場合でもプロジェクトをデバッグすることは可能です。ブレークポイント、ステップ実行、変数の表示と変更などのフィーチャーをはじめとして、デバッガーのほとんどのフィーチャーは動作します。ブレークポイントの設定対象であるソースをすべてインポートする必要があります。
ソースにビルド・エラーが発生すると、ソース・ビュー内のインスペクション・フィーチャーおよび表示フィーチャーは機能しません。
これらのフィーチャーを使用すると、ソース・ビューで式を選択し、それを評価することができます。
プロシージャー
- 「新規プロジェクト」ダイアログを開いて Java プロジェクトを作成します。
- ダイアログの左側で「Java」を選択し、ダイアログの右側で「Java Project」を選択します。
- 「次へ」をクリックしてから、WASExamples などのプロジェクトの名前を指定します。
- 「終了」をクリックして、プロジェクトを作成します。
- 新規プロジェクトを選択して、「ファイル」>「インポート」>「ファイル・システム」と選択し、
さらに「次へ」を選択して「Import file system」ダイアログを開きます。
- ファイルのディレクトリーをブラウズします。
次のディレクトリーに進みます。
profile_root/installedApps/node_name/DefaultApplication.ear/DefaultWebApplication.war
次のディレクトリーに進みます。
profile_root/installedApps/node_name/DefaultApplication.ear/DefaultWebApplication.war
- 「インポート」ダイアログの左側にある DefaultWebApplication.war を選択してから、「終了」をクリックします。 これにより、例の JavaServer Pages ファイルおよび Java ソースがプロジェクトにインポートされます。
- ビルドする必要がある JAR ファイルを Java ビルド・パスに追加します。
![[z/OS]](../../ngzos.gif)
右マウス・ボタン・クリック・メニューから「
プロパティー」を選択します。
「Java Build Path」ノードを選択してから、「ライブラリー」タブを選択します。
「
外部 JAR の追加」をクリックして、以下の JAR ファイルを追加します。
すべての JAR を追加したら「
OK」をクリックします。
![[i5/OS]](../../iseries.gif)
右マウス・ボタン・クリック・メニューから「
プロパティー」を選択します。
「Java Build Path」ノードを選択してから、「ライブラリー」タブを選択します。
「
外部 JAR の追加」をクリックして、以下の JAR ファイルを追加します。
すべての JAR を追加したら「
OK」をクリックします。
- 必要に応じて、この時点でブレークポイントをソースに設定することができますが、
ステップバイステップ・モードは、サーバーが Web オブジェクト上でメソッドを呼び出すたびにプロンプトを出すので、
この設定は必ずしも必要ではありません。 ステップバイステップ・モードについては、以下でより詳しく説明します。
- デバッグを開始するには、WebSphere Application Server をデバッグ・モードで始動し、
JVM デバッグ・ポートをメモする必要があります。 JVM デバッグ・ポートのデフォルト値は 7777 です。
- サーバーを始動したら、「ウィンドウ」>「パースペクティブのオープン」>「デバッグ」と選択して、
デバッグ・パースペクティブに切り替えます。「ウィンドウ」>「Customize Perspective」と選択して、「その他」カテゴリー内の「デバッグ」および「Launch」チェック・ボックスを選択することにより、「Java Perspective」内のデバッグ・ランチを使用可能にすることもできます。
- ワークベンチ・ツールバーの「デバッグ」プッシュボタンを選択した後、
ランチ構成のリストから「WebSphere Application Server Debug」を選択します。「新規」プッシュボタンをクリックして、新規構成を作成します。
- 構成に名前を付けて、デバッグ対象のプロジェクト (ユーザーの新規 WASExamples プロジェクト) を選択します。サーバーをデフォルトのポート (7777) で始動しなかった場合は、ポート番号を変更してください。
- 「デバッグ」をクリックして、デバッグを開始します。
- ご使用のブラウザーで、例のいずれかをロードします。例えば、http://your.server.name:9080/hitcount と入力します。
次の作業
デバッグについて詳しくは、Application Server Toolkit を立ち上げて、「
ヘルプ」>「
Help Contents」と選択し、「
Debugger Guide bookshelf」という項目を選択してください。
Application Server Toolkit に関する既知の制限および問題については、
Application Server Toolkit のリリース情報を参照してください。IBM サポートから入手可能な既知の問題およびその解決法に関する最新の情報については、
IBM サポート・ページを参照してください。
IBM サポートの資料を利用すると、
この問題の解決に必要な情報収集の時間を節約できます。
PMR を開く前に、IBM サポートに送信する情報の収集について、Must
gather ページを参照してください。