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

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 または 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
レコードの型。次のいずれかになります。
  • CICS - CICS トランザクション用
  • IMS - IMS トランザクション用
  • JCL - JCL ジョブ開始、ステップ完了、およびジョブ終了イベント
  • JCLF - メインフレーム ファイル イベント用
  • WEB - Web サービス用
PID
タスクを実行した SEP のプロセス ID。
Task
一意のタスク番号。
Date
タスクの実行が開始された日付 (yyyymmdd 形式)。
Time
タスクの実行が開始された時刻 (hhmmsscc 形式)。
Tran/Job
タスクの名前。以下のいずれかになります。
  • CICS および IMS タスクの場合は、トランザクション ID。
  • JCL および JCLF の場合は、ジョブ名。
  • Web サービスの場合は、サービス名。
User/DDName/CC
  • JCL および JCLF 以外のレコードの場合は、タスクを開始したユーザーの ID。
  • JCL STEP および JCL JOBEND レコードの場合は、関連する条件コード。
  • JCL JOBSTART レコードの場合は、ジョブをサブミットしたユーザー。
  • JCLF レコードの場合は、ジョブ ステップに関連付けられたファイルの DDName。
LU/Step
  • CICS タスクの場合は、論理ユニットまたはネット名 (タスクを開始するために使用された端末の識別子)。
  • JCL JOBSTART レコードの場合は、JOBSTART(CLASS=jobclass) インジケーター。
  • JCL STEP レコードの場合は、ステップ名。
  • JCL JOBEND レコードの場合は、JOBEND インジケーター。
  • JCLF の場合は、ステップ名。
Prog/DSName
  • CICS および IMS タスクの場合は、プログラム名。
  • JCL JOBSTART および JOBEND レコードの場合は、ジョブ番号。
  • JCL STEP レコードの場合は、プログラム名。
  • JCLF レコードの場合は、データセットの名前。
Latent/ReadCount
  • Enterprise Server が要求を受信してからタスクの実行が開始されるまでの時間 (100 分の 1 秒単位)。これは、JCLF レコードを除くすべてのレコードに適用されます。
  • JCLF レコードの場合は、関連するステップ中にファイルに対して実行された読み取りの数。
Resp/WriteCount
  • タスクが実行されていた時間 (100 分の 1 秒単位) (待ち時間を含まない)。これは、JCLF レコードを除くすべてのレコードに適用されます。
  • JCLF レコードの場合は、関連するステップ中にファイルに対して実行された書き込み操作の数。
API/RewriteCount
  • このタスクに対する CICS API (EXEC CICS 文) で費やされた時間 (100 分の 1 秒単位)。これは、JCLF レコードを除くすべてのレコードに適用されます。
  • JCLF レコードの場合は、関連するステップ中にファイルに対して実行された再書き込みの数。
SQL/DeleteCount
  • このタスクに対する SQL API (EXEC SQL 文) で費やされた時間 (100 分の 1 秒単位)。これは、JCLF レコードを除くすべてのレコードに適用されます。
  • JCLF レコードの場合は、関連するステップ中にファイルに対して実行されたレコード削除の数。
IMS/DSDeleteCount
  • このタスクに対する IMS DL/I API で費やされた時間 (100 分の 1 秒単位)。これは、JCLF レコードを除くすべてのレコードに適用されます。
  • JCLF レコードの場合は、現在のステップ中に関連するデータセットが削除された回数。
DSType
このフィールドはすべてのレコードで空白になります。ただし、JCLF レコードは例外で、次のいずれかになります。
  • Permanent
  • PC
  • Terminal
  • Sysout
  • Dummy
  • Temp
DSAccessType
このフィールドはすべてのレコードで空白になります。ただし、JCLF レコードは例外で、次のいずれかになります。
  • Alloc
  • Read
  • Update
  • Delete

構成可能なフィールド型

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

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

Microsoft Excel で表示したサンプルの内容



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