プロジェクト プロパティの [Debug] ページで指定したプロパティは、選択した構成に適用されます。
各プロジェクト テンプレートには、生成するアプリケーションのタイプに応じて、それぞれに関連する一連のデバッグ プロパティが含まれています。本トピックでは、Enterprise Developer プロジェクトで使用できるすべてのデバッグ プロパティを示します。それぞれのプロジェクト テンプレートで使用できるプロパティは、アプリケーションのタイプによって異なります。
- [Profile]
- デバッグ プロファイルには、アプリケーションのデバッグを開始する方法を指定する一連のプロパティが格納されます。実行する項目 (実行可能ファイル、.int ファイル、ブラウザーなど)、アプリケーションをローカル マシンで起動するかリモート マシンで起動するか、デバッガーのアタッチ方法 (プロセスを開始するかアタッチメントを待機するか) など、さまざまな詳細を指定できます。
- [New] ボタンを使用して作成して、プロジェクトに複数のデバッグ プロファイルを含めることができます。
ネイティブ COBOL および .NET COBOL プロジェクトのデバッグ プロパティ
[Launch]:
- [Project]
- 出力を起動してプロジェクトをデバッグすることを指定します。
複数の出力ファイル (.exe、.int、または .gnt) にコンパイルされるプロジェクトの場合、起動する出力ファイルを指定できます。ビルドによって [Output] フィールドで指定されたディレクトリに生成されたファイルのみ選択できます。選択した内容はプロジェクト プロパティに保存されます。
注: この設定は、複数の .dll ファイルにビルドされる
.NET COBOL クラス ライブラリ プロジェクトには適用されません。それらのタイプのプロジェクトに対しては、別の開始動作を指定する必要があります。
- [Executable]
- デバッグするファイルのパス。プロジェクト ディレクトリに対する相対パスを指定できます。
この設定は、通常、アプリケーションがライブラリである場合に使用されます。
次の設定は、ネイティブ COBOL プロジェクトにのみ使用できます。
- [Wait for debuggable attachment]
- デバッガーは、別のプロセスでプログラムが開始されるのを待ってから、プログラムをアタッチしようとします。プロセスを手動で起動する必要がある場合にオンにします。次のオプションを設定できます。
- [Wait for any program] - CBL_DEBUGBREAK を呼び出す COBOL プログラムか、COBSW 環境変数が +A の設定で起動される COBOL プログラムまで待機して、そのプログラムにアタッチします。
- [Wait for directory] - [Working Directory] で指定されたフォルダーまたはそのサブフォルダーを作業ディレクトリとして使用して起動される次の COBOL プログラムまで待機して、そのプログラムにアタッチします。作業ディレクトリが指定されていない場合は、プロジェクトの出力パスが使用されます。
- [Wait for ID] - [ID] フィールドで指定した識別子が引数として設定された CBL_DEBUG_START を呼び出す COBOL プログラムまで待機して、そのプログラムにアタッチします。識別子はソース コードで設定します。「CBL_DEBUG_START」を参照してください。
- [Launch Browser]
- Web ページを開いてデバッグを開始します。
次の開始オプションを選択できます。
- [Application Arguments]
- プログラムに渡す引数。
- [Working Directory]
- プログラムを起動するディレクトリ。
注: [
Launch] が [
Wait for debuggable attachment] に設定されている場合、このフィールドで指定したパスが [
Wait for directory] オプションで使用されます。
- [Use remote machine]
- リモート デバッグを有効にする場合にオンにします。リモート マシンのネットワーク名または IP アドレスを隣接するフィールドに入力します。
- [Port]
- cobdebugremote または cobdebugremote64 プロセスで使用されるポート番号を指定します。
[Debug options]:
次のプロパティは、ネイティブ COBOL プロジェクトにのみ適用されます。
- [Enable multiprocess debugging]
- デバッグしているプロセスで CBL_EXEC_RUN_UNIT 呼び出しを使用して新しいプロセスが開始された場合に、新しいプロセスを Visual Studio の別のインスタンスでデバッグできます。
- [Return to waiting state when debugging]
- オンにすると、CGI プログラムを複数回呼び出す場合に、それらのデバッグが可能になります。
次のプロパティは、.NET COBOL プロジェクトにのみ適用されます。
- [Enable SQL Server debugging]
- Microsoft SQL デバッガーを有効にします。
- [Enable mixed mode debugging]
- オンにすると、.NET コードに加えて C/C++ コードのデバッグが可能になります。
- [Redirect standard output]
- true または false。標準出力 (System.Console.WriteLine など) をデバッガーの出力ウィンドウにリダイレクトするかどうかを指定します。この初期値は、コンソール プロジェクトの場合は false に設定されており、Windows プロジェクトの場合は true に設定されています。
注: これは、64 ビット アプリケーションでは機能しません。また、64 ビット マシンでは、x86 プラットフォーム タイプでのみサポートされます。
- [Disable Windows authentication for remote debugging]
- リモート デバッガーへの接続時に資格情報を入力せずに済むようにする場合にオンにします。リモート デバッガーも Windows 認証なしで動作するように構成されていることを確認する必要があります。このオプションは、必要な資格情報を設定できないシナリオで役立ちます。
警告: リモート デバッガーでこのオプションを有効にすると、そのリモート マシンにネットワーク上の他のユーザーがアクセスできるようになります。
Docker 環境のデバッグ プロファイル
- [Project (Docker)]
- Docker コンテナー内でプロジェクト出力をデバッグする場合は、このプロファイルを選択します。デバッグを開始すると、Visual Studio から Docker コンテナーが起動し、プロジェクト出力がコンテナー内部で起動されてデバッグされます。
- [Executable (Docker)]
- Docker コンテナーのデバッグ時に起動する実行可能ファイルのパスを指定できます。デバッグを開始すると、Docker コンテナーが起動し、指定した実行可能ファイルがコンテナー内部で起動されてデバッグされます。
Enterprise Server で実行する必要があるネイティブ アプリケーションのデバッグ プロパティ
Web サービスを起動するかコア ダンプ ファイルを起動するかを指定します。
- [Web Service]
-
- [Client IP]
- このフィールドを空のままにすると、任意の IP アドレスからデバッグが可能になります。デバッグを許可する IP アドレスだけを指定します。
- [Service Name]
- デバッグする Web サービスのアドレスを指定します。Web サービスのアドレスおよびその一部である特定の操作を http://namespace/ServiceName#OperationName の形式で入力します。
- [Core Dump]
- アプリケーションのデバッグに使用するコア ダンプ ファイルの名前およびパスを指定します。
ネイティブ メインフレーム サブシステム プロジェクトのデバッグ プロパティ
次のデバッグ プロパティは、エンタープライズ サーバー インスタンスで実行されるネイティブ メインフレーム サブシステム アプリケーションにのみ適用されます。これらは、ネイティブ メインフレーム サブシステム アプリケーション プロジェクト タイプにのみ使用できます。
[Launch] を、デバッグするアプリケーションのタイプ (CICS、JCL、または IMS)、Web サービス、またはコアダンプ ファイルに設定します。
- [CICS]
-
- [User]
- アプリケーションを開始する際に使用する CICS ユーザー ID。
- [Terminal]
- アプリケーションを開始する際に使用する CICS 端末 ID。
- [Transaction]
- アプリケーションの CICS トランザクション。
- [Link-level program]
- CICS で起動したプログラム。ここでデバッグを開始します。
- [IMS]
-
- [User]
- このアプリケーションをデバッグする際に使用するユーザー ID。
- [Terminal]
- このアプリケーションをデバッグする際に使用する論理端末 ID。これは、Enterprise Server 内での TN3270 接続の 8 文字の名前で、動的に割り当てられるか TN3270 クライアント エミュレーターから指定されます。
- [Transaction]
- このアプリケーションをデバッグする際に使用するトランザクション。
- [Top-level program]
- このアプリケーションをデバッグする際に使用する開始プログラム。
- [JCL]
-
- [Job name]
- ジョブの名前。
- [Job number]
- 保持キュー内のジョブの番号。
- [Step name]
- デバッグするステップ。
- [Top-level program]
- デバッグするプログラムのプログラム ID。
- [Web Service]
-
- [Client IP]
- このフィールドを空のままにすると、任意の IP アドレスからデバッグが可能になります。デバッグを許可する IP アドレスだけを指定します。
- [Service Name]
- デバッグする Web サービスのアドレスを指定します。Web サービスのアドレスおよびその一部である特定の操作を http://namespace/ServiceName#OperationName の形式で入力します。
- [Core Dump]
- アプリケーションのデバッグに使用するコア ダンプ ファイルの名前およびパスを指定します。
ES.NET メインフレーム サブシステム プロジェクトのデバッグ プロパティ
次のデバッグ プロパティは、Enterprise Server for .NET で実行される .NET COBOL アプリケーションにのみ適用されます。これらは、ES.NET メインフレーム サブシステム アプリケーション プロジェクト タイプの [Debug] ページに表示されます。
[Launch] を、デバッグするアプリケーションのタイプ (CICS または JCL) に設定します。
- [CICS]
-
- [User]
- アプリケーションを開始する際に使用する CICS ユーザー ID。
- [Terminal]
- アプリケーションを開始する際に使用する CICS 端末 ID。
- [Transaction]
- アプリケーションの CICS トランザクション。
- [JCL]
-
- [User]
- アプリケーションを開始する際に使用するユーザー ID。
- [Job class]
- ジョブのクラス。
- [Job name]
- ジョブの名前。
- [Job number]
- 保持キュー内のジョブの番号。
- [Enable SQL Server Debugging]
- Microsoft SQL デバッガーを有効にします。
注: プロパティ ページに表示されるコントロールは、作業しているプロジェクトのタイプによって決まります。そのため、ここで説明されているコントロールの一部はプロパティ ページに表示されない、または選択できない場合があります。