.csv ファイルとしての HSF 情報の表示

制約事項: 本トピックは、Enterprise Server 機能が有効な場合にのみ該当します。

HSF レコードの収集およびディスクへの書き込みを有効にしている場合は、個々のトランザクション実行の詳細がカンマ区切り値ファイルに書き込まれ、1 つの HSF レコードが 1 行に記述されます。

これらのファイルは cashsf-a.csv および cashsf-b.csv という名前でシステムディレクトリに置かれます。これらのファイルのうち、アクティブになるのはどちらか一方のみで、アクティブなファイルが一杯になった場合、または ESMAC の [Control] ページの [HSF Data] セクションにある [Switch] ボタンをクリックした場合に、レコードがもう一方のファイルに書き込まれます。レコードの書き込みは、そのファイルの最大ファイルサイズに達するか、[Switch] ボタンを再度クリックするまで続きます。

このバージョンの製品で作成された .csv ファイルには次のヘッダーがあり、以下のフィールドが含まれます。

#HSFVer=03;Custom=xx;CicsFiles=xx;TSQ=xx;TDQ=xx
Type,PID,Task,Date,Time,Tran/Job,User/DDName/CC,LU/Step,Prog/DSName,Latent/ReadCount,Resp/WriteCount,
API/RewriteCount,SQL/DeleteCount,IMS/DSDeleteCount,DSType,DSAccessType,Custom01,File01,Count01,Time01,TS01,Count01,Time01,TD01,Count1,Time1

Custom、File、TS、および TD フィールドの数は、ヘッダー内の xx の値に対応します。これは、ES_HSF_CFG 環境変数に従って設定されます。

この変数を設定する際には、許容範囲内で値を設定する必要があります。値を設定しない場合は、そのフィールドにデフォルト値が使用されます。また、フィールド名が変数内で明示的に設定されていない場合は、そのデフォルト値が使用されます。許容範囲およびデフォルト値は次のとおりです。

フィールド名	範囲	デフォルト
CUSTOM	0 から 5	0
CICSF	0 から 20	5
TSQ	0 から 20	5
TDQ	0 から 20	5

たとえば、ES_HSF_CFG=CUSTOM=2;CICSF=10;TSQ=32 の場合、2 個のカスタムフィールド、10 個の CICS ファイルフィールド、5 個の TSQ フィールド、5 個の TDQ フィールドが生成されます。

重要: 以前のバージョンの製品の HSF 出力は、ヘッダーを含まないか、以下の行で始まらない場合があります。

#HSFVer=01 or 02

以前の一部の .csv ファイル (#HSFVer=01) は、DSType および DSAccessType フィールドを含まず、以下のヘッダーもありません。

#HSFVer=01
Type,PID,Task,Date,Time,Tran,User,LU,Prog,Latent,Resp,API,SQL,IMS,File1,Count1,Time1,File2,Count2,Time2,
File3,Count3,Time3,File4,Count4,Time4,File5,Count5,Time5,TS1,Count1,Time1,TS2,Count2,Time2,TS3,Count3,
Time3,TS4,Count4,Time4,TS5,Count5,Time5

または、以下の IMS フィールドがありません。

Type,PID,Task,Date,Time,Tran,User,LU,Prog,Latent,Resp,API,SQL,File1,Count1,Time1,File2,Count2,
Time2,File3,Count3,Time3,File4,Count4,Time4,File5,Count5,Time5,TS1,Count1,Time1,TS2,Count2,Time2,TS3,
Count3,Time3,TS4,Count4,Time4,TS5,Count5,Time5

フィールドの型

Type

レコードの型。次のいずれかになります。

WEB - Web サービス用

PID

タスクを実行した SEP のプロセス ID。

Task

一意のタスク番号。

Date

タスクの実行が開始された日付 (yyyymmdd 形式)。

Time

タスクの実行が開始された時刻 (hhmmssttt 形式。ttt はミリ秒を示す)。

Tran/Job

タスクの名前。以下のいずれかになります。

Web サービスの場合は、サービス名。

Latent/ReadCount

Enterprise Server が要求を受信してからタスクの実行が開始されるまでの時間 (ミリ秒単位)。

Resp/WriteCount

タスクが実行されていた時間 (ミリ秒単位) (待ち時間を含まない)。

SQL/DeleteCount

このタスクに対する SQL API (EXEC SQL 文) で費やされた時間 (ミリ秒単位)。

CPU Time

タスクで使用された CPU 時間 (ミリ秒単位)¹。

Mem Usage

メモリ使用量 (キロバイト単位)¹。

IO Read Size

読み取られたデータの量 (キロバイト単位)¹。

IO Write Size

書き込まれたデータの量 (キロバイト単位)¹。

IO Read Count

読み取りシステム呼び出しの数¹。

IO Write Count

書き込みシステム呼び出しの数¹。

MQ Time

MQ API 呼び出しの実行にかかった時間 (ミリ秒単位)¹。

EZASOKET Time

EZASOKET API 呼び出しの実行にかかった時間 (ミリ秒単位)¹。

DSType

このフィールドはすべてのレコードで空白になります。

DSAccessType

このフィールドはすべてのレコードで空白になります。

注: ¹ これらのフィールドには、リージョンが値を出力するように構成されている場合にのみ値が格納されます。これを制御するには、環境変数 ES_HSF_RTS_MONITOR を ON または OFF に設定します。

Windows では、これらのフィールドのサポートはデフォルトでは有効になっていません。有効にするには、ES_HSF_RTS_MONITOR=ON を設定します。

Linux では、これらのフィールドのサポートはデフォルトで有効になっています。無効にするには、ES_HSF_RTS_MONITOR=OFF を設定します。

UNIX では、これらのフィールドはサポートされていません。

構成可能なフィールド型

ES_HSF_CFG 環境変数の値に基づいて、以下の追加フィールドが繰り返される場合があります。

Customxx

ユーザーアプリケーションから ES_WRITE_CUSTOM_HSF を呼び出してレコードに書き込まれたカスタムデータ。

Filexx

トランザクションがアクセスしたファイルの名前。

Countxx: トランザクションがこのファイル xx にアクセスした回数。
Timexx: トランザクションがファイル xx へのアクセスに費やした時間 (ミリ秒単位)。

TSxx

トランザクションがアクセスした一時記憶キュー (TSQ) の名前。

Countxx: トランザクションが TSxx にアクセスした回数。
Timexx: トランザクションが TSxx へのアクセスに費やした時間 (ミリ秒単位)。

Microsoft Excel で表示されるサンプルの内容