[COBOL Application]、[COBOL Attach to Process]、[COBOL Wait for Application Attachment]

[General] タブ

[Debug Configurations] ダイアログ ボックスの [General] タブのオプションのうち、これらの構成に共通のものは次のとおりです。

[COBOL Project]

デバッグ中に使用されるプロジェクトです。

[Connection Properties]

プロジェクトまたはリモート マシン上で実行されているアプリケーションをデバッグする場合は、これらのフィールドに値を入力します。

[Remote Host]

リモート マシンの名前または IP アドレス。

[Specify the port on which cobdebugremote process will listen on the remote host]

リモート マシン上でアプリケーションをデバッグする場合は、cobdebugremote(Windows) または cobdebugremote32(UNIX) プロセス (64 ビット プロセスの場合は cobdebugremote64) がそのマシン上で実行されている必要があります。

リモート マシン上でアプリケーションを開発している場合

Micro Focus Enterprise Developer UNIX Componentsを使用している場合は、デバッグを開始すると、IDE が cobdebugremote(Windows) または cobdebugremote32(UNIX) プロセス (64 ビット プロセスの場合は cobdebugremote64) をリモート マシン上で自動的に起動します。プロセスの起動時にはランダムなポートが選択されるため、ユーザーがポートを選択する必要はありません。ただし、このオプションを選択した場合は、[cobdebugremote port] フィールドで特定のポートを割り当てることができます。ポートを指定すると、プロセスはそのポートで自動的に起動します。

ローカル マシン上でアプリケーションを開発し、リモートでデバッグしている場合

最初に、cobdebugremote(Windows) または cobdebugremote32(UNIX) プロセス (64 ビット プロセスの場合は cobdebugremote64) をコマンド プロンプトから起動する必要があります。

プロセスのオプションは次のとおりです。

オプションなし

プロセスを起動し、リモート接続のランダム ポートを開きます。ポート番号はコンソールに表示されます。

machine=name

プロセスが実行されているマシンを指定します。stop オプションでのみ有効です。

port

port=nnnnn

接続要求をリッスンするために使用するポートを指定します。

port=nnnnn-yyyyy

使用するポートの範囲を指定します。ポート nnnnn が使用中の場合は、空きポートが見つかるまで次のポートが試行されます。その範囲内で空きポートが見つからなかった場合は、ユーティリティはエラーを返します。

注: port オプションとして設定したものと同じ番号をデバッグ構成の [cobdebugremote port] フィールドに入力する必要があります。

repeat

デバッグ セッションの完了後に、別の接続のリッスンを開始します。オプションを指定しなかった場合、プロセスはデバッグ セッションの完了後に終了します。

stop

ポートでリッスンしているプロセスを終了させます。port オプションと併用する必要があります。これは、プロセスが接続を待っている場合にのみ有効です。

オプションなしでプロセスを実行する場合は、コンソールに表示されたポート番号を [cobdebugremote port] フィールドに入力する必要があります。

[X Server (DISPLAY)]

Micro Focus Enterprise Developer UNIX Componentsを使用してリモート UNIX マシン上でアプリケーションをデバッグする場合は、ローカル Windows マシン上でリモート プログラム出力を表示する X サーバーの識別子を入力します。デフォルト値は、client machine name:0.0 です。

デバッグを行う前に、X サーバーが実行されていること、およびリモート マシンの xhost 構成に正しいアクセス権限があることを確認してください。xhost + コマンドを使用すると、許可されているホストまたはユーザー名のリストに自分のホストまたはユーザー名を追加できます。

[Debug Options]

デバッグ プロセスをさらに制御するには、これらのオプションを使用します。

• デバッグを正しく機能させるには、デバッグ中のアプリケーションが 64 ビットまたはグラフィカルであるときに、それを示す必要があります。
• STOP RUN コマンドが実行されたときに、プログラムを終了するのではなく一時停止してデバッグを継続する場合は、[Suspend at 'stop run'] を選択します。
• 手続き部のエントリ ポイントが呼び出されたときのみにプログラム ブレークポイントによって実行が停止するように指定するには、[Program breakpoint on main entry point only] をオンにします。このオプションをオンにしないと (デフォルト設定)、プログラムへのどのエントリ ポイントでも、また呼び出しからプログラムに戻る時点でも、プログラム ブレークポイントによって実行が停止します。
• デバッグ中に実行パスを前後にたどれるようにするには、[Enable reverse debugging] を選択します。
  注: このオプションは、リバース デバッグをサポートするプラットフォーム上にあるプロジェクト/プログラムを選択した場合にのみ選択できます。サポートされるプラットフォームのリストについては、「リバース デバッグおよびライブ記録」を参照してください。

[Source] タブ

[Debug Configurations] ダイアログ ボックスの [Source] タブのオプションのうち、これらの構成に共通のものは次のとおりです。

[Source Lookup Path]

デバッガーがソース ファイルを検索する場所および順序を指定できます。

場所を追加するには [Add] をクリックします。

[COBOL Project]

検索するプロジェクトを選択する場合にクリックします。プロジェクトのプロパティの [Micro Focus > Build Path] タブで指定されているフォルダーや依存プロジェクトも検索されます。

[Environment Variable]

検索するフォルダーが含まれている変数を選択する場合にクリックします。

[File System Directory]

ワークスペースの外部に存在する可能性がある特定のファイル システム フォルダーを検索するように指定する場合にクリックします。

[Paths From Debugger Information Files]

.idy ファイルに指定されているパスを使用してソース ファイルを見つける場合にクリックします。このパスは、プログラムのコンパイル時に格納されます。ソース ファイルは、ワークスペースの外部にあってもかまいません。したがって、ソース ファイルが含まれているプロジェクトをソース検索パスに追加する必要はありません。

[Project]

特定のプロジェクトのフォルダーを検索する場合にクリックします。

[Remote File System Directory]

リモート プロジェクトのホスト上にある特定のリモート ファイル システム フォルダーを指定する場合にクリックします。このオプションを使用できるのは、[General] タブで [Connection Properties] グループの [Remote Host] フィールドを指定した場合だけです。

[Working Set]

ワーキング セットで定義されているすべての表示可能なプロジェクトのソース検索パスを追加する場合にクリックします。詳細については、「Working Sets」を参照してください。

[Workspace]

現在のワークスペースのすべてのフォルダーを検索する場合にクリックします。

[Workspace Folder]

ワークスペースの特定のフォルダーをソース検索パスとして指定する場合にクリックします。

[Debug Symbols] タブ

[Debug Configurations] ダイアログ ボックスの [Debug Symbols] タブでこれらの構成に使用できるオプションは次のとおりです。

[Debug Symbols Lookup Path]

デバッガーがデバッグ シンボル コンテナーおよびデバッグ シンボル ファイルを検索する場所および順序を指定できます。

場所を追加するには [Add] をクリックします。

[Environment Variable]

検索するフォルダーが含まれている変数を選択する場合にクリックします。

[File System Directory]

ワークスペースの外部に存在する可能性がある特定のファイル システム フォルダーを検索するように指定する場合にクリックします。

[Project]

特定のプロジェクトのフォルダーを検索する場合にクリックします。

[Remote File System Directory]

クリックすると、[Add File System Directory] ダイアログ ボックスが開きます。そこで、リモート プロジェクトのホスト上にある特定のリモート ファイル システム フォルダーを指定またはブラウズします。サブフォルダーを再帰的に検索する場合は [Search subfolders] をオンにします。このオプションを使用できるのは、[General] タブで [Connection Properties] グループの [Remote Host] フィールドを指定した場合だけです。

[Workspace Folder]

ワークスペースの特定のフォルダーをデバッグ シンボル検索パスとして指定する場合にクリックします。

[CTF]

このタブでは、プログラムの診断情報を生成するように統合化トレース機能 (CTF) を構成できます。

[Enable CTF]

これをオンにすると、ワークスペースにある CTF 構成ファイルが [Available configurations] リストに表示されます。

注: CTF 構成ファイルには .mfctfcfg というサフィックスが必要です。

[Use selected configuration]

選択した構成ファイルを使用する場合にクリックします。クリックすると、選択した構成ファイルに含まれている構成項目が [Chosen configuration] 領域に表示されます。必要に応じて構成項目を変更し、[Apply] をクリックします。

注: [Chosen configuration] 領域で構成を変更しても、元の構成ファイルは変更されません。

[Export]

変更した構成をローカル ファイルシステムのファイルまたはリモートの場所にエクスポートする場合にクリックします。

[Import]

構成をワークスペース外のローカル ファイルシステムのファイルまたはリモートの場所からインポートする場合にクリックします。

CTF 構成ファイルの詳細については、「統合化トレース機能」を参照してください。