リモートデバッガを使用し、アタッチ形式のリモートデバッグを行うことができます。
アタッチ形式のデバッグ開始を指示するための環境変数をサーバ側で設定し、COBOLアプリケーションを実行することによりリモートデバッガが起動され、リモートデバッグを開始します。
ローカルPC側リモートデバッガコネクタ
アタッチ形式のリモートデバッグを行う場合、サーバ側からのリモートデバッガ起動に関する指示を監視するリモートデバッガコネクタがデバッガ起動時にローカルPC上で自動的に起動されます。
ローカルPC側リモートデバッガコネクタが起動されると、タスクトレイにアイコン
が表示されます。リモートデバッガコネクタはデバッガ終了時に自動終了しないため、リモートデバッグを終了した場合は、リモートデバッガコネクタも終了させる必要があります。リモートデバッガコネクタを終了させるには、アイコンのコンテキストメニューから[終了]を選択してください。
ローカルPC側リモートデバッガコネクタに関するその他の詳細については、"NetCOBOL 使用手引書"を参照してください。
リモートデバッガの起動
以下にリモートデバッガを起動する手順を示します。
依存ビューまたは構造ビューからCOBOLプロジェクトを選択します。
メニューバーから[実行] > [構成およびデバッグ]を選択します。またはツールバーで
の▼をクリックし[構成およびデバッグ]を選択します。[構成およびデバッグ]ダイアログボックスが表示されます。
左のペインで[リモートCOBOLアプリケーション]を選択します。
左のペイン上の
をクリックすると、右のペインに起動構成の設定ページが表示されます。
デフォルトで[名前]に起動構成名が表示されます。起動構成名は任意の名前に変更できます。
[メイン]タブをクリックし、各設定項目の確認と必要に応じて変更を行います。
[プロジェクト名]には、選択したプロジェクト名が表示されています。
[デバッグ方法]では、[アタッチデバッグ]を選択します。
[デバッグ情報フォルダ]には、プロジェクトのプロパティの[リモート開発]ページの[サーバディレクトリ]で指定したディレクトリと異なるディレクトリにデバッグ情報ファイルが格納されている場合に、その格納ディレクトリを指定します。
複数のディレクトリを指定する場合には次のように指定します。
サーバがSolaris、Linuxの場合は":"(コロン)で区切って指定します。
サーバがWindowsの場合は";"（セミコロン）で区切って指定します。
[デバッグ]を選択することでデバッグが開始され、デバッグするアプリケーション側から起動が通知されるまで待ち状態となります。一度デバッグ起動した起動構成は、[実行] > [ヒストリのデバッグ]およびツールバーのショートカットに登録され、そこから再度起動できます。
注意
サーバがSolarisまたはLinuxであり、かつ、デバッグ対象のCOBOLアプリケーションが使用するダイナミックリンクライブラリが実行ファイルと異なるディレクトリに格納されている場合は、ダイナミックリンクライブラリのデバッグ情報ファイル(.svd)を実行ファイルの格納されているディレクトリにコピーしてからデバッグを開始してください。
ポイント
依存ビューまたは構造ビューでプロジェクトを選択し、メニューバーから[実行] > [デバッグ] > [リモートCOBOLアプリケーション]を選択することにより、デフォルトの設定でデバッガを起動できます。
サーバ側アプリケーションの実行
リモートデバッガに起動を通知するために必要となる環境変数の設定、およびデバッグ対象のアプリケーションの実行をサーバ側で行います。
設定する環境変数は以下のとおりです。"接続先"にはローカルPCのIPアドレスまたはホスト名および必要に応じてポート番号を指定します。
"追加パスリスト"には、起動するアプリケーションが動作し始めたときのカレントディレクトリと、起動するアプリケーションの格納ディレクトリは記述する必要はありません。以下の順序で、デバッグ情報のファイルが検索され、デバッグに利用されます。
追加パスリストの指定順(各パスは、Windowsの場合は";"で区切って記述してください。Solaris、Linuxの場合は":"で区切って記述してください)
アプリケーションが動作し始めたときのカレントディレクトリ
起動するアプリケーションの格納ディレクトリ
環境変数の設定方法に関する詳細は、"NetCOBOL 使用手引書"を参照してください。
サーバ | 環境変数 |
|---|---|
Windows(Itanium) | @CBR_ATTACH_TOOL=接続先/APD 追加パスリスト |
Windows(x64) | |
Solaris | CBR_ATTACH_TOOL=接続先/APD 追加パスリスト |
Linux |
接続待ち状態の解除
アタッチデバッグを実行したあとで、サーバ側アプリケーションからの接続待ち状態を解除する場合は、ウィンドウ右下の
をクリックし、表示された[進行状況]ビューで
をクリックしてください。
ローカルPC上のCOBOLアプリケーションをアタッチデバッグする
[リモートCOBOLアプリケーション]起動構成では、ローカルPC上でビルドしたCOBOLアプリケーションをアタッチデバッグすることもできます。
ローカルPC上でアタッチデバッグする場合には、デバッガにアプリケーションの起動を通知するために以下の環境変数をローカルPCに設定します。
ローカルPC | 環境変数 |
|---|---|
Windows | @CBR_ATTACH_TOOL=localhost/APD |
以下にローカルPC上でアタッチデバッグする手順を示します。
依存ビューまたは構造ビューからCOBOLプロジェクトまたはCORBAサーバプロジェクトを選択します。
メニューバーから[実行] > [構成およびデバッグ]を選択します。またはツールバーでの▼をクリックし[構成およびデバッグ]を選択します。[構成およびデバッグ]ダイアログボックスが表示されます。
左のペインで[リモートCOBOLアプリケーション]を選択します。
左のペイン上のをクリックすると、右のペインに起動構成の設定ページが表示されます。
デフォルトで[名前]に起動構成名が表示されます。起動構成名は任意の名前に変更できます。
[メイン]タブをクリックし、各設定項目の確認と必要に応じて変更を行います。
[プロジェクト名]には、選択したプロジェクト名が表示されています。
[デバッグ方法]では、[アタッチデバッグ]を選択します。
[デバッグ]を選択することでデバッグが開始され、デバッグするアプリケーション側から起動が通知されるまで待ち状態となります。
COBOLアプリケーションを実行し、デバッグを開始します。
