ファイル操作のトレース

ここでは、ファイル操作のトレースのために用意された機能の使用法について説明します。これらの機能は、ファイル処理の問題での調査に役立ちます。

はじめに

ファイルハンドラの機能のファイル操作のトレースでは、次の操作を行うことができます。

ファイルハンドラ構成パラメータを使用して、トレースのオン/オフを切り替える。
ファイルハンドラ構成パラメータを使用して、ログと呼ばれるさらに高度なトレースを設定する。
ライブラリルーチンを使用して、COBOL プログラムから動的にトレースのオン/オフを切り替える。

トレースとログの構成

ファイルハンドラ構成パラメータの TRACE、TRACEFILEEXTEND、TRACEFILENAME、LOG および LOGFILENAME を使用して、トレースとログのアクティビティを次のように制御します。

TRACE=ON に設定すると、トレースがオンになります。
TRACEFILEEXTEND=ON に設定すると、トレースファイルが存在する場合、現行のトレースファイルの最後にトレース情報が書き込まれます。
TRACEFILENAME=filename を設定すると、トレースファイルにデフォルト以外の名前をつけることができます。デフォルト名は xfhtrace.xfh です。
LOG=ON に設定すると、ファイルに関連した特殊状況 (ファイルの破損や自動ファイル回復など) がログファイルに逐次出力され、後から必要に応じて調査できます。
LOGFILENAME=filename を設定すると、ログファイルにデフォルト以外の名前をつけることができます。デフォルト名は xfhlog です。

TRACE と LOG は、グローバルにまたは個別のファイルに設定することができます。TRACEFILEEXTEND、TRACEFILENAME、および LOGFILENAME は、グローバルにしか設定できません。

構成オプションをグローバルに設定する方法や個別ファイルに設定する方法の詳細については、『ファイルハンドラの構成』の章の『構成ファイル』の項を参照してください。

次に構成ファイルの例を示します。

[XFH-DEFAULT]
TRACE=OFF
TRACEFILENAME=c:\trace\mftracefile.xfh
TRACEFILEEXTEND=ON
LOG=ON
LOGFILENAME=c:\temp\mflogfile.log

[datafile1.dat]
TRACE=ON

[datafile2.dat]
LOG=OFF

この例では、ファイルトレースはグローバルにはオフ、datafile1.dat データファイルに対してはオンです。新しいトレースレコードは、既存のトレースファイル c:¥trace¥mftracefile.xfh がある場合、このファイルに追加されます。ログは、グローバルではオン、データファイル datafile2.datに対してはオフです。

注：トレースファイルのサイズが 4 GBを超える場合は、構成オプションの FILEMAXSIZE=8 および IDXFORMAT=8 も指定する必要があります。

FCD に適切なフラグを設定するか、ライブラリルーチンを使用するかで、COBOL プログラム内からトレースのオン/オフを切り替えることができます。これは、アプリケーションの動作のサブセットで、ファイル処理の問題に対処したい場合に便利です。 FCD フラグを設定する場合は、特定のファイルに対してこれを行います。ライブラリルーチンを使用する場合は、トレース設定は、その時点以降のプログラムで実行されるすべてのファイル操作に影響します。

動的トレースを実行する場合には、2 つのフラグを同時に使用します。これは、READ や WRITE などのファイル操作をトレースするには、OPEN 操作がトレースされている必要があるためです。トレースをオフにしてプログラムを起動し、ファイルを開いた後に動的にトレースをオンにした場合、トレースの仕組みでは、後続の操作をトレースすることはできません。最も良い方法は、プログラムの始めに OPEN と CLOSE の動的トレースをオンにしてから、すべての操作のオン/オフを必要に応じて切り替えることです。 OPEN 操作と CLOSE 操作のトレース自体もまた役に立つことがあります。