統計ユーティリティ プログラムの casfhsf を使用すると、Historical Statistics Facility (HSF) によって作成された .csv ファイルから集計データを出力できます。casfhsf では、このデータがカンマ区切り値ファイルとして出力されます。
その情報を使用してシステムのパフォーマンスを定期的に確認すれば、補正的な調整措置が必要かどうかを判断するために大量のデータを調べなくても済みます。
Visual COBOL コマンド プロンプトから、casfhsf.exe(Windows) または 環境に応じて casfhsf32 または casfhsf64(UNIX) を起動します。
次のスイッチが用意されています。スラッシュの代わりにダッシュを使用することもできます。また、スイッチは大文字または小文字にできます。
スイッチ | 説明 |
---|---|
/A | cashsf-a.csv だけを処理します。 |
/B | cashsf-b.csv だけを処理します。 |
/C | cashsf-a.csv および cashsf-b.csv の両方を処理します (デフォルト)。 |
/D | バックアップ ファイルの cashsf.nnn だけを処理します。 |
/E | すべてのファイル (cashsf-a.csv、cashsf-b.csv、および cashsf.nnn) を処理します。 |
/G{s} | 出力を {s} 秒間隔で集計します。{s} は 1 から 9999 の秒数です。 |
/S[sd,st,ed,et] | 出力データを秒単位で集計します。オプションで、開始日 (sd)、開始時刻 (st)、終了日 (ed)、および終了時刻 (et) を指定できます。[sd,st,ed,et] = yyyymmdd,hhmmss,yyyymmdd,hhmmss |
/M[sd,st,ed,et] | 出力データを分単位で集計します (エラーの場合はデフォルト)。オプションで、開始日 (sd)、開始時刻 (st)、終了日 (ed)、および終了時刻 (et) を指定できます。[sd,st,ed,et] = yyyymmdd,hhmm,yyyymmdd,hhmm |
/IP | 入力ファイルの場所。デフォルト値は現在のディレクトリです。 |
/OP | 出力ファイルのパスの場所。デフォルト値は現在のディレクトリです。
出力ファイルは OutFile.csv という名前になります。 |
R{t}[[,{t}]...] | 指定された ID 別の応答時間の基準。{t} は小数点以下 2 桁までの秒数です。デフォルトは t=1 秒です。 |
/T | トランザクション ID をタイプ別にレポートします。 |
/X | 日付と時刻を別々の列として出力します。 |
特定のトランザクションまたはプログラムを集計するには、次の形式のパラメーターを使用してそれらのトランザクションまたはプログラムを指定します。
{type},{id}[[,{type},{id}]...]パラメーターは次のとおりです。
0 から 5 個の type,id ペアを指定できます。各 type とそれに対応する id はカンマで区切る必要があります。複数のペアを指定する場合は、各ペアをカンマで区切ってください。
ペアを指定しなかった場合は、すべてのトランザクションの集計が最初の未割り当てスロットで累積されます。この場合のデフォルト動作では、すべてのデータがスロット 1 で集計されます。
extfh.cfg ファイルは、大きなファイル入力を許容するために現在のディレクトリで生成されます (このファイルがまだ存在しない場合)。
スイッチまたはパラメーターを指定しなかった場合、ユーティリティはデフォルト値の使用を続行するかどうかをユーザーに尋ねます。
casfhsf /op"c:\Users\All Users\Micro Focus"このコマンドは、入力のデフォルトを使用して、現在のディレクトリ内の cashsf-a.csv と cashsf-b.csv の両方を処理し、すべてのトランザクションおよびプログラムについて分単位で時間を集計して、c:\Users\All Users\Micro Focus フォルダーに出力ファイルを作成します。
casfhsf32 /op"/opt/Micro Focus/logs"このコマンドは、入力のデフォルトを使用して、現在のディレクトリ内の cashsf-a.csv と cashsf-b.csv の両方を処理し、すべてのトランザクションおよびプログラムについて時間 (分単位) を集計して、/opt/Micro Focus/logs フォルダーに出力ファイルを作成します。
time,TPS,SYS<=,%SYS<=,Latency,min,max,Response,min,max,System,min,max,API,min,max,SQL,min,max,IMS,min,max...time フィールドの後に残りのフィールドが 5 回続きます。
フィールド | 説明 |
---|---|
time | 入力監視時間が集計される分単位 (hh:mm フォーマット) または秒単位 (hh:mm:ss フォーマット) の期間。フォーマットは、/S または /M スイッチによって決まります。 |
TPS | 1 秒または 1 分あたりの平均トランザクション数 |
SYS<= | /R オプションで指定された時間範囲 (オプションが使用されていない場合は 1 秒間) に実行されたトランザクションの数 |
%SYS<= | /R オプションで指定された時間範囲 (オプションが使用されていない場合は 1 秒間) に実行されたトランザクションの割合 |
Latency,min,max | この期間の平均待ち時間 (遅延または待機時間)、および最小待ち時間と最大待ち時間 |
Response,min,max | Enterprise Server がトランザクション要求に応答するのにかかった平均時間、および最小応答時間と最大応答時間 |
System,min,max | 平均待ち時間と平均応答時間の合計 (Latency + Response)、および特定のトランザクション実行の待ち時間と応答時間の合計の最小値と最大値 |
SQL,min,max | このタスクに SQL API (EXEC SQL 文) でかかった平均時間 (ミリ秒単位)、および最小時間と最大時間 |
ユーティリティに供給したパラメーターによっては、第 2 のヘッダーも存在します。
パラメーターがない場合は、すべての集計値が「Everything」の下で累積され、他の 4 つの列は「Unused」としてマークされます。
#HSFVer=03;Custom=xx;CicsFiles=xx;TSQ=xx;TDQ=xx
xx は、ES_HSF_CFG 環境変数で指定された各タイプのフィールド数に対応します。
#HSFVer=01 or 02
複数のファイルを処理する場合、casfhsf は受け取った最初のファイルと同じバージョンのファイルからのみデータを集計します。他のバージョンは無視されます。ただし、いずれのバージョンを処理する場合も、出力ファイル OutFile.csv には上記のすべてのフィールドが含まれ、存在しないフィールドの値は 0 になります。