PL/I デバッグ構成

[General] タブ

[PL/I Application]、[PL/I Attach to Application]、および [PL/I Wait for Application Attachment] に共通する [General] タブのオプションを以下に示します。

[PL/I 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) をコマンド プロンプトから起動する必要があります。

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

no options

Starts the process and opens a random port for remote connections. The port number is displayed in the console.

machine=name

Specify the machine that the process is running on. Only valid with the stop option.

port

port=nnnnn

Specify the port to use to listen for connection requests.

port=nnnnn-yyyyy

Specify the range of ports to use. If port nnnnn is in use, the next port is tried until a free port is found. If no free ports are found in the range, the utility returns an error.

注: You must enter the same number you set as the port option in the cobdebugremote port field of your debug configuration.

repeat

After the debug session has been completed, start listening for another connection. If no option is specified, the process exits after the debug session has completed.

stop

Causes the process that is listening on the port to exit. Must be used with the port option. This is only valid when the process is waiting for a connection.

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

[Use X Server]

SSH のみの接続タイプ (Micro Focus DevHub SSH Only) の場合、リモート プログラムの出力をローカル マシンで表示するために X Server 実装を使用する必要はありません。単純な I/O プログラムであれば、IDE 内の [Console] ビューで出力を表示できます。複雑なプログラムの場合は、見やすくするために X Server 実装を使用することもできます。

プログラム出力を [Console] ビューに送る場合は、[Use X Server] が選択されていないことを確認してください。他の接続タイプの場合は、このオプションは使用できず、X Server 実装を使用する必要があります。

[X Server (DISPLAY)]

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

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

次の設定は、[PL/I Attach to Application] および [PL/I Wait for Application Attachment] デバッグ構成に適用されます。

[Debug Options]

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

• デバッグを正しく機能させるには、デバッグ中のアプリケーションが 64 ビットまたはグラフィカルであるときに、それを示す必要があります。
• [PL/I Wait for Application Attachment] では、[Return to waiting state when debugger disconnects] オプションを選択できます。これは、デバッガーがデバッグ可能プログラムに再度アタッチされるまで待機することを意味します。これを選択しなかった場合、デバッグはプログラムからの切断時に終了します。

[Source] タブ

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

[Source Lookup Path]

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

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

[File System Directory]

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

[Environment Variable]

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

[PL/I Project]

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

[Project]

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

[Working Set]

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

[Workspace]

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

[Workspace Folder]

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

[Environment] タブ

このタブは、[PL/I Application] のみで利用できます。

環境変数を追加、変更、または削除するには、[Add]、[Edit]、または [Remove] ボタンを使用します。

環境スクリプトを使用するか、関連するプロジェクトのビルド環境から値を継承するかを選択することもできます。

[Common] タブ

このタブでは、起動構成に関するいくつかの設定を指定できます。

[Save As]

起動構成をローカル ファイルまたは共有ファイルのどちらとしてワークスペース プロジェクトに保存するかを選択できます。

[Display in favorites menu]

この構成をお気に入りとして表示するメニューを選択できます。[PL/I Application] については、[Debug] および [Run] を選択できます。他の 3 つの PL/I デバッグ構成タイプについては、[Debug] のみを選択できます。

[Encoding]

エンコーディングのタイプを選択できます。

[Launch in background]

このオプションを選択すると、構成がバックグラウンドで起動されます。

[Debug Symbols] タブ

このタブでは、デバッガーがデバッグ シンボル (.idy) ファイルを検索する場所を指定できます。

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

[Environment Variable]

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

[File System Directory]

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

[Project]

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

[Workspace Folder]

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