Visual Studio プロジェクトの構成

Micro Focus では、Visual Studio でプロジェクトを構成する際の推奨事項として、以下を提案しています。

IDE 設定を使用してコンパイラ指令を指定する

Visual COBOL のプロジェクトおよびファイルの IDE プロパティページには、広範な COBOL 設定が用意されています。

IDE 設定は、簡単に編集でき、移植も簡単です。この設定を使用してプロジェクトを構成すると、Visual Studio 内でもコマンドラインでも、この設定が適用されます。

コンパイラ指令を設定する際は、他の方法よりも、IDE プロパティページを使用することをお勧めします。具体的には、次のことを避ける必要があります。

COBOL プロジェクトファイル .cblproj を手動で編集する。
.bat ファイルとビルドスクリプトを混在させる。
指令に対する IDE 設定が存在する場合に、ファイルまたはプロジェクトのプロパティの [Additional Directives] にコンパイラ指令を手動で入力する。代わりに、GUI 設定を使用してください。
GUI コントロールと [Additional Directives] の両方を使用して同じ指令を設定すると、問題が起こる原因となります。

たとえば、プロジェクトレベルで [Additional Directives] に CICSECM を手動で入力できます。同時に、ファイルの GUI コントロールで [None] に設定することもできます。その結果、どの設定が実際に適用されるのか判断しにくくなります。

対応する IDE 設定が存在しない場合にのみ、[Additional Directives] に指令を指定する必要があります。

ソースファイルで $SET 文を使用しないようにする

ソースファイルで $SET 文を直接設定しないでください。代わりに、IDE 内のプロジェクトのプロパティページを使用して、対応するコンパイラ指令を設定してください。これは次の理由によります。

コード内の $SET 文は把握しにくく、特に多数のファイルを使用している場合には確認が困難になります。
Visual Studio では、プロジェクトレベルまたはファイルレベルで指定されている指令が可視化されます。ただし、コード内にある $SET 文は表示されません。そのため、GUI プロパティを使用して設定されたものとは異なるコンパイラ指令がソースコード内の $SET 文で設定されていると、予期しない動作が発生する可能性があります。

コンパイラ指令を含む外部ファイルは使用しない

必要なコンパイラ指令を格納するために外部ファイル (.dir など) を使用することは避けてください。これは次の理由によります。

Visual Studio 内から .dir ファイルの内容を簡単に確認する方法はありません。複数のプロジェクトがあるシナリオでは、どのプロジェクトで指令ファイルが使用されているのかが、わかりにくくなります。
プロジェクトのプロパティとして指定された指令と .dir ファイル内で指定された指令が混在していると、混乱の原因になります。

Open Folder を使用して開いたファイルのプロパティを指定する (Visual Studio 2017 以降のみ)

Open Folder 機能を使用してソースファイルをロードする場合、ファイルの場所に作成される .json は編集しないでください。代わりに、ワークスペース、フォルダー、またはファイルの GUI プロパティページを使用してコンパイラ指令を指定してください。

それらの GUI プロパティページで、対応する GUI プロパティがすでに存在する場合は、[Additional Directives] フィールドにコンパイラ指令を手動で入力しないでください。