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

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

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

これらのファイルは cashsf-a.csv および cashsf-b.csv という名前でシステム ディレクトリに保管されます。これらのファイルの 1 つは常にアクティブなファイルで、そのファイルがいっぱいになるか、ESMAC 制御ページの [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 フィールドの数は、ES_HSF_CFG 環境変数に従って設定された、ヘッダーの xx 値に対応します。

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

フィールド名 範囲 デフォルト
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

フィールドの型

型
レコードの型。次のいずれかになります。
  • WEB - Web サービス用
PID
タスクを実行した SEP のプロセス ID。
Task
一意のタスク番号。
Date
タスクの実行が開始された日付 (yyyymmdd 形式)。
Time
タスクの実行が開始された時刻 (hhmmsscc 形式)。
Tran/Job
以下のタスクの名前。
  • Web サービスの場合は、サービス名。
Latent/ReadCount
  • Enterprise Server が要求を受信してからタスクの実行が開始されるまでの時間 (100 分の 1 秒単位)。
Resp/WriteCount
  • タスクが実行されていた時間 (100 分の 1 秒単位) (待ち時間を含まない)。
SQL/DeleteCount
  • このタスクに対する SQL API (EXEC SQL 文) で費やされた時間 (100 分の 1 秒単位)。
DSType
このフィールドはすべてのレコードで空白になります。
DSAccessType
このフィールドはすべてのレコードで空白になります。

構成可能なフィールドの型

以下の追加フィールドは、ES_HSF_CFG 環境変数の値に基づいて繰り返すことができます。

Customxx
ユーザー アプリケーションから ES_WRITE_CUSTOM_HSF への呼び出しを介してレコードに書き込まれたカスタム データ。
Filexx
トランザクションがアクセスしたファイルの名前。
Countxx
トランザクションがこのファイル xx にアクセスした回数。
Timexx
トランザクションがファイル xx へのアクセスに費やした時間 (100 分の 1 秒単位)。
TSxx
トランザクションがアクセスした一時記憶キュー (TSQ) の名前。
Countxx
トランザクションが TSxx にアクセスした回数。
Timexx
トランザクションが TSxx へのアクセスに費やした時間 (100 分の 1 秒単位)。

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



上位ヘルプ： トランザクションに関するデータの収集および表示